Voraussetzungen
Führen Sie diese Einrichtungsschritte durch, bevor Sie fortfahren:
-
Einrichtung der lokalen Umgebung: Überprüfen Sie, ob die Umgebung korrekt eingerichtet ist, damit wir Firebase-Tools nutzen können:
- Führen Sie
npx -y firebase-tools@latest --versionaus, um zu prüfen, ob die Firebase CLI installiert ist. - Überprüfen Sie mit Ihren vorhandenen Tools, ob der Firebase MCP Server installiert ist.
- WICHTIG: Bevor Sie unten Erweiterungen oder Agenten-Umgebungen konfigurieren, MÜSSEN Sie references/local-env-setup.md lesen.
- ÜBERSPRINGEN SIE DIESEN SCHRITT NICHT: Wenn 'firebase-basics' die einzige Ihnen verfügbare Firebase-Skill ist, müssen Sie der Referenz für Ihre Agenten-Umgebung folgen, um die vollständige Suite der Firebase-Skills einzurichten:
- Gemini CLI: Lesen Sie references/setup/gemini_cli.md
- Antigravity: Lesen Sie references/setup/antigravity.md
- Android Studio: Lesen Sie references/setup/android_studio.md
- Claude Code: Lesen Sie references/setup/claude_code.md
- Cursor: Lesen Sie references/setup/cursor.md
- GitHub Copilot: Lesen Sie references/setup/github_copilot.md
- Andere Agenten: Lesen Sie references/setup/other_agents.md
- Führen Sie
-
Authentifizierung: Stellen Sie sicher, dass Sie bei Firebase angemeldet sind, damit Befehle die korrekten Berechtigungen haben. Führen Sie
npx -y firebase-tools@latest loginaus. Für Umgebungen ohne Browser (z. B. Remote-Shells) verwenden Sienpx -y firebase-tools@latest login --no-localhost.- Der Befehl sollte den aktuellen Benutzer ausgeben.
- Wenn Sie nicht angemeldet sind, folgen Sie den interaktiven Anweisungen dieses Befehls zur Authentifizierung.
-
Aktives Projekt: Die meisten Firebase-Aufgaben erfordern einen aktiven Projektkontext.
[!WICHTIG] Für Agenten: Bevor Sie mit der Projektkonfiguration fortfahren, MÜSSEN Sie innehalten und den Entwickler fragen, ob er bevorzugt:
- Eine vorhandene Firebase-Projekt-ID bereitstellt, oder
- Ein neues Firebase-Projekt erstellt.
-
Bei Verwendung einer vorhandenen Projekt-ID:
-
Überprüfen Sie das aktuelle Projekt, indem Sie
npx -y firebase-tools@latest useausführen. -
Wenn der Befehl
Active Project: <project-id>ausgibt, bestätigen Sie mit dem Benutzer, ob dies das gewünschte Projekt ist. -
Wenn nicht oder wenn kein Projekt aktiv ist, setzen Sie das vom Benutzer bereitgestellte Projekt:
npx -y firebase-tools@latest use <PROJECT_ID>
-
-
Bei Erstellung eines neuen Projekts: Führen Sie den folgenden Befehl aus, um es zu erstellen:
npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"Hinweis: Die
<project-id>muss 6-30 Zeichen lang sein, Kleinbuchstaben enthalten und darf Ziffern und Bindestriche enthalten. Sie muss global eindeutig sein.
Firebase-Nutzungsprinzipien
Halten Sie sich an diese Prinzipien:
- Verwenden Sie npx für CLI-Befehle: Um sicherzustellen, dass Sie immer die neueste Version der Firebase CLI verwenden, stellen Sie Befehlen stets
npx -y firebase-tools@latestvoran, anstatt nurfirebase. Verwenden Sie beispielsweisenpx -y firebase-tools@latest --version. Schlagen Sie NIEMALS den nackten Befehlfirebaseals Alternative vor. - Offizielles Wissen priorisieren: Konsultieren Sie für Firebase-bezogenes Wissen zuerst das MCP-Tool
developerknowledge_search_documents, bevor Sie auf Google Search oder Ihre interne Wissensdatenbank zurückgreifen. Die Angabe von „Firebase“ in Ihrer Suchanfrage verbessert die Relevanz erheblich. - Befolgen Sie Agent Skills für Implementierungsrichtlinien: Skills bieten spezifische Workflows (CUJs), Sicherheitsregeln und Best Practices. Konsultieren Sie sie immer, um zu verstehen, wie Firebase-Funktionen korrekt implementiert werden, anstatt sich auf allgemeines Wissen zu verlassen.
- Verwenden Sie Firebase MCP Server-Tools anstelle direkter API-Aufrufe: Wenn Sie mit entfernten Firebase-APIs interagieren müssen (z. B. Abrufen von Crashlytics-Protokollen oder Ausführen von Data Connect-Abfragen), verwenden Sie die vom Firebase MCP Server bereitgestellten Tools, anstatt manuelle API-Aufrufe zu versuchen.
- Plugin / Agent Skills aktualisiert halten: Da sich Firebase-Best Practices schnell weiterentwickeln, überprüfen Sie regelmäßig, ob Updates für Ihr Firebase-Plugin oder Ihre Agent Skills verfügbar sind, und installieren Sie diese. Wenn Sie auf Probleme mit veralteten Tools oder Befehlen stoßen, befolgen Sie die folgenden Schritte basierend auf Ihrer Agenten-Umgebung:
- Antigravity: Befolgen Sie references/refresh/antigravity.md
- Gemini CLI: Befolgen Sie references/refresh/gemini-cli.md
- Claude Code: Befolgen Sie references/refresh/claude.md
- Cursor: Befolgen Sie references/refresh/other-agents.md
- Android Studio: Befolgen Sie references/refresh/android_studio.md
- Andere: Befolgen Sie references/refresh/other-agents.md
- Automatisieren Sie den Abruf von Konfigurationsdateien: Wenn Sie iOS- oder Android-Apps einrichten, leiten Sie Benutzer NICHT zur Firebase Console, um
google-services.jsonoderGoogleService-Info.plistherunterzuladen. Verwenden Sie stattdessen die Firebase CLI, um die Konfiguration programmatisch abzurufen:- Für Android:
npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID> - Für iOS:
npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID>Speichern Sie die Ausgabe am entsprechenden Speicherort (z. B.app/google-services.jsonfür Android oder einem Pfad, der vonxcode-project-setupfür iOS verlinkt wird).
- Für Android:
Referenzen
- Firebase initialisieren: Siehe references/firebase-service-init.md, wenn Sie neue Firebase-Dienste mit der CLI initialisieren müssen.
- Befehle erkunden: Siehe references/firebase-cli-guide.md, um CLI-Funktionalitäten zu entdecken und zu verstehen.
- SDK-Einrichtung: Für detaillierte Anleitungen zum Hinzufügen von Firebase zu Ihrer App:
- Web: Siehe references/web_setup.md
- Android: Siehe references/android_setup.md
- iOS: Siehe references/ios_setup.md
Häufige Probleme
-
Anmeldeprobleme: Wenn der Browser während des Anmeldevorgangs nicht geöffnet wird, verwenden Sie stattdessen
npx -y firebase-tools@latest login --no-localhost. -
Genkit: Wenn Sie Genkit verwenden, installieren Sie die Skills:
npx skills add genkit-ai/skills