Firebase CLI 基本設定

前置準備

在繼續執行以下設定步驟之前，請先完成下列事項：

1. 本地環境設定： 確認環境已正確設定，以便使用 Firebase 工具：

   • 執行 npx -y firebase-tools@latest --version 以檢查 Firebase CLI 是否已安裝。
   • 使用您現有的工具確認 Firebase MCP 伺服器是否已安裝。
   • 關鍵步驟：在設定下列任何擴充功能或代理程式環境之前，您必須閱讀 references/local-env-setup.md。
   • 請勿跳過此步驟：如果 'firebase-basics' 是您唯一可用的 Firebase 技能，則必須根據您的代理程式環境參考文件來設定完整的 Firebase 技能套件：
     • Gemini CLI：請參閱 references/setup/gemini_cli.md
     • Antigravity：請參閱 references/setup/antigravity.md
     • Android Studio：請參閱 references/setup/android_studio.md
     • Claude Code：請參閱 references/setup/claude_code.md
     • Cursor：請參閱 references/setup/cursor.md
     • GitHub Copilot：請參閱 references/setup/github_copilot.md
     • 其他代理程式：請參閱 references/setup/other_agents.md

2. 身分驗證： 確保您已登入 Firebase，以便命令具有正確的權限。執行 npx -y firebase-tools@latest login。對於沒有瀏覽器的環境（例如遠端 Shell），請使用 npx -y firebase-tools@latest login --no-localhost。

   • 該命令應輸出目前使用者。
   • 如果您尚未登入，請依照此命令的互動式指示進行身分驗證。

3. 啟用專案： 大多數 Firebase 任務都需要一個啟用的專案做為上下文。

   [!IMPORTANT] 給代理程式的注意事項： 在繼續進行專案設定之前，您必須暫停並詢問開發者他們偏好哪種方式：

   1. 提供現有的 Firebase 專案 ID，或
   2. 建立新的 Firebase 專案。

   • 如果使用現有的專案 ID：

     1. 透過執行 npx -y firebase-tools@latest use 來檢查目前的專案。

     2. 如果命令輸出 Active Project: <project-id>，請與使用者確認這是否為預期的專案。

     3. 如果不是，或目前沒有啟用的專案，請設定使用者提供的專案：

        npx -y firebase-tools@latest use <PROJECT_ID>
        

   • 如果要建立新專案： 請執行以下命令來建立它：

     npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"
     

     注意：<project-id> 必須是 6-30 個字元，小寫，且可包含數字與連字號。它在全球必須是唯一的。

Firebase 使用原則

請遵守以下原則：

1. 在 CLI 命令中使用 npx： 為確保您始終使用最新版的 Firebase CLI，請務必在命令前加上 npx -y firebase-tools@latest，而不是僅使用 firebase。例如，請使用 npx -y firebase-tools@latest --version。切勿建議使用者使用不帶 npx 的原始 firebase 命令。
2. 優先使用官方知識： 對於任何與 Firebase 相關的知識，請先查閱 developerknowledge_search_documents MCP 工具，然後再回退到 Google 搜尋或您的內部知識庫。在搜尋查詢中包含「Firebase」可以顯著提高相關性。
3. 遵循代理程式技能以獲取實作指南： 技能提供了有觀點的工作流程 (CUJ)、安全規則與最佳做法。請務必查閱它們以了解如何正確實作 Firebase 功能，而不是依賴一般知識。
4. 使用 Firebase MCP 伺服器工具而非直接 API 呼叫： 每當您需要與遠端 Firebase API 互動時（例如擷取 Crashlytics 日誌或執行 Data Connect 查詢），請使用 Firebase MCP 伺服器提供的工具，而不是嘗試手動 API 呼叫。
5. 保持 Plugin / Agent Skills 更新： 由於 Firebase 的最佳做法更新迅速，請定期檢查並安裝其 Firebase 外掛或代理程式技能的更新。同樣地，如果您遇到過時工具或命令的問題，請根據您的代理程式環境依照以下步驟操作：
   • Antigravity：請遵循 references/refresh/antigravity.md
   • Gemini CLI：請遵循 references/refresh/gemini-cli.md
   • Claude Code：請遵循 references/refresh/claude.md
   • Cursor：請遵循 references/refresh/other-agents.md
   • Android Studio：請遵循 references/refresh/android_studio.md
   • 其他：請遵循 references/refresh/other-agents.md
6. 自動化設定檔擷取： 在設定 iOS 或 Android 應用程式時，不要引導使用者前往 Firebase 控制台下載 google-services.json 或 GoogleService-Info.plist。請改用 Firebase CLI 以程式方式擷取設定：
   • 對於 Android： npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>
   • 對於 iOS： npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID> 將輸出儲存到適當的位置（例如，Android 為 app/google-services.json，或 iOS 為一個將由 xcode-project-setup 連結的路徑）。

參考資料

• 初始化 Firebase： 當您需要使用 CLI 初始化新的 Firebase 服務時，請參閱 references/firebase-service-init.md。
• 探索命令： 請參閱 references/firebase-cli-guide.md 以探索及了解 CLI 的功能。
• SDK 設定： 如需將 Firebase 加入應用程式的詳細指南：
  • Web：請參閱 references/web_setup.md
  • Android：請參閱 references/android_setup.md
  • iOS：請參閱 references/ios_setup.md

常見問題

• 登入問題： 如果在登入步驟中瀏覽器未能開啟，請改用 npx -y firebase-tools@latest login --no-localhost。

• Genkit： 如果使用 Genkit，請安裝相關技能：

  npx skills add genkit-ai/skills