firebase-basics

前提条件

在继续之前，请完成以下设置步骤：

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. 使用 npx 执行 CLI 命令： 为确保始终使用最新版本的 Firebase CLI，请始终在命令前加上 npx -y firebase-tools@latest，而不是仅使用 firebase。例如，使用 npx -y firebase-tools@latest --version。切勿建议使用裸 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. 保持插件/代理技能更新： 由于 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