Preguntas frecuentes sobre la migración del SDK de iOS

Esta página responde a las preguntas más frecuentes sobre la migración del SDK de Appboy para iOS heredado (también conocido como el SDK de Objective-C) al SDK Swift de Braze.

Advertencia

AppboyKit (también conocido como SDK Objective-C) ya no recibe soporte y ha sido sustituido por Swift SDK. Ya no recibirá nuevas características, correcciones de errores, actualizaciones de seguridad ni soporte técnico; sin embargo, la mensajería y los análisis seguirán funcionando con normalidad. Para obtener más información, consulta Presentación del nuevo SDK Swift de Braze.

Compatibilidad de versiones y fin de vida útil

¿El SDK de Appboy para iOS 4.7.0 ha llegado al fin de vida útil?

Sí, el SDK de Appboy para iOS 4.7.0 (y todas las versiones 4.x) ha llegado al fin de vida útil. No se proporcionan correcciones de seguridad ni correcciones de errores críticos. Aunque la mensajería y los análisis siguen funcionando con normalidad, la versión 4.7.0 debe considerarse como no compatible desde el punto de vista de la seguridad.

¿Cuál es la versión mínima del SDK de Swift compatible en producción?

Las versiones principales actuales (16.x y posteriores) son el objetivo del soporte continuo, las correcciones de errores y las nuevas características. Es posible que las versiones secundarias anteriores no reciban mantenimiento continuo.

Bibliotecas de compatibilidad

¿BrazeKitCompat y BrazeUICompat son compatibles para uso en producción en Swift SDK 17.x?

Sí, BrazeKitCompat y BrazeUICompat son compatibles para uso en producción durante la migración. Están pensadas como un “paso intermedio” de migración mínima para ayudarte a pasar del SDK de Appboy al Swift SDK con cambios de código mínimos, no como un destino a largo plazo. Aunque cuentan con soporte formal y siguen recibiendo correcciones de errores, la intención es migrar eventualmente de estas bibliotecas de compatibilidad a las API modernas del Swift SDK.

¿Cuándo se eliminarán BrazeKitCompat y BrazeUICompat?

El equipo del Swift SDK tiene planes de descontinuar la biblioteca BrazeKitCompat, pero aún no se ha anunciado un cronograma específico. Se recomienda planificar una migración completa a las API modernas del Swift SDK (BrazeKit, BrazeUI) en lugar de depender de las bibliotecas de compatibilidad de forma indefinida.

Inicialización diferida

¿Puedo retrasar la inicialización del SDK hasta después del consentimiento del usuario?

Sí. El SDK de Swift admite la inicialización diferida, lo cual es útil para aplicaciones que necesitan esperar el consentimiento del usuario antes de iniciar el SDK. Llama a Braze.prepareForDelayedInitialization() (opcionalmente con un parámetro analyticsBehavior) de forma temprana en application(_:didFinishLaunchingWithOptions:), y luego inicializa el SDK más tarde llamando al inicializador estándar de Braze después de obtener el consentimiento.

Para una implementación detallada, consulta Configurar la inicialización diferida.

¿Cuál es la versión mínima del SDK de Swift requerida para la inicialización diferida?

El SDK de Swift 11.2.0 es la versión mínima para la inicialización diferida. La robustez de push y vínculos profundos para la inicialización diferida se mejoró aún más en la versión 14.1.0. El SDK de Swift 17.0.0 supera con creces ambos umbrales.

¿Qué sucede con los eventos recibidos antes de que se inicialice el SDK?

Cuando se inicializa el SDK, los elementos en cola se procesan. Sin embargo, el comportamiento varía según el canal:

Importante

No se garantiza la entrega de In-App Messages y Content Cards recibidos antes de la inicialización. Asegúrate de que el SDK esté inicializado antes de intentar mostrar estos canales.

Paquetes de recursos e integración con SPM

¿Por qué veo un error en tiempo de ejecución sobre braze-swift-sdk_BrazeUI.bundle faltante?

Esto no es un error conocido del SDK y probablemente se deba a una configuración incorrecta de la integración. A partir del Swift SDK 12.0.0, los XCFrameworks estáticos incluyen los recursos directamente en lugar de depender de paquetes de recursos externos.

¿Cuáles son los requisitos de SPM/Xcode/archivo para la incorporación de recursos?

A partir del Swift SDK 12.0.0, debes seleccionar Embed & Sign para los XCFrameworks de Braze en la configuración de tu proyecto de Xcode; esto aplica tanto para las variantes estáticas como dinámicas. Esta es la causa raíz más común de los errores de paquete faltante al archivar o publicar.

¿Cómo puedo anular los paquetes de recursos para sistemas de compilación no estándar?

Para sistemas de compilación no estándar (Tuist, Bazel, Buck, CI), usa las API de anulación aprobadas:

• BrazeKit.overrideResourcesBundle (nota el plural “Resources”)
• BrazeUI.overrideResourcesBundle (nota el plural “Resources”)

El singular overrideResourceBundle fue descontinuado en el Swift SDK 8.1.0 y no debe usarse.

Identidad de usuario y tokens de notificaciones push

¿Existe una lista de verificación para preservar perfiles, asociaciones de dispositivos y tokens de notificaciones push?

No existe una lista de verificación oficial específica para migraciones en la documentación. Te recomendamos que realices los siguientes pasos de validación:

1. Confirma que registerDeviceToken o la automatización de push esté configurada correctamente después de la migración.
2. Verifica los recuentos de usuarios registrados para push en el panel antes y después del despliegue.
3. Comprueba de forma puntual algunos ID externos específicos para confirmar que las asociaciones de dispositivos permanecen intactas.

¿changeUser garantiza que los tokens de notificaciones push sigan al nuevo usuario?

No existe una garantía explícita documentada por escrito. Sin embargo, la intención del diseño es que los tokens de notificaciones push sigan al dispositivo, no al usuario. Llamar a changeUser debería reasociar el token de dispositivo existente con el nuevo perfil de usuario. Deberías probar changeUser, verificar en el panel y confirmar que el token aparece en el nuevo perfil antes de un despliegue masivo.