React Native SDK Schnellstart

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

Voraussetzungen

Um das Pushwoosh React Native 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.

Das Beispielprojekt herunterladen

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

# Navigieren Sie zum Beispielverzeichnis
cd pushwoosh-react-native-plugin/example/demoapp/

Das Projekt konfigurieren

Installieren Sie die Abhängigkeiten:

npm install

Öffnen Sie Settings.js und aktualisieren Sie den Pushwoosh.init-Aufruf:

Pushwoosh.init({ "pw_appid" : "__YOUR_APP_ID__", "project_number":"__YOUR_FCM_SENDER_ID__"});

Ersetzen Sie die Werte __YOUR_APP_ID__ und __YOUR_FCM_SENDER_ID__ durch Ihren Pushwoosh App Code und Ihre Firebase Project Number.

iOS

1. Abhängigkeiten installieren

Navigieren Sie in das Verzeichnis ios 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)

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.

Das Projekt ausführen

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

Eine Push-Benachrichtigung senden

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