# Flutter SDK: Leitfaden zur Basis-Integration Dieser Abschnitt enthält Informationen zur Integration des Pushwoosh Flutter SDK in Ihre Anwendung. ## Voraussetzungen Um das Pushwoosh Flutter SDK in Ihre App zu integrieren, benötigen Sie Folgendes: ## Integrationsschritte ### 1. Pushwoosh Flutter SDK-Abhängigkeit hinzufügen Fügen Sie das `pushwoosh_flutter`-Paket zu Ihrer `pubspec.yaml`-Datei hinzu: ```yaml title="pubspec.yaml" dependencies: flutter: sdk: flutter # Use the latest version from https://pub.dev/packages/pushwoosh_flutter pushwoosh_flutter: ^[LATEST_VERSION] ``` Überprüfen Sie die [neueste Version](https://pub.dev/packages/pushwoosh_flutter) auf pub.dev. Führen Sie dann den folgenden Befehl im Stammverzeichnis Ihres Projekts aus, um die Abhängigkeit zu installieren: ```bash flutter pub get ``` Überprüfen Sie, ob das Paket korrekt installiert ist: ```bash flutter pub deps | grep pushwoosh_flutter # Example output: # ❯ flutter pub deps | grep pushwoosh_flutter # └── pushwoosh_flutter 2.3.11 ``` ### 2. Flutter SDK-Initialisierung In der Stammkomponente Ihrer `main.dart`-Datei: - Importieren Sie das `pushwoosh_flutter`-Paket. - Initialisieren Sie das Pushwoosh SDK. - Rufen Sie `registerForPushNotifications()` in Ihrer Initialisierungslogik auf, um sich für Push-Benachrichtigungen zu registrieren. ```dart title="main.dart" import 'package:pushwoosh_flutter/pushwoosh_flutter.dart'; void main() async { runApp(const MyApp()); Pushwoosh.initialize({ "app_id": "__YOUR_APP_ID__" }); Pushwoosh.getInstance.registerForPushNotifications(); } ``` Wobei: - `__YOUR_APP_ID__` ist der Anwendungscode aus dem Pushwoosh Control Panel. ### 3. Natives iOS-Setup #### 3.1 Capabilities Um Push-Benachrichtigungen in Ihrem Projekt zu aktivieren, müssen Sie bestimmte Capabilities hinzufügen. Fügen Sie im Abschnitt „Signing & Capabilities“ die folgenden Capabilities hinzu: - `Push Notifications` - `Background Modes`. Nachdem Sie diese Capability hinzugefügt haben, aktivieren Sie das Kontrollkästchen für `Remote notifications`. Wenn Sie Time Sensitive Notifications (iOS 15+) verwenden möchten, fügen Sie auch die Capability `Time Sensitive Notifications` hinzu. #### 3.2 Info.plist Setzen Sie in Ihrer `Runner/Info.plist` den Schlüssel `__PUSHWOOSH_DEVICE_API_TOKEN__` auf den [Pushwoosh Device API Token](/de/developer/api-reference/api-access-token/#device-api-token): ```swift title="info.plist" Pushwoosh_API_TOKEN __PUSHWOOSH_DEVICE_API_TOKEN__ ``` #### 3.3 Nachverfolgung der Nachrichtenzustellung Sie müssen Ihrem Projekt ein Notification Service Extension Target hinzufügen. Dies ist für eine genaue Zustellungsverfolgung und Funktionen wie Rich Media unter iOS unerlässlich. Befolgen Sie die [Schritte der nativen Anleitung](/de/developer/pushwoosh-sdk/ios-sdk/setting-up-pushwoosh-ios-sdk/basic-integration-guide/#4-message-delivery-tracking), um das Extension Target und den erforderlichen Pushwoosh-Code darin hinzuzufügen. Um sicherzustellen, dass die Notification Service Extension ordnungsgemäß in Ihr Flutter-Projekt integriert ist, müssen Sie die folgende Podfile-Konfiguration verwenden: ```ruby title="Podfile" target 'NotificationServiceExtension' do use_frameworks! use_modular_headers! pod 'PushwooshXCFramework' inherit! :search_paths end ``` #### 3.4 Installation von Abhängigkeiten für das iOS-Flutter-Projekt Um Abhängigkeiten für das iOS-Flutter-Projekt zu installieren, führen Sie den folgenden Befehl aus: ```bash flutter run ``` oder navigieren Sie im Terminal zum Ordner ```ios``` und führen Sie aus: ```bash pod install --repo-update ``` ### 4. Natives Android-Setup #### 4.1 Abhängigkeiten installieren Stellen Sie sicher, dass die erforderlichen Abhängigkeiten und Plugins zu Ihren Gradle-Skripten hinzugefügt werden: Fügen Sie das Google Services Gradle Plugin zu den Abhängigkeiten Ihrer `build.gradle`-Datei auf Projektebene hinzu: ```groovy title="android/build.gradle" buildscript { dependencies { classpath 'com.google.gms:google-services:4.3.15' } } ``` Wenden Sie das Plugin in Ihrer `build.gradle`-Datei auf App-Ebene an: ```groovy title="app/build.gradle" apply plugin: 'com.google.gms.google-services' ``` #### 4.2 Firebase-Konfigurationsdatei hinzufügen Platzieren Sie die Datei `google-services.json` im Ordner `android/app` in Ihrem Projektverzeichnis. #### 4.3 Pushwoosh-Metadaten hinzufügen Fügen Sie in Ihrer `main/AndroidManifest.xml` den [Pushwoosh Device API Token](/de/developer/api-reference/api-access-token/#device-api-token) innerhalb des ``-Tags hinzu: ```xml title="AndroidManifest.xml" ``` > **Wichtig:** Stellen Sie sicher, dass Sie dem Token im Pushwoosh Control Panel Zugriff auf die richtige App gewähren. [Erfahren Sie mehr](/de/developer/api-reference/api-access-token/#edit-token) ### 5. Projekt ausführen 1. Erstellen Sie das Projekt und führen Sie es aus. 2. Gehen Sie zum Pushwoosh Control Panel und [senden Sie eine Push-Benachrichtigung](/de/product/messaging-channels/push-notifications/send-push-notifications/one-time-push). 3. Sie sollten die Benachrichtigung in der App sehen. ## Erweiterte Integration In diesem Stadium haben Sie das SDK bereits integriert und können Push-Benachrichtigungen senden und empfangen. Lassen Sie uns nun die Kernfunktionalität erkunden. ### Event-Listener für Push-Benachrichtigungen Im Pushwoosh SDK gibt es zwei Event-Listener, die für die Verarbeitung von Push-Benachrichtigungen konzipiert sind: - Das `onPushReceived`-Event wird ausgelöst, wenn eine Push-Benachrichtigung empfangen wird - Das `onPushAccepted`-Event wird ausgelöst, wenn ein Benutzer eine Benachrichtigung öffnet Sie sollten diese Event-Listener direkt nach der Initialisierung des SDK beim Start der Anwendung einrichten: ```dart import 'package:pushwoosh_flutter/pushwoosh_flutter.dart'; class PushwooshNotificationHandler { void setupPushListeners(Pushwoosh pushwoosh) { pushwoosh.onPushReceived.listen((event) { print("Push received: ${event.pushwooshMessage.payload}"); }); pushwoosh.onPushAccepted.listen((event) { print("Push accepted: ${event.pushwooshMessage.payload}"); }); } } ``` ### Benutzerkonfiguration Indem Sie sich auf das individuelle Nutzerverhalten und die Vorlieben konzentrieren, können Sie personalisierte Inhalte bereitstellen, was zu einer höheren Nutzerzufriedenheit und -bindung führt. ```dart import 'package:pushwoosh_flutter/pushwoosh_flutter.dart'; class Registration { void afterUserLogin(User user) { // Benutzer-ID setzen Pushwoosh().setUserId(user.getId()); // Benutzer-E-Mail setzen Pushwoosh().setEmail(user.getEmail()); // SMS-Nummer registrieren // Die SMS- und WhatsApp-Nummern müssen im E.164-Format (z. B. "+1234567890") und gültig sein Pushwoosh().registerSmsNumber(user.getSmsNumber()); // WhatsApp-Nummer registrieren Pushwoosh().registerWhatsappNumber(user.getWhatsappNumber()); // Zusätzliche Benutzerinformationen als Tags für Pushwoosh setzen Pushwoosh().setTags({ "age": user.getAge(), "name": user.getName(), "last_login": user.getLastLoginDate() }); } } ``` ### Tags Tags sind Schlüssel-Wert-Paare, die Benutzern oder Geräten zugewiesen werden und eine Segmentierung nach Attributen wie Vorlieben oder Verhalten ermöglichen, was gezielte Nachrichtenübermittlung ermöglicht. ```dart import 'package:pushwoosh_flutter/pushwoosh_flutter.dart'; class UpdateUser { void afterUserUpdateProfile(User user) { // Liste der bevorzugten Kategorien setzen Pushwoosh().setTags({ "favorite_categories": user.getFavoriteCategoriesList() }); // Zahlungsinformationen setzen Pushwoosh().setTags({ "is_subscribed": user.isSubscribed(), "payment_status": user.getPaymentStatus(), "billing_address": user.getBillingAddress() }); } } ``` ### Events Events sind spezifische Benutzeraktionen oder Vorkommnisse innerhalb der App, die verfolgt werden können, um das Verhalten zu analysieren und entsprechende Nachrichten oder Aktionen auszulösen. ```dart import 'package:pushwoosh_flutter/pushwoosh_flutter.dart'; class Registration { // Login-Event verfolgen void afterUserLogin(User user) { Pushwoosh().postEvent("login", { "name": user.getName(), "last_login": user.getLastLoginDate() }); } void afterUserPurchase(Product product) { // Kauf-Event verfolgen Pushwoosh().postEvent("purchase", { "product_id": product.getId(), "product_name": product.getName(), "price": product.getPrice(), "quantity": product.getQuantity() }); } } ``` ## Verwendung von ProGuard Daher erhalten Sie möglicherweise diese Ausnahme: ```java java.lang.IllegalStateException: Could not find class for name: com.pushwoosh.plugin.PushwooshNotificationServiceExtension ``` In diesem Fall gibt es zwei Lösungen: 1. Verwenden Sie den Befehl `flutter build apk --no-shrink`, um Ihren Code ohne Verschleierung zu kompilieren. 2. Oder Sie können ProGuard manuell aktivieren und die notwendigen Regeln hinzufügen. Um ProGuard für Ihr Projekt zu aktivieren, fügen Sie die folgenden Zeichenfolgen zu Ihrer `build.gradle`-Datei hinzu: ```java title="build.gradle" buildTypes { release { minifyEnabled true useProguard true proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' signingConfig signingConfigs.debug } } ``` Fügen Sie dann die folgenden Regeln zur `android/app/proguard-rules.pro` hinzu ```java title="proguard-rules.pro" #Pushwoosh Flutter -keep class com.pushwoosh.plugin.PushwooshPlugin { *; } -keep class com.pushwoosh.plugin.PushwooshNotificationServiceExtension { *; } ``` ## Fehlerbehebung Wenn Sie während des Integrationsprozesses auf Probleme stoßen, lesen Sie bitte den Abschnitt [Support und Community](/de/developer/pushwoosh-sdk/support-and-community).