Rilascio Android SDK
Consulta le principali modifiche al DEUNA Android SDK, i limiti di compatibilità e una procedura di aggiornamento sicura per le integrazioni con versioni Gradle fisse.
In questa pagina
Il repository Android mantenuto è attualmente contrassegnato con v2.12.8. 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#
Punti salienti delle release#
v2.12.x · Rafforzamento della protezione antifrode e APM nativo
v2.12.8è l'ultima versione presente nel repository controllato.- Il
v2.12.5Aggiunta l'integrazione e il supporto di inizializzazione del fornitore di servizi Mercado Pago per la protezione antifrode. - Il
v2.12.4Aggiunto 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 corrente
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 errore
OrderResponseeElementsResponsesono state cambiate inMap<String, Any>payloads.CheckoutErrorsono state cambiate inPaymentsError.- 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 pubblici
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.
Cronologia completa delle versioni#
Tutti i cambiamenti significativi documentati nelle versioni dell'SDK Android, seguendo Keep a Changelog e Semantic Versioning:
[v2.12.7] - 2026-09-29
Corretti
-
Utilizzo del delimitatore hash in sed per supportare l'alternanza regex nel workflow move-repo
-
Aggiornamento dell'azione setup-android alla versione v4
[v2.12.5] - 2026-09-29
Aggiunto
- Supporto per l'impronta digitale antifrode di Mercado Pago e correzioni del provider
Aggiornato
- Pubblicazione automatica del changelog dell'SDK Android al rilascio [ENTP1-18063]
[v2.12.4] - 2026-08-12
Aggiunto
- Aggiunta della callback onError errorApmMissingReference e correzione della gestione dei deep link in ExternalUrlWebView
Corretti
- Filtro della scoperta dei test per ANDROID_TEST_ANNOTATION
Aggiornato
-
Preservazione dei fallimenti dei test Android per i tentativi successivi
-
Isolamento del servizio compose per i test Android
-
Aggiornamento dell'emulatore Android da API 31 a 33 e correzione dell'instabilità del test di deselezione delle rate
[v2.12.3] - 2026-07-15
Aggiunto
- Aggiunta del supporto Docker e dell'integrazione E2E all'app explore
Corretti
- Pre-installazione delle piattaforme Android SDK 32, 34 e dei build-tools 34.0.0 al momento della build
Aggiornato
-
Pubblicazione dell'immagine di test preprod per Android
-
Impostazione della proprietà di /app su androidusr nel Dockerfile di explore
-
Prestazioni: ottimizzazione dell'utilizzo della memoria dell'emulatore e di Gradle per prevenire OOM in CI
-
Implementazione del port forwarding locale e della configurazione dell'ambiente dell'emulatore
-
Passaggio degli endpoint di ambiente ai test di strumentazione tramite argomenti gradle
-
Consenso al traffico HTTP in chiaro verso il backend locale 10.0.2.2 nell'app explore
-
Test di integrazione E2E mobile preprod per Android
-
Rinomina del volume test-results in android-test-reports per la CI preprod
-
Mantenimento dell'accelerazione hardware di WebView per 3DS
-
@duna-alex-vidal ha effettuato il suo primo contributo
[v2.12.2] - 2026-06-12
Aggiornato
- Correzione dello scroll interno di WebView bloccato da verticalScroll di Compose in modalità auto-resize
[v2.12.1] - 2026-06-11
Aggiornato
- Aggiunta degli eventi Elements mancanti in onEventDispatch
[v2.12.0] - 2026-06-04
Aggiunto
-
Miglioramento dei test explore
-
Aggiunta di nuovi test
-
Aggiunto il supporto auto resize e accertify
[v2.11.7] - 2026-05-25
Aggiornato
- Aggiornamento della versione del plugin Android Gradle a 8.5.1
[v2.11.6] - 2026-05-22
Aggiunto
- Aggiunti signifyd & sift ai provider antifrode
[v2.11.5] - 2026-05-07
Aggiunto
- Aggiunta della nuova app explore
[v2.11.4] - 2026-05-05
Aggiunto
- Aggiunto il supporto per il portafoglio Google Pay
[v2.11.3] - 2026-04-30
Aggiunto
- Aggiunto il supporto per gli spazi bianchi in firstName & lastName
[v2.11.2] - 2026-04-27
Aggiunto
- Aggiunto il supporto per le impostazioni personalizzate di WebView e aggiornamento delle dipendenze per…
[v2.11.0] - 2026-04-24
Aggiunto
- Aggiunte librerie native per generateFraudId
Aggiornato
- Aggiornamento della dichiarazione di dipendenza per l'SDK Riskified per chiarirne l'utilizzo…
[v2.10.0] - 2026-03-30
Aggiunto
- Stabilizzazione dei flussi WebView esterni e aggiunta delle callback per le rate/bin per Elements
[v2.9.17] - 2026-03-23
Aggiunto
- Introduzione di una vasta gamma di nuovi tipi di evento per i widget Checkout ed Elements.
[v2.9.16] - 2026-02-19
Aggiunto
- Aggiunto userAgent nel payload di onSuccess
[v2.9.15] - 2025-12-18
Corretti
- Impedisce URL esterni duplicati
[v2.9.14] - 2025-11-26
Aggiunto
- Aggiunto parametro domain opzionale
[v2.9.13] - 2025-11-10
Corretti
- Risolto crash dell'app sui reindirizzamenti esterni
[v2.9.12] - 2025-10-22
Aggiunto
- Aggiunto supporto per fraudCredentials su PaymentWidget
[v2.9.7] - 2025-09-26
Aggiornato
- Annulla "feat(): Rimosso vecchio azione di pubblicazione"
[v2.9.6] - 2025-09-04
Aggiunto
- Invia userInfo e userToken su vault
[v2.9.5] - 2025-07-23
Aggiunto
- Rilascio v2.9.5
[v2.9.4] - 2025-06-19
Aggiunto
-
Supporto per Custom Chrome Tabs
-
Rilascio v2.9.4
[v2.9.3] - 2025-06-02
Aggiunto
- Rilascio v2.9.3
[v2.8.13] - 2025-03-12
Aggiunto
- Aggiungi nuovi campi in initElements - Android
[v2.8.12] - 2025-02-27
Aggiunto
- Rilascio 2.8.12
[v2.8.11] - 2024-12-17
Aggiunto
- Supporto per link nei parametri di query
[v2.8.10] - 2024-10-29
Aggiornato
- @capdilla ha fatto il suo primo contributo
[v2.8.8] - 2024-10-11
Corretti
- Rilascio 2.8.8
[v2.8.5] - 2024-10-01
Aggiunto
- Rilascio 2.8.5
[v2.8.4] - 2024-09-27
Aggiunto
- Rilascio 2.8.4
[v2.8.3] - 2024-09-26
Aggiunto
- Rilascio 2.8.3
[v2.8.2] - 2024-09-17
Aggiunto
- Rilascio 2.8.2
[v2.8.1] - 2024-09-11
Aggiunto
- Aggiunti eventi purchaseRejected e apmSuccess
[v2.8.0] - 2024-09-11
Aggiunto
- Rilascio 2.8.0
[v2.7.1] - 2024-09-04
Aggiunto
- Rilascio 2.7.1
[v2.7.0] - 2024-09-02
Aggiunto
- Rilascio 2.7.0
[v2.6.1] - 2024-08-29
Aggiunto
- Rilascio 2.6.0
[v2.6.0] - 2024-08-29
Aggiunto
- Rilascio 2.6.0
[v2.5.2] - 2024-08-20
Aggiunto
- Rilascio 2.5.2
[v2.5.1] - 2024-08-12
Aggiunto
-
Migrazione a jitpack.io come repository di pacchetti
-
Rilascio 2.5.0
[v2.4.0] - 2024-07-16
Aggiunto
- Rilascio 2.4. - Widget di pagamento
[v2.1.1] - 2024-07-03
Aggiunto
- Feat(v2.1.1): Ritorno al supporto di compileSdk 32
[v2.0.3] - 2024-06-28
Aggiunto
- Feat(2.0.3): Risolti domini sandbox
[v2.0.2] - 2024-06-24
Aggiunto
- Feat(V2.0.2): Rilascio v2.0.2
[v2.0.0] - 2024-04-10
Aggiunto
- Feat(Entp1-9897) aggiungi change cart al dizionario dell'SDK
Aggiornato
-
Pre-rilascio 2.0.0
-
@DinaRocio ha fatto il suo primo contributo
[v1.0.9] - 2024-02-16
Aggiunto
- Aggiunta barra di avanzamento durante il caricamento degli URL
Aggiornato
- Utilizza versione rigorosa in google.code.gson
[v1.0.8] - 2024-01-16
Corretti
- Reindirizzamento URL esterni
Aggiornato
- @catalanseb ha effettuato il primo contributo
[v1.0.6] - 2023-12-18
Aggiornato
-
Feature/plat 2108 test chiusura su eventi
-
Ottieni campi opzionali da OrderResponse
-
Aggiungi barra di caricamento per 3 secondi dopo il caricamento della webview
[v1.0.5] - 2023-12-06
Aggiornato
-
Supporto 3ds in elementActivity
-
Release-candidate: v1.0.5
[v1.0.4] - 2023-11-30
Aggiornato
-
Sposta orderToken da config all'istanza initCheckout
-
Sposta userToken da config a initElements
-
@dependabot ha effettuato il primo contributo
[v1.0.3] - 2023-11-22
Aggiornato
-
Aggiunta funzionalità per chiudere l'activity quando gli eventi rientrano negli eventi di chiusura
-
Aggiungi configurazione signin e cambia funzione close in closeCheckout
[v1.0.1] - 2023-11-17
Aggiornato
- Feature/dipendenze transitive
[v1.0.0] - 2023-11-14
Aggiornato
-
Feature/flusso normale
-
@silvaignacio ha effettuato il primo contributo
-
@mavelar ha effettuato il primo contributo
Prima di v2.0.0
Versioni pubbliche iniziali che coprono i widget Payment Widget, Elements, Voucher e Next Action.
**Aggiornato 23 giorni fa Questa pagina ti è stata utile?**Sì.**No.
Matrice di compatibilità#
| Superficie | Verifica aggiornamento |
|---|---|
| Gradle e repository | Identificare il tag SDK corretto utilizzando i repository documentati per quella release |
| Strumenti per Android | Compilare utilizzando l'AGP, Kotlin e JDK effettivi dell'app. compileSdk, e matrice min-SDK |
| Widget ospitati | Modalità, incorporati, auto-ridimensionamento, tastiera, rotazione, navigazione indietro e gestione del controller |
| Azioni esterne | 3DS, schede personalizzate, applicazioni provider, link profondi, cancellazione e comportamento di ritorno all'app |
| Portafogli nativi | Capacità del dispositivo, configurazione del commerciante, risultato dell'attività, tokenizzazione e cancellazione |
| Fornitori di prevenzione delle frodi | Dipendenza nativa presente, inizializzazione precoce, timeout, dati mancanti e configurazione specifica del fornitore |
| Payload di callback | Gestori 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.