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 :

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 jusqu'au projet d'exemple
git clone https://github.com/Pushwoosh/pushwoosh-flutter

# Naviguez jusqu'au répertoire example
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 jusqu’au 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 de package de votre application (par ex. com.example.pushwoosh).
• NotificationService : le nom de package de votre application avec .NotificationServiceExtension (par ex. com.example.pushwoosh.NotificationServiceExtension).
• StopwatchWidgetExtension : le nom de package de votre application avec .StopwatchWidget (par 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 de 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. L’application aura deux onglets : Actions et Settings. Naviguez jusqu’à l’onglet Settings.
3. Appuyez sur le bouton Register for Pushes.
4. 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é.