Passa al contenuto principale
Tutti i sistemi operativiNovitàv1
Accedi
Android SDK

Rilascio Android SDK

Monitora le modifiche significative dell'Android SDK, i limiti di compatibilità e un processo di aggiornamento sicuro per le integrazioni Gradle.

Ultimo aggiornamento: October 16, 2026
In questa pagina

Il repository Android mantenuto è attualmente contrassegnato con v2.12.7. Definisci una versione specifica in produzione e rivedi l'artefatto di rilascio upstream prima di ogni aggiornamento. Questa pagina riassume le modifiche che impattano l'integrazione, verificate rispetto al commit del repository. f8c9845e9aa78ea471a69afe952b83579e031154; non è un sostituto per la documentazione completa Cronologia rilasci del repository.

Flusso di aggiornamento#

01 · compare
Visualizza le modifiche relative alle chiavi
Esamina la fonte, le note di rilascio, le API rimosse, le dipendenze native e l'applicazione di esempio.
02 · resolve
Aggiorna Gradle in un ramo
Fissa la nuova SDK e risolvi i requisiti per il repository, la compilazione di SDK, Kotlin, AndroidX e il manifest.
03 · exercise
Eseguire la matrice di pagamento
Testare le modalità di widget, i portafogli, i fornitori di servizi antifrode, i redirect, 3DS, APM, la gestione degli errori e l'accessibilità.
04 · release
Implementazione e monitoraggio
Confrontare le eccezioni del cliente, la copertura delle callback, i risultati dei pagamenti e l'abbandono con la versione precedente.

Punti salienti delle release#

v2.12.x · Rafforzamento della protezione antifrode e APM nativoLinea attualmente verificata
  • v2.12.7 è l'ultima versione presente nel repository controllato.
  • Il v2.12.5 Aggiunta l'integrazione e il supporto di inizializzazione del fornitore di servizi Mercado Pago per la protezione antifrode.
  • Il v2.12.4 Aggiunto un meccanismo esplicito per la gestione di riferimenti mancanti nei flussi di voucher APM e per l'intercettazione di schemi di applicazioni esterne.

Riprovare l'inizializzazione nativa della frode, la risoluzione delle dipendenze del provider, le callback di errore dei voucher e ogni percorso di ritorno delle applicazioni esterne. Un build che ha successo non dimostra che l'SDK del provider è stato inizializzato o ha restituito dati di dispositivo utilizzabili.

v2.9.0 · Widget integrati e funzionalità del controller correntePresentazione e dati di frode

Questa linea ha aggiunto widget integrati, comportamento controllato dal commerciante del pulsante di pagamento, generazione di impronte di frode e supporto per il widget Next Action, rimuovendo le funzioni obsolete.

Durante l'aggiornamento da una versione precedente, migrare ai metodi attuali nella Guida allo SDK Android, quindi testare indipendentemente il comportamento modale, integrato e auto-ridimensionamento.

Linea beta v2.4.0 · Modifiche al contratto di risposta e erroreModifiche ai tipi di risposta
  • OrderResponse e ElementsResponse sono state cambiate in Map<String, Any> payloads.
  • CheckoutError sono state cambiate in PaymentsError.
  • Il supporto per il widget di pagamento è stato spostato nel modello del controller widget corrente.

Evitare conversioni estese su mappe grezze. Preferire callback dedicati e tollerare campi aggiuntivi nei payload di eventi.

v2.0.0 · Rinominare simboli pubbliciMigrazione principale

La principale linea ha rinominato DeUnaSdk a DeunaSDK, Callbacks a CheckoutCallbacks, simboli di risposta/evento e modifica dell'ordine degli argomenti nella funzione di ascolto degli eventi. (response, type) a (type, response).

Compilare tutti gli adattatori per callback e analisi degli audit durante la migrazione; lo scambio di argomenti può causare la corruzione dei dati a runtime, anche quando la logica dell'applicazione utilizza wrapper di tipo debole.

Matrice di compatibilità#

SuperficieVerifica aggiornamento
Gradle e repositoryIdentificare il tag SDK corretto utilizzando i repository documentati per quella release
Strumenti per AndroidCompilare utilizzando l'AGP, Kotlin e JDK effettivi dell'app. compileSdk, e matrice min-SDK
Widget ospitatiModalità, incorporati, auto-ridimensionamento, tastiera, rotazione, navigazione indietro e gestione del controller
Azioni esterne3DS, schede personalizzate, applicazioni provider, link profondi, cancellazione e comportamento di ritorno all'app
Portafogli nativiCapacità del dispositivo, configurazione del commerciante, risultato dell'attività, tokenizzazione e cancellazione
Fornitori di prevenzione delle frodiDipendenza nativa presente, inizializzazione precoce, timeout, dati mancanti e configurazione specifica del fornitore
Payload di callbackGestori dedicati di successo/errore/chiusura, oltre a un fallback per eventi sconosciuti

Checklist di regressione#

  • Installazione e aggiornamento puliti dalla versione attualmente in uso.
  • Versione di rilascio con attivazione di compressione/offuscamento.
  • Protezione contro la ricreazione dell'attività, la terminazione del processo, l'utilizzo in background/foreground e il lancio duplicato.
  • Widget, elementi, voucher e "prossimo passo" supportati in tutte le modalità di presentazione.
  • Percorsi per carta, portafoglio, APM, 3DS, errore, timeout, chiusura e tentativo di riprovo.
  • Contenuto di 320 dp, testo di grandi dimensioni, navigazione tramite tastiera, TalkBack e impostazioni di animazione ridotte.
  • Riconciliazione lato server dopo ogni callback del client.
Integrazione per AndroidInstallazione, inizializzazione, presentazione dei widget e gestione dei callback.Eventi SDKUtilizzare segnali di ciclo di vita stabili e gestire i payload grezzi in modo sicuro.Rilasci precedentiVerificare l'intero record di rilascio di proprietà dell'utente.