Passa al contenuto principale
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#

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.8 è 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.

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à#

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.