Esta página documenta un SDK heredado. ¿Vas a iniciar una nueva integración? Usa el Yuno SDK. ¿Ya usas un SDK heredado? Sigue la guía de migración.El nuevo Yuno SDK (Web v2.x, iOS v3.x, Android v3.x, React Native v2.x) reemplaza los SDK Full, Lite, Seamless, Render, Headless y Secure Fields con una sola API en todas las plataformas. Los SDK heredados siguen siendo compatibles en paralelo durante la transición y está previsto dejarlos de usar en 2027. Contacta a tu Account Manager para planificar la migración.
YunoPaymentDelegate, YunoEnrollmentDelegate). Esta sección explica los desafíos y ofrece soluciones para distintos escenarios de implementación.
Comprende la concurrencia en Swift 6La concurrencia es la capacidad de tu app para gestionar varias tareas de forma simultánea. Con Swift 6, las reglas de concurrencia son más estrictas para mejorar la estabilidad de la app y evitar fallos.
El problema
Con Swift 6, los protocolos que heredan deSendable exigen que todas sus implementaciones sean seguras para hilos (thread-safe). Esto genera advertencias al implementar el delegate en clases marcadas como @MainActor.
Que sea seguro para hilos significa que tu código se puede llamar desde varios hilos sin causar fallos ni comportamientos inesperados. @MainActor garantiza que el código se ejecute en el hilo principal (el hilo de la interfaz de usuario).
Decisión de diseño
El SDK no marca los protocolos como@MainActor porque:
- Obligaría a que todas las implementaciones fueran compatibles con
MainActor - Reduciría la flexibilidad para los comercios que no usan
MainActor - Cada implementación tiene necesidades de concurrencia distintas
Responsabilidad del comercio
Es responsabilidad del comercio gestionar la concurrencia según su implementación. A continuación se presentan tres enfoques distintos que puedes usar según tus necesidades específicas.Opción 1: propiedades inmutables
Este enfoque usa propiedades inmutables que son seguras para hilos de forma automática, por lo que es ideal para apps sencillas con valores de configuración fijos que no cambian durante la ejecución.Opción 2: propiedades mutables con MainActor.assumeIsolated
Este enfoque permite propiedades mutables y mantiene la seguridad para hilos mediante MainActor.assumeIsolated. Es ideal para apps cuyos valores de configuración pueden cambiar durante la ejecución, como las preferencias del usuario.
Opción 3: para clases que no son MainActor
Este enfoque es adecuado para clases de servicio que no requieren aislamiento de MainActor. Es ideal para servicios en segundo plano o clases de utilidad que no interactúan con la interfaz de usuario.
Los ejemplos anteriores usan
YunoPaymentDelegate, pero los mismos principios se aplican a YunoEnrollmentDelegate. Debes usar customerSession en lugar de checkoutSession al implementar el delegate de inscripción.Consideraciones importantes
Al implementar la concurrencia en tu delegate, ten en cuenta estos puntos clave:MainActor.assumeIsolated: úsalo solo cuando garantices que se llama desdeMainActor. Es un mecanismo de seguridad que le dice a Swift “confía en mí, sé que esto se ejecuta en el hilo principal.”nonisolated: significa que se puede acceder desde cualquier hilo, por lo que debe ser seguro para hilos. Úsalo cuando tus propiedades o métodos no dependan del estado de la interfaz de usuario.viewController: el protocolo delegate declara esta propiedad como@MainActorporque siempre se debe acceder a ella desde el hilo principal. Los componentes de la interfaz de usuario siempre deben ejecutarse en el hilo principal para evitar fallos.