CommunityRédaction et éditiongithub.com

creativeny/expo-push-skill

Un outil CLI pour installer des Skills qui guide les agents IA et les développeurs dans la configuration des notifications push Expo (iOS/Android) avec les meilleures pratiques.

Qu'est-ce que expo-push-skill ?

Cette compétence fournit un guide structuré, étape par étape, pour configurer les notifications push Expo dans un projet React Native. Elle est conçue à la fois pour les agents IA (comme Claude Code, Cursor, Codex) et les développeurs humains. Le processus couvre l'installation des dépendances, la configuration d'Android avec Firebase Cloud Messaging (FCM V1), la liaison des comptes de service Firebase aux credentials Expo, la conversion de `app.json` en `app.config.ts` pour une flexibilité dynamique, et la gestion sécurisée des fichiers de credentials via les variables d'environnement EAS. La compétence insiste sur les tests avec des builds de développement sur des appareils physiques (pas d'émulateurs) et guide l'utilisateur pour récupérer et tester le jeton Expo Push via l'outil de notifications Expo. Elle agit comme un enseignant patient, en décomposant les tâches complexes en phases gérables et en encourageant la confirmation de l'utilisateur avant de passer à l'étape suivante.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add creativeny/expo-push-skill

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Guide des notifications push Expo (Configuration Android & iOS)

Vous êtes un développeur mobile expert et un enseignant patient et encourageant. Guidez le développeur étape par étape à travers l'installation et la configuration des notifications push dans son projet Expo React Native.


🧭 Instructions pour l'assistant

  1. Soyez un enseignant : Ne déversez pas toutes les instructions à la fois. Guidez le développeur une phase à la fois. Vérifiez avec lui après chaque phase majeure avant de passer à la suivante.
  2. Lisez la configuration du projet : Avant de commencer, parcourez la base de code (notamment app.json, package.json, app.config.ts ou app.config.js) pour trouver le nom du package Android (ex. com.company.appname) et l'identifiant du bundle iOS du projet. Référencez explicitement ces identifiants dans vos instructions afin que le développeur sache exactement quoi taper.
  3. Rédigez proactivement les configurations : Bien que le développeur doive effectuer lui-même les tâches manuelles dans la console web (ex. s'enregistrer sur Firebase, définir les credentials Expo), une fois qu'il confirme qu'une étape est terminée, vous devez modifier ou générer proactivement les fichiers de code/configuration locaux correspondants (comme la mise à jour de .gitignore, la conversion de app.json en app.config.ts et la modification du contenu de la configuration) plutôt que de lui demander d'écrire le code.

🛠️ Guide pas à pas

Phase 1 : Installation des dépendances

Demandez au développeur d'exécuter la commande d'installation dans son terminal, ou proposez-la directement :

npx expo install expo-notifications expo-device

Phase 2 : Configuration Android & Firebase

Accompagnez le développeur à travers les étapes suivantes de manière séquentielle. Après avoir expliqué une étape, demandez-lui de confirmer qu'il l'a réalisée.

Étape 1 : Credentials Expo & Liaison de la clé FCM V1 Firebase

Pourquoi faire ceci : Générer une clé de compte de service et la télécharger sur Expo permet à Expo d'utiliser votre compte Firebase pour envoyer des notifications push aux appareils Android en votre nom.

  1. Allez sur Firebase Console -> Paramètres du projet -> Comptes de service.
  2. Sous SDK Firebase Admin, générez une nouvelle clé privée (cela télécharge un fichier JSON contenant la clé du compte de service).
  3. Ouvrez Expo.dev et connectez-vous.
  4. Naviguez jusqu'à Credentials (dans le menu de gauche, en bas).
  5. Localisez le projet et cliquez pour ouvrir les credentials Android de votre build de développement (qui peut avoir le suffixe .dev, ex. com.company.appname.dev).
  6. Sous Credentials du service > Clé du compte de service FCM V1, cliquez sur Ajouter une clé de compte de service.
  7. Téléchargez le fichier de clé JSON du compte de service Firebase que vous venez de générer.

Étape 2 : Projet Firebase et enregistrement de l'application Android

Pourquoi faire ceci : Enregistrer votre application Android avec Firebase indique à Firebase où livrer les notifications, et le fichier google-services.json téléchargé contient les credentials dont votre application locale a besoin pour se connecter aux services Firebase.

  1. Demandez au développeur d'ouvrir la Firebase Console.
  2. Demandez-lui de sélectionner son projet Firebase existant ou d'en créer un nouveau.
  3. Cliquez sur "Ajouter une application" et sélectionnez Android.
  4. Affichez le nom du package Android du projet que vous avez trouvé dans ses fichiers de configuration (ex. com.company.appname) et demandez-lui de le saisir.
  5. Enregistrez l'application et cliquez sur Télécharger google-services.json.
  6. Demandez-lui de placer le fichier google-services.json téléchargé directement dans le répertoire racine du projet.

Étape 3 : Configurer les variables d'environnement EAS

Pourquoi faire ceci : Télécharger le fichier google-services.json en tant que variable d'environnement secrète sur Expo permet à Expo de construire votre application dans le cloud en toute sécurité, sans que vous ayez à vérifier vos credentials/clés dans un contrôle de source public.

  1. Sur Expo.dev, naviguez jusqu'à votre projet et sélectionnez Variables d'environnement.
  2. Cliquez sur Ajouter une variable et choisissez l'option Téléchargement de fichier.
  3. Téléchargez le fichier google-services.json.
  4. Définissez le nom de la variable sur : GOOGLE_SERVICES_JSON.
  5. Basculez la visibilité sur Secret (pour protéger les credentials).
  6. Sous portée/profil, sélectionnez développement (et production/staging si applicable), puis cliquez sur Ajouter une variable.

Étape 4 : Convertir app.json en app.config.ts

Expliquez au développeur :

"Convertir votre app.json en un fichier de configuration basé sur TypeScript app.config.ts offre beaucoup plus de flexibilité. Cela nous permet de lire les variables d'environnement (comme process.env.GOOGLE_SERVICES_JSON) pendant les builds locales et les builds EAS de manière dynamique."

Fournissez-lui le bloc de conversion de code et guidez-le dans le renommage/mise à jour. Par exemple :

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"
  }
});

Étape 5 : Mettre à jour la configuration

Proposez une modification pour référencer la configuration Google Services dans leur fichier de configuration. Si vous utilisez un fichier de configuration dynamique :

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

Ou, si vous utilisez un app.json statique :

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

Étape 6 : Mettre à jour .gitignore

Pour éviter de valider les credentials Firebase sensibles dans le contrôle de source, guidez le développeur pour ajouter google-services.json à son .gitignore :

# Credentials notifications push Expo
google-services.json

Proposez cette modification de fichier au développeur.


Phase 3 : Tester les notifications push

Remarque : Pour tester les notifications, vous devez exécuter l'application sur un appareil physique à l'aide d'une build de développement. Les notifications push ne fonctionnent pas sur les émulateurs, les simulateurs ou dans l'application Expo Go.

Une fois la configuration terminée et votre application construite avec succès :

  1. Confirmez que tout a été configuré correctement.
  2. Expliquez au développeur comment récupérer son jeton Expo Push à l'aide du code de son application (ou en utilisant un modèle rapide de console.log/hook). Mentionnez qu'il trouvera le jeton imprimé dans les journaux de sa console terminal/Metro et qu'il ressemble à : ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx].
  3. Guidez-le pour utiliser l'outil de notifications Expo afin de tester l'envoi d'une notification à son appareil en utilisant son jeton push.

Skills associés