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 :

Prérequis

• Un compte Pushwoosh
• Un projet Pushwoosh configuré dans votre compte.
• Une plateforme iOS configurée pour envoyer des notifications push. Nous vous recommandons d’utiliser la configuration d’authentification basée sur un token comme approche la plus simple.
• Lors de la configuration, réglez la passerelle (Gateway) sur Sandbox pour envoyer des pushes à un simulateur.
• Votre Pushwoosh Application Code et votre jeton d’API de l’appareil Pushwoosh (Pushwoosh Device API Token) depuis le panneau de contrôle Pushwoosh pour votre 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. Ouvrez le projet dans Xcode.

2. Ajoutez https://github.com/Pushwoosh/Pushwoosh-XCFramework en tant que dépendance Swift Package.

3. Définissez l’identifiant de bundle pour la cible principale (PushwooshSampleApp) afin qu’il corresponde à votre projet Pushwoosh (par ex., com.pushwoosh.PushwooshSampleApp).

4. Utilisez le même identifiant de bundle pour la cible NotificationService, en y ajoutant .NotificationService (par ex., com.pushwoosh.PushwooshSampleApp.NotificationService).

5. Dans Info.plist, définissez :

   • la clé Pushwoosh_APPID sur le code d’application Pushwoosh
   • la clé Pushwoosh_API_TOKEN sur le Jeton d’API d’appareil Pushwoosh

Important : Assurez-vous de donner au jeton l’accès à la bonne application dans votre Panneau de Contrôle Pushwoosh. En savoir plus

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.