PushEngage για Expo
Χρησιμοποιήστε το PushEngage σε μια εφαρμογή Expo μέσω του PushEngage React Native SDK και μιας ανάπτυξης build του Expo. Το Expo Go δεν υποστηρίζεται, επειδή δεν μπορεί να εκτελέσει τον εγγενή κώδικα του SDK.
Τι μπορείτε να κάνετε με το Expo
Το ίδιο API με το bare React Native
Μόλις η ανάπτυξη build είναι έτοιμη, το JavaScript API είναι πανομοιότυπο με ένα bare React Native project.
Πλήρες σύνολο δυνατοτήτων push σε μια ανάπτυξη build
Ο οδηγός αναφέρει τη βαθιά σύνδεση (deep linking), τα τμήματα (segments) και τα χαρακτηριστικά (attributes), την παρακολούθηση στόχων (goal tracking) και τις καμπάνιες ενεργοποίησης (trigger campaigns) ως υποστηριζόμενες, συν τις πλούσιες ειδοποιήσεις (rich notifications) μόλις προσθέσετε ένα Notification Service Extension.
Τα εργαλεία του Expo συνεχίζουν να λειτουργούν
Μετά το prebuild μπορείτε ακόμα να χρησιμοποιήσετε το EAS Build και τις ενημερώσεις over-the-air με το EAS Update.
Παράδειγμα plugin διαμόρφωσης για ανανεωμένα projects
Εάν οι εγγενείς φάκελοι σας ανανεώνονται σε κάθε build, ο οδηγός περιλαμβάνει ένα τοπικό plugin διαμόρφωσης Expo που μπορείτε να αντιγράψετε για να επαναφέρετε το κλειδί App Group και την άδεια ειδοποιήσεων Android.
Διαδρομή από το expo-notifications
Ο οδηγός σας καθοδηγεί στην αντικατάσταση της ενσωματωμένης υπηρεσίας push του Expo: αλλάξτε το αίτημα άδειας και τους χειριστές πατήματος, και στείλτε μέσω του PushEngage REST API.
Πώς να το ρυθμίσετε
- Εγκαταστήστε το expo-dev-client και το πακέτο @pushengage/pushengage-react-native.
- Εκτελέστε npx expo prebuild –clean για να δημιουργήσετε τους φακέλους ios και android.
- Για iOS, ανοίξτε τον δημιουργημένο χώρο εργασίας στο Xcode, προσθέστε Push Notifications, Background Modes με Remote notifications, και App Groups, και στη συνέχεια προσθέστε το PushEngage_App_Group_Key στο Info.plist.
- Για Android, προσθέστε το αποθετήριο JitPack και το plugin Google Services, τοποθετήστε το google-services.json στο android/app, και προσθέστε την άδεια POST_NOTIFICATIONS στο manifest.
- Δημιουργήστε έναν client ανάπτυξης με npx expo run:ios ή npx expo run:android, ή με ένα προφίλ ανάπτυξης EAS Build.
- Αρχικοποιήστε το SDK με το App ID σας στο index.js πριν την εγγραφή της εφαρμογής, και στη συνέχεια ζητήστε άδεια ειδοποιήσεων στην εφαρμογή σας.
- Δημιουργήστε την παραγωγή build σας με το EAS Build.
Πλήρης οδηγός: PushEngage με Expo και bare workflow
Καλό είναι να γνωρίζετε
- Οι ειδοποιήσεις push εφαρμογών και το React Native SDK περιλαμβάνονται σε όλα τα πλάνα του PushEngage, συμπεριλαμβανομένου του δωρεάν πλάνου. Η παρακολούθηση στόχων, οι προσαρμοσμένες καμπάνιες ενεργοποίησης και τα μηνύματα εντός εφαρμογής απαιτούν επί πληρωμή πλάνο.
- Ο οδηγός αναφέρει το Expo SDK 49 ή νεότερο, το EAS CLI, έναν λογαριασμό Apple Developer για iOS, και ένα project Firebase για Android ως προαπαιτούμενα.
- Το Expo Go δεν μπορεί να εκτελέσει το PushEngage. Δοκιμάστε με μια ανάπτυξη build σε φυσική συσκευή, καθώς οι προσομοιωτές δεν λαμβάνουν ειδοποιήσεις push.
- Το Prebuild αναδημιουργεί τους εγγενείς φακέλους από την αρχή. Κάντε commit τους φακέλους ios και android, ή χρησιμοποιήστε ένα plugin διαμόρφωσης, ώστε η ρύθμιση του PushEngage να μην χαθεί.
- Οι δυνατότητες Push Notifications και Background Modes χρειάζονται δικαιώματα (entitlements), επομένως ένα plugin διαμόρφωσης από μόνο του δεν μπορεί να τις ρυθμίσει. Ο οδηγός προτείνει τη διαμόρφωσή τους μία φορά στο Xcode.
- Το PushEngage δεν δημοσιεύει το δικό του plugin διαμόρφωσης Expo. Αυτό στον οδηγό είναι ένα παράδειγμα για να αντιγράψετε στο έργο σας.
Σχετικά με αυτήν τη σύνδεση
- Η υποστήριξη Expo παρέχεται μέσω του PushEngage React Native SDK, το οποίο η PushEngage δημιουργεί και συντηρεί. Δεν πρόκειται για συνεργασία με την Expo.
- Δεν υπάρχει ξεχωριστό πακέτο Expo. Εγκαθιστάτε το @pushengage/pushengage-react-native από το npm.
- Τα έγγραφα API της PushEngage αναφέρουν τις αναπτύξεις ανάπτυξης Expo ως υποστηριζόμενες με μη αυτόματη εγγενή διαμόρφωση, το bare React Native ως την προτεινόμενη ρύθμιση και το Expo Go ως μη υποστηριζόμενο.
- Ο πηγαίος κώδικας του SDK είναι δημόσιος στο GitHub στο αποθετήριο awesomemotive/pushengage-react-native υπό την άδεια MIT.
Κατάλογος Συνεργατών PushEngage
Έτοιμοι να προσθέσετε ειδοποιήσεις στην εφαρμογή σας Expo; Ξεκινήστε με τον οδηγό εγκατάστασης.
Το PushEngage έχει δωρεάν πρόγραμμα, οπότε μπορείτε να το εγκαταστήσετε και να στείλετε την πρώτη σας καμπάνια πριν πληρώσετε οτιδήποτε.