Cordova SDK Schnellstart

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

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.

Das Beispielprojekt herunterladen

# 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/

Das Projekt konfigurieren

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 appid und projectid durch Ihren Pushwoosh App Code und Ihre Firebase Projektnummer.

iOS

1. Bundle Identifier festlegen

Ö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ähigkeiten hinzufügen

Um Push-Benachrichtigungen zu aktivieren, müssen Sie bestimmte Fähigkeiten hinzufügen.

Fügen Sie im Abschnitt „Signing & Capabilities“ die folgenden Fähigkeiten hinzu:

• Push Notifications
• Background Modes. Nachdem Sie diese Fähigkeit hinzugefügt haben, aktivieren Sie das Kontrollkästchen für Remote notifications.

3. API-Token festlegen

Setzen Sie in Ihrer ios/newdemo/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 Stammverzeichnis des Projekts

2. Paketnamen festlegen

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

3. 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. 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.

Eine Push-Benachrichtigung senden

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