Démarrage rapide du SDK React Native

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

Prérequis

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

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

# Cloner le dépôt du SDK et naviguer vers le projet d'exemple
git clone https://github.com/Pushwoosh/pushwoosh-react-native-plugin.git

# Naviguer vers le répertoire d'exemple
cd pushwoosh-react-native-plugin/example/demoapp/

Configurer le projet

Installez les dépendances :

npm install

Ouvrez Settings.js et mettez à jour l’appel Pushwoosh.init :

Pushwoosh.init({ "pw_appid" : "__YOUR_APP_ID__", "project_number":"__YOUR_FCM_SENDER_ID__"});

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

iOS

1. Installer les dépendances

Naviguez vers le répertoire ios et installez les dépendances :

cd ios && pod install --repo-update

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

Ouvrez le fichier ios/Runner.xcworkspace dans Xcode.

Définissez le Bundle Identifier pour chaque cible :

Runner : le nom du package de votre application. (par ex. com.example.pushwoosh)
NotificationService : le nom du package de votre application avec .NotificationServiceExtension (par ex. com.example.pushwoosh.NotificationServiceExtension)

3. Définir le jeton d’API

Dans votre ios/Runner/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 android/app.

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> :

<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

Compilez et exécutez le projet.
L’application aura deux onglets : « Actions » et « Settings ». Naviguez vers l’onglet Settings.
Appuyez sur le bouton Register for Push Notifications.
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é.