Plateforme d'applications

PushEngage pour Expo

Utilisez PushEngage dans une application Expo via le SDK React Native de PushEngage et une build de développement Expo. Expo Go n'est pas pris en charge, car il ne peut pas exécuter le code natif du SDK.

Ce que vous pouvez faire avec Expo

La même API qu'un projet React Native natif

Une fois la build de développement mise en place, l'API JavaScript est identique à celle d'un projet React Native natif.

Ensemble complet des fonctionnalités push dans une build de développement

Le guide liste le deep linking, les segments et attributs, le suivi des objectifs et les campagnes de déclenchement comme pris en charge, ainsi que les notifications enrichies une fois que vous ajoutez une extension de service de notification.

Les outils Expo continuent de fonctionner

Après le prebuild, vous pouvez toujours utiliser EAS Build et les mises à jour over-the-air avec EAS Update.

Exemple de plugin de configuration pour les projets régénérés

Si vos dossiers natifs sont régénérés à chaque build, le guide inclut un plugin de configuration Expo local que vous pouvez copier pour réappliquer la clé de groupe d'applications et l'autorisation de notification Android.

Chemin depuis expo-notifications

Le guide explique comment remplacer le service push intégré d'Expo : échangez la demande d'autorisation et les gestionnaires de tap, et envoyez via l'API REST PushEngage.

Comment le configurer

  1. Installez expo-dev-client et le package @pushengage/pushengage-react-native.
  2. Exécutez npx expo prebuild --clean pour générer les dossiers ios et android.
  3. Pour iOS, ouvrez l'espace de travail généré dans Xcode, ajoutez les notifications push, les modes d'arrière-plan avec notifications à distance, et les groupes d'applications, puis ajoutez PushEngage_App_Group_Key à Info.plist.
  4. Pour Android, ajoutez le dépôt JitPack et le plugin Google Services, placez google-services.json dans android/app, et ajoutez la permission POST_NOTIFICATIONS au manifeste.
  5. Créez un client de développement avec npx expo run:ios ou npx expo run:android, ou avec un profil de développement EAS Build.
  6. Initialisez le SDK avec votre ID d'application dans index.js avant que l'application ne soit enregistrée, puis demandez l'autorisation de notification dans votre application.
  7. Créez votre build de production avec EAS Build.

Guide complet : PushEngage avec Expo et le workflow natif

Les mises à jour remplacent vos valeurs actuelles, donc un changement partiel laisse le reste inchangé.

  • Les notifications push de l'application et le SDK React Native sont inclus dans tous les plans PushEngage, y compris le plan gratuit. Le suivi des objectifs, les campagnes déclenchées personnalisées et les messages in-app nécessitent un plan payant.
  • Le guide liste Expo SDK 49 ou ultérieur, EAS CLI, un compte développeur Apple pour iOS, et un projet Firebase pour Android comme prérequis.
  • Expo Go ne peut pas exécuter PushEngage. Testez avec une build de développement sur un appareil physique, car les simulateurs ne reçoivent pas les notifications push.
  • Prebuild régénère les dossiers natifs à partir de zéro. Validez les dossiers ios et android, ou utilisez un plugin de configuration, afin que votre configuration PushEngage ne soit pas perdue.
  • Les fonctionnalités Push Notifications et Background Modes nécessitent des autorisations, donc un plugin de configuration seul ne peut pas les définir. Le guide suggère de les configurer une fois dans Xcode.
  • PushEngage ne publie pas son propre plugin de configuration Expo. Celui du guide est un exemple à copier dans votre projet.

À propos de cette connexion

  • Le support d'Expo passe par le SDK PushEngage React Native, que PushEngage construit et maintient. Ce n'est pas un partenariat avec Expo.
  • Il n'y a pas de package Expo séparé. Vous installez @pushengage/pushengage-react-native depuis npm.
  • La documentation de l'API de PushEngage indique que les builds de développement Expo sont pris en charge avec une configuration native manuelle, que le flux React Native natif est la configuration recommandée, et que l'Expo Go n'est pas pris en charge.
  • Le code source du SDK est public sur GitHub dans le dépôt awesomemotive/pushengage-react-native sous licence MIT.

Répertoire des partenaires PushEngage

Prêt à ajouter des notifications push à votre application Expo ? Commencez par le guide d'installation.

PushEngage dispose d'un plan gratuit, vous pouvez donc l'installer et envoyer votre première campagne avant de payer quoi que ce soit.