Como configurar o VS Code com o C# Dev Kit no Linux

O VS Code não é o Visual Studio.

[0:42 - 1:59] Tim começa com um esclarecimento que confunde muita gente: Visual Studio e Visual Studio Code são produtos diferentes. O Visual Studio é um ambiente de desenvolvimento integrado (IDE) completo que só funciona no Windows porque está vinculado a bibliotecas específicas do Windows. O VS Code é um editor de texto leve e multiplataforma e, com a extensão C# Dev Kit, torna-se um ambiente capaz para a maioria dos trabalhos de desenvolvimento .NET .

Essa distinção é importante na prática porque o Visual Studio não pode ser instalado no Linux. O VS Code é o caminho a seguir.

Instalando o VS Code

[1:59 - 3:46] O processo de instalação é simples. Baixe o arquivo .deb do site do Visual Studio Code , abra-o e o gerenciador de pacotes cuidará do resto.

Um efeito colateral útil desta instalação: ela adiciona automaticamente o repositório de pacotes da Microsoft ao apt, o que significa que o VS Code permanece atualizado por meio do processo normal de atualização do sistema. Sem isso, você precisaria adicionar manualmente o repositório e seu certificado de assinatura.

Após a instalação, fixe o VS Code na barra de tarefas para facilitar o acesso.

Adicionando a extensão do C# Dev Kit

[4:44 - 5:47] Abra o painel Extensões e pesquise por "C#". O primeiro resultado deve ser o C# Dev Kit da Microsoft. Até a data da gravação do vídeo, ele já contava com quase 14 milhões de downloads.

A extensão representa uma melhoria significativa em relação à edição de texto simples para trabalhos em C#.

Instale-o com a atualização automática ativada.

O Requisito de Licenciamento

[5:47 - 8:03] Após a instalação, o C# Dev Kit pede que você entre com uma conta da Microsoft para obter o licenciamento. O depurador C# da Microsoft é proprietário, razão pela qual a autenticação é necessária para que a experiência completa de depuração esteja disponível.

Os termos são permissivos: gratuito para desenvolvedores individuais, gratuito para empresas com menos de cinco desenvolvedores que faturam menos de um milhão de dólares por ano, e somente uma licença Professional paga é necessária acima desse limite.

Criando um aplicativo web Blazor

Com o VS Code configurado, Tim cria um novo projeto diretamente da IDE. Usando o comando "Criar Projeto .NET ", ele seleciona o modelo de aplicativo web Blazor e o configura com HTTPS, modo automático interativo e páginas de exemplo incluídas.

Após a criação da estrutura básica do projeto, o Solution Explorer aparece no lado esquerdo, exibindo a estrutura do projeto em um layout semelhante ao do Visual Studio.

Execução e depuração

Para iniciar o aplicativo, use "Executar e Depurar" na barra lateral e selecione o perfil de inicialização HTTPS. O VS Code compilará o projeto e o abrirá no navegador padrão.

É aqui que Tim se depara com uma regressão conhecida no.NET SDK 10.0.103 : os certificados de desenvolvimento não são instalados corretamente devido a um conflito de mesclagem na compilação do SDK. O navegador exibe um aviso de certificado não confiável.

A solução alternativa é clicar no aviso do navegador ("Avançado" e depois em "Continuar"). O site funciona perfeitamente com SSL depois que você o instala. Reverter para o SDK 10.0.102 ou atualizar para a versão 10.0.104 resolve o problema permanentemente.

Apesar do problema com o certificado, todas as páginas padrão (página inicial, contador, previsão do tempo) carregam corretamente.

Habilitando a recarga dinâmica

Por padrão, o recurso de recarregamento dinâmico (hot reload) está desativado no VS Code. Tim demonstra isso alterando "Olá, Mundo" para "Olá, YouTube" e não vendo nenhuma atualização no navegador, mesmo depois de salvar e atualizar a página.

Para habilitá-lo, são necessárias duas configurações no VS Code:

Com ambas as configurações ativadas, reinicie a sessão de depuração. Um ícone de fogo aparece na barra de ferramentas, confirmando que a recarga dinâmica está ativa. Agora, ao salvar um arquivo Razor , a alteração é refletida imediatamente no navegador.

O que você pode e não pode construir no Linux

[16:59 - 18:00] Tim explora brevemente os modelos de projeto disponíveis e faz uma observação importante: qualquer coisa com "Windows" no nome (WinForms, WPF, UWP) não estará disponível porque essas estruturas estão vinculadas à plataforma Windows.

O que funciona no Linux abrange tudo o que é multiplataforma no ecossistema .NET : aplicativos da Web, APIs ASP.NET Core , serviços gRPC, bibliotecas de classes, aplicativos de console, projetos de teste e serviços de trabalho.

Para aplicações desktop em Linux, a Plataforma Uno (usando XAML e MVVM/MVUX) é mencionada como um tópico para um episódio futuro sobre a criação de aplicativos desktop multiplataforma .

Concluindo: Um ambiente C# completo no Linux

[18:02 - 18:28] Ao final do passo a passo, todas as etapas do fluxo de trabalho de desenvolvimento estão implementadas: edição, compilação, depuração e recarregamento em tempo real, tudo funcionando dentro do VS Code no Linux. Abrir um projeto .NET multiplataforma existente a partir de outra máquina deve funcionar sem alterações.

Conclusão

[18:02 - 19:07] Resumindo: o VS Code com o C# Dev Kit fornece ao Linux uma configuração completa para desenvolvimento em C#. A instalação consiste em um arquivo baixado .deb e uma extensão. A recarga instantânea está desativada por padrão, mas leva menos de um minuto para ser ativada no painel de configurações. E o problema com o certificado de desenvolvedor no SDK 10.0.103 é resolvido na versão 10.0.104.

A maioria dos tipos de projetos .NET que você usaria em produção (aplicativos web, APIs, serviços, bibliotecas) funcionam de forma idêntica no Linux. As que não seguem esse padrão são explicitamente projetadas em torno de estruturas de interface do usuário específicas do Windows, que é o limite esperado.

Assim, da próxima vez que você configurar uma nova máquina Linux para desenvolvimento, todo o ambiente estará pronto em minutos. A única configuração que não é óbvia logo de cara é o hot reload, e agora você sabe exatamente onde encontrá-la.

Exemplo de dica: Se a recarga dinâmica não estiver funcionando após ativar as configurações, certifique-se de ter encerrado e reiniciado completamente a sessão de depuração. O ícone de fogo na barra de ferramentas de depuração confirma que está ativo. Se o ícone não estiver presente, a sessão antiga ainda está em execução sem as novas configurações.

Assista ao vídeo completo no canal dele no YouTube e obtenha mais informações sobre desenvolvimento em C# no Linux.