Démarrage rapide du SDK Flutter

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

Prérequis

Pour intégrer le SDK Flutter 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-flutter

# Naviguer vers le répertoire d'exemple
cd pushwoosh-flutter/Source/pushwoosh/example

Configurer le projet

Installez les dépendances :

flutter pub get

Ouvrez lib/main.dart et mettez à jour l’appel Pushwoosh.initialize :

Pushwoosh.initialize({"app_id": "XXXXX-XXXXX", "sender_id": "XXXXXXXXXXXX"});

Remplacez les valeurs app_id et 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 le 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. (ex. com.example.pushwoosh)
NotificationService : le nom du package de votre application avec .NotificationServiceExtension (ex. com.example.pushwoosh.NotificationServiceExtension)
StopwatchWidgetExtension : le nom du package de votre application avec .StopwatchWidget (ex. com.example.pushwoosh.StopwatchWidget)

3. Définir le jeton d’API

Dans votre fichier 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. (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 « Paramètres ». Naviguez vers l’onglet Paramètres.
Appuyez sur le bouton Register for Pushes.
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é.