Démarrage rapide du SDK Cordova

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

Prérequis

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

Prérequis

• Un compte Pushwoosh.
• Un projet Pushwoosh configuré dans votre compte.
• Pour l’intégration iOS :
  • Une plateforme iOS configurée pour envoyer des notifications push. Nous recommandons d’utiliser la configuration d’authentification basée sur un jeton comme approche la plus simple.
  • Lors de la configuration, réglez la passerelle sur Sandbox pour envoyer des notifications push à un simulateur.
• Pour l’intégration Android :
  • Une plateforme Android configurée.
  • Le project number (également connu sous le nom de Sender ID), le fichier google-services.json et le package name de votre projet Firebase.
  • Un projet Firebase connecté à votre application Android. Suivez le guide de configuration Firebase si nécessaire.
• Votre Pushwoosh Application Code et votre jeton d’API de l’appareil Pushwoosh depuis le panneau de contrôle Pushwoosh pour votre application.

Télécharger le projet d’exemple

# Clonez le dépôt du SDK et naviguez vers le projet d'exemple
git clone https://github.com/Pushwoosh/pushwoosh-phonegap-plugin.git

# Naviguez vers le répertoire d'exemple
cd pushwoosh-phonegap-plugin/example/newdemo/

Configurer le projet

Installez les dépendances :

npm i

Ajoutez le plugin Pushwoosh :

cordova plugin add ../../ --link --nofetch

Ouvrez www/js/index.js et mettez à jour l’appel pushwoosh.onDeviceReady :

pushwoosh.onDeviceReady({
    appid: "XXXXX-XXXXX",
    projectid: "XXXXXXXXXXXXXXX"
});

Remplacez les valeurs appid et projectid par votre Code d’Application Pushwoosh et votre Numéro de Projet Firebase.

iOS

1. Définir l’identifiant de l’ensemble (Bundle Identifier)

Ouvrez le fichier platforms/ios/newdemo.xcworkspace dans Xcode.

Définissez le Bundle Identifier pour chaque cible :

• newdemo : le nom du package de votre application (par ex. com.example.pushwoosh).

2. Ajouter des capacités (capabilities)

Pour activer les notifications Push, vous devez ajouter certaines capacités.

Dans la section Signing & Capabilities, ajoutez les capacités suivantes :

• Push Notifications
• Background Modes. Après avoir ajouté cette capacité, cochez la case Remote notifications.

3. Définir le jeton d’API

Dans votre fichier ios/newdemo/Info.plist, définissez la clé Pushwoosh_API_TOKEN sur le Jeton d’API d’appareil Pushwoosh.

Android

1. Configurer google-services.json

Copiez votre fichier google-services.json dans le répertoire racine du projet.

2. Définir le nom du package

Ouvrez android/app/build.gradle et définissez l’applicationId sur le nom du package de votre application (par ex. com.example.pushwoosh).

3. Définir le jeton d’API

Ouvrez votre fichier android/app/src/main/AndroidManifest.xml et ajoutez les métadonnées suivantes à l’intérieur de la balise <application> :

AndroidManifest.xml

<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />

Remplacez __YOUR_PUSHWOOSH_DEVICE_API_TOKEN__ par votre Jeton d’API d’appareil Pushwoosh.

Exécuter le projet

1. Compilez et exécutez le projet.
2. Activez l’interrupteur Register for notifications.
3. Accordez l’autorisation pour les notifications push. L’appareil sera enregistré auprès de Pushwoosh.

Envoyer une notification push

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