Lancements de l'Android SDK
Suivez les modifications importantes de l'Android SDK de DEUNA, les limites de compatibilité et un processus de mise à niveau sécurisé pour les intégrations Gradle.
Sur cette page
Le dépôt Android maintenu est actuellement étiqueté v2.12.7. Définissez une version spécifique en production et examinez l'artefact de version upstream avant chaque mise à niveau. Cette page résume les modifications impactant l'intégration, vérifiées par rapport aux commits du dépôt. f8c9845e9aa78ea471a69afe952b83579e031154; ce n'est pas un substitut à la documentation complète Historique des versions du dépôt.
Flux de mise à niveau#
Lignes de publication notables#
v2.12.x · Renforcement de la détection de fraude et des APMs
v2.12.7est la dernière version dans le référentiel audité.- Le
v2.12.5Ajout de l'intégration et du support d'initialisation du fournisseur de fraude Mercado Pago. - Le
v2.12.4Ajout d'une gestion explicite des références manquantes pour les flux de bons de caisse et interception des schémas d'applications externes.
Ré-tester l'initialisation native de la fraude, la résolution des dépendances des fournisseurs, les appels de retour d'erreur des bons de caisse et tous les chemins de retour des applications externes. Une build réussie ne prouve pas que le SDK du fournisseur a été initialisé ou qu'il a renvoyé des données de périphérique utilisables.
v2.9.0 · Widgets intégrés et capacités du contrôleur actuel
Cette ligne ajoute des widgets intégrés, le comportement du bouton de paiement contrôlé par le commerçant, la génération de l'empreinte de fraude et la prise en charge du widget "Next Action", et supprime les fonctions obsolètes.
Lors de la mise à niveau à partir d'une ancienne version, migrez vers les méthodes actuelles dans le guide du SDK Android, puis testez indépendamment le comportement modal, intégré et auto-réglable.
ligne de test beta v2.4.0 · Modifications du contrat de réponse et d'erreur
OrderResponseetElementsResponseenMap<String, Any>payloads.CheckoutErrorenPaymentsError.- Prise en charge du widget de paiement intégrée au modèle de contrôleur de widget actuel.
Évitez les conversions exhaustives des tableaux bruts. Préférez les appels de retour dédiés et acceptez les champs additionnels dans les payloads d'événements.
v2.0.0 · Renommage des symboles publics
La majeure ligne a renommé DeUnaSdk à DeunaSDK, Callbacks à CheckoutCallbacks, symboles de réponse/événements et changement de l'ordre des arguments des écouteurs d'événements à partir (response, type) à (type, response).
Compiler tous les adaptateurs de callback et d'analyse des données lors de la migration ; les arguments modifiés peuvent entraîner une corruption des données au moment de l'exécution, même lorsque la logique de l'application fonctionne à travers des enveloppes faiblement typées.
Matrice de compatibilité#
| Surface | Vérification de mise à jour |
|---|---|
| Gradle et référentiels | Déterminer l'exacte version de l'SDK à l'aide des référentiels documentés pour cette version |
| Outils Android | Compiler avec l'AGP, Kotlin et JDK réels de l'application, compileSdket matrice min-SDK |
| Widgets hébergés | Modales, intégrés, auto-réglage, clavier, rotation, navigation en arrière et gestion des contrôleurs |
| Actions externes | 3DS, Custom Tabs, applications de fournisseurs, liens profonds, annulation et comportement de retour à l'application |
| Portefeuilles natifs | Capacités du dispositif, configuration du commerçant, résultat d'activité, tokenisation et annulation |
| Fournisseurs de lutte contre la fraude | Dépendance native présente, initialisation précoce, délai d'attente, données manquantes et configuration spécifique au fournisseur |
| Payloads de callback | Gestionnaires de succès/erreur/fermeture dédiés, ainsi qu'un mécanisme de secours pour les événements inconnus |
Liste de contrôle de régression#
- Installation et mise à niveau propres à partir de la version actuellement déployée.
- Version de publication avec compression/obfuscation activée.
- Protection contre la réutilisation de l'activité, la fermeture du processus, le mode arrière-plan/avant-plan et les lancements multiples.
- Widget de paiement, éléments, code promo et prochaine action dans chaque mode de présentation pris en charge.
- Chemins pour la carte, le portefeuille, APM, 3DS, erreur, timeout, fermeture et tentative.
- Contenu de 320 dp de largeur, texte important, navigation au clavier, TalkBack et paramètres d'animation réduits.
- Réconciliation côté serveur après chaque appel de retour du client.