Firebase Studio 疑難排解與常見問題
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
如何從 Firebase Studio 下載檔案?
如要將檔案下載為 ZIP 檔案,請按照下列步驟操作:
在「Explorer」窗格中的任何目錄上按一下滑鼠右鍵,然後選取「Zip 及下載」 。
如要下載專案目錄中的所有內容,請按照下列步驟操作:
依序選取「檔案」>「開啟資料夾」 。
接受預設的 /home/user
目錄。
檔案載入後,請在工作目錄上按一下滑鼠右鍵,然後選取「壓縮並下載」 。如果使用 App Prototyping agent ,您的工作目錄會是 studio
。如果使用範本或已上傳的專案,則這會是專案名稱。
系統提示您重建環境時,請按一下「取消」 。
下載完成後,請從「File」 選單重新開啟工作目錄,即可返回工作區。
未啟用第三方 Cookie。
開始使用前,您可能需要為瀏覽器啟用第三方 Cookie。Firebase Studio 需要在大多數瀏覽器中使用第三方 Cookie,才能驗證工作區。
Chrome
開啟「設定」 。
開啟「隱私權和安全性」 分頁。
確認已啟用「允許所有 Cookie」 。
開啟 Firebase Studio 。
按一下網址列中的顯示圖示 visibility_off ,開啟「追蹤防護 」面板。開啟「第三方 Cookie」 設定,暫時允許第三方 Cookie。這會在 Firebase Studio 上啟用 Cookie,有效期為 90 天。
Safari
開啟 Safari 並前往「設定」 。
關閉下列設定:
進階 > 封鎖所有 Cookie
隱私權 > 防止跨網站追蹤
開啟 Firebase Studio 。
Opera
開啟 Opera。
開啟選單,然後按一下「設定」 。
前往「隱私權和安全性」 部分,然後展開「第三方 Cookie」 選項。
選取「在無痕模式中封鎖第三方 Cookie」 或「允許第三方 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」 。
請等候約五秒鐘,然後重新整理頁面。
預覽畫面無法載入,但我無法在程式碼中找到任何問題。如何重新啟動 Firebase Studio ?
如果 Firebase Studio 無法正常重新整理 (通常是因為進行重大重構,或環境 dev.nix
檔案發生變更),請開啟指令選單 (Mac 上的 Cmd+Shift+P
,或 ChromeOS、Windows 或 Linux 上的 Ctrl+Shift+P
),然後執行 Hard Restart 指令。如果這個方法無效,請嘗試執行「Rebuild Environment」 指令。
建立工作區時,我看到「Whoops...We need to start a new VM」 訊息,且 UI 在之後會停止運作。
Firebase Studio 會維護一組 VM 待命池,用於隨需佈建工作區。當集區資源不足時,系統會在啟動新的虛擬機器後佈建工作區。這項程序可能需要一些時間 (有時最多五分鐘),但最終會成功。
建立工作區時,我收到「發生內部錯誤」 。
在工作區佈建期間發生內部錯誤的大多數情況下,只要在約一分鐘後重新整理頁面,即可解決錯誤並進入工作區。
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 連接埠,以便在不同工作區中分別開發前端和後端:
您可以手動在終端機中啟動後端或 API 伺服器,也可以在 dev.nix
檔案 的預覽設定或 onStart
生命週期鉤子中啟動。
按一下活動列 (預設在左側) 中的 Firebase Studio 圖示,開啟 Firebase Studio 面板。
展開「後端通訊埠」 部分,即可查看執行中的伺服器清單,包括通訊埠號碼和程序 ID (PID)。
按一下 port 號碼左側的 「公開」 圖示 (鎖頭)。
警告: 在工作區有效且您未明確關閉公開存取權之前,任何網際網路使用者都能存取您的端口。
按一下連接埠號碼右側的 「複製網址」 圖示,即可複製完整的網址。
您現在可以從前端直接參照這個網址 (例如使用 fetch
呼叫)。
注意: 如果您的前端是網頁瀏覽器,您可能需要在後端或 API 伺服器中啟用 CORS 支援功能 (例如,針對 Node.js 應用程式使用 cors
NPM 套件,或針對 Python Flask 應用程式使用 flask-cors
)。
我關閉了預覽分頁。該如何還原?
使用 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 產品的地方。
我曾在 Firebase Studio 中使用特定功能,但現在找不到。為什麼會遭到移除?
Firebase Studio 中的部分功能仍在實驗階段。我們重視您的意見回饋,並積極運用這些意見來調整目前和未來的功能組合,並定期移除未達到您或我們期望的功能。如果您希望 Firebase Studio 的理想版本中提供某些功能,請提供意見回饋 。歡迎提供寶貴意見!
我無法建立專案
當您佈建 Gemini API 金鑰或部署至 Firebase App Hosting 時,系統會根據 Firebase Studio 工作區名稱,為您自動佈建專案。如果您收到「Failed to create a project」(建立專案失敗) 錯誤,請確認工作區名稱中沒有特殊字元。Firebase 專案名稱只能使用英文字母、數字、引號、連字號、空格和驚嘆號。