PushEngage para React Native
Adicione notificações push e mensagens in-app a uma aplicação React Native no Android e iOS com o SDK PushEngage React Native. Um pacote npm com suporte TypeScript e JavaScript abrange ambas as plataformas, e as campanhas são executadas a partir do painel PushEngage.
O que pode fazer com React Native
Um pacote para Android e iOS
Uma única API JavaScript assenta sobre código nativo Swift e Kotlin, entregando através do Firebase Cloud Messaging no Android e do serviço Apple Push Notification no iOS.
Deep links e toques em cold-start
Um listener recebe o deep link e os dados da notificação quando uma notificação é tocada, e uma chamada separada retorna a notificação que iniciou a aplicação.
Permissão e subscrição numa única chamada
Solicitar permissão de notificação também subscreve o utilizador quando ele a permite, pelo que não há um passo de subscrição separado.
Segmentos, atributos e campanhas acionadas
Adicione subscritores a segmentos estáticos ou dinâmicos, defina atributos personalizados e envie eventos de gatilho, metas e alertas de queda de preço ou de inventário a partir de JavaScript.
Mensagens na aplicação
Mostre banners, modais e mensagens a ecrã inteiro desenhadas no painel. Não é necessária configuração no lado JavaScript depois de o SDK ter o seu App ID.
Fluxo de trabalho bare e builds de desenvolvimento Expo
Projetos React Native bare são totalmente suportados. Projetos Expo funcionam através de um build de desenvolvimento, abordado na página Expo deste diretório.
Como configurar
- Instale @pushengage/pushengage-react-native com npm ou yarn.
- Para Android, configure o Firebase Cloud Messaging e insira o seu Sender ID e Service Account JSON no PushEngage em Site Settings > Installation > Android SDK.
- Para iOS, adicione Push Notifications e Background Modes no Xcode, e carregue o seu certificado APNs no separador iOS SDK no PushEngage.
- Adicionar uma Extensão de Serviço de Notificação ao projeto iOS. Uma Extensão de Conteúdo de Notificação é opcional.
- Adicione a capacidade App Groups ao target principal da aplicação e à extensão.
- Inicialize o SDK com o seu App ID no índice root.js antes de a aplicação ser registada, e adicione as linhas PushEngage a AppDelegate.mm para iOS.
- Execute num dispositivo físico e envie um teste de Campaign > Push Broadcasts.
Guia completo: quickstart do React Native
Bom saber
- Push para aplicações e este SDK 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 SDK atual necessita de React Native 0.78 ou posterior com a Nova Arquitetura (Turbo Modules). A documentação aponta versões mais antigas do React Native para uma versão anterior do SDK.
- Android necessita de um projeto Firebase, e iOS necessita de uma conta de Desenvolvedor Apple com um ID de Aplicação e um certificado APNs.
- O SDK inclui código nativo, pelo que não funciona no Expo Go. Use um projeto bare ou um build de desenvolvimento Expo.
- A configuração nativa ainda é necessária em ambos os lados: Gradle e Firebase para Android, capacidades Xcode e uma Extensão de Serviço de Notificação para iOS.
- Se o build iOS falhar em @import com módulos C++ desativados, adicione -fcxx-modules a Other C++ Flags no Xcode.
Sobre esta ligação
- PushEngage constrói e mantém este SDK. Não é uma parceria com a Meta ou o projeto React Native.
- O código fonte está público no GitHub no repositório awesomemotive/pushengage-react-native sob a licença MIT.
- O pacote é publicado no npm sob o âmbito @pushengage.
- A PushEngage também publica Agent Skills de código aberto, para que um agente de codificação de IA como Claude Code ou Cursor possa executar a integração e diagnosticar uma configuração com falha.
Diretório de Parceiros PushEngage
Pronto para adicionar notificações push à sua aplicação React Native? 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.