Visão geral do editor base

O Cloud Workstations vem com um editor de base padrão que permite escrever, criar, testar, depurar e executar seus aplicativos. O editor base é baseado no projeto de código aberto Code-OSS, oferece suporte a extensões de ambiente de desenvolvimento integrado fornecidas com o Open VSX Registry e vem com a extensão de ambiente de desenvolvimento integrado Cloud Code pré-instalada.

Para começar a usar o editor de base do Cloud Workstations:

  1. Siga as instruções do guia de início rápido para criar uma configuração de estação de trabalho. Quando solicitado a selecionar Personalização do ambiente, selecione Code OSS (padrão) como seu editor de código.
  2. Siga as instruções do guia de início rápido para criar uma estação de trabalho usando a configuração que você acabou de criar.

  3. No console do Google Cloud, acesse a página Estações de trabalho do Cloud para iniciar a estação de trabalho no navegador.

    Acessar o Cloud Workstations

Barra de atividades

A barra de atividades aparece ao lado, e você pode acessar as visualizações disponíveis no editor de base do Cloud Workstations. Estas são as visualizações da barra de atividades:

  • Explorador: confira as pastas e os arquivos no seu espaço de trabalho atual

  • Pesquisar: pesquise uma string ou uma expressão regular nos seus arquivos

  • Controle de origem: gerencie arquivos de aplicativos com o suporte ao Git do editor de base do Cloud Workstations

  • Depurar: depure o aplicativo definindo pontos de interrupção e inspecionando variáveis.

  • Extensões: pesquise em um catálogo de extensões que adicionam mais recursos ao ambiente de desenvolvimento integrado.

  • Cloud Code: crie e implante aplicativos do Google Cloud diretamente no ambiente de desenvolvimento integrado.

  • Configurações: personalize o editor de base do Cloud Workstations para se adequar ao seu fluxo de trabalho.

Acessar e editar arquivos

O editor de código integrado que permite navegar por diretórios de arquivos e visualizar e editar arquivos na estação de trabalho.

Para trabalhar com o editor básico, siga estas etapas:

  1. Use a Barra de atividades para alternar entre as visualizações.

  2. Use o Editor para acessar e editar seus arquivos.

  3. Use a visualização do Explorer para navegar pelos diretórios de arquivos, fazer upload e download de arquivos, visualizar aplicativos da Web em uma instância de máquina virtual do Cloud Workstations e conferir estatísticas de uso.

    Figura 1. Editor de base do Cloud Workstations

Fazer upload e download de arquivos e diretórios

Para fazer upload ou download de arquivos e diretórios na visualização do Code-OSS Explorer, use um dos seguintes métodos:

  • Arraste os arquivos para a visualização do Explorer e adicione ao espaço de trabalho.

  • Navegue até os arquivos e diretórios que você quer usar, clique com o botão direito do mouse e escolha Fazer upload ou Fazer o download.

    Figura 2. Clique com o botão direito do mouse na visualização do Explorer para fazer upload e download de arquivos

Suporte ao idioma

O editor base do Cloud Workstations oferece suporte a linguagens como Go, Python, Java, .NET Core e Node.js por extensões, fornecendo recursos de linguagem como:

  • Destaque inteligente, sugestões de código e conclusões baseadas em contexto
  • Como inspecionar e fornecer erros descritivos
  • Navegação de código (acesse definições, declarações, referências e implementações)
  • Compatibilidade de depuração intuitiva

Integração com o Cloud Code

O Cloud Code oferece suporte a ambiente de desenvolvimento integrado no ciclo de desenvolvimento completo dos aplicativos Kubernetes e Cloud Run, desde a criação e personalização de um novo aplicativo a partir de modelos de aplicativos até a execução do aplicativo finalizado. O Cloud Code também oferece suporte ao longo do tempo com amostras prontas para execução, snippets de configuração e uma experiência de depuração personalizada.

O Cloud Code se integra ao Gemini, um colaborador com tecnologia de IA, para simplificar o desenvolvimento. Use o Gemini para concluir tarefas de forma mais eficaz e eficiente.

O Cloud Code é compatível com o desenvolvimento de aplicativos em Node.js, Python, Java, Go e .NET Core.

Além do menu do Cloud Code disponível na barra de status do Cloud Workstations, também é possível acessar os comandos do Cloud Code pela paleta de comandos. Para abrir a paleta de comandos, pressione Ctrl + Shift + P (ou Command + Shift + P no macOS) ou clique em Ver > Paleta de comandos.

Suporte ao controle de versões

O editor de base do Cloud Workstations vem com controle de versão pré-configurado. É possível inicializar repositórios, diferenciar entre estados de arquivos, estágios, etapas e confirmar alterações. Também é possível usar repositórios públicos, particulares ou até mesmo autohospedados, desde que sejam acessíveis na estação de trabalho.

Gerenciamento do espaço de trabalho

Com o Cloud Workstations, é possível gerenciar e configurar seus projetos como espaços de trabalho. Os espaços de trabalho geralmente representam a pasta do projeto raiz, e com o editor de base do Cloud Workstations, é possível criar, abrir e salvar espaços de trabalho e personalizá-los com configurações específicas do projeto.

Para abrir uma pasta como um espaço de trabalho, use o menu na parte de cima da barra de atividades e selecione File > Open Folder. Como alternativa, use as opções Open File ou Recent Workspace na página de boas-vindas do editor básico ou use o parâmetro de URL folder para especificar o caminho da pasta que você quer abrir. Por exemplo, &folder=/home/user/foo.

Depurar aplicativos

As Cloud Workstations permitem depurar seu aplicativo, com suporte para aplicativos Go, Node.js, Python e Java. Você pode criar configurações de inicialização, definir pontos de interrupção e inspecionar variáveis, tudo no Cloud Workstations.

Além disso, é possível depurar aplicativos do Kubernetes em um cluster local, como o minikube ou o Docker Desktop, um cluster remoto no GKE ou em qualquer outro provedor do Cloud.

Terminal integrado

É possível interagir com o ambiente de desenvolvimento subjacente pelo terminal integrado. Use um dos seguintes métodos para ativar e desativar a visualização do terminal:

  • Pressione Control+.
  • Pressione Ctrl + Shift + P (ou Command + Shift + P no macOS) ou clique em Ver > Paleta de comandos e digite View: Toggle Terminal.
  • Selecione Terminal > Novo terminal.
  • Selecione Visualizar > Terminal.
  • Clique em AdicionarAdicionar na lista de guias do terminal.

Para abrir várias janelas de terminal, clique em Split ou pressione Control+Shift+5.

Editor de código das estações de trabalho
Figura 4. Interface do Cloud Workstations com o terminal aberto

Gerenciar e personalizar guias do terminal

Se você abrir vários terminais, uma lista de guias de terminal vai aparecer ao lado da visualização do terminal. Esta lista contém nomes de terminais abertos.

  • Quando você seleciona um nome de terminal na lista, os ícones Split e Delete são exibidos. Clique no ícone correspondente para dividir ou excluir uma janela do terminal.

  • Para conferir outras opções de terminal, como Mover terminal para a área do editor, Renomear, Mudar cor, Mudar ícone e muito mais, clique com o botão direito do mouse em um nome de terminal.

    Lista de guias do terminal
    Figura 5. Personalizar seu terminal

Rolar a tela

Além de usar o mouse enquanto o foco do navegador está em uma guia de sessão, você pode rolar a tela pressionando Control+Shift+PageUp e Control+Shift+PageDn no Windows e no Linux (ou Fn+Shift+Up e Fn+Shift+Down no macOS).

Personalizar configurações

Para personalizar o editor, a interface do usuário e o comportamento funcional, o editor de base do Cloud Workstations oferece os seguintes escopos para definir as configurações:

  • Configurações da máquina: configurações aplicadas globalmente quando você se conecta a uma instância virtual do Cloud Workstations e que aparecem na estação de trabalho no arquivo $HOME/.codeoss-cloudworkstations/data/Machine/settings.json.

  • Configurações do usuário: configurações aplicadas globalmente quando você se conecta a uma instância virtual do Cloud Workstations e que persistem no armazenamento do navegador para cada instância da estação de trabalho.

  • Configurações do espaço de trabalho: configurações armazenadas em um espaço de trabalho que são aplicadas somente ao abrir esse espaço. Essas configurações aparecem com seus arquivos de espaço de trabalho no arquivo $WORKSPACE_ROOT/.vscode/settings.json.

O editor avalia cada escopo de configurações.

Atalhos do teclado

Como o editor de base padrão é executado no navegador, alguns atalhos de teclado podem ser reservados pelo navegador e não capturados pelo editor.

Para oferecer suporte a todos os atalhos de teclado, o editor de base padrão inclui um app da Web progressivo (PWA, na sigla em inglês) que permite que o editor capture esses atalhos.

Para usar a PWA:

  1. Abra a Workstation no navegador.
  2. Clique no ícone de instalação que aparece na barra de endereço do navegador.

O PWA precisa ser instalado e a estação de trabalho ser reaberta no PWA. Em cargas subsequentes da estação de trabalho, o navegador apresenta uma opção para reabrir a estação de trabalho na PWA na barra de endereço.