Guide d'intégration avancée du SDK iOS

Cette section fournit des informations sur l’intégration avancée du SDK Pushwoosh pour iOS.

Pour activer cette fonctionnalité, vous devez ajouter les modes d’arrière-plan (Background Modes) à votre projet.

1. Ouvrez votre projet dans Xcode et sélectionnez-le dans le Navigateur de projet (Project Navigator).
2. Choisissez la cible de votre application dans le panneau de gauche.
3. Accédez à l’onglet Signature et Capacités (Signing & Capabilities).
4. Cliquez sur le bouton + Capacité (+ Capability) dans le coin supérieur gauche.
5. Recherchez et sélectionnez Modes d’arrière-plan (Background Modes) dans la liste.
6. Dans la section Modes d’arrière-plan (Background Modes), activez les Notifications à distance (Remote notifications) en cochant la case.

Une fois terminé, votre application sera capable de gérer les notifications push, y compris les silencieuses, tout en s’exécutant en arrière-plan.

Par défaut, le SDK iOS de Pushwoosh affiche la bannière de notification lorsque l’application s’exécute au premier plan.

Vous pouvez contrôler ce comportement en définissant l’indicateur booléen suivant dans votre code (par exemple, dans votre AppDelegate) :

// Set false to disable foreground notifications, true to enable it
Pushwoosh.sharedInstance().showPushnotificationAlert = true

// Set 0 to disable foreground notifications, 1 to enable it
[[Pushwoosh sharedInstance] setShowPushnotificationAlert:0];

Le SDK iOS de Pushwoosh prend en charge les niveaux de journalisation suivants :

• NONE - Aucun journal du SDK.
• ERROR - Affiche uniquement les messages d’erreur dans la console.
• WARNING - Affiche les avertissements en plus des erreurs.
• INFO - Inclut les messages d’information (paramètre par défaut).
• DEBUG - Inclut des informations de débogage détaillées.

Par défaut, le niveau de journalisation est défini sur INFO, ce qui garantit que le SDK fournit des informations pertinentes sans encombrer la console du développeur.

Pour modifier le niveau de journalisation, mettez à jour la clé Pushwoosh_LOG_LEVEL dans le fichier Info.plist de votre application :

<key>Pushwoosh_LOG_LEVEL</key>
<string>YOUR_LOG_LEVEL</string>

Alternativement, vous pouvez modifier le niveau de journalisation en utilisant l’extrait de code ci-dessous :

Pushwoosh.Debug.setLogLevel(.PW_LL_DEBUG)

Remplacez YOUR_LOG_LEVEL par le niveau souhaité (par exemple, DEBUG ou ERROR).

Si vous souhaitez utiliser votre propre UNNotificationCenterDelegate (par exemple, pour les notifications locales), vous devez en informer le SDK Pushwoosh pour un comportement correct. Vous pouvez le faire avec la propriété notificationCenterDelegateProxy de l’instance Pushwoosh :

Pushwoosh.sharedInstance()?.notificationCenterDelegateProxy.add(my_delegate)

[Pushwoosh.sharedInstance.notificationCenterDelegateProxy addNotificationCenterDelegate:my_delegate];

Ensuite, implémentez les méthodes UNNotificationCenterDelegate dans votre délégué :

func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    willPresent notification: UNNotification,
    withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
) {
    if (!PWMessage.isPushwooshMessage(notification.request.content.userInfo)) {
        // Handle your notification
        completionHandler(UNNotificationPresentationOptions.alert)
    }
}

func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    didReceive response: UNNotificationResponse,
    withCompletionHandler completionHandler: @escaping () -> Void
) {
    if (!PWMessage.isPushwooshMessage(response.notification.request.content.userInfo)) {
        // Handle your notification
        completionHandler()
    }
}

- (void)userNotificationCenter:(UNNotificationCenter *)center
        willPresentNotification:(UNNotification *)notification
        withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler {
    if (
![PWMessage isPushwooshMessage:notification.request.content.userInfo])
{
        // Handle your message
        completionHandler(UNNotificationPresentationOptionAlert);
    }
}

- (void)userNotificationCenter:(UNNotificationCenter *)center
        didReceiveNotificationResponse:(UNNotificationResponse *)response
        withCompletionHandler:(void (^)(void))completionHandler {
    if (
![PWMessage.isPushwooshMessage:response.notification.request.content.userInfo])
{
        // Handle your message
        completionHandler();
    }
}

L’indicateur Pushwoosh_LAZY_INITIALIZATION empêche l’initialisation automatique du SDK Pushwoosh au démarrage de l’application. Cela permet un meilleur contrôle sur le moment où les services du SDK Pushwoosh sont démarrés.

Lorsque cet indicateur est activé, le SDK Pushwoosh ne démarre ses services que lorsque les méthodes du SDK iOS de Pushwoosh sont explicitement appelées.

Ajoutez l’entrée suivante à Info.plist :

<key>Pushwoosh_LAZY_INITIALIZATION</key>
<true/>

Cas d’utilisation

1. Initialisation contrôlée du SDK – L’indicateur Pushwoosh_LAZY_INITIALIZATION permet de retarder le démarrage du SDK Pushwoosh, offrant un meilleur contrôle sur le moment où les services push sont activés.

2. Activation différée des notifications push – Dans certaines applications, les notifications push ne doivent être initialisées que sous des conditions spécifiques. L’activation de cet indicateur garantit que le SDK Pushwoosh ne démarre que lorsqu’il est explicitement demandé.

3. Configuration push spécifique à l’utilisateur – Certaines applications peuvent nécessiter la personnalisation des paramètres de notification push en fonction des préférences de l’utilisateur ou des paramètres du compte. Avec l’initialisation différée, le SDK Pushwoosh ne démarre qu’une fois la configuration appropriée déterminée.