Skip to main content

Usar espaços de código no Visual Studio Code

Você pode desenvolver seu codespace diretamente em Visual Studio Code, conectando a extensão de GitHub Codespaces à sua conta no GitHub Enterprise Cloud.

Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. Para obter mais informações, consulte os "produtos do GitHub".

Sobre Codespaces em Visual Studio Code

Você pode usar sua instalação local de Visual Studio Code para criar, gerenciar, trabalhar e excluir codespaces. Para usar Codespaces em VS Code, você deverá instalar a extensão de GitHub Codespaces. Para obter mais informações sobre a configuração de codespaces em VS Code, consulte "pré-requisitos".

Por padrão, se você criar um novo codespace em GitHub.com, ele será aberto no navegador. Se você preferir abrir qualquer codespace novo em VS Code automaticamente, você pode definir seu editor padrão como VS Code. Para obter mais informações, consulte "Definindo seu editor padrão para Codespaces".

Se você preferir trabalhar no navegador, mas deseja continuar usando suas extensões de VS Code temas e atalhos existentes, você poderá ativar as Configurações Sincronizadas. Para obter mais informações, consulte "Personalizar Codespaces para sua conta".

Pré-requisitos

Para desenvolver-se em uma plataforma de codespace diretamente em VS Code, você deverá instalar e efetuar o login na extensão GitHub Codespaces com as suas credenciais de GitHub Enterprise Cloud. A extensão de GitHub Codespaces exige a versão de outubro de 2020 1.51 ou posterior de VS Code.

Use o Visual Studio Code Marketplace para instalar a extensão GitHub Codespaces. Para obter mais informações, consulte Extensão do Marketplace na documentação do VS Code.

  1. Em VS Code, na barra lateral esquerda, clique no ícone Remote Explorer. O ícone do Remote Explorer em Visual Studio Code

  2. Clique em Iniciar sessão para visualizar GitHub....

    Registrar-se para visualizar Codespaces

  3. Para autorizar o VS Code a acessar sua conta no GitHub Enterprise Cloud, clique em Permitir.

  4. Registre-se e, GitHub Enterprise Cloud para aprovar a extensão.

  1. Em VS Code, na barra lateral esquerda, clique no ícone Remote Explorer. O ícone do Remote Explorer em Visual Studio Code

  2. Utilize o menu suspenso "EXPLORADOR REMOTO" e clique em GitHub Codespaces.

    Cabeçalho do Codespaces

  3. Clique em Iniciar sessão para visualizar Codespaces....

    Registrar-se para visualizar Codespaces

  4. Para autorizar o VS Code a acessar sua conta no GitHub Enterprise Cloud, clique em Permitir.

  5. Registre-se e, GitHub Enterprise Cloud para aprovar a extensão.

Criar um codespace em VS Code

After you connect your account on GitHub.com to the GitHub Codespaces extension, you can create a new codespace. For more information about the GitHub Codespaces extension, see the VS Code Marketplace marketplace.

Observação: Atualmente, VS Code não permite que você escolha uma configuração de contêiner de desenvolvimento ao cria um codespace. Se você quiser escolher uma configuração de contêiner de desenvolvimento específica, use a interface web do GitHub para criar o seu codespace. For more information, click the Web browser tab at the top of this page.

  1. Em VS Code, na barra lateral esquerda, clique no ícone Remote Explorer. O ícone do Remote Explorer em Visual Studio Code

  2. Click the Add icon: .

    A opção "Criar novo codespace" em Codespaces

  3. Type the name of the repository you want to develop in, then select it.

    Pesquisar um repositório para criar um novo Codespaces

  4. Clique no branch que você deseja desenvolver.

    Pesquisar um branch para criar um novo Codespaces

  5. Click the machine type you want to use.

    Tipos de instância para um novo Codespaces

    Observação: Your choice of available machine types may be limited by a policy configured for your organization, or by a minimum machine type specification for your repository. For more information, see "Restricting access to machine types" and "Setting a minimum specification for codespace machines."

Abrir um codespace em VS Code

  1. Em VS Code, na barra lateral esquerda, clique no ícone Remote Explorer. O ícone do Remote Explorer em Visual Studio Code

  2. Em "Codedespaces", clique no código que você deseja desenvolver.

  3. Clique no ícone Conectar-se ao Codespace.

    Ícone de conectar-se a um Codespace em VS Code

Alterar o tipo da máquina em VS Code

Typically, you can run your codespace on a choice of remote machine, from 2 cores to 32 cores. Cada uma delas tem um nível diferente de recursos e uma camada diferente de cobrança. For information, see "About billing for Codespaces."

By default the machine type with the lowest valid resources is used when you create a codespace. Você pode alterar o tipo de máquina do seu codespace a qualquer momento.

  1. Em VS Code, abra a Paleta de Comando (shift comando P / shift control P).

  2. Pesquise e selecione "Codespaces: Alterar tipo de máquina."

    Pesquisar um branch para criar um novo Codespaces

  3. Clique no codespace que você deseja alterar.

    Pesquisar um branch para criar um novo Codespaces

  4. Escolha o tipo de máquina que você quer usar.

    Observação: Your choice of available machine types may be limited by a policy configured for your organization, or by a minimum machine type specification for your repository. For more information, see "Restricting access to machine types" and "Setting a minimum specification for codespace machines."

  5. Se o codespace estiver sendo executado, será exibida uma mensagem perguntando se você deseja reiniciar e reconectar-se ao seu codespace agora.

    Clique em Sim se desejar mudar o tipo de máquina utilizado para este codespace imediatamente.

    Se você clicar em Não, ou se o código não estiver em execução, a alteração entrará em vigor na próxima vez que o codespace for reiniciado.

Excluir um codespace em VS Code

You can delete codespaces from within VS Code when you are not currently working in a codespace.

  1. Em VS Code, na barra lateral esquerda, clique no ícone Remote Explorer. O ícone do Remote Explorer em Visual Studio Code

  2. Under "GITHUB CODESPACES", right-click the codespace you want to delete.

  3. Click Delete Codespace.

    Excluir um codespace em GitHub

Alternando para a compilação de Insiders de VS Code

Você pode usar o Compilação de Insiders de VS Code dentro de Codespaces.

  1. Na parte inferior esquerda da sua janela Codespaces, selecione Configurações de .

  2. Na lista, selecione "Alternar para Versão de Insiders".

    Clicando em "Insiders Build" em Codespaces

  3. Uma vez selecionado, Codespaces continuará a abrir na Versão do Insiders.