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 自主处理项目转换。
- 在 Firebase Studio 中,点击工作区顶部的“立即移动 (Move now)”按钮。
- 根据出现的窗口,遵循相应的导出方法:
- 如果您看到“Zip and Download(压缩并下载)”按钮,请点击它。
- 否则,请打开命令面板(Mac 上为
Cmd + Shift + P,ChromeOS、Windows 或 Linux 上为Ctrl + Shift + P)并运行Firebase Studio: Zip & Download命令。
- 在本地解压该文件夹并在 Antigravity 中打开。
- 在 Antigravity 的 Agent 面板中,输入以下提示词。为了优化您的工作流并节省 token,我们建议选择 Gemini Flash 模型。它专为文件转换等大批量转换任务中的速度和效率而设计。随后,Antigravity Agent 将开始项目迁移,并在过程中请求您的协助。请遵循 Agent 的引导以完成迁移过程。如果您遇到任何错误,请提示 Agent 重试。
@fbs-to-agy-export
[!NOTE] 如果未出现下载窗口,请检查浏览器的地址栏中是否有弹出窗口拦截器图标,并确保允许弹出窗口。
选项 2:手动导出
如果您希望自己管理迁移而不消耗 AI token,可以使用 Firebase CLI 手动导出项目。此方法更为直接,且不需要与 Agent 交互。
打开终端并运行以下命令,将 <path> 替换为您提取的项目文件夹或原始 .zip 文件的文件路径:
npx firebase-tools@latest studio:export <path>[!WARNING]
studio:export命令目前针对 Next.js、Flutter 和 Angular 工作空间进行了优化。虽然您也可以将此命令用于其他工作空间类型,但迁移可能无法完全成功。我们正在积极改进迁移流程。
步骤 2:预览您的应用
在提取项目并在 Antigravity 中打开后,您就可以在本地查看您的应用程序了:
- 在 Antigravity 中,导航到左侧边栏中的“运行和调试 (Run and Debug)”菜单。
- 点击播放按钮启动本地开发服务器。
- 按照终端中的指示预览您的应用。
[!TIP] 若要改进您的应用或排查问题,只需使用自然语言与 Agent 聊天即可。如果 Agent 面板被隐藏,点击窗口顶部的“切换 Agent (Toggle Agent)”图标即可重新打开。
步骤 3:发布您的应用
Antigravity 使用 Agent 技能,遵循 Firebase 最佳实践来发布您的应用。
- 在聊天面板中,输入以下提示词(只需指示 Agent):
Publish my app - 当系统提示运行
firebase deploy时,选择“是 (Yes)”。如果您之前已发布到 App Hosting,Agent 会将其发布到您现有的 URL。如果这是您首次发布到 App Hosting,Agent 将引导您完成整个流程。 - 对于未来的更新,只需在 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 中文文档