O editor github.dev baseado na web

Sobre o github.dev

O github.dev introduz uma experiência leve de edição, que é executada inteiramente no seu navegador. Com o github.dev, você pode navegar por arquivos e repositórios de código-fonte do GitHub, bem como efetuar e fazer commit das alterações de código. É possível abrir qualquer repositório, bifurcação ou pull request no editor.

O github.dev está disponível para todos gratuitamente em GitHub.com.

O github.dev fornece muitos dos benefícios de Visual Studio Code, como pesquisa, destaque de sintaxe e uma visão de controle de origem. Você também pode usar Sincronização de Configurações para compartilhar suas próprias configurações do VS Code com o editor. Para obter mais informações, consulte "Sincronização de Configurações" na documentação do VS Code.

O github.dev é executado inteiramente no sandbox do seu navegador. O editor não clona o repositório, mas usa a extensão Repositórios do GitHub para executar a maior parte da funcionalidade que você usará. Seu trabalho é salvo no armazenamento local do navegador até que você faça commit dele. Você deve fazer commit das alterações regularmente para garantir que estejam sempre acessíveis.

Você precisa estar conectado para usar o editor baseado na Web.

Abrir o github.dev

Você pode abrir qualquer repositório de GitHub em github.dev em qualquer uma das seguintes maneiras:

• Para abrir o repositório na mesma guia do navegador, pressione . enquanto navega em qualquer repositório ou solicitação de pull no GitHub.

  Para abrir o repositório em uma nova guia do navegador, pressione >.

• Alterando a URL de "github.com" para "github.dev".

• Ao exibir um arquivo, use o menu suspenso ao lado de e selecione Abrir no github.dev.

  

Codespaces e github.dev

Tanto o github.dev quanto o GitHub Codespaces permitem que você edite seu código diretamente do seu repositório. No entanto, ambos têm benefícios ligeiramente diferentes, dependendo da sua utilização.

	github.dev	GitHub Codespaces
Custo	Livre.	Cota mensal gratuita de uso para contas pessoais. Para obter mais informações sobre preços, confira "Sobre a cobrança dos GitHub Codespaces".
Disponibilidade	Disponível para todos no GitHub.com.	Disponível para todos no GitHub.com.
Inicialização	O github.dev abre instantaneamente com um toque de tecla e você pode começar a usá-lo imediatamente, sem ter que esperar por uma configuração ou instalação adicional.	Quando você cria ou retoma um codespace, o código é atribuído a uma VM e o contêiner é configurado com base no conteúdo de um arquivo devcontainer.json. Essa configuração pode levar alguns minutos para criar o ambiente. Para obter mais informações, confira "Como criar um codespace para um repositório".
Computação	Não há nenhum computador associado. Portanto você não conseguirá criar e executar o seu código ou usar o terminal integrado.	Com o GitHub Codespaces, você usufrui da alta eficiência de uma VM dedicada na qual pode executar e depurar seu aplicativo.
Acesso ao terminal	Nenhum.	O GitHub Codespaces fornece um conjunto comum de ferramentas por padrão, o que significa que você pode usar o Terminal exatamente como você faria no ambiente local.
Extensões	Apenas um subconjunto de extensões que podem ser executadas na web aparecerão na visualização de extensões e podem ser instaladas. Para obter mais informações, confira "Como usar extensões".	Com os GitHub Codespaces, você pode usar a maioria das extensões do Visual Studio Code Marketplace.

Continue trabalhando nos Codespaces

Você pode iniciar o fluxo de trabalho no github.dev e continuar trabalhando em um codespace. Se você tentar acessar a janela ou terminal Executar e Depurarl, você receberá uma mensagem de que eles não estão disponíveis em github.dev.

Para continuar seu trabalho em um codespace, clique em Continuar Trabalhando em… e selecione Criar Codespace para criar um codespace no branch atual. Antes de selecionar esta opção, você precisa fazer commit de quaisquer alterações.

Usando controle de origem

Ao usar o github.dev, todas as ações são gerenciadas por meio da Visualização de Controle de Origem, localizado na Barra de Atividades do lado esquerdo. Para obter mais informações sobre a Exibição de Controle do Código-Fonte, consulte "Controle de versão" na documentação do VS Code.

Como o editor da web usa a extensão dos repositórios do GitHub para melhorar suas funcionalidades, você pode alternar entre branches sem precisar ocultar alterações. Para obter mais informações, consulte "Repositórios do GitHub" na documentação do VS Code.

Criar uma nova ramificação

1. Se o branch atual não for mostrado na barra de status, na parte inferior do seu codespace, clique com o botão direito do mouse na barra de status e selecione Controle do código-fonte.
2. Clique no nome do branch na barra de status.
3. No menu suspenso, clique no branch para o qual deseja alternar ou insira o nome de um novo branch e clique em Criar branch. Todas as alterações sem commit feitas no branch antigo ficarão disponíveis no novo branch.

Confirmar as alterações

1. Na Barra de Atividades, clique na exibição Controle do Código-Fonte.
2. Para preparar as alterações, clique em + ao lado do arquivo que você alterou ou ao lado de Alterações se tiver alterado vários arquivos e quiser preparar todos eles.
3. Digite uma mensagem do commit que descreve a alteração que você fez.
4. Para fazer commit das alterações preparadas, clique na marca de seleção na parte superior da barra lateral do controle do código-fonte.
5. Depois de ter feito as commit das suas alterações, elas serão automaticamente enviadas para o seu branch em GitHub.

Criar uma solicitação de pull

1. Depois de fazer commit das alterações na cópia local do repositório, clique no ícone Criar Solicitação de Pull.
2. Verifique se o branch local e o repositório do qual você está fazendo merge, o branch remoto e o repositório no qual você está fazendo merge estão corretos. Em seguida, dê ao pull request um título e uma descrição.
3. Clique em Criar.

Trabalhando com um pull request existente

Você pode usar o github.dev para trabalhar com uma solicitação de pull existente.

1. Acesse a solicitação de pull que você gostaria de abrir em github.dev.
2. Pressione . para abrir a solicitação de pull no github.dev.
3. Depois de fazer alterações, faça commit delas usando as etapas descritas em Fazer commit das alterações. As suas alterações serão registradas diretamente no branch. Não é necessário fazer push das alterações.

Como usar extensões

O github.dev é compatível com as extensões do VS Code que foram especificamente criadas ou atualizadas para serem executadas na Web. Essas extensões são conhecidas como "extensões da web". Para saber como criar uma extensão da Web ou atualizar sua extensão existente para trabalhar na Web, consulte "Extensões da Web" na documentação do VS Code.

As extensões que podem ser executadas no github.dev aparecerão na vista de Extensões e poderão ser instaladas. Se você usar a Sincronização de Configurações, todas as extensões compatíveis também são instaladas automaticamente. Para obter mais informações, consulte "Sincronização de Configurações" na documentação do VS Code.

Solução de problemas

Se você tiver problemas ao abrir github.dev, tente o seguinte:

• Verifique se você está conectado a GitHub.
• Desabilita qualquer bloqueador de anúncios.
• Use uma janela não anônima no seu navegador para abrir o github.dev.

Limitações conhecidas

• O github.dev atualmente é compatível com o Chrome (e vários outros navegadores baseados no Chromium), Edge, Firefox e Safari. Recomendamos que você use as versões mais recentes desses navegadores.
• Algumas teclas de atalho podem não funcionar, dependendo do navegador que você estiver usando. Essas limitações de associação de teclas são documentadas na seção "Limitações e adaptações conhecidas" da documentação do VS Code.
• Talvez o . não funcione para abrir o github.dev de acordo com o layout local do teclado. Nesse caso, você pode abrir qualquer repositório do GitHub no github.dev alterando a URL de github.com para github.dev.