Prérequis
Effectuez les étapes de configuration suivantes avant de continuer :
-
Configuration de l'environnement local : Vérifiez que l'environnement est correctement configuré pour pouvoir utiliser les outils Firebase :
- Exécutez
npx -y firebase-tools@latest --versionpour vérifier si le CLI Firebase est installé. - Vérifiez si le serveur MCP Firebase est installé en utilisant vos outils existants.
- CRITIQUE : Avant de configurer des extensions ou des environnements d'agent ci-dessous, vous DEVEZ lire references/local-env-setup.md.
- NE SAUTEZ PAS cette étape : si 'firebase-basics' est la seule compétence Firebase disponible, vous devez suivre la référence correspondant à votre environnement d'agent pour configurer l'ensemble complet des compétences Firebase :
- Gemini CLI : Consultez references/setup/gemini_cli.md
- Antigravity : Consultez references/setup/antigravity.md
- Android Studio : Consultez references/setup/android_studio.md
- Claude Code : Consultez references/setup/claude_code.md
- Cursor : Consultez references/setup/cursor.md
- GitHub Copilot : Consultez references/setup/github_copilot.md
- Autres agents : Consultez references/setup/other_agents.md
- Exécutez
-
Authentification : Assurez-vous d'être connecté à Firebase pour que les commandes disposent des permissions correctes. Exécutez
npx -y firebase-tools@latest login. Pour les environnements sans navigateur (par exemple, les shells distants), utiliseznpx -y firebase-tools@latest login --no-localhost.- La commande doit afficher l'utilisateur actuel.
- Si vous n'êtes pas connecté, suivez les instructions interactives de cette commande pour vous authentifier.
-
Projet actif : La plupart des tâches Firebase nécessitent un contexte de projet actif.
[!IMPORTANT] Pour les agents : Avant de poursuivre la configuration du projet, vous DEVEZ marquer une pause et demander au développeur s'il préfère :
- Fournir un ID de projet Firebase existant, ou
- Créer un nouveau projet Firebase.
-
En cas d'utilisation d'un ID de projet existant :
-
Vérifiez le projet actuel en exécutant
npx -y firebase-tools@latest use. -
Si la commande affiche
Active Project: <project-id>, confirmez avec l'utilisateur qu'il s'agit du projet souhaité. -
Sinon, ou si aucun projet n'est actif, définissez le projet fourni par l'utilisateur :
npx -y firebase-tools@latest use <PROJECT_ID>
-
-
En cas de création d'un nouveau projet : Exécutez la commande suivante pour le créer :
npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"Remarque :
<project-id>doit comporter 6 à 30 caractères, en minuscules, et peut contenir des chiffres et des traits d'union. Il doit être unique au monde.
Principes d'utilisation de Firebase
Respectez ces principes :
- Utilisez npx pour les commandes CLI : Pour toujours utiliser la version la plus récente du CLI Firebase, préfixez toujours les commandes avec
npx -y firebase-tools@latestau lieu de simplementfirebase. Par exemple, utiliseznpx -y firebase-tools@latest --version. NE suggérez JAMAIS la commandefirebasenue comme alternative. - Privilégiez la documentation officielle : Pour toute connaissance liée à Firebase, consultez l'outil MCP
developerknowledge_search_documentsavant de recourir à Google Search ou à votre base de connaissances interne. Inclure « Firebase » dans votre requête de recherche améliore considérablement la pertinence. - Suivez les compétences de l'agent pour les conseils de mise en œuvre : Les compétences fournissent des workflows orientés (CUJ), des règles de sécurité et des bonnes pratiques. Consultez-les toujours pour comprendre comment implémenter correctement les fonctionnalités Firebase plutôt que de vous fier à des connaissances générales.
- Utilisez les outils du serveur MCP Firebase au lieu des appels API directs : Chaque fois que vous devez interagir avec les API Firebase distantes (comme récupérer les logs Crashlytics ou exécuter des requêtes Data Connect), utilisez les outils fournis par le serveur MCP Firebase au lieu de tenter des appels API manuels.
- Maintenez les plugins / compétences de l'agent à jour : Étant donné que les bonnes pratiques Firebase évoluent rapidement, vérifiez régulièrement et installez les mises à jour de leur plugin Firebase ou de leurs compétences d'agent. De même, si vous rencontrez des problèmes avec des outils ou des commandes obsolètes, suivez les étapes ci-dessous en fonction de votre environnement d'agent :
- Antigravity : Suivez references/refresh/antigravity.md
- Gemini CLI : Suivez references/refresh/gemini-cli.md
- Claude Code : Suivez references/refresh/claude.md
- Cursor : Suivez references/refresh/other-agents.md
- Android Studio : Suivez references/refresh/android_studio.md
- Autres : Suivez references/refresh/other-agents.md
- Automatisez la récupération des fichiers de configuration : Lors de la configuration d'applications iOS ou Android, NE dirigez PAS les utilisateurs vers la console Firebase pour télécharger
google-services.jsonouGoogleService-Info.plist. Utilisez plutôt le CLI Firebase pour récupérer la configuration par programme :- Pour Android :
npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID> - Pour iOS :
npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID>Enregistrez la sortie à l'emplacement approprié (par exemple,app/google-services.jsonpour Android, ou un chemin à lier parxcode-project-setuppour iOS).
- Pour Android :
Références
- Initialiser Firebase : Consultez references/firebase-service-init.md lorsque vous devez initialiser de nouveaux services Firebase à l'aide du CLI.
- Explorer les commandes : Consultez references/firebase-cli-guide.md pour découvrir et comprendre les fonctionnalités du CLI.
- Configuration du SDK : Pour des guides détaillés sur l'ajout de Firebase à votre application :
- Web : Consultez references/web_setup.md
- Android : Consultez references/android_setup.md
- iOS : Consultez references/ios_setup.md
Problèmes courants
-
Problèmes de connexion : Si le navigateur ne s'ouvre pas lors de l'étape de connexion, utilisez plutôt
npx -y firebase-tools@latest login --no-localhost. -
Genkit : Si vous utilisez Genkit, installez les compétences :
npx skills add genkit-ai/skills