Plataforma de apps

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

  1. Instale o expo-dev-client e o pacote @pushengage/pushengage-react-native.
  2. Execute npx expo prebuild –clean para gerar as pastas ios e android.
  3. 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.
  4. 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.
  5. Crie um cliente de desenvolvimento com npx expo run:ios ou npx expo run:android, ou com um perfil de desenvolvimento EAS Build.
  6. 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.
  7. 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.