Firebase Studio 疑難排解與常見問題

如何從 Firebase Studio 下載檔案？

如要將檔案下載為 ZIP 檔案，請按照下列步驟操作：

  • 在「Explorer」窗格中的任何目錄上按一下滑鼠右鍵，然後選取「Zip 及下載」。

如要下載專案目錄中的所有內容，請按照下列步驟操作：

  1. 依序選取「檔案」>「開啟資料夾」。

  2. 接受預設的 /home/user 目錄。

  3. 檔案載入後，請在工作目錄上按一下滑鼠右鍵，然後選取「壓縮並下載」。如果使用 App Prototyping agent，您的工作目錄會是 studio。如果使用範本或已上傳的專案，則這會是專案名稱。

  4. 系統提示您重建環境時，請按一下「取消」。

  5. 下載完成後，請從「File」選單重新開啟工作目錄，即可返回工作區。

未啟用第三方 Cookie。

開始使用前，您可能需要為瀏覽器啟用第三方 Cookie。Firebase Studio 需要在大多數瀏覽器中使用第三方 Cookie，才能驗證工作區。

ChromeSafariFirefoxOpera弧形Brave
  1. 開啟「設定」。
  2. 開啟「隱私權和安全性」分頁。
  3. 確認已啟用「允許所有 Cookie」。
  4. 開啟 Firebase Studio。
  5. 按一下網址列中的顯示圖示 visibility_off，開啟「追蹤防護」面板。開啟「第三方 Cookie」設定，暫時允許第三方 Cookie。這會在 Firebase Studio 上啟用 Cookie，有效期為 90 天。
  1. 開啟 Safari 並前往「設定」。
  2. 關閉下列設定：
    • 進階 > 封鎖所有 Cookie
    • 隱私權 > 防止跨網站追蹤
  3. 開啟 Firebase Studio。

您不需要為 Firefox 啟用第三方 Cookie。開啟 Firebase Studio。

  1. 開啟 Opera。
  2. 開啟選單，然後按一下「設定」。
  3. 前往「隱私權和安全性」部分，然後展開「第三方 Cookie」選項。
  4. 選取「在無痕模式中封鎖第三方 Cookie」或「允許第三方 Cookie」。
  5. 開啟 Firebase Studio。
  1. 前往 arc://settings。
  2. 前往「隱私權和安全性」部分，然後展開「第三方 Cookie」選項。
  3. 選取「在無痕模式中封鎖第三方 Cookie」或「允許第三方 Cookie」。
  4. 開啟 Firebase Studio。

您不需要為 Brave 啟用第三方 Cookie。開啟 Firebase Studio。

為什麼 Firebase Studio 需要啟用第三方 (3P) Cookie？

Firebase Studio 需要啟用第三方 Cookie，因為我們會在另一個網域 (studio.firebase.google.com) 中算繪來自一個網域 (cloudworkstations.dev 的子網域) 的 iframe，而第三方 Cookie 可啟用安全的跨來源通訊。

開啟工作區時，系統會顯示「無法將要求轉送至後端」訊息。畫面上會顯示「Couldn't connect to a server on port 80」。

請等候約五秒鐘，然後重新整理頁面。

如何查看自動產生 Gemini API 金鑰的每分鐘要求配額？

瞭解 Gemini API 的頻率限制和配額。

您可以在 Google Cloud 控制台的「生成式語言 API 配額和系統限制」頁面中，查看與自動產生 API 金鑰相關聯的配額。

預覽畫面無法載入，但我無法在程式碼中找到任何問題。如何重新啟動 Firebase Studio？

如果 Firebase Studio 無法正常重新整理 (通常是因為進行重大重構，或環境 dev.nix 檔案發生變更)，請開啟指令選單 (Mac 上的 Cmd+Shift+P，或 ChromeOS、Windows 或 Linux 上的 Ctrl+Shift+P)，然後執行 Hard Restart 指令。如果這個方法無效，請嘗試執行「Rebuild Environment」指令。

我的工作區無法回應，載入時只會顯示空白畫面

如果工作區未回應，您可以嘗試重設 VM。現在說明一下操作方式：

  1. 在 Firebase Studio 中，按一下「More」 ( more_horiz ) 選單，然後選取「Reset」。

  2. 系統顯示提示時，請再按一下「重設」。

  3. 重新開啟工作區。

建立工作區時，我看到「Whoops...We need to start a new VM」訊息，且 UI 在之後會停止運作。

Firebase Studio 會維護一組 VM 待命池，用於隨需佈建工作區。當集區資源不足時，系統會在啟動新的虛擬機器後佈建工作區。這項程序可能需要一些時間 (有時最多五分鐘)，但最終會成功。

建立工作區時，我收到「發生內部錯誤」。

在工作區佈建期間發生內部錯誤的大多數情況下，只要在約一分鐘後重新整理頁面，即可解決錯誤並進入工作區。

我可以建立多少個工作區？

Firebase Studio 免付費方案每位使用者最多只能建立三個工作區。加入 Google 開發人員計畫後，您最多可建立 10 個工作區。如要升級至 30 個工作區，請訂閱 Google 開發人員計畫 Premium。

工作區載入，但模擬器空白。

我們正積極改善雲端模擬器的可靠性。如果重新整理頁面無法解決問題，請向 Firebase 支援團隊回報問題。

Firebase Studio 工作區的 Flutter 版本與我的專案不相容。

您可以在工作區中升級或降級幾乎所有預先安裝的軟體版本，就像在本機電腦上 (使用 apt-get 或 brew) 一樣。您可以在工作區中升級或降級軟體，但已安裝的軟體不會在不同工作階段中保留。建議您在 dev.nix 檔案中加入所有必要套件。

我們正積極改善 Firebase Studio 中的 Flutter 版本管理功能。

我與他人分享工作站網址，但對方無法看到。

您只能將工作區網址分享給有權存取該工作區的使用者。沒有權限的使用者嘗試造訪網址時，會看到錯誤訊息。請務必明確與對方共用工作區。

當我分享工作站時，協作者可以看到什麼內容？

加入工作區的使用者可完全存取虛擬機器的整個檔案系統，其中可能包含私密金鑰和儲存在磁碟上的存取權權杖等敏感檔案。請務必只與信任的人共用工作區。雖然這種做法可讓其他使用者查看工作區的確切狀態，但也代表他們可以查看工作區中的所有內容。

我已分享工作區，為什麼協作者無法發布或監控我的應用程式？

您新增至工作區的使用者可能沒有底層 Firebase 專案的權限，而該專案支援「應用程式總覽」發布和監控功能。如要授予他們 Firebase 專案的權限，請參閱「Firebase 專案的權限和存取權」

我可以使用 Firebase Studio 沒有範本的架構來建構應用程式嗎？

當然可以！您可以自訂環境，以便在 Firebase Studio 中搭配使用任何架構或語言。

將 Flutter 應用程式發布至 Firebase Hosting 時，應選取哪個目標目錄？

選擇 build/web 目錄。這個目錄應包含 index.html，以及在應用程式成功建構 (透過 flutter build web) 後，用於轉譯網頁應用程式的所有靜態資產。

如何在工作區中設定應用程式的後端，讓前端能夠與其通訊？

您可以暫時公開後端伺服器執行的 TCP 連接埠，以便在不同工作區中分別開發前端和後端：

  1. 您可以手動在終端機中啟動後端或 API 伺服器，也可以在 dev.nix 檔案的預覽設定或 onStart 生命週期鉤子中啟動。

  2. 按一下活動列 (預設在左側) 中的 Firebase Studio 圖示，開啟 Firebase Studio 面板。

  3. 後端通訊埠

    展開「後端通訊埠」部分，即可查看執行中的伺服器清單，包括通訊埠號碼和程序 ID (PID)。

  4. 按一下 port 號碼左側的 鎖頭圖示的圖片「公開」圖示 (鎖頭)。

  5. 按一下連接埠號碼右側的 複製圖示的圖片「複製網址」圖示，即可複製完整的網址。

  6. 您現在可以從前端直接參照這個網址 (例如使用 fetch 呼叫)。

我關閉了預覽分頁。該如何還原？

使用 Ctrl+Shift+P (在 macOS 上為 Cmd-Shift-P) 開啟指令面板，然後選取「Firebase Studio: 顯示 Android 預覽畫面」或「Firebase Studio: 顯示網頁預覽畫面」。

什麼是 Code OSS？

Code-Open Source Software (Code-OSS) 是 VS Code 核心層的開放原始碼專案。Code-OSS 是根據標準 MIT 授權條款在 GitHub 上提供，也是 Microsoft 開發 VS Code 產品的地方。

如何避免程式碼完成作業和 Gemini 聊天提示用於訓練資料？

使用 Firebase Studio 時，必須遵守 Google 服務條款。

不過，請注意，您在 Firebase Studio 中使用生成式 AI 功能時，須遵守《生成式 AI 使用限制政策》和《Gemini API 附加服務條款》(具體而言，請遵守《Gemini API 附加服務條款：未付費服務》)。

如要禁止系統使用提示和回覆進行模型訓練，請勿使用 App Prototyping agent，也請勿在 Firebase Studio 中的 Firebase 中使用 Gemini。如要禁止使用程式碼進行模型訓練，請在 Firebase Studio 設定中關閉程式碼補全和程式碼索引。

如何針對遇到的問題提出功能要求或意見回饋？

如果您在使用 Firebase Studio 時遇到問題，或有功能要求，請與 Firebase 支援團隊聯絡。

我曾在 Firebase Studio 中使用特定功能，但現在找不到。為什麼會遭到移除？

Firebase Studio 中的部分功能仍在實驗階段。我們重視您的意見回饋，並積極運用這些意見來調整目前和未來的功能組合，並定期移除未達到您或我們期望的功能。如果您希望 Firebase Studio 的理想版本中提供某些功能，請提供意見回饋。歡迎提供寶貴意見！

我無法建立專案

當您佈建 Gemini API 金鑰或部署至 Firebase App Hosting 時，系統會根據 Firebase Studio 工作區名稱，為您自動佈建專案。如果您收到「Failed to create a project」(建立專案失敗) 錯誤，請確認工作區名稱中沒有特殊字元。Firebase 專案名稱只能使用英文字母、數字、引號、連字號、空格和驚嘆號。