Solução de problemas de clientes do GitHub Codespaces

Solução de problemas do cliente web do Visual Studio Code

Se você encontrar problemas ao usar GitHub Codespaces em um navegador que não seja baseado em Chromium, tente mudar para um navegador baseado em Chromium, como o Google Chrome ou o Microsoft Edge. Como alternativa, verifique problemas conhecidos do seu navegador no repositório, procurando por questões rotuladas com o nome do seu navegador, como ou .

Se você encontrar problemas ao usar GitHub Codespaces em um navegador baseado em Chromium, verifique se há outro problema conhecido com o VS Code no repositório .

Diferenças de trabalhar localmente no VS Code

Ao abrir um codespace no navegador usando o cliente Web do VS Code, você observará algumas diferenças em relação ao trabalho em um workspace local no aplicativo da área de trabalho do VS Code. Por exemplo, algumas teclas vinculadas serão diferentes ou estarão ausentes e algumas extensões poderão comportar-se de maneira diferente. Para ver um resumo, confira: Limitações conhecidas e adaptações na documentação do VS Code.

Verifique se há problemas conhecidos e registre novos problemas em log com a experiência do VS Code no repositório .

Visual Studio Code Insiders

O Visual Studio Code Insiders é a versão mais frequente do VS Code. Ela tem todos os recursos mais recentes e correções de erros, mas também pode ocasionalmente conter novos problemas que resultem em um build quebrado.

Se você estiver usando uma versão Insiders e perceber comportamentos anormais, recomendamos mudar para a versão estável do Visual Studio Code e tentar novamente.

Clique em no canto inferior esquerdo do editor e selecione Mudar para Versão Estável.... Se a versão da Web do VS Code não for carregada ou não estiver disponível, você pode forçar a mudança para o Visual Studio Code Estável adicionando à URL do codespace e carregando-o nessa URL.

Se o problema não for corrigido no Visual Studio Code Estável, verifique se há problemas conhecidos e, se necessário, registre um novo problema com a experiência do VS Code, no repositório .

Solução de problemas do Simple Browser

Quando você iniciar um aplicativo Web em um codespace, poderá visualizá-lo em execução no Simple Browser inserido em VS Code. Em alguns projetos, o aplicativo é aberto automaticamente em uma guia do Simple Browser no editor quando o aplicativo é iniciado. Isso acontece quando, no arquivo de configuração devcontainer.json do codespace, a propriedade onAutoForward da porta em que o aplicativo é executado está definida como openPreview.

"portsAttributes": {
  "3000": {
    "label": "Application",
    "onAutoForward": "openPreview"
  }
}

Se a guia do Simple Browser não abrir automaticamente, você poderá abri-lo manualmente para ver o aplicativo.

1. Em VS Code, clique na guia Portas.

2. Clique com o botão direito do mouse na porta e clique em Visualizar no Editor.

   

A guia Simple Browser não é aberta automaticamente

Se o arquivo de configuração devcontainer.json especificar "onAutoForward": "openPreview" para uma porta, mas o Simple Browser não abrir automaticamente quando um aplicativo for iniciado, verifique se o aplicativo foi iniciado na porta especificada na configuração. O aplicativo poderá iniciar em uma porta diferente se a porta pretendida estiver ocupada.

Para implementar a configuração de porta especificada em devcontainer.json, o GitHub Codespaces grava a configuração no arquivo settings.json do VS Code quando um codespace é criado. Você pode verificar se a configuração foi gravada corretamente no settings.json no codespace.

1. No terminal no codespace, insira o comando a seguir.

   Bash

   cat ~/.vscode-remote/data/Machine/settings.json
   

2. Verifique se o arquivo settings.json contém linhas como a seguir.

    "remote.portsAttributes": {
        "3000": {
            "label": "Application",
            "onAutoForward": "openPreview"
        }
    }
   

Se o arquivo settings.json não contiver essas configurações, verifique se há dotfiles habilitados e se alguma configuração nos dotfiles está substituindo o arquivo settings.json. Para saber mais, confira Personalizando GitHub codespaces para sua conta.

O aplicativo não é carregado

Ocasionalmente, você pode descobrir que a guia do Simple Browser é aberta, mas exibe um ícone de página de erro ou uma página em branco em vez do aplicativo em execução. Isso pode acontecer se o aplicativo Web que você está carregando incluir uma CSP (política de segurança de conteúdo) que restrinja os domínios nos quais as páginas do site podem ser inseridas. Para obter mais informações, confira CSP: frame-ancestors no site do mdn.

Talvez você possa alterar a política de segurança do aplicativo frame-ancestors localmente para que o aplicativo seja exibido no Simple Browser. Como alternativa, se uma política frame-ancestors estiver causando o problema, você poderá exibir o aplicativo abrindo-o em uma guia de navegador regular em vez de no Simple Browser. Para fazer isso, clique na guia Portas em VS Code, clique com o botão direito do mouse na porta e clique em Abrir no Navegador.

"portsAttributes": {
  "3000": {
    "label": "Application",
    "onAutoForward": "openPreview"
  }
}