Flutter SDK Schnellstart

Beginnen Sie mit dem Pushwoosh Flutter SDK mit diesem schnellen und einfachen Beispiel.

Voraussetzungen

Um das Pushwoosh Flutter SDK in Ihre App zu integrieren, benötigen Sie Folgendes:

Anforderungen

• Ein Pushwoosh-Konto.
• Ein in Ihrem Konto eingerichtetes Pushwoosh-Projekt.
• Für die iOS-Integration:
  • Eine iOS-Plattform, die für den Versand von Push-Benachrichtigungen konfiguriert ist. Wir empfehlen die Verwendung der Konfiguration für tokenbasierte Authentifizierung als einfachsten Ansatz.
  • Stellen Sie während der Einrichtung das Gateway auf Sandbox, um Push-Benachrichtigungen an einen Simulator zu senden.
• Für die Android-Integration:
  • Eine konfigurierte Android-Plattform
  • Die Projektnummer (auch als Sender-ID bekannt), die Datei google-services.json und der Paketname aus Ihrem Firebase-Projekt.
  • Ein Firebase-Projekt, das mit Ihrer Android-Anwendung verbunden ist. Folgen Sie bei Bedarf der Firebase-Einrichtungsanleitung.
• Ihr Pushwoosh Application Code und Ihr Pushwoosh Device API Token aus dem Pushwoosh Control Panel für Ihre Anwendung.

Laden Sie das Beispielprojekt herunter

# Klonen Sie das SDK-Repository und navigieren Sie zum Beispielprojekt
git clone https://github.com/Pushwoosh/pushwoosh-flutter

# Navigieren Sie zum Beispielverzeichnis
cd pushwoosh-flutter/Source/pushwoosh/example

Konfigurieren Sie das Projekt

Installieren Sie die Abhängigkeiten:

flutter pub get

Öffnen Sie lib/main.dart und aktualisieren Sie den Aufruf von Pushwoosh.initialize:

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

Ersetzen Sie die Werte für app_id und sender_id durch Ihren Pushwoosh App Code und Ihre Firebase Projektnummer.

iOS

1. Abhängigkeiten installieren

Navigieren Sie in das ios-Verzeichnis und installieren Sie die Abhängigkeiten:

cd ios && pod install --repo-update

2. Den Bundle Identifier festlegen

Öffnen Sie die Datei ios/Runner.xcworkspace in Xcode.

Legen Sie den Bundle Identifier für jedes Ziel fest:

• Runner: der Paketname Ihrer App. (z.B. com.example.pushwoosh)
• NotificationService: der Paketname Ihrer App mit .NotificationServiceExtension (z.B. com.example.pushwoosh.NotificationServiceExtension)
• StopwatchWidgetExtension: der Paketname Ihrer App mit .StopwatchWidget (z.B. com.example.pushwoosh.StopwatchWidget)

3. Den API-Token festlegen

Setzen Sie in Ihrer ios/Runner/Info.plist den Schlüssel Pushwoosh_API_TOKEN auf den Pushwoosh Device API Token.

Android

1. google-services.json einrichten

Kopieren Sie Ihre google-services.json-Datei in das Verzeichnis android/app.

2. Den Paketnamen festlegen

Öffnen Sie android/app/build.gradle und setzen Sie die applicationId auf den Paketnamen Ihrer App. (z.B. com.example.pushwoosh)

3. Den API-Token festlegen

Öffnen Sie Ihre Datei android/app/src/main/AndroidManifest.xml und fügen Sie die folgenden Metadaten innerhalb des <application>-Tags hinzu:

AndroidManifest.xml

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

Ersetzen Sie __YOUR_PUSHWOOSH_DEVICE_API_TOKEN__ durch Ihren Pushwoosh Device API Token.

Führen Sie das Projekt aus

1. Erstellen Sie das Projekt und führen Sie es aus.
2. Die App hat zwei Tabs: „Actions“ und „Settings“. Navigieren Sie zum Tab Settings.
3. Tippen Sie auf die Schaltfläche Register for Pushes.
4. Erteilen Sie die Berechtigung für Push-Benachrichtigungen. Das Gerät wird bei Pushwoosh registriert.

Senden Sie eine Push-Benachrichtigung

Gehen Sie zurück zum Pushwoosh Control Panel und senden Sie eine Push-Benachrichtigung an Ihr registriertes Gerät.