--------------------------------------------------------

The Cloud Code extension for VS Code is a powerful tool that enables swift app development with Google Cloud integration. Before you start, make sure you have the necessary tools installed and set up on your system.

Prerequisites

Before installing Cloud Code, confirm that you have:

  • Visual Studio Code (VS Code) installed and configured
  • Language support installed for Swift or other programming languages of your choice
  • Git installed and set up on your machine
  • Docker client installed and added to the PATH environment variable (optional)
  • A Google Cloud project created and billing enabled (if using Google Cloud)

Installing Cloud Code

To install Cloud Code, follow these steps:

  1. Open the Extensions view in VS Code by clicking Extensions or pressing Ctrl/Cmd + Shift + X
  2. Search for "Google Cloud Code" in the Marketplace
  3. Click Install to download and install the extension
  4. If prompted, restart VS Code

Once installed, you'll see the Cloud Code icon added to your activity bar, ready for use.

Customizing Your Cloud Code Installation

By default, Cloud Code has Auto dependencies turned on. To customize your installation:

  1. Go to Code > Settings > Extensions and search for "Gemini Code Assist + Google Cloud Code"
  2. Set Auto Dependencies (cloudcode.autoDependencies) to off
  3. Install the required command-line dependencies manually

Verifying Cloud Code vsix using VsixSignTool

To verify the integrity of your Cloud Code installation:

  1. Install Nuget package manager and ensure you're on a production release of Cloud Code
  2. Download the packaged version of Cloud Code from the Marketplace (Resources > Download Extension)
  3. Run the following command in a terminal window:

`

PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX

`

Verify that the output matches: "VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid."

Authenticating Credentials for Google Cloud

To help with application development using Google Cloud APIs:

  1. Sign in to your Google Cloud account through the Cloud Code status bar
  2. Confirm your Application Default Credentials are updated

Known Issue: Edge Browser Redirects

When using Microsoft Edge browser, you may encounter a known issue where the URL http://localhost:3000 is redirected to https://localhost:3000. To resolve this:

  1. Open the Edge browser and navigate to edge://net-internals/#hsts
  2. Delete domain security policies for localhost

Signing Out of Google Cloud

To sign out of your Google Cloud account:

  1. Click Help and Feedback in the Cloud Code status bar
  2. Select Sign-out
  3. Alternatively, use the Command Palette: Press Ctrl/Cmd + Shift + P or click View > Command Palette, then select Sign out of all accounts in Google Cloud SDK

Changing the Active Google Cloud Project

To switch between Google Cloud projects:

  1. Click the active project name in the Cloud Code status bar
  2. Select "Switch Project" from the Quick Pick menu that appears
  3. Search for and select a new project or enter keywords to filter results

Authenticating Credentials for Debugging Applications Locally

To authenticate your credentials for debugging applications locally:

  1. Sign in to your Google Cloud account through the Cloud Code status bar (as above)
  2. Confirm your Application Default Credentials are updated
  3. If you encounter an error message when running/debugging a local application, follow the same sign-in steps as above