Ajouter des appareils de test pour les notifications push

Vous pouvez utiliser les Appareils de test pour prévisualiser l’apparence des notifications push sur un appareil avant de les envoyer aux utilisateurs de l’application. Pour ce faire, vous devez enregistrer votre appareil (avec votre application installée) en tant qu’Appareil de test.

Note

Ce guide concerne les appareils de test pour les notifications push. Les appareils de test pour les e-mails et les SMS ne nécessitent aucune intégration côté application — consultez Appareil de test pour e-mail et Appareil de test pour SMS dans la documentation produit.

Pour ajouter un appareil de test :

1. Accédez à la section Appareils de test dans votre compte Pushwoosh.

2. Cliquez sur le bouton déroulant Créer un appareil de test dans le coin supérieur droit et sélectionnez Push.

Vous pouvez ajouter un appareil de test pour les notifications push en utilisant l’une des trois méthodes suivantes : la configuration automatique avec un code QR, l’enregistrement depuis l’application ou la configuration manuelle.

Ajout automatique des appareils de test

Cette méthode ne convient qu’aux appareils iOS et Android.

Avant votre premier enregistrement, ajoutez la gestion des liens profonds (deep link) pour les appareils de test à l’application — une configuration unique, généralement effectuée en même temps que l’intégration du SDK Pushwoosh :

• Pour Android : Ajoutez DeepLinkActivity au fichier AndroidManifest.xml.
• Pour iOS : Ajoutez le schéma d’URL pushwoosh-VOTRE_APP_ID_PUSHWOOSH au fichier Info.plist.

Suivez les instructions pour Android et iOS dans la section Implémentation.

Une fois cela fait, pour enregistrer un appareil :

1. Dans la section Appareils de test, cliquez sur Créer un appareil de test et sélectionnez Push.
2. Scannez le code QR qui apparaît dans la fenêtre contextuelle avec n’importe quelle application de scanner QR. Cela ouvre le lien profond que le SDK Pushwoosh analyse pour enregistrer votre appareil comme appareil de test.

Conseil pour les lecteurs QR

Assurez-vous que le lien scanné s’ouvre dans le navigateur natif, et non dans la webview du lecteur QR. De nombreux lecteurs QR ont un bouton « Ouvrir dans le navigateur » à cet effet.

Enregistrer un appareil de test depuis l’application

Indépendamment de la méthode du code QR ci-dessus, le SDK Pushwoosh peut enregistrer l’appareil actuel comme appareil de test de manière autonome : en mettant l’application en arrière-plan et en la ramenant au premier plan 6 fois en 30 secondes. Aucun scan ni saisie manuelle n’est nécessaire.

Pour éviter les enregistrements involontaires, cela ne fonctionne que pendant l’ouverture d’une fenêtre d’enregistrement d’une heure.

1. Dans la section Appareils de test, activez le bouton Ajouter des appareils de test depuis l’application. Cela ouvre la fenêtre pour 1 heure.

Attention

L’activation de ce bouton nécessite l’autorisation de modifier l’application ; sans elle, la requête échoue avec une erreur « l’utilisateur ne peut pas modifier l’application ». La fenêtre reste ouverte pendant 1 heure puis se ferme automatiquement ; lorsqu’elle est fermée, l’appel d’enregistrement de l’application renvoie toujours un succès, mais aucun appareil n’est enregistré.

2. Pendant que la fenêtre est ouverte, mettez l’application en arrière-plan et au premier plan 6 fois en 30 secondes. L’appareil est ajouté à la liste des Appareils de test.

Ajout manuel des appareils de test

Si vous préférez enregistrer un appareil de test manuellement, suivez ces étapes :

1. Obtenez l’ID matériel (HWID) de l’appareil à partir d’un appel API /registerDevice réussi.
2. Remplissez les champs obligatoires :
   • Nom de l’appareil : Un nom descriptif pour l’appareil de test (par ex., « Android de John »).
   • HWID de l’appareil : L’ID matériel unique de l’appareil.
   • Type d’appareil : Sélectionnez la plateforme (par ex., iOS, Android, Web).
   • Description (Facultatif) : Ajoutez des notes ou des détails sur l’appareil pour référence.
3. Cliquez sur Enregistrer pour enregistrer l’appareil de test.

Une fois enregistré, l’appareil de test sera disponible dans la section Appareils de test.

Enregistrement des appareils de test via l’API

Pour provisionner des appareils de test à partir d’un script ou d’un pipeline CI au lieu du formulaire manuel, appelez createTestDevice avec le jeton push de l’appareil — et non le HWID utilisé dans le formulaire manuel, un identifiant différent obtenu de la même manière, par ex. à partir d’un appel /registerDevice réussi. listTestDevices renvoie ce qui est déjà enregistré pour une application.

Implémentation

Android

1. Intégrez le SDK Pushwoosh à votre application.

2. Ajoutez DeepLinkActivity à votre AndroidManifest.xml :

<activity
          android:name="com.pushwoosh.DeepLinkActivity"
          android:theme="@android:style/Theme.Translucent.NoTitleBar" >
  <intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="pushwoosh-YOUR_PUSHWOOSH_APP_ID" />
  </intent-filter>
</activity>

N’oubliez pas de remplacer VOTRE_APP_ID_PUSHWOOSH dans le xml ci-dessus par votre ID d’application Pushwoosh.
Exemple : <data android:scheme=“pushwoosh-ABCDE-EDCBA” />

3. Lancez l’application pour vous abonner aux notifications push.

4. Scannez le code QR dans le formulaire Appareils de test en utilisant n’importe quelle application de scanner de code QR appropriée*. Un message toast apparaîtra indiquant l’état de l’enregistrement de l’appareil de test.

* la plupart des applications de scan de code QR gèrent correctement ces liens profonds, en voici quelques-unes :

• QR & Barcode Scanner, Gamma Play
• QR & Barcode Scanner, Maker, AppSourceHub

iOS

1. Intégrez le SDK Pushwoosh à votre application.

2. Ajoutez le schéma d’URL pushwoosh-VOTRE_APP_ID_PUSHWOOSH au fichier Info.plist :

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLName</key>
    <string>com.pushwoosh.scheme</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>pushwoosh-YOUR_PUSHWOOSH_APP_ID</string>
    </array>
  </dict>
</array>

N’oubliez pas de remplacer VOTRE_APP_ID_PUSHWOOSH dans le XML ci-dessus par votre ID d’application Pushwoosh.
Exemple : pushwoosh-ABCDE-EDCBA

Attention

Si votre projet est construit avec SwiftUI (uniquement), vous devez ajouter un SceneDelegate

SwiftUI gère le cycle de vie de l’application différemment d’UIKit. Pour garantir que certains événements système fonctionnent correctement — comme l’enregistrement d’un appareil de test pour les notifications push ou la gestion des liens profonds — vous devez explicitement ajouter et enregistrer un SceneDelegate.

Sans cela, ces événements pourraient ne pas être déclenchés correctement, et l’enregistrement pour les notifications push peut échouer.

Si vous n’utilisez pas SwiftUI, vous pouvez sauter cette étape et passer directement à l’étape 3.

Info.plist

Ajoutez UIApplicationSceneManifest à votre Info.plist.

  <key>UIApplicationSceneManifest</key>
  <dict>
    <key>UIApplicationSupportsMultipleScenes</key>
    <true/>
    <key>UISceneConfigurations</key>
    <dict>
      <key>UIWindowSceneSessionRoleApplication</key>
      <array>
        <dict>
          <key>UISceneConfigurationName</key>
          <string></string>
          <key>UISceneDelegateClassName</key>
          <string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
        </dict>
      </array>
    </dict>
  </dict>

SceneDelegate

Ajoutez le code du SceneDelegate comme indiqué dans l’exemple ci-dessous.

import SwiftUI

@main
struct DemoApp: App {
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

  var body: some Scene {
      WindowGroup {
          ContentView()
      }
  }
}

class SceneDelegate: NSObject, UIWindowSceneDelegate {

  var window: UIWindow?

  func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
      guard let _ = (scene as? UIWindowScene) else { return }
  }
}

class AppDelegate: NSObject, UIApplicationDelegate, PWMessagingDelegate {

  func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
      let sceneConfig: UISceneConfiguration = UISceneConfiguration(name: nil, sessionRole: connectingSceneSession.role)
      sceneConfig.delegateClass = SceneDelegate.self
      return sceneConfig
  }

}

3. Lancez l’application pour vous abonner aux notifications push.

4. Scannez le code QR dans le formulaire Appareils de test en utilisant n’importe quel scanner de code QR approprié.