Prérequis
Effectuez ces étapes de configuration 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 que la CLI Firebase est installée. - Vérifiez si le serveur MCP Firebase est installé à l'aide de 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 à votre disposition, vous devez suivre la référence pour votre environnement d'agent afin de configurer la suite complète 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 autorisations 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 faire 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.
-
Si vous utilisez 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 prévu. -
Dans le cas contraire, ou si aucun projet n'est actif, définissez le projet fourni par l'utilisateur :
npx -y firebase-tools@latest use <PROJECT_ID>
-
-
Si vous créez 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 : Le
<project-id>doit comporter 6 à 30 caractères, en minuscules, et peut contenir des chiffres et des tirets. Il doit être globalement unique.
Principes d'utilisation de Firebase
Respectez ces principes :
- Utilisez npx pour les commandes CLI : Pour vous assurer d'utiliser toujours la dernière version de la CLI Firebase, faites toujours précéder les commandes de
npx -y firebase-tools@latestau lieu de simplementfirebase. Par exemple, utiliseznpx -y firebase-tools@latest --version. NE suggérez JAMAIS la commande nuefirebasecomme alternative. - Priorisez les connaissances officielles : Pour toute connaissance liée à Firebase, consultez l'outil MCP
developerknowledge_search_documentsavant de recourir à une recherche Google 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 d'implémentation : Les compétences fournissent des workflows (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 plutôt que des appels API directs : Chaque fois que vous avez besoin d'interagir avec les API Firebase distantes (comme la récupération des logs Crashlytics ou l'exécution de requêtes Data Connect), utilisez les outils fournis par le serveur MCP Firebase au lieu de tenter des appels API manuels.
- Maintenez à jour les plugins / compétences de l'agent : Comme les bonnes pratiques Firebase évoluent rapidement, vérifiez et installez régulièrement 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 la 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 de la CLI.
- Explorer les commandes : Consultez references/firebase-cli-guide.md pour découvrir et comprendre les fonctionnalités de la CLI.
- Configuration 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