Skip to content

Firebase Studio 迁移指南 (Firebase Studio Migration)

Antigravity 是 Google 的下一代、Agent 优先平台。它旨在成为高速、自主开发工作流的主要阵地。Antigravity 不仅依赖于基于云端的网页编辑器,更是将 AI 的力量直接带入您的本地开发环境中。

为什么选择 Antigravity?

与 Firebase Studio 中基于网页的 Code(代码)视图相比,Antigravity 提供了显著的增强功能:

  • 本地环境控制:Antigravity 在您的机器上本地运行,这意味着您对文件系统、版本和终端拥有完全的控制权。
  • 真正的 Agent 导向开发:超越基础的代码补全。Antigravity 提供了 Agent 导向的开发工作流,能够自主地在您的整个代码库中进行格式化、测试和实现完整的任务。
  • 无缝的 Firebase 支持:您仍然可以轻松地将项目部署到 Firebase,通过 Firebase CLI 与 Firebase 服务进行通信,并像往常一样在本地测试您的 Functions 函数。

了解如何在 Antigravity 中进行导航

为了帮助您快速适应,以下是您可以在 Antigravity 中找到您喜爱的 Firebase Studio 功能对应位置的地方:

  • Cloud IDE Code 视图 (Cloud IDE Code view):享受熟悉的 VS Code 界面,但它搭载了 AI 增强并在您的硬件上本地运行。
  • Agent 聊天 (Agentic chat):您在 Firebase Studio 中使用的 AI 聊天现在已原生集成到您的 IDE 中,能够跨本地文件执行自主操作。
  • App Hosting 部署 (App Hosting deployments):您可以使用 Firebase CLI 或内置的 IDE 集成,继续无缝部署和管理您的 App Hosting URL。
  • 基于浏览器的模拟器 (Browser-based emulators):直接在您的机器上运行 Firebase 本地模拟器套件 (Firebase Local Emulator Suite),进行更快速的离线测试。

将您的 Firebase Studio 项目迁移到 Antigravity

Antigravity 是一款本地运行、Agent 优先的 IDE,它将 AI 的强大能力带入您的本地开发环境中。

前提条件

请确保您已在本地安装并完全更新了以下内容:

  • Google Antigravity IDE
  • Node.js(版本 20 或更高)
  • Firebase CLI(版本 15.10.0 或更高)

步骤 1:导出并初始化您的应用

选项 1:自动迁移

此工作流使用 Antigravity Agent 自主处理项目转换。

  1. 在 Firebase Studio 中,点击工作区顶部的“立即移动 (Move now)”按钮。
  2. 根据出现的窗口,遵循相应的导出方法:
    • 如果您看到“Zip and Download(压缩并下载)”按钮,请点击它。
    • 否则,请打开命令面板(Mac 上为 Cmd + Shift + P,ChromeOS、Windows 或 Linux 上为 Ctrl + Shift + P)并运行 Firebase Studio: Zip & Download 命令。
  3. 在本地解压该文件夹并在 Antigravity 中打开。
  4. 在 Antigravity 的 Agent 面板中,输入以下提示词。为了优化您的工作流并节省 token,我们建议选择 Gemini Flash 模型。它专为文件转换等大批量转换任务中的速度和效率而设计。
    @fbs-to-agy-export
    随后,Antigravity Agent 将开始项目迁移,并在过程中请求您的协助。请遵循 Agent 的引导以完成迁移过程。如果您遇到任何错误,请提示 Agent 重试。

[!NOTE] 如果未出现下载窗口,请检查浏览器的地址栏中是否有弹出窗口拦截器图标,并确保允许弹出窗口。

选项 2:手动导出

如果您希望自己管理迁移而不消耗 AI token,可以使用 Firebase CLI 手动导出项目。此方法更为直接,且不需要与 Agent 交互。

打开终端并运行以下命令,将 <path> 替换为您提取的项目文件夹或原始 .zip 文件的文件路径:

bash
npx firebase-tools@latest studio:export <path>

[!WARNING] studio:export 命令目前针对 Next.js、Flutter 和 Angular 工作空间进行了优化。虽然您也可以将此命令用于其他工作空间类型,但迁移可能无法完全成功。我们正在积极改进迁移流程。

步骤 2:预览您的应用

在提取项目并在 Antigravity 中打开后,您就可以在本地查看您的应用程序了:

  1. 在 Antigravity 中,导航到左侧边栏中的“运行和调试 (Run and Debug)”菜单。
  2. 点击播放按钮启动本地开发服务器。
  3. 按照终端中的指示预览您的应用。

[!TIP] 若要改进您的应用或排查问题,只需使用自然语言与 Agent 聊天即可。如果 Agent 面板被隐藏,点击窗口顶部的“切换 Agent (Toggle Agent)”图标即可重新打开。

步骤 3:发布您的应用

Antigravity 使用 Agent 技能,遵循 Firebase 最佳实践来发布您的应用。

  1. 在聊天面板中,输入以下提示词(只需指示 Agent):
    Publish my app
  2. 当系统提示运行 firebase deploy 时,选择“是 (Yes)”。如果您之前已发布到 App Hosting,Agent 会将其发布到您现有的 URL。如果这是您首次发布到 App Hosting,Agent 将引导您完成整个流程。
  3. 对于未来的更新,只需在 Antigravity 聊天面板中指示 Agent Publish my app 即可。

继续您的工作

您可以通过以下几种方式在 Antigravity 中继续您的开发:

  • 运行工作流:在 Antigravity 中,您可以通过在聊天面板中输入 @workflows <workflow_name> 来无缝执行工作流并与模型继续工作。
  • App Hosting 部署:您可以使用 Agent 技能直接通过 Agent 无缝部署应用,也可以使用跨平台的 Firebase CLI 和 GitHub 进行部署。
  • 疑难排查:如果您遇到部署问题,请尝试使用 Firebase CLI 重新进行身份验证,或验证您的项目 secrets 密钥。

感谢您成为 Firebase Studio 旅程的一部分。您的原型和反馈直接塑造了 Google 的 AI 工具,我们迫不及待想看到您接下来在 Antigravity 中构建的成果!

需要帮助吗?

请在我们的 GitHub Issues 中提交任何迁移相关的 bug。

Gemini中文文档