PushEngage para Expo
Use o PushEngage em um aplicativo Expo através do SDK React Native do PushEngage e de um build de desenvolvimento Expo. O Expo Go não é compatível, pois não pode executar o código nativo do SDK.
O que você pode fazer com o Expo
A mesma API do React Native puro
Uma vez que o build de desenvolvimento esteja configurado, a API JavaScript é idêntica à de um projeto React Native puro.
Conjunto completo de recursos de push em um build de desenvolvimento
O guia lista deep linking, segmentos e atributos, rastreamento de metas e campanhas de gatilho como suportados, além de notificações ricas assim que você adicionar uma Extensão de Serviço de Notificação.
As ferramentas do Expo continuam funcionando
Após o prebuild, você ainda pode usar o EAS Build e atualizações over-the-air com o EAS Update.
Plugin de configuração de exemplo para projetos regenerados
Se suas pastas nativas são regeneradas a cada build, o guia inclui um plugin de configuração local do Expo que você pode copiar para reaplicar a chave do Grupo de Aplicativos e a permissão de notificação do Android.
Caminho de expo-notifications
O guia detalha a substituição do serviço de push integrado do Expo: troque a solicitação de permissão e os manipuladores de toque, e envie através da API REST do PushEngage.
Como configurar
- Instale o expo-dev-client e o pacote @pushengage/pushengage-react-native.
- Execute npx expo prebuild –clean para gerar as pastas ios e android.
- Para iOS, abra o workspace gerado no Xcode, adicione Push Notifications, Background Modes com Remote notifications e App Groups, e então adicione PushEngage_App_Group_Key ao Info.plist.
- Para Android, adicione o repositório JitPack e o plugin Google Services, coloque google-services.json em android/app, e adicione a permissão POST_NOTIFICATIONS ao manifest.
- Crie um cliente de desenvolvimento com npx expo run:ios ou npx expo run:android, ou com um perfil de desenvolvimento EAS Build.
- Inicialize o SDK com seu App ID em index.js antes que o aplicativo seja registrado, e então solicite a permissão de notificação em seu aplicativo.
- Crie seu build de produção com EAS Build.
Guia completo: PushEngage com Expo e fluxo de trabalho puro
Bom saber
- Push de aplicativo e o SDK React Native estão listados em todos os planos PushEngage, incluindo o plano gratuito. Rastreamento de metas, campanhas acionadas personalizadas e mensagens no aplicativo exigem um plano pago.
- O guia lista o Expo SDK 49 ou posterior, o EAS CLI, uma conta de Desenvolvedor Apple para iOS e um projeto Firebase para Android como pré-requisitos.
- O Expo Go não pode executar o PushEngage. Teste com uma build de desenvolvimento em um dispositivo físico, pois simuladores não recebem notificações push.
- O prebuild regenera as pastas nativas do zero. Faça o commit das pastas ios e android, ou use um plugin de configuração, para que sua configuração do PushEngage não seja perdida.
- As capacidades de Notificações Push e Modos de Segundo Plano precisam de entitlements, então um plugin de configuração sozinho não pode configurá-las. O guia sugere configurá-las uma vez no Xcode.
- O PushEngage não publica seu próprio plugin de configuração do Expo. O que está no guia é um exemplo para copiar para o seu projeto.
Sobre esta conexão
- O suporte do Expo é feito através do SDK React Native do PushEngage, que o PushEngage constrói e mantém. Não é uma parceria com o Expo.
- Não há um pacote Expo separado. Você instala o @pushengage/pushengage-react-native do npm.
- A documentação da API do PushEngage lista as builds de desenvolvimento do Expo como suportadas com configuração nativa manual, React Native puro como a configuração recomendada, e o Expo Go como não suportado.
- O código fonte do SDK é público no GitHub no repositório awesomemotive/pushengage-react-native sob a licença MIT.
Diretório de Parceiros PushEngage
Pronto para adicionar push ao seu aplicativo Expo? Comece com o guia de configuração.
O PushEngage tem um plano gratuito, então você pode instalá-lo e enviar sua primeira campanha antes de pagar qualquer coisa.