Saltar al contenido principal
En esta página

El repositorio de Android mantenido actualmente está etiquetado como v2.12.7. Asegurar una versión específica en producción y revisar el artefacto de la versión anterior antes de cada actualización. Esta página resume los cambios que impactan la integración, verificados en relación con el commit del repositorio. f8c9845e9aa78ea471a69afe952b83579e031154; no sustituye a la documentación completa Historial de versiones del repositorio.

Flujo de actualización#

01 · compare
Leer cambios entre versiones
Revisar la fuente, notas de la versión, APIs eliminadas, dependencias nativas y la aplicación de ejemplo.
02 · resolve
Actualizar Gradle en una rama
Establecer el nuevo SDK y resolver los requisitos del repositorio, compilar el SDK, Kotlin, AndroidX y el manifiesto.
03 · exercise
Ejecutar la matriz de pagos
Probar los modos del widget, billeteras, proveedores de prevención de fraude, redirecciones, 3DS, APMs, el proceso de finalización y la accesibilidad.
04 · release
Implementar y supervisar
Compare excepciones del cliente, cobertura de callback, resultados de pagos y abandono con la versión anterior.

Líneas de lanzamiento destacadas#

v2.12.x · Reforzamiento de la prevención de fraude y APMLínea actual verificada
  • v2.12.7 es la última etiqueta en el repositorio auditado.
  • El v2.12.5 Se añadió la integración y el soporte de inicialización de Mercado Pago para la prevención de fraude.
  • El v2.12.4 Se añadió el manejo explícito de referencias faltantes para los flujos de vales y la interceptación de esquemas de aplicaciones externas.

Re-probar la inicialización nativa de la prevención de fraude, la resolución de dependencias del proveedor, las llamadas de retorno de error de los vales y todas las rutas de retorno de las aplicaciones externas. Una compilación que tiene éxito no prueba que el SDK del proveedor se ha inicializado o ha devuelto datos de dispositivo utilizables.

v2.9.0 · Widgets integrados y capacidades del controlador actualPresentación y datos de fraude

Esta línea añadió widgets integrados, el comportamiento del botón de pago controlado por el comerciante, la generación de huellas de fraude y el soporte del Widget de Próxima Acción, y eliminó las funciones obsoletas.

Al actualizar desde una línea anterior, migre a los métodos actuales en la guía del SDK de Android, y luego pruebe de forma independiente el comportamiento modal, integrado y de auto-ajuste.

Línea beta v2.4.0 · Cambios en el contrato de respuesta y errorTipos de respuesta
  • OrderResponse y ElementsResponse cambiados a Map<String, Any> payloads.
  • CheckoutError cambiados a PaymentsError.
  • El soporte del Widget de Pago se ha movido al modelo actual del controlador de widgets.

Evite conversiones exhaustivas sobre mapas brutos. Prefiera los callbacks dedicados y tolerar campos adicionales en los payloads de eventos.

v2.0.0 · Cambios en los nombres de los símbolos públicosMigración importante

La línea principal renombró DeUnaSdk funcione DeunaSDK, Callbacks funcione CheckoutCallbacks, símbolos de respuesta/evento, y cambió el orden de los argumentos del listener de eventos de (response, type) funcione (type, response).

Compile todos los adaptadores de callback y de análisis cuando migre; los argumentos intercambiados pueden provocar corrupción de datos en tiempo de ejecución incluso cuando la lógica de la aplicación sigue funcionando a través de envoltorios de tipo flexible.

Matriz de compatibilidad#

SuperficieVerificación de actualización
Gradle y repositoriosResuelva la etiqueta del SDK exacta utilizando los repositorios documentados para esa versión
Herramientas de AndroidCompile con el AGP, Kotlin y JDK reales de la aplicación, compileSdk, y la matriz de min-SDK
Widgets alojadosModal, integrado, auto-ajuste, teclado, rotación, navegación hacia atrás y descarte del controlador
Acciones externas3DS, pestañas personalizadas, aplicaciones de proveedores, enlaces profundos, cancelación y comportamiento de retorno a la aplicación
Carteras nativasCapacidad del dispositivo, configuración del comerciante, resultado de la actividad, tokenización y cancelación
Proveedores de fraudeDependencia nativa presente, inicialización temprana, tiempo de espera, datos faltantes y configuración específica del proveedor
Payloads de callbackManejadores dedicados de éxito/error/cierre, más un fallback para eventos desconocidos

Lista de verificación de regresión#

  • Instalación y actualización desde la versión actualmente desplegada.
  • Publicar la versión con compresión/ofuscación habilitada.
  • Recreación de la actividad, finalización del proceso, modo de fondo/primario y protección contra lanzamientos duplicados.
  • Widget de pago, elementos, cupón y siguiente acción en todas las presentaciones compatibles.
  • Rutas para tarjeta, billetera, APM, 3DS, error, timeout, cerrar y reintentar.
  • Ancho de contenido de 320 dp, texto grande, navegación con teclado, TalkBack y ajustes de animación reducidos.
  • Reconciliación en el backend después de cada llamada de retorno del cliente.