Firebase Studio 終止服務和專案遷移

Firebase Studio 將於 2027 年 3 月 22 日停用。 我們將 Firebase Studio 預先發布版中學到的經驗，融入旗艦工具 Google AI Studio 和 Google Antigravity，簡化 AI 開發人員產品。

雖然建構應用程式的介面不斷演進，但我們對 Firebase 生態系統的承諾比以往更堅定。我們直接將代理功能整合至旗艦級 AI 平台，確保 Firebase 能持續為 AI 導向開發作業提供流暢可靠的後端。Cloud Firestore、Authentication 和 App Hosting 等核心 Firebase 服務，在 Firebase Studio 以外仍可繼續運作。

異動原因

Firebase Studio 推出預先發布版，探索 AI 輔助全端開發的未來。根據您的意見回饋，我們正在簡化工具，提供更清晰、更強大的發展路徑：

• 程式碼優先的 Agentic Workflows 開發：我們將重點放在 Antigravity，這是新一代平台，專為高速、自主的多代理工作流程設計。

• 快速在瀏覽器中設計原型：我們已將 Cloud Firestore 和 Firebase Authentication 直接整合至 Google AI Studio，提供從提示到正式環境的最快路徑。

Cloud Firestore、Authentication、App Hosting 等核心 Firebase 服務不受影響。資料庫和使用者資料仍會正常運作。這項淘汰作業僅適用於 Firebase Studio 開發環境。

停用時程

我們提供一年的過渡期，確保您有充裕的時間遷移專案：

• 2026 年 3 月 19 日：發布停用公告，並開始向Firebase Studio推出遷移工具。
• 2026 年 6 月 22 日：停用建立新工作區和使用者註冊功能。您可以繼續在現有工作區中工作，也可以遷移這些工作區。
• 2027 年 3 月 22 日：Firebase Studio 關閉，所有 剩餘資料都會永久刪除，無法復原。

選擇遷移路徑

請根據您使用 Firebase Studio 的方式，選擇最適合工作流程的遷移路徑。

遷移至 Google Antigravity

如要以程式碼優先的方式開發代理，建議遷移至 Antigravity。這是新一代的代理優先平台，專為高速、自主的工作流程和多代理自動調度管理而設計。如果您符合下列任一條件，請選擇Antigravity：

• 偏好在代理優先的桌面環境中工作，並使用 Antigravity IDE 或終端機，更深入控管程式碼集
• 使用內建範本或匯入的存放區在 Firebase Studio 中建立應用程式
• 主要使用 Firebase Studio 的程式碼檢視環境
• 希望在強大的代理中心，直接使用最先進的代理式 AI 開發功能，並支援使用 Claude 和 GPT-OSS 等不同模型，以及 Gemini
• 以Prototyper模式啟動，但新增了重要功能或執行指令碼，需要不受雲端限制的本機環境

遷移至 Google AI Studio

如要使用網頁式原型設計環境，在瀏覽器中運用 AI 的強大功能，建議遷移至 Google AI Studio。從提示到全端正式版應用程式， 是最快的途徑。如果您符合下列任一條件，建議 選擇 Google AI Studio：

• 偏好網頁式體驗，適合支援多種裝置的工作流程或無法安裝本機軟體的環境
• 使用 Firebase Studio 中的 App Prototyping agent 建立應用程式，並重視快速原型設計和提示式應用程式生成
• 想以最快速度從提示詞到正式版全端應用程式

將應用程式遷移至 Google AI Studio

Google AI Studio 提供最快的途徑，讓您從提示詞到全端正式版應用程式。

步驟 1：轉移工作區

1. 按一下工作區頂端的「立即移動」按鈕，然後選取「準備使用 AI Studio」。
2. 完成準備步驟後，按一下 「Move to」(移至 Google AI Studio)。
3. 如果系統要求，請詳閱並接受《服務條款》。程式碼會自動在新的 Google AI Studio 工作區中開啟。

Google AI Studio 可能需要幾分鐘才能轉換及載入應用程式，完成後會通知您。完成後，您可以繼續在 Google AI Studio 代理的協助下，反覆調整應用程式。進一步瞭解如何在 Google AI Studio 中建構應用程式。

步驟 2：選擇發布方式

請根據部署需求，以及是否要保留現有應用程式網址，選取下列其中一種發布方法。

選項 A：發布至 App Hosting 並保留現有網址

如果您先前透過 Firebase Studio 發布應用程式，且想保留 *.hosted.app 網址或自訂網域，請保護 Gemini API 金鑰，並使用 GitHub 同步功能：

1. 保護 Gemini API 金鑰：

   1. 在 Firebase 控制台中，前往「App Hosting」頁面。
   2. 找出現有的後端 (通常名為 studio)，然後按一下「查看」。
   3. 在「設定」分頁中，前往「環境」。

   4. 按一下「Add new」，然後將 .env 檔案的內容貼到「Key」欄位，將 Gemini API 金鑰安全地儲存為環境變數。

2. 從 Google AI Studio 同步至 GitHub：

   1. 在 Google AI Studio 中，按一下「Settings」(設定) 圖示，然後前往「GitHub」面板。
   2. 按一下「Sign in to GitHub」(登入 GitHub)，然後安裝 Google AI Studio GitHub 應用程式。

   3. 按一下「Create GitHub repository」(建立 GitHub 存放區)。

   4. 選取「暫存並修訂所有變更」。

3. 將存放區連結至 App Hosting：

   1. 在 Firebase 控制台中，前往「App Hosting」頁面。
   2. 找出現有的後端 (通常名為 studio)，然後按一下「查看」。
   3. 在「設定」分頁中，依序選取「部署」>「連結至 GitHub」。
   4. 登入 GitHub 並安裝 Firebase App Hosting GitHub 應用程式。
   5. 選取存放區，將分支版本設為 main，並將根目錄設為 /。
   6. 點選「儲存並部署」。

4. 將變更同步至 GitHub 並部署：

   1. 在 Google AI Studio 中，前往「GitHub」面板。
   2. 查看要發布的變更。
   3. 按一下「暫存並修訂所有變更」。
   4. 前往 Firebase 控制台，監控 App Hosting 部署作業的進度。

做法 B：移至 Cloud Run，並將應用程式發布至新網址

如果您偏好一鍵式體驗，且先前未發布應用程式，或不介意使用新網址 (*.run.app)，請使用 Google AI Studio 中的「Publish」(發布) 按鈕：

1. 在 Google AI Studio 中開啟應用程式，然後按一下「發布」。
2. 在專案選取器中，按一下「匯入專案」。
3. 搜尋並選取 Firebase Studio 使用的專案名稱 (位於 Firebase Studio 工作區的頂端導覽列)。
4. 依序點選「匯入」和「發布」。

將應用程式遷移至 Antigravity

Antigravity 是以代理為優先的本機平台和代理中心，可將自主多代理工作流程的功能，帶入本機開發環境。

必要條件

請確認您已在本機安裝下列項目，且均為最新版本：

• Google Antigravity IDE：從下載選項中選擇「Antigravity IDE」(編輯器環境)。這是以程式碼為優先的工作區，您可以在這裡開啟及執行遷移後的應用程式。
• Node.js (20 以上版本)
• Firebase CLI (15.10.0 以上版本)

步驟 1：匯出及初始化應用程式

npx firebase-tools@latest studio:export PATH

步驟 2：預覽應用程式

解壓縮專案並在 Antigravity IDE 中開啟後，您可以在本機查看應用程式：

1. 在 Antigravity IDE 中，前往左側欄的「Run and Debug」(執行與偵錯) 選單。
2. 按一下播放按鈕，啟動本機開發伺服器。
3. 按照終端機中的指示預覽應用程式。

步驟 3：發布應用程式

Antigravity 會運用代理程式技能，按照 Firebase 最佳做法發布應用程式。

1. 在代理對話面板，輸入下列提示詞：

   Publish my app
   

2. 系統提示執行 firebase deploy 時，請選擇「是」。如果先前已發布至 Firebase App Hosting，代理會發布至現有網址。如果這是您第一次發布至App Hosting，代理程式會引導您完成程序。

3. 如要更新，請在對話面板中指示代理publish my app。

將應用程式遷移至其他平台

如要將專案移至其他開發環境或託管平台，可以匯出原始碼並手動管理部署作業。

步驟 1：匯出專案來源

在服務終止日期前，請務必下載專案檔案的本機副本：

1. 按一下工作區頂端的「Move now」(立即移動) 按鈕 >「Zip and Download」(壓縮並下載)。
2. 將封存檔解壓縮至本機電腦。

步驟 2：選擇發布方式

程式碼儲存在本機後，您可以使用下列方法繼續提供應用程式：

• Firebase CLI (保留現有網址)

  1. 執行下列指令，使用 npm 安裝 Firebase CLI：

     npm install -g firebase-tools
     

  2. 在終端機中前往專案目錄。

  3. 執行下列指令，為本機專案設定 App Hosting 部署作業：

     firebase init apphosting
     

  4. 看到提示時，請選取「連結至現有後端」，然後選擇名為「studio」的後端。這樣一來，應用程式的網址就不會改變。

  5. 按照提示完成設定。您的 App Hosting 設定將新增至 firebase.json。

  6. 部署應用程式：

     firebase deploy
     

• 外部代管：匯出的程式碼是標準網頁應用程式，因此您可以使用任何代管服務供應商初始化。請注意，改用外部供應商會產生新的網址。

• 僅限本機開發：您可以繼續使用 Firebase Local Emulator Suite 在本機開發及測試應用程式，以便快速進行離線測試，而不必部署至實際環境。

疑難排解與常見問題

請參閱下列常見問題和疑難排解步驟，瞭解如何遷移 Firebase Studio 專案。

在停用前，我可以繼續使用 Firebase Studio 嗎？

可以，在 2027 年 3 月 22 日前，您都可以存取現有工作區。 我們會繼續提供重要的安全性修補程式和 Gemini 模型更新，確保您目前的專案保持穩定。請注意，自 2026 年 6 月 22 日起，您將無法建立新的工作區。

代理的對話記錄會遷移嗎？

目前的匯出 ZIP 檔案不含代理對話記錄。不過，您可以在 Firebase Studio 工作區的 /home/user/.idx/ai 目錄中，找到工作區內 App Prototyping agent 和 Gemini 代理的對話記錄檔案。這包含所有對話模式的提示和回覆。

建立含有記錄的 ZIP 檔案：

1. 依序選取「File」>「Open Folder」。
2. 接受預設的 /home/user 目錄。
3. 檔案載入後，在 .idx/ai 目錄上按一下滑鼠右鍵，然後選取「Zip and Download」(壓縮並下載)。
4. 系統提示您重建環境時，請按一下「Cancel」(取消)。
5. 下載完成後，請從「File」(檔案) 選單重新開啟目前使用的目錄，返回工作區。

如果是 Prototyper 工作階段，您也可以在 git 記錄中查看提示。找出這些資訊的方法如下：

1. 開啟「Code」(程式碼) 檢視畫面 ()。

2. 執行下列任一操作：

   • 開啟終端機工作階段 (Mac 上的 Cmd-Shift-C 或 ChromeOS、Windows 或 Linux 上的 Ctrl-Shift-C)，然後輸入 git log。
   • 開啟「Source Control」(Mac 上的 Cmd+Shift+G 或 ChromeOS、Windows 或 Linux 上的 Ctrl-Shift+G)，然後查看來源記錄。

我嘗試在 Firebase Studio 壓縮及下載檔案，但沒有任何反應。

這通常是瀏覽器的彈出式視窗攔截器所致。由於遷移流程會開啟新介面來處理要求，部分瀏覽器可能會將其標示為垃圾彈出式視窗。

如要解決這個問題，請在瀏覽器的網址列 (通常位於右側) 尋找「已封鎖彈出式視窗」通知。請按一下該圖示，然後選取允許彈出式視窗的選項，再試著按一下按鈕。

如果這個方法無效，請按照「如何從 Firebase Studio 下載檔案？」一文中的指示操作。手動執行 Zip and Download 指令。

我可以遷移與我共用的 Firebase Studio 工作區嗎？

只有建立 Firebase Studio 工作區的使用者，才能使用「Move now」(立即移動) 按鈕。如要取得專案副本，可以採取下列任一做法：

• 複製工作區：在自己的帳戶下建立專案副本，以便連結至自己的 Firebase 專案，並使用遷移工具。
• 手動匯出程式碼：在「程式碼檢視」中，開啟指令面板 (Mac 上的 Cmd+Shift+P 或 ChromeOS、Windows 或 Linux 上的 Ctrl+Shift+P)，然後執行 Firebase Studio：Zip & Download 指令。

哪裡可以找到已遷移至 Google AI Studio 的應用程式？

「Your apps」(您的應用程式) 頁面會提供 所有專案的統一清單，包括在 Google AI Studio 中從頭建立的專案，以及您遷移的任何專案。

遷移至 Google AI Studio 後，使用 Google 登入的 Firebase Authentication 無法運作。

如果應用程式使用 Google 登入功能，您必須授權新的專案網域。

1. 在 Firebase 控制台中，前往「 Authentication settings」(設定) 頁面。
2. 按一下「授權網域」。
3. 按一下「新增網域」，然後新增 Google AI Studio 應用程式的網域。

如果 Google AI Studio 代理程式停止運作，或遷移後 Google AI Studio 出現錯誤，該怎麼辦？

Google AI Studio 代理會在遷移應用程式時管理複雜的背景工作，因此有時可能會遇到「工作已取消」、重複訊息或執行緒沒有回應等問題。

• 如果代理在任務中途停止，且未顯示明確錯誤，請提供「從上次中斷的地方繼續」或「再次嘗試上一個步驟」等提示，通常就能重新啟動程序。
• 如果看到程式碼執行錯誤的訊息，請點選「Fix」(修正) 按鈕，提示代理自動解決問題。

如果匯出作業停滯或逾時，該怎麼辦？

如果遷移程序在準備檔案時停止運作，通常是因為專案資料夾過大。

為確保遷移作業順利進行，請採取下列做法：

• 刪除 node_modules：在遷移過程中，系統通常會移除這個資料夾。不過，如果您已重新命名或移動該檔案，或打算手動壓縮並下載程式碼，請在開始遷移前刪除該檔案。您不需要遷移這個資料夾，因為您可以在移至新環境後執行 npm install。
• 移除大型構件：刪除任何大型媒體檔案、資料庫匯出內容，或原始碼不一定需要的建構資料夾。
• 檢查「隱藏」的膨脹：請確認您未意外壓縮龐大的 .git 記錄或本機記錄。

刪除大型檔案後，請再次嘗試遷移專案。

為什麼我的 Firebase CLI 或 npx 指令在 Antigravity 終端機中失敗？

如果在 Antigravity 中執行 npx 指令時，遇到「找不到指令」錯誤或問題，但這些指令在標準系統終端機中可以正常運作，這可能是因為殼層環境的初始化方式。

Antigravity 的終端機環境會在 ~/.bash_profile 中尋找配置設定。許多開發人員會將 npx 和路徑設定儲存在 ~/.bashrc 中。如果未分享這些設定，Antigravity 就不知道該去哪裡尋找工具。

如要修正這個問題，請在 .bash_profile 中尋找 .bashrc 檔案。這樣可確保每次 Antigravity 啟動時，都會載入所有現有設定。

1. 在 Antigravity 中開啟 ~/.bash_profile 檔案。

2. 在檔案中新增下列程式碼區塊：

   if [ -f ~/.bashrc ]; then
       source ~/.bashrc
   fi
   

3. 儲存檔案。

4. 重新啟動 Antigravity。

其他資源

• 試用從 Firebase Studio 遷移至 Antigravity 的程式碼實驗室。
• 瀏覽 Antigravity 說明文件。
• 瀏覽 Google AI Studio 說明文件。

需要協助嗎？

如果您有任何問題、意見回饋，或在遷移專案時遇到任何問題，請透過下列任一管道與我們聯絡：

• 請與 Firebase 支援團隊聯絡。
• 在Firebase Studio社群論壇發文。