Pular para o conteúdo principal
Nesta página

O repositório Android mantido está atualmente marcado com a versão v2.12.8. Defina uma versão específica em produção e revise o artefato de lançamento upstream antes de cada atualização. Esta página resume as alterações que impactam a integração, verificadas em relação aos commits do repositório. f8c9845e9aa78ea471a69afe952b83579e031154; Não substitui a documentação completa Histórico de lançamentos do repositório.

Fluxo de atualização#

01 · compare
Ler as alterações entre os pinos
Revisar a fonte, notas de lançamento, APIs removidas, dependências nativas e a aplicação de exemplo.
02 · resolve
Atualizar o Gradle em um branch
Fixar o novo SDK e resolver os requisitos do repositório, compilar o SDK, Kotlin, AndroidX e o manifesto.
03 · exercise
Execute a matriz de pagamento
Teste os modos do widget, carteiras, provedores de prevenção de fraude, redirecionamentos, 3DS, APMs, tratamento de falhas e acessibilidade.
04 · release
Implementação e monitoramento
Compare exceções do cliente, cobertura de callbacks, resultados de pagamentos e abandono com a versão anterior.

Principais lançamentos#

v2.12.x · Fortalecimento da prevenção de fraude e APM nativoVersão atualmente verificada
  • v2.12.8 é a versão mais recente no repositório auditado.
  • O v2.12.5 Adicionada integração e suporte de inicialização do provedor Mercado Pago para prevenção de fraude.
  • O v2.12.4 Adicionado tratamento explícito para referências ausentes nos fluxos de vouchers do APM e interceptação de esquemas de aplicativos externos.

Re-testar a inicialização nativa de prevenção de fraudes, resolução de dependências do provedor, callbacks de erro de vouchers e todas as rotas de retorno de aplicativos externos. Uma build que é bem-sucedida não prova que o SDK do provedor foi inicializado ou retornou dados de dispositivo utilizáveis.

v2.9.0 · Widgets incorporados e capacidades do controlador atualApresentação e dados de prevenção de fraudes

Esta linha adicionou widgets incorporados, comportamento do botão de pagamento controlado pelo comerciante, geração de "impressões digitais" de fraude e suporte para o Widget de Próxima Ação, e removeu funções obsoletas.

Ao atualizar de uma versão anterior, migre para os métodos atuais no Guia do Android SDK, e teste o comportamento modal, incorporado e de auto-redimensionamento de forma independente.

Versão beta v2.4.0 · Alterações no contrato de resposta e erroTipos de resposta
  • OrderResponse e ElementsResponse mudados para Map<String, Any> payloads.
  • CheckoutError mudados para PaymentsError.
  • Suporte para Widget de Pagamento movido para o modelo atual do controlador de widgets.

Evite conversões exaustivas em mapas brutos. Prefira callbacks dedicados e aceite campos adicionais nos payloads de eventos.

v2.0.0 · Renomeação de símbolos públicosMigração principal

A principal linha renomeou DeUnaSdk para DeunaSDK, Callbacks para CheckoutCallbacks, símbolos de resposta/evento e alteração na ordem dos argumentos dos listeners, (response, type) para (type, response).

Compile todos os adaptadores de callback e de análise, ao migrar; a troca de argumentos pode causar corrupção de dados em tempo de execução, mesmo que a lógica da aplicação continue a funcionar através de wrappers de tipagem fraca.

Histórico completo de lançamentos#

Todas as alterações relevantes documentadas nas versões do Android SDK, seguindo Keep a Changelog e Semantic Versioning:

[v2.12.7] - 2026-09-29

Corrigido

  • Usar delimitador hash no sed para suportar alternância de regex no fluxo de trabalho move-repo

  • Atualizar ação setup-android para v4

[v2.12.5] - 2026-09-29

Adicionado

  • Suporte à impressão digital antifraude do Mercado Pago e correções de provedor

Atualizado

  • Publicação automática do changelog do Android SDK no lançamento [ENTP1-18063]

[v2.12.4] - 2026-08-12

Adicionado

  • Adicionar errorApmMissingReference no callback onError e corrigir tratamento de deep link no ExternalUrlWebView

Corrigido

  • Filtrar descoberta de testes por ANDROID_TEST_ANNOTATION

Atualizado

  • Preservar falhas de testes Android para novas tentativas

  • Isolar serviço de compose de testes Android

  • Atualizar emulador Android API 31→33 e corrigir instabilidade no teste de desmarcar parcelas

[v2.12.3] - 2026-07-15

Adicionado

  • Adicionar suporte a Docker e integração E2E ao aplicativo explore

Corrigido

  • Pré-instalar plataformas Android SDK 32, 34 e build-tools 34.0.0 no momento da compilação

Atualizado

  • Publicar imagem de teste preprod do Android

  • Definir propriedade de /app para androidusr no Dockerfile do explore

  • Desempenho: otimizar uso de memória do emulador e Gradle para evitar OOM no CI

  • Implementar encaminhamento de porta local e configuração de ambiente do emulador

  • Passar endpoints de ambiente para testes de instrumentação via argumentos do gradle

  • Permitir tráfego HTTP em texto claro para backend local 10.0.2.2 no aplicativo explore

  • Testes de integração E2E mobile preprod do Android

  • Renomear volume test-results para android-test-reports para CI preprod

  • Manter aceleração de hardware do WebView para 3DS

  • @duna-alex-vidal fez sua primeira contribuição

[v2.12.2] - 2026-06-12

Atualizado

  • Corrigir rolagem interna do WebView bloqueada por verticalScroll do Compose no modo auto-resize

[v2.12.1] - 2026-06-11

Atualizado

  • Adicionados eventos Elements ausentes no onEventDispatch

[v2.12.0] - 2026-06-04

Adicionado

  • Melhorar testes do explore

  • Adicionados novos testes

  • Adicionado suporte a auto resize e accertify

[v2.11.7] - 2026-05-25

Atualizado

  • Atualizar versão do plugin Android Gradle para 8.5.1

[v2.11.6] - 2026-05-22

Adicionado

  • Adicionados signifyd & sift aos provedores antifraude

[v2.11.5] - 2026-05-07

Adicionado

  • Adicionado novo aplicativo explore

[v2.11.4] - 2026-05-05

Adicionado

  • Adicionado suporte à carteira Google Pay

[v2.11.3] - 2026-04-30

Adicionado

  • Adicionado suporte para espaços em branco em firstName & lastName

[v2.11.2] - 2026-04-27

Adicionado

  • Adicionar suporte a configurações personalizadas do WebView e atualizar dependências para…

[v2.11.0] - 2026-04-24

Adicionado

  • Adicionadas bibliotecas nativas ao generateFraudId

Atualizado

  • Atualizar declaração de dependência do SDK Riskified para esclarecer uso…

[v2.10.0] - 2026-03-30

Adicionado

  • Estabilizar fluxos de WebView externos e adicionar callbacks de parcela/bin para Elements

[v2.9.17] - 2026-03-23

Adicionado

  • Introduzir uma ampla gama de novos tipos de evento para widgets Checkout e Elements.

[v2.9.16] - 2026-02-19

Adicionado

  • Adicionado userAgent no payload de onSuccess

[v2.9.15] - 2025-12-18

Corrigido

  • Prevenção de URLs externas duplicadas

[v2.9.14] - 2025-11-26

Adicionado

  • Adicionado parâmetro domain opcional

[v2.9.13] - 2025-11-10

Corrigido

  • Corrigido crash do app em redirecionamentos externos

[v2.9.12] - 2025-10-22

Adicionado

  • Adicionado suporte para fraudCredentials no PaymentWidget

[v2.9.7] - 2025-09-26

Atualizado

  • Revertido "feat(): Removed old publishing action"

[v2.9.6] - 2025-09-04

Adicionado

  • Envio de userInfo e userToken no vault

[v2.9.5] - 2025-07-23

Adicionado

  • Lançamento v2.9.5

[v2.9.4] - 2025-06-19

Adicionado

  • Suporte para Custom Chrome Tabs

  • Lançamento v2.9.4

[v2.9.3] - 2025-06-02

Adicionado

  • Lançamento v2.9.3

[v2.8.13] - 2025-03-12

Adicionado

  • Adicionar novos campos em initElements - Android

[v2.8.12] - 2025-02-27

Adicionado

  • Lançamento 2.8.12

[v2.8.11] - 2024-12-17

Adicionado

  • Suporte para links em parâmetros de consulta

[v2.8.10] - 2024-10-29

Atualizado

  • @capdilla fez sua primeira contribuição

[v2.8.8] - 2024-10-11

Corrigido

  • Lançamento 2.8.8

[v2.8.5] - 2024-10-01

Adicionado

  • Lançamento 2.8.5

[v2.8.4] - 2024-09-27

Adicionado

  • Lançamento 2.8.4

[v2.8.3] - 2024-09-26

Adicionado

  • Lançamento 2.8.3

[v2.8.2] - 2024-09-17

Adicionado

  • Lançamento 2.8.2

[v2.8.1] - 2024-09-11

Adicionado

  • Adicionados eventos purchaseRejected e apmSuccess

[v2.8.0] - 2024-09-11

Adicionado

  • Lançamento 2.8.0

[v2.7.1] - 2024-09-04

Adicionado

  • Lançamento 2.7.1

[v2.7.0] - 2024-09-02

Adicionado

  • Lançamento 2.7.0

[v2.6.1] - 2024-08-29

Adicionado

  • Lançamento 2.6.0

[v2.6.0] - 2024-08-29

Adicionado

  • Lançamento 2.6.0

[v2.5.2] - 2024-08-20

Adicionado

  • Lançamento 2.5.2

[v2.5.1] - 2024-08-12

Adicionado

  • Migração para jitpack.io como repositório de pacotes

  • Lançamento 2.5.0

[v2.4.0] - 2024-07-16

Adicionado

  • Lançamento 2.4. - Widget de pagamento

[v2.1.1] - 2024-07-03

Adicionado

  • Feat(v2.1.1): Retorno ao suporte para compileSdk 32

[v2.0.3] - 2024-06-28

Adicionado

  • Feat(2.0.3): Domínios sandbox corrigidos

[v2.0.2] - 2024-06-24

Adicionado

  • Feat(V2.0.2): Lançamento v2.0.2

[v2.0.0] - 2024-04-10

Adicionado

  • Feat(Entp1-9897) adicionar change cart ao dicionário do SDK

Atualizado

  • Pré-lançamento 2.0.0

  • @DinaRocio fez sua primeira contribuição

[v1.0.9] - 2024-02-16

Adicionado

  • Barra de progresso adicionada durante o carregamento das URLs

Atualizado

  • Usar versão estrita no google.code.gson

[v1.0.8] - 2024-01-16

Corrigido

  • Redirecionar URL externa

Atualizado

  • @catalanseb fez sua primeira contribuição

[v1.0.6] - 2023-12-18

Atualizado

  • Feature/plat 2108 close on events testing

  • Obter campos opcionais de OrderResponse

  • Adicionar barra de carregamento por 3 segundos após carregar webview

[v1.0.5] - 2023-12-06

Atualizado

  • Suporte a 3DS em elementActivity

  • Release-candidate: v1.0.5

[v1.0.4] - 2023-11-30

Atualizado

  • Mover orderToken de config para instância initCheckout

  • Mover userToken de config para initElements

  • @dependabot fez sua primeira contribuição

[v1.0.3] - 2023-11-22

Atualizado

  • Adicionar funcionalidade para fechar atividade quando eventos estão em close events

  • Adicionar config signin e alterar função close para closeCheckout

[v1.0.1] - 2023-11-17

Atualizado

  • Feature/transitive dependencies

[v1.0.0] - 2023-11-14

Atualizado

  • Feature/normal flow

  • @silvaignacio fez sua primeira contribuição

  • @mavelar fez sua primeira contribuição

Antes da v2.0.0

Lançamentos públicos iniciais cobrindo widgets de Pagamento, Elements, Voucher e Next Action.

**Atualizado há 23 dias Esta página foi útil?SimNão

Matriz de compatibilidade#

SuperfícieVerificação de atualização
Gradle e repositóriosResolva a versão exata do SDK usando os repositórios documentados para essa versão
Ferramentas AndroidCompile com a versão real do AGP, Kotlin e JDK da aplicação, compileSdke matriz de min-SDK
Widgets hospedadosModais, embutidos, auto-redimensionamento, teclado, rotação, navegação para trás e descarte do controlador
Ações externas3DS, Custom Tabs, aplicativos de provedor, deep links, cancelamento e comportamento de retorno para a aplicação
Carteiras nativasCapacidade do dispositivo, configuração do comerciante, resultado de atividade, tokenização e cancelamento
Provedores de fraudeDependência nativa presente, inicialização precoce, timeout, dados ausentes e configuração específica do provedor
Payloads de callbackManipuladores dedicados de sucesso/erro/fechamento, além de um fallback para eventos desconhecidos

Lista de verificação de regressão#

  • Instalação e atualização limpas a partir da versão atualmente em uso.
  • Versão de lançamento com compactação/ofuscação habilitadas.
  • Proteção contra recriação de atividades, término de processos, modo de fundo/frente e lançamento duplicado.
  • Widget de pagamento, elementos, voucher e próxima ação em todos os modos de apresentação suportados.
  • Caminhos para cartão, carteira, APM, 3DS, erro, timeout, fechar e tentar novamente.
  • Conteúdo de 320 dp de largura, texto grande, navegação por teclado, TalkBack e configurações de animação reduzidas.
  • Reconciliação no backend após cada chamada de retorno do cliente.