PushEngage para Expo
Utilize o PushEngage numa app Expo através do SDK PushEngage React Native e de uma build de desenvolvimento Expo. O Expo Go não é suportado, pois não consegue executar o código nativo do SDK.
O que pode fazer com o Expo
A mesma API que o React Native nativo
Uma vez que a build de desenvolvimento esteja implementada, a API JavaScript é idêntica a um projeto React Native nativo.
Conjunto completo de funcionalidades push numa build de desenvolvimento
O guia lista deep linking, segmentos e atributos, rastreamento de objetivos e campanhas de gatilho como suportados, além de notificações ricas assim que adicionar uma Extensão de Serviço de Notificação.
As ferramentas Expo continuam a funcionar
Após o prebuild, 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 as suas pastas nativas forem regeneradas a cada build, o guia inclui um plugin de configuração Expo local que pode copiar para reaplicar a chave do Grupo de Apps e a permissão de notificação Android.
Caminho de expo-notifications
O guia percorre a substituição do serviço push integrado do Expo: troque o pedido de permissão e os manipuladores de toque, e envie através da API REST 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 espaço de trabalho gerado no Xcode, adicione Notificações Push, Modos de Background com notificações Remotas e Grupos de Apps, depois 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 manifesto.
- 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 o seu ID de App em index.js antes da app ser registada, depois solicite a permissão de notificação na sua app.
- Crie a sua build de produção com o EAS Build.
Guia completo: PushEngage com Expo e fluxo de trabalho nativo
Bom saber
- Notificações push da app e o SDK React Native estão listados em todos os planos PushEngage, incluindo o plano gratuito. O rastreamento de objetivos, campanhas acionadas personalizadas e mensagens in-app necessitam de 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 num dispositivo físico, pois os simuladores não recebem notificações push.
- O Prebuild regenera as pastas nativas do zero. Faça commit das pastas ios e android, ou use um plugin de configuração, para que a sua configuração do PushEngage não se perca.
- As capacidades de Notificações Push e Modos em Segundo Plano necessitam de entitlements, pelo que um plugin de configuração sozinho não as pode definir. O guia sugere configurá-las uma vez no Xcode.
- O PushEngage não publica o seu próprio plugin de configuração do Expo. O que está no guia é um exemplo para copiar para o seu projeto.
Sobre esta ligação
- O suporte do Expo é fornecido 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 existe um pacote Expo separado. Instale o @pushengage/pushengage-react-native a partir do npm.
- A documentação da API do PushEngage lista as builds de desenvolvimento do Expo como suportadas com configuração nativa manual, o React Native bare como a configuração recomendada, e o Expo Go como não suportado.
- O código fonte do SDK está público no GitHub no repositório awesomemotive/pushengage-react-native sob a licença MIT.
Diretório de Parceiros PushEngage
Pronto para adicionar notificações push à sua aplicação Expo? Comece com o guia de configuração.
A PushEngage tem um plano gratuito, pelo que pode instalá-la e enviar a sua primeira campanha antes de pagar nada.