Visão geral do editor base

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

Para começar a usar o editor básico 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 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 Cloud Workstations para iniciar a estação de trabalho no navegador.

    Acesse o Cloud Workstations

Barra de atividades

A barra de atividades aparece ao lado e é possível acessar as visualizações disponíveis no editor básico do Cloud Workstations. As visualizações da barra de atividades são as seguintes:

  • 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 do aplicativo com o suporte Git do editor básico do Cloud Workstations

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

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

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

  • Configurações: personalize o editor básico do Cloud Workstations para atender ao seu fluxo de trabalho

Acessar e editar arquivos

O editor de código integrado que permite navegar por diretórios de arquivos, além de 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 conferir e editar seus arquivos.

  3. Use a visualização 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 ver estatísticas de uso.

    Figura 1. Editor 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 explorador Code-OSS, use um dos seguintes métodos:

  • Arraste os arquivos até a visualização "Explorador" para adicioná-los 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 Explorador 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 meio de 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 (vá para 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 ao ambiente de desenvolvimento integrado em todo o ciclo de desenvolvimento dos aplicativos do Kubernetes e do Cloud Run, desde a criação e personalização de um novo aplicativo de amostra até a execução do aplicativo finalizado. O Cloud Code também oferece 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 realizar tarefas com mais eficácia e eficiência.

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 usando a paleta de comandos. Para abrir a paleta de comandos, pressione Control+Shift+P (ou Command+Shift+P no macOS) ou clique em View > Command Palette.

Suporte ao controle de versões

O editor básico do Cloud Workstations vem com controle de versão pré-configurado. É possível inicializar repositórios, diferenciar estados de arquivo e organizar, remover e confirmar alterações. Também é possível usar repositórios públicos, privados ou até mesmo auto-hospedados, desde que eles sejam acessíveis na estação de trabalho.

Gerenciamento do espaço de trabalho

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

Para abrir uma pasta como espaço de trabalho, use o menu na parte superior da barra de atividades e selecione Arquivo > Abrir pasta. Como alternativa, use as opções Abrir arquivo ou Espaço de trabalho recente 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

O Cloud Workstations permite depurar seu aplicativo com suporte a aplicativos Go, Node.js, Python e Java. É possível 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 qualquer outro provedor do Cloud.

Terminal integrado

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

  • Pressione Control+.
  • Pressione Control + Shift + P (ou Command + Shift + P no macOS) ou clique em View > Command Palette e digite View: Toggle Terminal.
  • Selecione Terminal > Novo Terminal.
  • Selecione Visualizar > Terminal.
  • Clique em addAdd 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 do Workstations
Figura 4. Interface do Cloud Workstations com o terminal aberto

Gerenciar e personalizar as guias do terminal

Se você abrir vários terminais, uma lista de guias do terminal será exibida na lateral da visualização. Essa lista contém os nomes dos terminais abertos.

  • Ao selecionar um nome de terminal na lista, os ícones Split e Delete são mostrados. Clique no ícone correspondente para dividir ou excluir uma janela de terminal.

  • Para ver mais opções do terminal, como Move Terminal into Editor Area, Rename, Change Color, Change Icon, entre outras, clique com o botão direito do mouse em um nome de terminal.

    Lista de guias do terminal
    Figura 5. Personalize 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 básico do Cloud Workstations oferece os seguintes escopos para definir as configurações:

  • Configurações da máquina: configurações que se aplicam 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 que se aplicam 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ó se aplica ao abrir esse espaço de trabalho. Essas configurações aparecem com seus arquivos do espaço de trabalho no arquivo $WORKSPACE_ROOT/.vscode/settings.json.

O editor avalia cada escopo de configurações, respectivamente.

Atalhos do teclado

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

Para oferecer suporte a todos os atalhos de teclado, o editor básico padrão inclui um Progressive Web App (PWA) que permite que o editor capture esses atalhos.

Para usar o PWA:

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

O PWA será instalado e a estação de trabalho será aberta novamente. Nos carregamentos subsequentes da estação de trabalho, o navegador apresenta uma opção para reabrir a estação de trabalho no PWA na barra de endereço.