Acelere a depuração com o Microsoft Visual Studio Code

O VS Code funciona com muitas extensões disponíveis para funcionar como um IDE completo.

Você precisará completar várias etapas para usar o VS Code no Unity.

Primeiro, baixe e instale o Visual Studio Code a partir do site, onde você encontrará versões para Windows, macOS e Linux.

Depois de instalar o VS Code, obtenha o pacote do Editor Visual Studio para Unity. Na janela Gerenciador de Pacotes, certifique-se de instalar. Se você tiver uma versão mais antiga do pacote, atualize para versão 2.0.20 ou superior.

O pacote do Editor Visual Studio agora lida com toda a família de produtos Visual Studio. Certifique-se de não confundi-lo com o pacote chamado Editor do Visual Studio Code, que não é mais suportado.

Após instalar o VS Code e o pacote Visual Studio Editor, você precisará definir o VS Code como o editor de script externo.

Faça isso através de Unity > Preferências > Ferramentas Externas no Editor. Em Editor de Script Externo, escolha Visual Studio Code no menu suspenso. Se o VS Code não aparecer na lista, clique em Procurar e localize o executável do VS Code no seu sistema. Na próxima vez que você abrir um arquivo C# no Unity, ele abrirá o Visual Studio Code para você.

O próximo passo é instalar a extensão Unity para o Visual Studio Code, que fornece uma experiência de desenvolvimento Unity simplificada. Ela se baseia nas ricas capacidades fornecidas pelo C# Dev Kit e extensões C#, e se integra nativamente ao Visual Studio Code.

Os principais recursos incluem:

- Um depurador para seu Editor Unity e jogadores

- Analisadores e refatorações específicas do C# para Unity

- Coloração de código para formatos de arquivo Unity (.asmdef, .shader, .uss, .uxml)

Vá para o Marketplace do Visual Studio para obter a extensão. Após baixá-la, uma janela solicitará que você a abra no aplicativo Visual Studio Code. O VS Code então instalará as extensões Unity, incluindo C# Dev Kit e extensões C#.

Uma vez instalado, você pode configurar o ambiente do C# Dev Kit.

Há um botão Play na barra de ferramentas à esquerda do editor VS Code que está marcado com um ícone de inseto. Ao clicar nisso, você abrirá a visualização Executar e Depurar. Na parte superior dessa visualização, há um botão Reproduzir e uma lista suspensa de opções de lançamento do arquivo launch.json. Selecione o Unity Editor (deve já estar selecionado por padrão, pois é a primeira opção de lançamento).

A visualização Executar e Depurar inclui cinco janelas para examinar o estado do seu programa: Locais, Assistir, Pilha de Chamadas, Pontos de Interrupção e Pontos de Interrupção de Exceção (esta última opção geralmente não é usada com tanta frequência quanto as outras quatro). Essas janelas ajudam você a inspecionar seu código e entender o estado atual de sua aplicação enquanto você está depurando. Elas funcionam de maneira semelhante às janelas de depuração no Visual Studio.

Adicione pontos de interrupção clicando na margem ou pressionando F9 quando a linha do ponto de interrupção estiver selecionada no código que você deseja testar. Os pontos de interrupção na margem do editor serão mostrados como círculos vermelhos sólidos.

Os pontos de interrupção podem ser editados clicando com o botão direito, e condições podem ser adicionadas para controlar a interrupção do programa. Quando a execução do programa é pausada no VS Code, uma barra de ferramentas é adicionada à visualização (semelhante ao Visual Studio). A barra de ferramentas fornece os seguintes botões:

- Reproduzir/Pausar (F6)

- Passar (F10)

- Entrar (F11)

- Sair (⇧F11)

- Reiniciar: Ctrl⇧F5 (Windows) e ⇧⌘F5 (macOS)

- Parar Depuração (⇧F5)

Saiba mais sobre o recurso da barra de ferramentas do VS Code na documentação do VS Code, e veja este vídeo para mais dicas.

Local
A janela Local exibe os valores de todas as variáveis locais no escopo atual onde a execução está pausada. Isso inclui variáveis declaradas dentro do método ou função que você está depurando atualmente, permitindo que você as inspecione para verificar os valores das variáveis no ponto atual da execução do seu código.

Watch
A janela Watch permite que você adicione variáveis ou expressões específicas que deseja monitorar durante o processo de depuração, adicionando manualmente qualquer variável ou expressão ao Watch. Você pode ver os valores sendo atualizados à medida que avança pelo código, um recurso útil quando deseja acompanhar variáveis ou expressões específicas ao longo da sessão de depuração, mesmo que não estejam no escopo atual.

Call Stack
A janela Call Stack é útil para entender o fluxo do seu código e identificar como uma parte específica do código foi alcançada. Ela mostra a sequência de chamadas de métodos ou funções que levaram ao ponto atual de execução, com cada entrada na pilha de chamadas representando uma chamada de método ou função e a chamada mais recente no topo. Você pode clicar em qualquer entrada na pilha de chamadas para navegar até o código correspondente em seu projeto e visualizar as variáveis locais naquele ponto da execução.

Breakpoint
A janela Breakpoint mostra uma lista de todos os pontos de interrupção que você definiu em seu código. Os pontos de interrupção são os marcadores que você coloca em seu código para pausar a execução quando uma linha específica é alcançada. Você pode usar esta janela para habilitar ou desabilitar pontos de interrupção, removê-los ou navegar até a linha correspondente do código em seu projeto. Isso é útil para gerenciar seus pontos de interrupção (se você tiver muitos) e para pular rapidamente para locais específicos em seu código onde deseja pausar a execução.

Você está planejando usar outro editor de código? Você pode ler nosso artigo sobre Microsoft Visual Studio 2022.

Ajude a aumentar a produtividade da equipe com nosso e-book Crie um guia de estilo C#: Escreva um código mais limpo que escale. Obtenha conselhos de especialistas da indústria sobre como criar um guia de estilo de código para ajudar sua equipe a desenvolver uma base de código limpa, legível e escalável.

Você encontrará muitas mais dicas de produtividade em 70+ dicas para aumentar a produtividade com Unity. Melhore seu fluxo de trabalho agregado do dia a dia com Unity 2020 LTS, incluindo dicas que até mesmo desenvolvedores experientes podem ter perdido.

Encontre todos os e-books e artigos avançados da Unity no hub de melhores práticas da Unity.