Lançamentos do SDK para Android
Acompanhe as principais alterações no Android SDK da DEUNA, os limites de compatibilidade e um processo de atualização seguro para integrações Gradle.
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#
Principais lançamentos#
v2.12.x · Fortalecimento da prevenção de fraude e APM nativo
v2.12.8é a versão mais recente no repositório auditado.- O
v2.12.5Adicionada integração e suporte de inicialização do provedor Mercado Pago para prevenção de fraude. - O
v2.12.4Adicionado 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 atual
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 erro
OrderResponseeElementsResponsemudados paraMap<String, Any>payloads.CheckoutErrormudados paraPaymentsError.- 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úblicos
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ície | Verificação de atualização |
|---|---|
| Gradle e repositórios | Resolva a versão exata do SDK usando os repositórios documentados para essa versão |
| Ferramentas Android | Compile com a versão real do AGP, Kotlin e JDK da aplicação, compileSdke matriz de min-SDK |
| Widgets hospedados | Modais, embutidos, auto-redimensionamento, teclado, rotação, navegação para trás e descarte do controlador |
| Ações externas | 3DS, Custom Tabs, aplicativos de provedor, deep links, cancelamento e comportamento de retorno para a aplicação |
| Carteiras nativas | Capacidade do dispositivo, configuração do comerciante, resultado de atividade, tokenização e cancelamento |
| Provedores de fraude | Dependência nativa presente, inicialização precoce, timeout, dados ausentes e configuração específica do provedor |
| Payloads de callback | Manipuladores 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.