Cloud Code for VS Code 擴充功能可為 VS Code 新增 Google Cloud 開發支援功能。
事前準備
安裝 Cloud Code 前，請確認系統已安裝並設定下列工具：
- 在電腦上安裝並設定 Visual Studio Code。
安裝並設定語言支援。
Cloud Code 擴充功能最適合搭配下列語言使用：
安裝 Git。您必須使用 Git，才能將範例複製到電腦。
安裝 Docker 用戶端，並將其新增至
PATH環境變數：- 如果您只使用 Cloud Build 或 Jib 進行建構，可以略過安裝 Docker 的步驟。
- 如果您使用 Windows Home，請參閱 Windows Home 專用 Docker Desktop 指南，瞭解如何設定 Docker 用戶端。
- 如果您使用 WSL 但無法安裝 Docker for Desktop，請改用 minikube 搭配 Cloud Code 進行本機開發。
如果您使用的是 Google Cloud，請建立 Google Cloud 專案，然後啟用計費功能。
您可以透過專案將個別應用程式的相關資源收集在同一位置、管理 API、啟用 Google Cloud 服務、新增及移除協作者，以及管理 Google Cloud 資源的權限。
安裝 Cloud Code
從 Visual Studio Code Marketplace 安裝 Google Cloud Code 擴充功能。
或者，您也可以在 VS Code 中開啟「Extensions」檢視畫面：
按一下「擴充功能」
或按下 Ctrl/Cmd+Shift+X。搜尋
Google Cloud Code。
按一下 [安裝]。
如果系統提示，請重新啟動 VS Code。
擴充功能安裝完成後，Cloud Code 圖示會新增至活動列，即可使用。您可以使用頂層應用程式工具列指定偏好設定，進一步設定 Cloud Code 安裝：依序前往「Code」 >「Settings」 >「Settings」 >「Extensions」，然後搜尋
Gemini Code Assist + Google Cloud Code。
依附元件的自訂版本
根據預設，Cloud Code 會開啟「自動依附元件」，並自動安裝一些指令列依附元件。如果您關閉自動依附元件，可以使用自訂版本的依附元件，但必須自行安裝依附元件，才能讓 Cloud Code 運作。
如要使用自訂版本的 Cloud Code 依附元件，請按照下列步驟操作：
依序點選「設定」「管理」>「設定」，然後將「自動依附元件」(
cloudcode.autoDependencies) 設為off。在
PATH上安裝下列依附元件：
安裝 Google Cloud CLI
首次使用需要 gcloud CLI 的功能時，您可以選擇瞭解如何從 IDE 安裝 CLI、使用現有的安裝作業，或繼續使用受管理的依附元件。如果您想手動安裝 gcloud CLI，請參閱「安裝 gcloud CLI」。
選用：使用 VsixSignTool 驗證 Cloud Code vsix
如要使用 VsixSignTool 驗證 Cloud Code vsix，請執行下列步驟：
請確認你使用的是下列項目：
- Nuget 套件管理工具
- Windows 作業系統
- Cloud Code 的正式版本
安裝 Microsoft VsixSignTool，並記下安裝路徑。
開啟 VS Code，然後依序前往「Extensions」 >「Cloud Code」。
在「詳細資料」分頁的「擴充功能資源」下方，按一下「市集」。
在瀏覽器的市集頁面中，點選「資源」下方的「下載擴充功能」，即可下載 Cloud Code 的套件版本。這會將 Cloud Code 的套件版本 (具有
.vsix檔案副檔名) 下載至預設下載目錄。如果您想驗證非最新版本，請按一下「版本記錄」分頁，然後選取要下載的其他版本。
下載完成後，請開啟終端機視窗並執行以下指令：
PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX確認輸出內容是否符合下列內容：
VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.
驗證 Google Cloud的憑證
為協助您使用 Google Cloud API 開發應用程式，當您登入 gcloud CLI 時，系統會更新應用程式預設憑證。
登入 Google Cloud
如果您尚未登入 Google Cloud，請按照下列步驟操作：
- 在 Cloud Code 狀態列中，按一下「Cloud Code - Sign in」。
如果這是您在 IDE 中首次連線至 Google Cloud ，系統會提示您將
https://accounts.google.com新增至「信任的網域」。在隨即顯示的對話方塊中，按一下「Configure Trusted Domains」：
按照提示使用網路瀏覽器登入。
當系統提示您允許 Cloud Code 存取您的 Google 帳戶時，請按一下「允許」。
已知問題：Edge 瀏覽器在驗證回呼時會重新導向至 HTTPS
使用 Microsoft Edge 瀏覽器驗證憑證時，您可能會發現 Edge 瀏覽器會將網址 http://localhost:3000 重新導向至 https://localhost:3000。這會導致顯示以下失敗訊息：
The connection for this site is not secure. localhost sent an invalid response.
Try running Windows Network Diagnostics. ERR_SSL_PROTOCOL_ERROR.
如要解決這個問題，您可以從重新導向中排除 localhost：
在 Edge 瀏覽器的網址列中輸入
edge://net-internals/#hsts。前往「刪除網域安全性政策」部分。
輸入
localhost，然後按一下「刪除」。
登出 Google Cloud
- 按一下
「Cloud Code」，然後展開「說明與意見回饋」。 - 按一下「Sign Out of Google Cloud」，然後在系統提示時選取「Sign-out」。
- 或者，您也可以使用指令區塊登出。按下
Ctrl/Cmd+Shift+P鍵，或依序點選「View」 >「Command Palette」，然後點選「Sign out of all accounts in Google Cloud SDK」。
變更有效 Google Cloud 專案
在 Cloud Code 狀態列中，按一下目前專案名稱。
在隨即顯示的「Quick Pick」選單中，選取「sync_alt」sync_alt「Switch Project」。
選取專案，或在搜尋列中輸入關鍵字，即可篩選專案。
驗證憑證，以便在本機偵錯應用程式
除了「登入 Google Cloud」一節中的驗證步驟之外，您還需要驗證憑證，才能在 IDE 中對發出 Google API 呼叫的應用程式進行本機偵錯。
如果您未驗證應用程式偵錯憑證，當您嘗試執行/偵錯嘗試呼叫 Google API 的本機應用程式時，IDE 會顯示錯誤訊息。
如要驗證憑證，以便在本機上偵錯應用程式，請執行下列步驟：
如果尚未在機器上安裝 gcloud，請先完成這項作業。
執行下列指令：
gcloud auth application-default login在本機完成除錯後，您可以執行下列指令登出：
gcloud auth application-default revoke
如要進一步瞭解應用程式預設憑證和 Google API，請參閱「使用用戶端程式庫向 Cloud 服務進行驗證」。