O editor github.dev baseado na web

Sobre o editor baseado na web

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

O editor baseado na web está disponível para todos gratuitamente em GitHub.com.

O editor baseado na web 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 a sincronização de configuração para compartilhar suas próprias configurações Visual Studio Code com o editor. Para obter mais informações, consulte "Sincronização de configurações" na documentação de Visual Studio Code.

O editor baseado na web é executado inteiramente no sandbox do seu navegador. O editor não clona o repositório, mas usa a Extensão de repositórios do GitHub para realizar a maior parte das funcionalidades 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.

Abrindo o editor baseado na web

Você pode abrir qualquer repositório de GitHub em editor baseado na web em qualquer uma das seguintes maneiras:

• Pressione . enquanto navega em qualquer repositório ou pull request no GitHub.
• Alterando a URL de "github.com" para "github.dev".

Codespaces e editor baseado na web

Tanto o editor baseado na web quanto o 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.

	editor baseado na web	Codespaces
Custo	Grátis.	Custos de computação e armazenamento. Para obter informações sobre os preços, consulte "Preços de codespaces"
Disponibilidade	Disponível para todos no GitHub.com.	Disponível para organizações que usam o GitHub Team ou GitHub Enterprise Cloud.
Inicialização	O editor baseado na web 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.	Ao criar ou retomar 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, consulte "Criando um codespace".
Calcular	Não há nenhum computador associado. Portanto você não conseguirá criar e executar o seu código ou usar o terminal integrado.	Com Codespaces, você obtém o poder da VM dedicada na qual você pode executar e depurar seu aplicativo.
Acesso ao terminal	Nenhum.	Codespaces fornece um conjunto comum de ferramentas por padrão, o que significa que você pode usar o Terminal exatamente como você faria no seu 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, consulte "Usando as extensões."	Com codespaces, você pode utilizar a maioria das extensões do Marketplace do Visual Studio Code.

Continue trabalhando em Codespaces

Você pode iniciar seu fluxo de trabalho em editor baseado na web e continuar trabalhando em um codespace, desde que você tenha acesso a Codespaces. 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 editor baseado na web.

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

Usando controle de origem

Ao usar o editor baseado na web, 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 Visualização de Controle de Origem, consulte "Controle de Versão" na documentação de Visual Studio 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 no GitHub" na documentação do Visual Studio Code.

Criar um branch

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 na barra de status e selecione Controle de origem.
2. Clique no nome do branch na barra de status.
3. No menu suspenso, clique no branch para o qual você deseja alternar ou digite o nome de um novo branch e clique em Criar novo branch. Quaisquer alterações não feitas no seu branch antigo estarão disponíveis no seu novo branch.

Faça commit das suas alterações

1. Na barra de atividade, clique na vista Controle de Origem.
2. Para testar suas alterações, clique + ao lado do arquivo que você alterou, ou ao lado de Alterações se você mudou vários arquivos e quiser testar todos.
3. Digite uma mensagem do commit que descreve a alteração que você fez.
4. Para fazer commit das alterações em fase de preparação, clique na marca de seleção na parte superior da barra lateral de controle de origem.
5. Depois de ter feito as commit das suas alterações, elas serão automaticamente enviadas para o seu branch em GitHub.

Criar um pull request

1. Depois de realizar alterações na sua cópia local do repositório, clique no ícone Criar Pull Request.
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 editor baseado na web para trabalhar com um pull request existente.

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

Usando extensões

O editor baseado na web é compatível com extensões de Visual Studio 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 funcionar na web, consulte "Extensões da web" na documentação de Visual Studio Code.

As extensões que podem ser executadas no editor baseado na web 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 informações, consulte "Sincronização de Configurações" na documentação de Visual Studio Code.

Solução de Problemas

Se você tiver problemas ao abrir editor baseado na web, 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 editor baseado na web.

Limitações conhecidas

• O editor baseado na web 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 atalhos de tecla estão documentadas na seção "Limitações e adaptações conhecidas" da documentação de Visual Studio Code.
• . pode não funcionar para abrir o editor baseado na web de acordo com o layout local do teclado. Nesse caso, você pode abrir qualquer repositório GitHub em editor baseado na web alterando o URL de github.com para github.dev.