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.7. 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.7é 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.
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.