Plataforma de aplicativos

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

  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 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.
  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 manifest.
  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 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.
  7. 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.