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.
  • Pendant la configuration, réglez la Gateway sur Sandbox pour envoyer des pushes à un simulateur.
• Pour l’intégration Android :
  • Une plateforme Android configurée
  • 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 de 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"});

Remplacez la valeur app_id par votre code d’application Pushwoosh.

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 (par ex. com.example.pushwoosh).
• NotificationService : le nom du package de votre application avec .NotificationServiceExtension (par ex. com.example.pushwoosh.NotificationServiceExtension).
• StopwatchWidgetExtension : le nom du 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 de l’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> :

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 de l’appareil Pushwoosh.

Exécuter le projet

1. Compilez et exécutez le projet.
2. L’application aura deux onglets : « Actions » et « Paramètres ». Naviguez vers l’onglet Paramètres.
3. Appuyez sur le bouton S’inscrire aux notifications Push.
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 de Pushwoosh et envoyez une notification push à votre appareil enregistré.