Mendix-Modul Schnellstart

Legen Sie mit dem Pushwoosh-Modul für Mendix los, indem Sie die mit dem Modul gelieferte Demo-App ausführen und eine Push-Benachrichtigung an sie senden.

Voraussetzungen

Um die Demo-App auszuführen, 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 Konfiguration für die tokenbasierte Authentifizierung als einfachsten Ansatz zu verwenden.
  • Stellen Sie während der Einrichtung das Gateway auf Sandbox ein, um Pushes 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 der Pushwoosh Device API Token aus dem Pushwoosh Control Panel für Ihre Anwendung.

Sie benötigen außerdem Mendix Studio Pro 11.12.3 oder neuer mit einem nativen mobilen Navigationsprofil sowie Xcode oder Android Studio, um den nativen Build zu erstellen.

Der Device API Token in der obigen Liste wird für dieses Modul nicht benötigt. Das Widget nimmt nur den Application Code und nichts anderes.

Demo-App herunterladen

Klonen Sie das Modul-Repository:

git clone https://github.com/Pushwoosh/pushwoosh-mendix.git

Die Demo-App befindet sich im Ordner demo. Es ist dieselbe App, gegen die das Modul entwickelt wird: ein Bildschirm mit Schaltflächen zum Registrieren und Abmelden des Geräts, zum Lesen des Push-Tokens, zum Setzen und Lesen von Tags und zum Posten eines Events, sowie Eingabefelder für den Tag-Schlüssel und -Wert und für den Event-Namen.

App in Studio Pro öffnen

Öffnen Sie demo/PushwooshDemo.mpr in Studio Pro. Die App enthält bereits das Pushwoosh-Modul, das Pushwoosh events-Widget auf der Startseite und einen Nanoflow hinter jeder Schaltfläche.

Ihren Application Code festlegen

Öffnen Sie die Startseite des nativen mobilen Navigationsprofils, wählen Sie das Pushwoosh events-Widget aus und ersetzen Sie den Platzhalter XXXXX-XXXXX in der Eigenschaft Application Code durch den Application Code Ihrer App aus dem Pushwoosh Control Panel.

Native App erstellen

Die Demo kann nicht in der „Make It Native“-App ausgeführt werden, da diese App keinen nativen Code von Drittanbietern enthält. Erstellen Sie stattdessen eine benutzerdefinierte Entwickler-App oder einen echten nativen Build.

Unter Windows verwenden Sie App > Build Native App, um den Native Mobile Builder zu öffnen, und stellen Sie die Funktionen wie folgt ein:

• Push notifications: aus.
• Firebase Android: ein.

Pushwoosh ersetzt den integrierten Push einer Mendix-App, anstatt daneben zu arbeiten. Zwei Benachrichtigungsdienste, die für dasselbe Firebase-Event registriert sind, überschatten sich gegenseitig und Benachrichtigungen kommen nicht mehr an.

Unter macOS hat Studio Pro keinen Native Mobile Builder. Konfigurieren Sie stattdessen die native Vorlage mit dem Befehlszeilentool @mendix/native-mobile-toolkit und erstellen Sie dann die generierten iOS- und Android-Projekte lokal.

Für iOS öffnen Sie das generierte Xcode-Projekt und fügen Sie die Funktion Push Notifications unter Signing & Capabilities hinzu. Für Android platzieren Sie die Datei google-services.json aus Ihrem Firebase-Projekt in das generierte Android-Projekt.

App ausführen und Gerät registrieren

Starten Sie die Mendix-Laufzeit für die App, starten Sie dann den nativen Build auf einem Gerät oder einem Simulator und tippen Sie auf Register For Push Notifications. Das Gerät bittet um die Berechtigung für Benachrichtigungen, registriert sich bei Pushwoosh und zeigt das Push-Token in einer Nachricht an.

Eine Test-Push-Benachrichtigung senden

Registrieren Sie das Gerät als Testgerät und senden Sie eine Nachricht von der Pushwoosh Control Panel aus. Die Schritte finden Sie unter Testen Sie Ihre Integration.

Nächste Schritte

• Grundlegende Integrationsanleitung - fügen Sie das Modul zu Ihrer eigenen App hinzu
• Referenz der Modulaktionen - die Widget-Eigenschaften und die JavaScript-Aktionen