Saltar al contenido principal
En esta página

El repositorio y el podspec de iOS mantenidos están etiquetados v2.12.6. Fijar una versión en producción y revisar el artefacto original antes de cada actualización. Esta página resume los cambios que impactan la integración, verificados contra el commit del repositorio. 96501079d01ce15ecaf43d486dd0b2e8c86ab8df; no sustituye a la documentación completa Historial de versiones del repositorio.

Flujo de actualización#

01 · inventory
Registrar la versión actual
Capturar la fuente del paquete, subespecificaciones de CocoaPods, entitlements, frameworks de prevención de fraude, callbacks y modos de presentación.
02 · resolve
Actualizar dependencias
Cambiar una versión, resolver paquetes o pods, e inspeccionar el grafo y los manifiestos de privacidad resueltos.
03 · exercise
Probar en dispositivos reales
Cubrir widgets, wallets, proveedores de fraude, redirecciones, 3DS, APMs, transiciones de ciclo de vida y accesibilidad.
04 · release
Monitorizar resultados
Comparar errores, cobertura de callbacks, inicialización de proveedores y resultados de pagos en el backend con la versión anterior.

Líneas de lanzamiento destacadas#

v2.12.x · Proveedores de detección de fraude modulares y endurecimiento del APMLínea actual verificada
  • v2.12.6 agrega soporte nativo de "huella de fraude" de Mercado Pago y una subespecífica de CocoaPods dedicada.
  • Anteriormente v2.12.x se modularizó el soporte para proveedores de detección de fraude, se añadió el manejo de dependencias en tiempo de ejecución e incluyeron actualizaciones de manifiesto de privacidad para los marcos de proveedores aplicables.
  • v2.12.4 agrega un manejo explícito para una referencia de APM que no puede ser generada o mostrada.
  • v2.12.2 agrega eventos de ciclo de vida de Elements, configuración de dominio y consistencia userInfo forwarding.

Re-probar cada proveedor de detección de fraude habilitado con la subespecífica y la configuración de la aplicación exactas. La falta de marcos de tiempo de ejecución puede aparecer como datos de dispositivo vacíos en lugar de un fallo de compilación.

v2.11.x · Trabajo nativo de billetera y presentaciónCiclo de vida de billetera y widget

Esta línea introdujo y refinó la disponibilidad y el comportamiento de lanzamiento de la billetera nativa, la configuración de Apple Pay, el trabajo de autoajuste del widget, el despacho de finalización en el hilo principal y la eliminación segura del controlador.

Verifique los permisos, identificadores del comerciante, redes compatibles, disponibilidad del dispositivo físico, cancelación, comportamiento en segundo plano/primero plano, y conciliación en el backend.

v2.4.0 · Cambios en la respuesta y presentaciónCambios en los tipos de datos
  • Los datos de respuesta tipados, como ElementsResponseData, CheckoutResponseData, CardBinMetadatay InstallmentMetadata cambiados a [String: Any] payloads.
  • PaymentsError se convirtieron en el tipo de error público.
  • Obsoleto presentInModal y showCloseButton Se eliminaron los parámetros de los puntos de entrada de Checkout y Elements antiguos.

Utilice las APIs de control y presentación actuales en la guía de iOS,y evite la igualdad estricta de todo el diccionario para los datos de eventos adicionales.

v2.0.0 · Migración de símbolos públicosMigración importante

Se renombraron las principales funciones de llamada, respuesta y evento, incluyendo Callbacks funcione CheckoutCallbacks y CheckoutEventType funcione CheckoutEvent. Compile todas las integraciones y adaptadores de análisis después de actualizar las importaciones.

Matriz de compatibilidad#

SuperficieVerificación de actualización
Gestor de dependenciasVersión exacta de SPM o versión de CocoaPods y subespecificaciones requeridas, para una resolución reproducible.
Herramientas de AppleObjetivo de despliegue de la aplicación, Xcode, Swift, configuraciones del enlazador y manifiestos de privacidad.
PresentaciónPropiedad de UIKit y SwiftUI, modos modales e incrustados, autoajuste, teclado y descarte.
Acciones externas3DS, ASWebAuthenticationSession o flujo de navegador aprobado, enlaces profundos, cancelación y devolución.
Carteras nativasPermisos, ID del comerciante, capacidad del dispositivo físico, redes, tokenización y cancelación.
Proveedores de fraudeMarco de proveedor requerido, momento de inicialización, tiempo de espera, datos faltantes y declaraciones de privacidad.
CallbacksTrabajo de la interfaz de usuario en el hilo principal, manejadores dedicados, datos de eventos adicionales y fallback para eventos desconocidos.

Lista de verificación de regresión#

  • Realice una instalación y actualización limpia desde la versión de pin actualmente desplegada utilizando el gestor de dependencias de producción.
  • Cree builds de depuración y archivado en las versiones de SO más antiguas y más recientes compatibles.
  • Widget de pago, elementos, cupón y siguiente acción en todas las presentaciones compatibles.
  • Rotación, Dynamic Type, VoiceOver, teclado, descarte de hojas, segundo plano/primero plano y liberación de memoria.
  • Disponibilidad de Apple Pay y autorización de pagos en dispositivos físicos.
  • Cada proveedor de fraude nativo habilitado con datos permitidos y manejo de errores.
  • Recuperación en el backend o confirmación de webhook verificada después de cada resultado del cliente.