PushEngage для Expo
Используйте PushEngage в приложении Expo через PushEngage React Native SDK и сборку для разработки Expo. Expo Go не поддерживается, так как он не может запускать нативный код SDK.
Что можно делать с Expo
Тот же API, что и в обычном React Native
После настройки сборки для разработки JavaScript API идентичен проекту обычного React Native.
Полный набор функций push-уведомлений в сборке для разработки
В руководстве перечислены глубокие ссылки, сегменты и атрибуты, отслеживание целей и кампании триггеров как поддерживаемые, плюс расширенные уведомления после добавления расширения службы уведомлений.
Инструменты Expo продолжают работать
После prebuild вы по-прежнему можете использовать EAS Build и обновления по воздуху с помощью EAS Update.
Пример плагина конфигурации для сгенерированных проектов
Если ваши нативные папки перегенерируются при каждой сборке, руководство включает локальный плагин конфигурации Expo, который вы можете скопировать, чтобы повторно применить ключ группы приложений и разрешение на уведомления Android.
Путь из expo-notifications
Руководство описывает замену встроенной службы push-уведомлений Expo: замените запрос разрешения и обработчики нажатий и отправляйте через REST API PushEngage.
Как настроить
- Установите 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 и плагин Google Services, поместите google-services.json в android/app и добавьте разрешение POST_NOTIFICATIONS в манифест.
- Создайте клиент для разработки с помощью npx expo run:ios или npx expo run:android, или с помощью профиля разработки EAS Build.
- Инициализируйте SDK с вашим App ID в index.js перед регистрацией приложения, затем запросите разрешение на уведомления в вашем приложении.
- Создайте производственную сборку с помощью EAS Build.
Полное руководство: PushEngage с Expo и обычным рабочим процессом
Хорошо знать
- Push-уведомления приложений и SDK React Native включены во все тарифные планы PushEngage, включая бесплатный. Отслеживание целей, настраиваемые кампании триггеров и внутриприложения сообщения требуют платного плана.
- В руководстве указаны Expo SDK 49 или новее, EAS CLI, учетная запись Apple Developer для iOS и проект Firebase для Android в качестве предварительных условий.
- Expo Go не может запускать PushEngage. Тестируйте со сборкой для разработки на физическом устройстве, так как симуляторы не получают push-уведомления.
- Prebuild перегенерирует нативные папки с нуля. Зафиксируйте папки ios и android или используйте плагин конфигурации, чтобы ваша настройка PushEngage не была потеряна.
- Возможности Push Notifications и Background Modes требуют разрешений, поэтому один только конфигурационный плагин не может их установить. Руководство предлагает настроить их один раз в Xcode.
- PushEngage не публикует собственный конфигурационный плагин Expo. Тот, что в руководстве, является примером для копирования в ваш проект.
Об этом подключении
- Поддержка Expo осуществляется через SDK PushEngage React Native, который PushEngage разрабатывает и поддерживает. Это не партнерство с Expo.
- Отдельного пакета Expo нет. Вы устанавливаете @pushengage/pushengage-react-native из npm.
- В документации API PushEngage указано, что сборки для разработки Expo поддерживаются с ручной нативной конфигурацией, bare React Native — рекомендуемая настройка, а Expo Go — не поддерживается.
- Исходный код SDK общедоступен на GitHub в репозитории awesomemotive/pushengage-react-native под лицензией MIT.
Каталог партнеров PushEngage
Готовы добавить push в ваше приложение Expo? Начните с руководства по настройке.
У PushEngage есть бесплатный тариф, поэтому вы можете установить его и отправить свою первую кампанию до того, как заплатите.