Démarrage rapide du SDK iOS 7.0+

Démarrez avec le SDK iOS de Pushwoosh en utilisant cet exemple simple et rapide.

Nouveautés du SDK iOS 7.0+

À partir de la version 7.0, le SDK iOS de Pushwoosh a été repensé avec une architecture entièrement modulaire. Le SDK est désormais divisé en modules distincts : PushwooshFramework, PushwooshCore, PushwooshBridge et PushwooshLiveActivities sont requis pour une intégration de base, tandis que PushwooshForegroundPush, PushwooshVoIP et PushwooshTVOS peuvent être ajoutés en option en fonction de vos besoins.

Cette approche modulaire vous permet d’inclure uniquement les fonctionnalités que votre application utilise réellement, réduisant ainsi la taille du binaire final et améliorant les temps de compilation. Chaque module peut être mis à jour indépendamment, ce qui facilite l’adoption de nouvelles fonctionnalités sans affecter le reste de votre intégration.

Cette version introduit la prise en charge native du Swift Package Manager pour une gestion plus facile des dépendances, ainsi qu’une interopérabilité Swift améliorée sur tous les modules. La documentation est désormais intégrée directement dans les frameworks binaires, vous pouvez donc accéder à la référence de l’API et aux exemples de code directement dans Xcode via l’Aide rapide et la fenêtre de Documentation du développeur. Les nouvelles fonctionnalités incluent la prise en charge complète des Live Activities d’iOS 16+ avec l’intégration de Dynamic Island, des notifications push de premier plan personnalisables avec des bannières animées et un retour haptique, des capacités VoIP améliorées et un module tvOS dédié pour les applications Apple TV.

Prérequis

Pour intégrer le SDK iOS de Pushwoosh dans votre application, vous aurez besoin des éléments suivants :

Requirements

• A Pushwoosh account
• A Pushwoosh project set up in your account.
• An iOS platform configured to send push notifications. We recommend using the Token-Based Authentication configuration as the simplest approach.
• During setup, set the Gateway to Sandbox to send pushes to a simulator.
• Your Pushwoosh Application Code and Pushwoosh Device API Token from the Pushwoosh Control Panel for your application.

Télécharger le projet d’exemple

Clonez le projet d’exemple depuis GitHub :

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

Configurer le projet

1. Open the project in Xcode.

2. Add https://github.com/Pushwoosh/Pushwoosh-XCFramework as Swift Package Dependency.

3. Set the bundle identifier for the main target (PushwooshSampleApp) to match your Pushwoosh project (e.g., com.pushwoosh.PushwooshSampleApp).

4. Use the same bundle identifier for the NotificationService target, appending .NotificationService (e.g., com.pushwoosh.PushwooshSampleApp.NotificationService).

5. In Info.plist, set the:

   • Pushwoosh_APPID key to the Pushwoosh Application Code
   • Pushwoosh_API_TOKEN key to the Pushwoosh Device API Token

Important: Be sure to give the token access to the right app in your Pushwoosh Control Panel. Learn more

Exécuter le projet

1. Compilez et exécutez le projet.
2. L’application aura deux onglets : « Actions » et « Paramètres ». Accédez à l’onglet Paramètres.
3. Appuyez sur le bouton Register for Pushes.
4. Accordez l’autorisation pour les notifications push. L’appareil sera enregistré auprès de Pushwoosh.

Vous devriez voir une entrée de journal comme celle-ci :

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__

Votre appareil est maintenant enregistré auprès de Pushwoosh.

Envoyer une notification push

Retournez au Panneau de Contrôle de Pushwoosh et envoyez une notification push à votre appareil enregistré.

Migration depuis le SDK 6.x

Si vous mettez à niveau depuis la version 6.x du SDK, le principal changement concerne la manière d’accéder à l’instance de Pushwoosh. Dans la version 7.0+, utilisez Pushwoosh.configure au lieu de Pushwoosh.sharedInstance() :

Avant (6.x) :

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

Après (7.0+) :

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

Toutes les autres API restent les mêmes, donc la mise à jour de votre code ne nécessite que le remplacement de sharedInstance() par configure dans tout votre projet.

Prochaines étapes

Pour en savoir plus, veuillez vous référer au guide d’intégration de base.