Cordova SDK Schnellstart

Starten Sie mit dem Pushwoosh Cordova SDK mithilfe dieses schnellen und einfachen Beispiels.

Voraussetzungen

Um das Pushwoosh Cordova 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-phonegap-plugin.git

# Navigieren Sie zum Beispielverzeichnis
cd pushwoosh-phonegap-plugin/example/newdemo/

Konfigurieren Sie das Projekt

Installieren Sie die Abhängigkeiten:

npm i

Fügen Sie das Pushwoosh-Plugin hinzu:

cordova plugin add ../../ --link --nofetch

Öffnen Sie www/js/index.js und aktualisieren Sie den pushwoosh.onDeviceReady-Aufruf:

pushwoosh.onDeviceReady({
    appid: "XXXXX-XXXXX",
    projectid: "XXXXXXXXXXXXXXX"
});

Ersetzen Sie die Werte für appid und projectid durch Ihren Pushwoosh App Code und Ihre Firebase Project Number.

iOS

1. Legen Sie den Bundle Identifier fest

Öffnen Sie die Datei platforms/ios/newdemo.xcworkspace in Xcode.

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

• newdemo: der Paketname Ihrer App. (z.B. com.example.pushwoosh)

2. Fügen Sie Capabilities hinzu

Um Push-Benachrichtigungen 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.

3. Legen Sie den API-Token fest

Setzen Sie in Ihrer ios/newdemo/Info.plist den Schlüssel Pushwoosh_API_TOKEN auf den Pushwoosh Geräte-API-Token.

Android

1. Richten Sie google-services.json ein

Kopieren Sie Ihre google-services.json-Datei in das Stammverzeichnis des Projekts.

2. Legen Sie den Paketnamen fest

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

3. Legen Sie den API-Token fest

Ö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 Geräte-API-Token.

Führen Sie das Projekt aus

1. Erstellen Sie das Projekt und führen Sie es aus.
2. Betätigen Sie den Schalter Für Benachrichtigungen registrieren.
3. Erteilen Sie die Erlaubnis 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.