Inicio rápido del SDK de iOS 7.0+

Comience a usar el SDK de iOS de Pushwoosh con este ejemplo rápido y sencillo.

Novedades del SDK de iOS 7.0+

A partir de la versión 7.0, el SDK de iOS de Pushwoosh ha sido rediseñado con una arquitectura completamente modular. El SDK ahora se divide en módulos separados: PushwooshFramework, PushwooshCore, PushwooshBridge y PushwooshLiveActivities son necesarios para la integración básica, mientras que PushwooshForegroundPush, PushwooshVoIP y PushwooshTVOS se pueden agregar opcionalmente según sus necesidades.

Este enfoque modular le permite incluir solo las características que su aplicación realmente utiliza, reduciendo el tamaño final del binario y mejorando los tiempos de compilación. Cada módulo se puede actualizar de forma independiente, lo que facilita la adopción de nuevas características sin afectar el resto de su integración.

Esta versión introduce soporte nativo para Swift Package Manager para una gestión de dependencias más sencilla, junto con una interoperabilidad mejorada de Swift en todos los módulos. La documentación ahora está integrada directamente en los frameworks binarios, por lo que puede acceder a la referencia de la API y a ejemplos de código directamente en Xcode a través de Quick Help y la ventana de Developer Documentation. Las nuevas características incluyen soporte completo para Live Activities de iOS 16+ con integración de Dynamic Island, notificaciones push en primer plano personalizables con banners animados y retroalimentación háptica, capacidades de VoIP mejoradas y un módulo tvOS dedicado para aplicaciones de Apple TV.

Prerrequisitos

Para integrar el SDK de iOS de Pushwoosh en su aplicación, necesitará lo siguiente:

Requisitos

• Una cuenta de Pushwoosh
• Un proyecto de Pushwoosh configurado en su cuenta.
• Una plataforma iOS configurada para enviar notificaciones push. Recomendamos usar la configuración de autenticación basada en token como el enfoque más simple.
• Durante la configuración, establezca la Gateway en Sandbox para enviar pushes a un simulador.
• Su Pushwoosh Application Code y Pushwoosh Device API Token desde el Panel de Control de Pushwoosh para su aplicación.

Descargar el proyecto de ejemplo

Clone el proyecto de ejemplo desde GitHub:

git clone https://github.com/Pushwoosh/pushwoosh-ios-sample.git

Configurar el proyecto

1. Abra el proyecto en Xcode.

2. Añada https://github.com/Pushwoosh/Pushwoosh-XCFramework como una dependencia de paquete de Swift (Swift Package Dependency).

3. Establezca el identificador de paquete (bundle identifier) para el objetivo principal (PushwooshSampleApp) para que coincida con su proyecto de Pushwoosh (p. ej., com.pushwoosh.PushwooshSampleApp).

4. Use el mismo identificador de paquete (bundle identifier) para el objetivo NotificationService, añadiendo .NotificationService (p. ej., com.pushwoosh.PushwooshSampleApp.NotificationService).

5. En Info.plist, establezca lo siguiente:

   • la clave Pushwoosh_APPID al Código de Aplicación de Pushwoosh
   • la clave Pushwoosh_API_TOKEN al Token de API de Dispositivo de Pushwoosh

Importante: Asegúrese de dar al token acceso a la aplicación correcta en su Panel de Control de Pushwoosh. Aprenda más

Ejecutar el proyecto

1. Compile y ejecute el proyecto.
2. La aplicación tendrá dos pestañas: «Actions» y «Settings». Navegue a la pestaña Settings.
3. Toque el botón Register for Pushes.
4. Conceda permiso para las notificaciones push. El dispositivo se registrará en Pushwoosh.

Debería ver una entrada de registro como esta:

Pushwoosh: Initializing application runtime
[PW] BUNDLE ID: __YOUR_BUNDLE_ID__
[PW] APP CODE: __YOUR_APP_CODE__
[PW] PUSHWOOSH SDK VERSION: 7.0.0
[PW] HWID: __YOUR_HWID__
[PW] PUSH TOKEN: (null)
[PW] [I] -[PWNotificationManagerCompatiOS10] NotificationCenter authorization granted: 1
[PW] [I] -[PWPushNotificationsManagerCommon] Registered for push notifications: __YOUR_PUSH_TOKEN__

Su dispositivo ya está registrado en Pushwoosh.

Enviar una notificación push

Vuelva al Panel de Control de Pushwoosh y envíe una notificación push a su dispositivo registrado.

Migración desde el SDK 6.x

Si está actualizando desde la versión 6.x del SDK, el cambio principal es cómo accede a la instancia de Pushwoosh. En la versión 7.0+, use Pushwoosh.configure en lugar de Pushwoosh.sharedInstance():

Antes (6.x):

Pushwoosh.sharedInstance().registerForPushNotifications()
Pushwoosh.sharedInstance().delegate = self

Después (7.0+):

Pushwoosh.configure.registerForPushNotifications()
Pushwoosh.configure.delegate = self

Todas las demás API siguen siendo las mismas, por lo que actualizar su código solo requiere reemplazar sharedInstance() por configure en todo su proyecto.

¿Qué sigue?

Para obtener más información, consulte la guía de integración básica