---
url: /antigravity/firebase-studio-migration.md
description: >-
  了解如何将您的 Firebase Studio 项目迁移到本地的 Google Antigravity，享受真正的 Agent 导向开发、本地环境控制和无缝
  Firebase 支持。
---

# 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。