Cordova SDK Schnellstart

Starten Sie mit diesem schnellen und einfachen Beispiel mit dem Pushwoosh Cordova SDK.

Voraussetzungen

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

Anforderungen

• Ein Pushwoosh-Konto.
• Ein Pushwoosh-Projekt, das in Ihrem Konto eingerichtet ist.
• Für die iOS-Integration:
  • Eine iOS-Plattform, die für den Versand von Push-Benachrichtigungen konfiguriert ist. Wir empfehlen, die Konfiguration für die Token-basierte Authentifizierung als einfachsten Ansatz zu verwenden.
  • Stellen Sie während der Einrichtung das Gateway auf Sandbox ein, um Push-Benachrichtigungen an einen Simulator zu senden.
• Für die Android-Integration:
  • Eine konfigurierte Android-Plattform
  • Die Datei google-services.json und der package name 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 Aufruf pushwoosh.onDeviceReady:

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

Ersetzen Sie den appid-Wert durch Ihren Pushwoosh App Code.

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 Device API Token

Android

1. Richten Sie google-services.json ein

Kopieren Sie Ihre Datei google-services.json 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 Device 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 Register for notifications.
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.