安裝 Cloud Code for VS Code 擴充功能

Cloud Code for VS Code 擴充功能可為 VS Code 新增 Google Cloud 開發支援。

事前準備

安裝 Cloud Code 前,請確認下列工具已安裝並設定完成:

  1. 在電腦上安裝並設定 Visual Studio Code
  2. 安裝並設定語言支援。

    Cloud Code 擴充功能最適合以下語言:

  3. 安裝 Git。 您必須使用 Git,才能將範例複製到電腦。

  4. 安裝 Docker 用戶端,然後將其新增至 PATH 環境變數:

    • 如果您只使用 Cloud Build 或 Jib 建構,可以略過安裝 Docker。
    • 如果您使用 WSL 但無法安裝 Docker Desktop,請改用 minikube 搭配 Cloud Code 進行本機開發。
  5. 如果您使用 Google Cloud,請建立 Google Cloud 專案,然後啟用計費功能

    專案可讓您將單一應用程式的所有相關資源收集在同一位置、管理 API、啟用 Google Cloud 服務、新增及移除協作者,以及管理 Google Cloud 資源的權限。

安裝 Cloud Code

從 Visual Studio Code Marketplace 安裝 Google Cloud Code 擴充功能

或者,您也可以在 VS Code 中開啟「Extensions」檢視畫面:

  1. 按一下 擴充功能圖示 「擴充功能」,或按下 Ctrl/Cmd+Shift+X

  2. 搜尋 Google Cloud Code

    VSC Marketplace 中的 Cloud Code 擴充功能

  3. 按一下 [安裝]

  4. 如果系統提示,請重新啟動 VS Code。

    擴充功能安裝完成後,活動列會新增 Cloud Code 圖示,即可開始使用。您可以使用頂層應用程式工作列指定偏好設定,進一步設定 Cloud Code 安裝作業:依序前往「Code」 >「Settings」 >「Settings」 >「Extensions」,然後搜尋 Gemini Code Assist + Google Cloud Code

自訂版本的依附元件

根據預設,Cloud Code 會開啟「自動依附元件」,並自動為您安裝部分指令列依附元件。如果關閉自動依附元件,您可以使用自訂版本的依附元件,但必須自行安裝依附元件,Cloud Code 才能運作。

如要使用自訂版本的 Cloud Code 依附元件,請按照下列步驟操作:

  1. 依序點選「設定」>「管理」>「設定」,然後將「自動依附元件」(cloudcode.autoDependencies) 設為 off

  2. PATH 上安裝下列依附元件:

安裝 Google Cloud CLI

首次使用需要 gcloud CLI 的功能時,系統會提供選項,讓您瞭解如何從 IDE 安裝 CLI、使用現有安裝項目,或繼續使用受管理依附元件。如要手動安裝 gcloud CLI,請參閱「安裝 gcloud CLI」。

選用:使用 VsixSignTool 驗證 Cloud Code vsix

如要使用 VsixSignTool 驗證 Cloud Code vsix,請按照下列步驟操作:

  1. 請確認你使用的是下列項目:

    • NuGet 套件管理員
    • Windows 作業系統
    • Cloud Code 的正式版
  2. 安裝 Microsoft VsixSignTool,並記下安裝路徑。

  3. 開啟 VS Code,然後依序前往「擴充功能」VSC 中的擴充功能圖示 >「Cloud Code」

  4. 在「詳細資料」分頁的「擴充功能資源」下方,按一下「Marketplace」

  5. 在瀏覽器的 Marketplace 頁面中,按一下「資源」下方的「下載擴充功能」,即可下載 Cloud Code 的封裝版本。系統會將 Cloud Code 的封裝版本 (副檔名為 .vsix) 下載到預設下載目錄。

  6. 如要驗證最新版本以外的版本,請按一下「版本記錄」分頁,然後選取要下載的其他版本。

  7. 下載完成後,開啟終端機視窗並執行下列指令:

    PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
    
  8. 確認輸出內容如下所示:

    VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

驗證「 Google Cloud」的憑證

為協助您使用 Google Cloud API 開發應用程式,登入 gcloud CLI 時,系統會更新應用程式預設憑證

登入 Google Cloud

如果尚未登入 Google Cloud,請按照下列步驟登入:

  1. 在 Cloud Code 狀態列中,按一下「Cloud Code - Sign in」
  2. 如果是首次在 IDE 中連線至 Google Cloud ,系統會提示您將 https://accounts.google.com 新增至信任的網域。在隨即顯示的對話方塊中,按一下「設定信任網域」

    「設定信任網域」對話方塊

  3. 按照畫面上的提示,使用網路瀏覽器登入帳戶。

  4. 系統提示您允許 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

  1. 在 Edge 瀏覽器的網址列中輸入 edge://net-internals/#hsts

  2. 前往「刪除網域安全性政策」部分。

  3. 輸入 localhost,然後按一下「刪除」

登出 Google Cloud

  1. 按一下 「Cloud Code」,然後展開「說明與意見回饋」
  2. 按一下「Sign Out of Google Cloud」(登出 Google Cloud),然後在系統提示時選取「Sign-out」(登出)
  3. 或者,您也可以使用指令區塊面板登出。按下 Ctrl/Cmd+Shift+P 鍵,或依序點選「View」(瀏覽) >「Command Palette」(指令面板),然後點選「Sign out of all accounts in Google Cloud SDK」(登出 Google Cloud SDK 中的所有帳戶)

變更有效 Google Cloud 專案

  1. 在 Cloud Code 狀態列中,按一下有效專案名稱。

    狀態列中的有效專案名稱

  2. 在隨即顯示的「快速挑選」選單中,選取「sync_alt」sync_alt「切換專案」

  3. 選取專案,或在搜尋列中輸入關鍵字來篩選專案。

驗證憑證,以便在本機對應用程式偵錯

除了「登入 Google Cloud」一節中的驗證步驟外,您還需要驗證憑證,才能在 IDE 中偵錯會發出 Google API 呼叫的本機應用程式。

如果您未驗證應用程式的偵錯憑證,嘗試執行/偵錯會呼叫 Google API 的本機應用程式時,IDE 會顯示錯誤訊息。

如要驗證憑證,以便在本機上對應用程式進行偵錯,請按照下列步驟操作:

  1. 如果尚未在電腦上安裝 gcloud,請先完成這項程序。

  2. 執行下列指令:

    gcloud auth application-default login
    
  3. 完成本機除錯後,您可以執行下列指令登出:

    gcloud auth application-default revoke
    

如要進一步瞭解應用程式預設憑證和 Google API,請參閱「使用用戶端程式庫向 Cloud 服務進行驗證」。

後續步驟

取得支援

如要提供意見,請前往 GitHub 回報問題,或在 Stack Overflow 上提問。