Visão geral do editor base

O Cloud Workstations vem com um editor de base padrão que permite programar, criar, testar, depurar e executar seus aplicativos. O editor básico é baseado no projeto de código aberto Code-OSS, aceita 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 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 Código 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 recém-criada.

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

    Acessar 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. Essas visualizações da Barra de atividades são as seguintes:

  • Explorer: veja as pastas e arquivos no seu espaço de trabalho atual

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

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

  • Debug: depure seu app 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 base do Cloud Workstations para atender ao seu fluxo de trabalho

Ver e editar arquivos

o editor de código integrado que permite navegar pelos 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 atividade 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 ver 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 explorador Code-OSS, use um destes métodos:

  • Arraste os arquivos sobre a visualização Explorer 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 do Explorador para fazer upload e download de arquivos.

Suporte ao idioma

O editor de 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 (acessar 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 para todo o ciclo de desenvolvimento de aplicativos do Kubernetes e do Cloud Run, desde a criação e personalização de um novo aplicativo a partir de aplicativos de amostra até a execução do seu 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 de forma mais eficaz.

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 Ver > Paleta de comandos.

Suporte ao controle de versões

O editor de base do Cloud Workstations vem com controle de versões pré-configurado. É possível inicializar repositórios, diferenciar estados de arquivos, organizar, cancelar a preparação e confirmar alterações. Também é possível usar repositórios públicos, particulares ou até auto-hospedados, desde que os repositórios possam ser acessados 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 raiz do projeto e, com o editor base 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 um 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 base ou usar 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 o aplicativo com suporte para 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 de nuvem.

Terminal integrado

Você pode interagir com seu 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 Ver > Paleta de comandos e depois 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 guias do terminal

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

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

  • Para conferir outras opções do terminal, como Mover terminal para área do editor, Renomear, Alterar cor, Alterar ícone e muito mais, 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 pressionando Control+Shift+PageUp e Control+Shift+PageDn no Windows e no Linux (ou Fn+Shift+Up e Fn+Shift+Down no macOS).

Personalize as configurações

Para personalizar o editor, a interface do usuário e o comportamento funcional, o editor básico do Cloud Workstations fornece os seguintes escopos para definir 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 são mantidas no armazenamento do navegador para cada instância de estação de trabalho.

  • Configurações do espaço de trabalho: configurações armazenadas em um espaço de trabalho que só se aplicam quando você abre 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ção, respectivamente.

Atalhos do teclado

Como o editor básico 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 básico padrão agrupa um Progressive Web App (PWA) que permite que o editor capture esses atalhos.

Para usar o PWA:

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

O PWA será instalado e a estação de trabalho será reaberta no PWA. Em 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.