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 驅動的全端開發未來。根據您的意見回饋，我們將簡化工具，提供更清楚且強大的前進道路：

• 以程式碼為優先的代理式開發：我們著重於 Antigravity，這是新一代 IDE，專為高速自主本機工作流程而設計。

• 快速原型設計 (透過瀏覽器)：我們已將 Cloud Firestore 和 Firebase Authentication 直接整合至 Google AI Studio，讓您以最快的速度從提示詞生成內容，並投入正式版群組。

您的核心 Firebase 服務 (Cloud Firestore、Authentication、App Hosting 等) 不會受到影響。您的資料庫和使用者資料仍可繼續正常運作。這項淘汰措施僅適用於 Firebase Studio 開發環境。

日落時間軸

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

• 2026 年 3 月 19 日：發布停用公告，並開始向Firebase Studio推出遷移工具。
• 2026 年 6 月 22 日：停用建立新工作區的功能。您可以繼續在現有工作區中作業，並遷移這些工作區。
• 2027 年 3 月 22 日：Firebase Studio 服務終止，所有剩餘資料將永久刪除，無法復原。

選擇遷移路徑

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

遷移至 Google Antigravity

如要享有以程式碼為優先的代理程式開發體驗，建議遷移至 Antigravity。這是新一代 IDE，專為高速自主的本機工作流程而設計。如果符合下列任一條件，請選擇 Antigravity：

• 偏好在本機程式碼優先開發環境中工作，並對程式碼集有更深入的控制權
• 使用內建範本或在 Firebase Studio 中匯入存放區，建立應用程式
• 主要在 Firebase Studio 中使用程式碼檢視環境
• 想在功能強大的 IDE 中直接存取最先進的代理式 AI 開發功能，並支援使用 Claude 和 GPT-OSS 等不同模型，以及 Gemini
• 開始時間：Prototyper mode, but added significant features or execution scripts that require a local environment without cloud limitations

遷移至 Google AI Studio

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

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

將應用程式遷移至 Google AI Studio

Google AI Studio 可讓您以最快的速度，從提示詞生成完整的全端正式版應用程式。

步驟 1：轉移工作區

1. 按一下工作區頂端的「立即遷移」按鈕，然後選取「為 AI Studio 做好準備」。
2. 完成準備步驟後，請按一下「移至 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. 按一下「新增」，然後將 .env 檔案的內容貼到「金鑰」欄位，安全地將 Gemini API 金鑰儲存為環境變數。

2. 從 Google AI Studio 同步至 GitHub：

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

   3. 按一下「建立 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 中的「發布」按鈕：

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

將應用程式遷移至 Antigravity

Antigravity 是首重代理的本機 IDE，可將 AI 的強大功能帶進本機開發環境。

事前準備

確認您已在本機安裝下列軟體，且均為最新版本：

• Google Antigravity IDE
• Node.js (20 以上版本)
• Firebase CLI (15.10.0 以上版本)

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

npx firebase-tools@latest studio:export PATH

步驟 2：預覽應用程式

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

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

步驟 3：發布應用程式

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

1. 在對話面板中輸入下列提示：

   Publish my app
   

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

3. 如要取得後續更新，請在 Antigravity 聊天面板中指示代理程式 publish my app。

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

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

步驟 1：匯出專案來源

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

1. 按一下工作區頂端的「立即轉移」按鈕 >「壓縮並下載」。
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 檔案不包含代理程式即時通訊記錄。不過，您可以在工作區的 /home/user/.idx/ai 目錄中，找到 Firebase Studio 工作區內 Gemini、App Prototyping agent 和 Gemini Firebase 代理程式的即時通訊記錄檔案。這份記錄包含所有Gemini對話模式的提示和回覆。

如要建立含有記錄的 ZIP 檔案，請按照下列步驟操作：

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

適用對象：Prototyper sessions, you can also view your prompts as part of the git log. Here's how to locate them:

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

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 下載檔案？」一文中的指示操作。手動執行「壓縮並下載」指令。

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

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

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

遷移到 Google AI Studio 的應用程式在哪裡？

「您的應用程式」頁面會列出所有專案，包括在 Google AI Studio 中從頭建立的專案，以及您遷移的專案。

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

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

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

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

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

• 如果代理程式在執行工作期間停止運作，且沒有明確的錯誤訊息，請輸入「從上次停止的地方繼續」或「再次嘗試上一個步驟」等提示，通常就能重新啟動程序。
• 如果看到程式碼執行時發生錯誤的訊息，請按一下「修正」按鈕，讓代理程式自動解決問題。

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

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

如要確保遷移作業順利進行，請採取下列行動：

• 刪除 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社群論壇發文。