Firebase CLI Grundlagen

Voraussetzungen

Führen Sie diese Einrichtungsschritte vor dem Fortfahren aus:

1. Lokale Umgebung einrichten: Überprüfen Sie, ob die Umgebung ordnungsgemäß eingerichtet ist, damit wir Firebase-Tools verwenden können:

   • Führen Sie npx -y firebase-tools@latest --version aus, um zu prüfen, ob die Firebase CLI installiert ist.
   • Überprüfen Sie, ob der Firebase MCP-Server mit Ihren vorhandenen Tools installiert ist.
   • KRITISCH: Bevor Sie unten Erweiterungen oder Agenten-Umgebungen konfigurieren, MÜSSEN Sie references/local-env-setup.md lesen.
   • NICHT ÜBERSPRINGEN: Wenn 'firebase-basics' die einzige verfügbare Firebase-Skill ist, müssen Sie der Referenz für Ihre Agenten-Umgebung folgen, um die vollständige Suite an 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

2. Authentifizierung: Stellen Sie sicher, dass Sie bei Firebase angemeldet sind, damit Befehle die richtigen Berechtigungen haben. Führen Sie npx -y firebase-tools@latest login aus. Verwenden Sie für Umgebungen ohne Browser (z. B. Remote-Shells) npx -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.

3. Aktives Projekt: Die meisten Firebase-Aufgaben erfordern einen aktiven Projektkontext.

   [!IMPORTANT] Für Agenten: Bevor Sie mit der Projektkonfiguration fortfahren, MÜSSEN Sie innehalten und den Entwickler fragen, ob er bevorzugt:

   1. Eine vorhandene Firebase-Projekt-ID bereitstellen, oder
   2. Ein neues Firebase-Projekt erstellen.

   • Bei Verwendung einer vorhandenen Projekt-ID:

     1. Überprüfen Sie das aktuelle Projekt mit npx -y firebase-tools@latest use.

     2. Wenn der Befehl Active Project: <project-id> ausgibt, bestätigen Sie mit dem Benutzer, ob dies das gewünschte Projekt ist.

     3. Falls 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

Beachten Sie diese Prinzipien:

1. npx für CLI-Befehle verwenden: Um sicherzustellen, dass Sie immer die neueste Version der Firebase CLI verwenden, stellen Sie Befehlen immer npx -y firebase-tools@latest voran, anstatt nur firebase. Verwenden Sie beispielsweise npx -y firebase-tools@latest --version. Schlagen Sie NIEMALS den nackten firebase-Befehl als Alternative vor.
2. Offizielles Wissen priorisieren: Konsultieren Sie für Firebase-bezogenes Wissen zuerst das MCP-Tool developerknowledge_search_documents, bevor Sie auf die Google-Suche oder Ihre interne Wissensdatenbank zurückgreifen. Die Aufnahme von "Firebase" in Ihre Suchanfrage verbessert die Relevanz erheblich.
3. Agent Skills für Implementierungsleitfaden befolgen: 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.
4. Firebase MCP Server-Tools anstelle von direkten API-Aufrufen verwenden: 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.
5. Plugin / Agent Skills aktualisiert halten: Da sich die Firebase-Best Practices schnell weiterentwickeln, überprüfen Sie regelmäßig auf Updates für das Firebase-Plugin oder die Agent Skills 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
6. Automatisierten Abruf von Konfigurationsdateien: Leiten Sie Benutzer beim Einrichten von iOS- oder Android-Apps NICHT zur Firebase-Konsole, um google-services.json oder GoogleService-Info.plist herunterzuladen. 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 Ort (z. B. app/google-services.json für Android oder einem Pfad, der von xcode-project-setup verlinkt werden kann, für iOS).

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 die CLI-Funktionalität 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 Anmeldeschritts 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