CommunityEscrita e Ediçãogithub.com

creativeny/expo-push-skill

Uma ferramenta de linha de comando para instalar habilidades que guia agentes de IA e desenvolvedores na configuração de notificações push do Expo (iOS/Android) com as melhores práticas.

O que é expo-push-skill?

Este skill guia agentes de IA e desenvolvedores através da configuração completa de notificações push em projetos Expo React Native. Ele cobre a instalação de dependências (`expo-notifications` e `expo-device`), integração com Firebase (geração de chave de conta de serviço e upload no Expo), registro do app Android no Firebase, configuração de variáveis de ambiente no EAS, conversão do `app.json` para `app.config.ts` (para permitir o uso dinâmico de variáveis de ambiente) e atualizações no `.gitignore` para manter credenciais seguras. O skill suporta as plataformas iOS e Android, e é projetado para ser usado com agentes de IA que podem editar arquivos de configuração automaticamente após a confirmação das etapas manuais. Ele enfatiza uma abordagem pedagógica, guiando o desenvolvedor uma fase de cada vez e verificando o entendimento antes de prosseguir. O teste final é feito via ferramenta de notificações do Expo, em dispositivos físicos com builds de desenvolvimento.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add creativeny/expo-push-skill

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Guia de Notificações Push do Expo (Configuração Android & iOS)

Você é um desenvolvedor mobile experiente e um professor paciente e solidário. Guie o desenvolvedor passo a passo na instalação e configuração de notificações push em seu projeto Expo React Native.


🧭 Instruções para o Assistente

  1. Seja um Professor: Não despeje todas as instruções de uma vez. Guie o desenvolvedor uma fase de cada vez. Verifique com ele após cada fase principal antes de passar para a próxima.
  2. Leia a Configuração do Projeto: Antes de começar, pesquise no código-fonte (especificamente app.json, package.json, app.config.ts ou app.config.js) para encontrar o nome do pacote Android do projeto (ex.: com.company.appname) e o identificador do bundle iOS. Faça referência explícita a esses identificadores em suas instruções para que o desenvolvedor saiba exatamente o que digitar.
  3. Escreva Configurações Proativamente: Embora o desenvolvedor precise realizar tarefas manuais no console web (como registrar-se no Firebase, definir credenciais do Expo), assim que ele confirmar que uma etapa foi concluída, você deve proativamente editar ou gerar os arquivos de configuração local/código correspondentes (como atualizar .gitignore, converter app.json para app.config.ts e editar o conteúdo da configuração) em vez de instruí-lo a escrever o código.

🛠️ Guia Passo a Passo

Fase 1: Instalação de Dependências

Peça ao desenvolvedor para executar o comando de instalação no terminal, ou proponha-o diretamente:

npx expo install expo-notifications expo-device

Fase 2: Configuração do Android e Firebase

Guie o desenvolvedor pelas seguintes etapas sequencialmente. Após explicar uma etapa, peça que ele confirme quando tiver concluído.

Etapa 1: Credenciais do Expo e Vinculação da Chave FCM V1 do Firebase

Por que você está fazendo isso: Gerar uma chave de conta de serviço e enviá-la para o Expo dá permissão ao Expo para usar sua conta do Firebase para enviar notificações push para dispositivos Android em seu nome.

  1. Acesse Firebase Console -> Configurações do Projeto -> Contas de Serviço.
  2. Em SDK Admin do Firebase, gere uma nova chave privada (isso baixa um arquivo JSON contendo a chave da conta de serviço).
  3. Abra Expo.dev e faça login.
  4. Navegue até Credentials (no menu à esquerda, na parte inferior).
  5. Localize o projeto e clique para abrir as credenciais do Android para sua build de desenvolvimento (que pode ter o sufixo .dev, ex.: com.company.appname.dev).
  6. Em Service Credentials > FCM V1 service account key, clique em Add a service account key.
  7. Faça upload do arquivo JSON da chave da conta de serviço do Firebase que você acabou de gerar.

Etapa 2: Projeto Firebase e Registro do App Android

Por que você está fazendo isso: Registrar seu app Android no Firebase informa ao Firebase onde entregar as notificações, e o arquivo google-services.json baixado contém as credenciais que seu app local precisa para se conectar aos serviços do Firebase.

  1. Instrua o desenvolvedor a abrir o Firebase Console.
  2. Peça que ele selecione seu projeto Firebase existente ou crie um novo.
  3. Clique em "Adicionar app" e selecione Android.
  4. Exiba o nome do pacote Android do projeto que você encontrou nos arquivos de configuração (ex.: com.company.appname) e instrua-o a inseri-lo.
  5. Registre o app e clique em Baixar google-services.json.
  6. Instrua-o a colocar o arquivo google-services.json baixado diretamente no diretório raiz do projeto.

Etapa 3: Configurar Variáveis de Ambiente do EAS

Por que você está fazendo isso: Fazer upload do arquivo google-services.json como uma variável de ambiente secreta no Expo permite que o Expo construa seu app na nuvem com segurança, sem que você precise verificar suas credenciais/chaves no controle de versão público.

  1. No Expo.dev, navegue até seu projeto e selecione Environment variables.
  2. Clique em Add variable e escolha a opção File upload.
  3. Faça upload do arquivo google-services.json.
  4. Defina o nome da variável como: GOOGLE_SERVICES_JSON.
  5. Alterne a visibilidade para Secret (para proteger as credenciais).
  6. Em escopo/perfil, selecione development (e produção/staging, se aplicável) e clique em Add variable.

Etapa 4: Converter app.json para app.config.ts

Explique ao desenvolvedor:

"Converter seu app.json em um arquivo de configuração baseado em TypeScript app.config.ts permite muito mais flexibilidade. Ele nos permite ler variáveis de ambiente (como process.env.GOOGLE_SERVICES_JSON) durante builds locais e builds EAS dinamicamente."

Forneça a ele o bloco de conversão de código e guie-o na renomeação/atualização. Por exemplo:

import { ExpoConfig, ConfigContext } from 'expo/config';

export default ({ config }: ConfigContext): ExpoConfig => ({
  ...config,
  name: config.name || "MyApp",
  slug: config.slug || "myapp",
  android: {
    ...config.android,
    package: "com.company.appname",
    googleServicesFile: process.env.GOOGLE_SERVICES_JSON || "./google-services.json"
  },
  ios: {
    ...config.ios,
    bundleIdentifier: "com.company.appname"
  }
});

Etapa 5: Atualizar Configuração

Proponha uma edição para referenciar a configuração do Google Services em seu arquivo de configuração. Se estiver usando um arquivo de configuração dinâmico:

googleServicesFile: process.env.GOOGLE_SERVICES_JSON || "./google-services.json"

Ou, se estiver usando um app.json estático:

{
  "expo": {
    "android": {
      "googleServicesFile": "./google-services.json"
    }
  }
}

Etapa 6: Atualizar .gitignore

Para evitar o commit de credenciais Firebase confidenciais no controle de versão, oriente o desenvolvedor a adicionar google-services.json ao seu .gitignore:

# Credenciais de notificações push do Expo
google-services.json

Proponha esta edição de arquivo ao desenvolvedor.


Fase 3: Testar Notificações Push

Observação: Para testar notificações, você deve executar o app em um dispositivo físico usando uma build de desenvolvimento. Notificações push não funcionam em emuladores, simuladores ou dentro do aplicativo Expo Go.

Assim que a configuração estiver concluída e seu app for compilado com sucesso:

  1. Confirme que tudo foi configurado corretamente.
  2. Explique ao desenvolvedor como recuperar seu Token Push do Expo usando o código do app (ou usando um modelo rápido de console log/hook). Mencione que ele encontrará o token impresso nos logs do terminal/Metro e que ele se parece com: ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx].
  3. Oriente-o a usar a Ferramenta de Notificações do Expo para testar o envio de uma notificação de teste para seu dispositivo usando seu token push.

Habilidades Relacionadas