App-Plattform

PushEngage für Expo

Verwenden Sie PushEngage in einer Expo-App über das PushEngage React Native SDK und einen Expo-Entwicklungsbuild. Expo Go wird nicht unterstützt, da es den nativen Code des SDKs nicht ausführen kann.

Was Sie mit Expo tun können

Die gleiche API wie bei nativem React Native

Sobald der Entwicklungsbuild eingerichtet ist, ist die JavaScript-API identisch mit einem nativen React Native-Projekt.

Vollständiger Push-Funktionsumfang in einem Entwicklungsbuild

Die Anleitung listet Deep Linking, Segmente und Attribute, Zielverfolgung und Trigger-Kampagnen als unterstützt auf, plus Rich Notifications, sobald Sie eine Notification Service Extension hinzufügen.

Expo-Tools funktionieren weiterhin

Nach dem Prebuild können Sie EAS Build und Over-the-Air-Updates mit EAS Update weiterhin nutzen.

Beispiel-Konfigurations-Plugin für neu generierte Projekte

Wenn Ihre nativen Ordner bei jedem Build neu generiert werden, enthält die Anleitung ein lokales Expo-Konfigurations-Plugin, das Sie kopieren können, um den App-Gruppenschlüssel und die Android-Benachrichtigungsberechtigung erneut anzuwenden.

Pfad von expo-notifications

Die Anleitung führt Sie durch den Austausch des integrierten Push-Dienstes von Expo: Tauschen Sie die Berechtigungsanfrage und die Tipp-Handler aus und senden Sie über die PushEngage REST API.

So richten Sie es ein

  1. Installieren Sie expo-dev-client und das Paket @pushengage/pushengage-react-native.
  2. Führen Sie npx expo prebuild –clean aus, um die Ordner ios und android zu generieren.
  3. Öffnen Sie für iOS den generierten Workspace in Xcode, fügen Sie Push Notifications, Background Modes mit Remote notifications und App Groups hinzu und fügen Sie dann PushEngage_App_Group_Key zu Info.plist hinzu.
  4. Fügen Sie für Android das JitPack-Repository und das Google Services-Plugin hinzu, platzieren Sie google-services.json in android/app und fügen Sie die POST_NOTIFICATIONS-Berechtigung zum Manifest hinzu.
  5. Erstellen Sie einen Entwicklungsclient mit npx expo run:ios oder npx expo run:android oder mit einem EAS Build-Entwicklungsprofil.
  6. Initialisieren Sie das SDK mit Ihrer App-ID in index.js, bevor die App registriert wird, und fordern Sie dann die Benachrichtigungsberechtigung in Ihrer App an.
  7. Erstellen Sie Ihren Produktionsbuild mit EAS Build.

Vollständige Anleitung: PushEngage mit Expo und nativem Workflow

Gut zu wissen

  • App Push und das React Native SDK sind in jedem PushEngage-Plan enthalten, einschließlich des kostenlosen Plans. Zielverfolgung, benutzerdefinierte Trigger-Kampagnen und In-App-Nachrichten erfordern einen kostenpflichtigen Plan.
  • Die Anleitung listet Expo SDK 49 oder neuer, die EAS CLI, ein Apple Developer-Konto für iOS und ein Firebase-Projekt für Android als Voraussetzungen auf.
  • Expo Go kann PushEngage nicht ausführen. Testen Sie mit einem Entwicklungs-Build auf einem physischen Gerät, da Simulatoren keine Push-Benachrichtigungen empfangen.
  • Prebuild generiert die nativen Ordner von Grund auf neu. Committen Sie die Ordner ios und android oder verwenden Sie ein Konfigurations-Plugin, damit Ihre PushEngage-Einrichtung nicht verloren geht.
  • Die Funktionen Push-Benachrichtigungen und Hintergrundmodi benötigen Berechtigungen, sodass ein Konfigurations-Plugin allein diese nicht festlegen kann. Der Leitfaden schlägt vor, sie einmal in Xcode zu konfigurieren.
  • PushEngage veröffentlicht kein eigenes Expo-Konfigurations-Plugin. Das im Leitfaden erwähnte ist ein Beispiel, das Sie in Ihr Projekt kopieren können.

Über diese Verbindung

  • Der Expo-Support erfolgt über das PushEngage React Native SDK, das von PushEngage erstellt und gepflegt wird. Es handelt sich nicht um eine Partnerschaft mit Expo.
  • Es gibt kein separates Expo-Paket. Sie installieren @pushengage/pushengage-react-native von npm.
  • Die API-Dokumentation von PushEngage listet Expo-Entwicklungs-Builds als unterstützt mit manueller nativer Konfiguration, Bare React Native als empfohlene Einrichtung und Expo Go als nicht unterstützt auf.
  • Der SDK-Quellcode ist öffentlich auf GitHub im Repository awesomemotive/pushengage-react-native unter der MIT-Lizenz verfügbar.

PushEngage Partnerverzeichnis

Bereit, Push-Benachrichtigungen zu Ihrer Expo-App hinzuzufügen? Beginnen Sie mit dem Einrichtungsleitfaden.

PushEngage hat einen kostenlosen Plan, sodass Sie es installieren und Ihre erste Kampagne senden können, bevor Sie etwas bezahlen.