Firebase Studio 一般
如何從 Firebase Studio 下載檔案?
如要以 ZIP 檔案格式下載檔案,請按照下列步驟操作:
在「檔案總管」窗格中,對任何目錄按一下滑鼠右鍵,然後選取「壓縮並下載」 。
如要下載專案目錄中的所有內容,請按照下列步驟操作:
依序選取「File」>「Open Folder」 。
接受預設的 /home/user
目錄。
檔案載入後,在工作目錄上按一下滑鼠右鍵,然後選取「壓縮並下載」 。如果使用 App Prototyping agent ,工作目錄會是 studio
。如果使用範本或上傳的專案,這就是專案名稱。
系統提示您重建環境時,請按一下「取消」 。
下載完成後,請從「檔案」 選單重新開啟工作目錄,返回工作區。
第三方 Cookie 未啟用。
開始使用前,您可能需要為瀏覽器啟用第三方 Cookie。Firebase Studio 需要大多數瀏覽器的第三方 Cookie,才能驗證工作區。
Chrome
開啟「設定」 。
開啟「隱私權和安全性」 分頁。
確認已啟用「允許所有 Cookie」 。
開啟 Firebase Studio 。
按一下網址列中的顯示狀態圖示 visibility_off ,開啟「追蹤保護」 面板。啟用「第三方 Cookie」 設定,暫時允許第三方 Cookie。這項設定會啟用 90 天的 Cookie。Firebase Studio
Safari
開啟「Safari」>「設定...」 。
關閉下列設定:
「進階」>「封鎖所有 Cookie」
「隱私權」>「防止跨網站追蹤」
開啟 Firebase Studio 。
Opera
開啟 Opera。
開啟選單,然後按一下「設定」 。
前往「隱私權與安全性」 部分,然後展開「第三方 Cookie」 選項。
選取「在無痕模式中封鎖第三方 Cookie」 或「允許第三方 Cookie」 。
開啟 Firebase Studio 。
為什麼需要啟用第三方 (3P) Cookie 才能使用 Firebase Studio ?
Firebase Studio 需要啟用第三方 Cookie,因為我們會在另一個網域 (studio.firebase.google.com
) 上,從一個網域 (cloudworkstations.dev
的子網域) 算繪 iframe,而第三方 Cookie 可確保跨來源通訊安全無虞。
開啟工作區時,系統顯示「無法將要求轉送至後端。系統會顯示「無法連線至通訊埠 80 上的伺服器」 。
等待約五秒,然後重新整理頁面。
預覽畫面無法載入,但我在程式碼中找不到任何問題。如何重新啟動 Firebase Studio ?
如果 Firebase Studio 無法正常重新整理 (通常是因為重大重構,或是環境 dev.nix
檔案發生變更),請開啟指令調色盤 (在 Mac 上按 Cmd+Shift+P
鍵,在 ChromeOS、Windows 或 Linux 上按 Ctrl+Shift+P
鍵),然後執行「Hard Restart」 指令。如果無效,請嘗試執行「Rebuild Environment」 指令。
我的工作區沒有回應,載入時只看到空白畫面
如果工作區沒有回應,可以嘗試重設 VM。現在說明一下操作方式:
依序點按 Firebase Studio 「更多」 ( more_horiz ) 選單和「重設」 。
系統提示時,再次按一下「重設」 。
重新開啟工作區。
建立工作區時,系統顯示「糟糕...我們需要啟動新的 VM」 訊息,且 UI 隨後停止回應。
Firebase Studio 會維護 VM 的暖集區,用於隨選佈建工作區。當集區資源不足時,系統會在啟動新的虛擬機器後,佈建工作區。這個程序可能需要一些時間 (有時最多五分鐘),但最終會成功。
[Errno 28] No space left on
device
如果磁碟空間已滿,可能會看到這則訊息。Firebase Studio 工作區提供:
Nix 套件 和 /tmp
的磁碟空間總計 100 GiB
/home
目錄 10 GiB
建立工作區時,我收到「發生內部錯誤」 訊息。
在大多數情況下,如果工作區佈建期間發生內部錯誤,只要稍候片刻後重新整理頁面,應該就能解決錯誤並進入工作區。
我之前在 Firebase Studio 中使用特定功能,但現在找不到該功能了。為什麼會遭到移除?
Firebase Studio 中的部分功能仍在實驗階段。我們很重視您的意見,並積極運用這些意見來規劃目前和未來的系列功能,定期移除不符合您或我們期望的功能。如果希望理想的 Firebase Studio 版本提供特定功能,請傳送意見回饋 。歡迎提供寶貴意見!
Firebase Studio 程式碼工作區
Firebase Studio 工作區的 Flutter 版本與我的專案不相容。
您幾乎可以升級或降級工作區中預先安裝的所有軟體版本,就像在本機上操作一樣 (使用 apt-get 或 brew)。您可以在工作區中升級或降級軟體,但已安裝的軟體不會在工作階段之間保留。建議您在 dev.nix 檔案中加入所有必要套件。
我們正積極改善 Flutter 版本管理功能。Firebase Studio
我與他人分享工作站網址,但對方無法查看。
只有具備工作區存取權的使用者,才能透過工作區網址存取工作區。
如果使用者沒有權限,嘗試造訪網址時會看到錯誤訊息。請務必明確與對方共用工作區 。
分享工作站時,協作者可以看到哪些內容?
新增至工作區的使用者可完整存取虛擬機器的整個檔案系統,其中可能包含儲存在磁碟上的私密金鑰和存取權權杖等機密檔案。請只與信任的人共用工作區。 雖然這種做法可讓其他使用者查看工作區的確切狀態,但他們會看到工作區中的所有內容。
我已共用工作區,為什麼協作者無法發布或監控我的應用程式?
新增至工作區的使用者可能沒有基礎 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 面板。
展開「Backend ports」(後端通訊埠) 部分,即可查看執行中的伺服器清單,包括通訊埠號碼和程序 ID (PID)。
按一下連接埠號碼左側的「設為公開」 圖示 (鎖頭)。
警告: 啟用公開存取權後,只要工作區處於有效狀態,網路上任何人都能存取您的連接埠,直到您明確關閉公開存取權為止。
按一下連接埠號碼右側的「複製網址」 圖示,即可複製其完整網址。
您現在可以直接參照這個網址 (例如透過前端的 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 產品。
Gemini
如何查看自動產生的 Gemini API 金鑰每分鐘要求配額?
您可以在 Google Cloud 控制台 的「Generative Language API Quotas and System Limits」(Generative Language API 配額與系統限制) 頁面,查看與自動產生的 API 金鑰相關聯的配額。
我收到錯誤訊息,指出已超出允許的權杖數量上限
專案中的資料量 (以「權杖」表示) 大於模型可接受的上限。如要解決這項錯誤,請調整程式碼集中的哪些檔案應對 Gemini 隱藏:
在工作區中,切換至
Code 檢視畫面。
建立 .aiexclude
檔案 。
加入 Gemini 應忽略的檔案或目錄,減少專案中的資料量。舉例來說,您可能想新增 .next/
和所有子目錄。路徑應與包含 .aiexclude
檔案的目錄相對:
.next/
請再次嘗試使用 Gemini 。如果仍收到有關超過權杖數上限的錯誤訊息,請嘗試將其他大型檔案或目錄新增至 .aiexclude
檔案。
應用程式原型設計代理程式
我無法建立專案
當您佈建 Gemini API 金鑰等資源或部署至 Firebase App Hosting 時,系統會根據 Firebase Studio 工作區的名稱,自動為您佈建專案。
如果收到「無法建立專案」錯誤訊息:
如要進一步瞭解 Firebase 和Google Cloud 專案,請參閱「瞭解 Firebase 專案 」一文。
無法建立 Cloud Billing 帳戶
佈建資源 (例如部署至 Firebase App Hosting ) 時,您可以選擇或建立 Cloud Billing 帳戶。
如果收到「無法建立 Cloud Billing 帳戶」錯誤訊息:
確認您有權建立 Cloud Billing 帳戶。
請檢查權限,或向管理員尋求協助。
如果收到「這個帳單帳戶的專案過多」錯誤訊息:
如要進一步瞭解如何建立帳戶,請參閱「建立新的自助式帳單帳戶 」。Cloud Billing
如果上述方法都無法解決問題,請洽詢Cloud Billing 支援團隊 。
為什麼 App Prototyping agent 沒有提供修正問題的選項?
應用程式原型設計代理 會偵測 Next.js 錯誤,並提供修正建議。如果收到錯誤訊息,但系統未提供修正方式,請複製問題文字並貼到即時通訊中。
為獲得最佳結果,請盡可能提供問題性質的相關資訊。
舉例來說,如果看到 Property access is undefined
on object. for 'list' @ L6
這類 Firebase 錯誤,表示 Cloud Firestore 規則有問題,請在錯誤訊息前加上「Can you help me fix this Cloud Firestore rules issue?」(可以幫我修正這個 Cloud Firestore 規則問題嗎?)。
發布後收到「無法發布應用程式」錯誤訊息
發布失敗時,系統通常會將可執行的錯誤記錄到 Cloud Build 記錄檔。如要偵錯及解決發布失敗問題,請按照下列步驟操作:
在「應用程式詳細資料」 頁面中 (如果已縮小,請按一下「發布」 來顯示),按一下「查看詳細資料」 。這會在 Firebase 控制台中開啟 App Hosting 。
在 Firebase 控制台App Hosting 頁面中,按一下「查看 Cloud Build 記錄」 。
這會開啟 Firebase 控制台,您可以在其中查看建構記錄並找出錯誤。
複製錯誤訊息,然後貼到工作區的 App Prototyping agent 或 Gemini 版 Firebase Chat 中,並要求 Gemini 修正錯誤。
如要驗證修正內容,請切換至「程式碼」 檢視畫面,開啟終端機並執行 npm
run build
。如果看到其他錯誤訊息,請再試一次。如果看到 FirebaseError
,請參閱「為什麼 App Prototyping agent 沒有提供修正問題的建議? 」。
建構成功後,請按一下 npm run start
開啟提供的 localhost 連結,並測試應用程式功能。您可以檢查終端機是否有任何執行階段錯誤。
如果一切順利,請在終端機中輸入 Ctrl-C
,停止在工作區中執行的生產環境封裝建構作業,然後再次嘗試App Hosting 發布流程。
我無法使用 App Prototyping agent 進行變更
如果 App Prototyping agent 無法完成要求的程式碼變更、還原至「應用程式藍圖」步驟,或反覆傳回錯誤訊息,指出發生問題:
重設 VM 。
如果重新開啟工作區後問題仍未解決,請在 /clear
App Prototyping agent 聊天室中輸入 /clear
。
注意: 這項指令會清除你的對話記錄,包括還原 至先前狀態的按鈕。
如果問題仍未解決,可以嘗試從舊版應用程式建立分支版本:
切換至「 」
Code 檢視畫面。
開啟「來源控制」 分頁。
在「Source Control Graph」中,按一下滑鼠右鍵選取較舊版本 >「Create Branch」 。輸入分支名稱。
返回Prototyper mode. If the agent still
doesn't respond or returns an error, try branching from an even earlier
version of your app.
如要在您建立的分支版本之間切換 (或返回主要分支版本),請點選 Code 檢視畫面左下角的分支版本名稱,然後選擇要使用的分支版本。