Pular para o conteúdo principal

Guia de configuração do ambiente de desenvolvimento no Devin Desktop

Visão geral

Os workspaces do Devin Desktop dependem exclusivamente de ferramentas open source para compilação, linting e depuração. Os componentes proprietários do Visual Studio da Microsoft não podem ser redistribuídos, por isso integramos servidores de linguagem, depuradores e compiladores mantidos pela comunidade. Este guia aborda duas stacks:
  1. .NET / C# – com suporte a .NET Core e .NET Framework (via Mono)
  2. C / C++ – usando ferramentas baseadas em clang
Você pode instalar uma ou ambas no mesmo workspace.
⚠️ Importante: Os exemplos abaixo são templates que você precisa personalizar para seu projeto específico. Será necessário editar caminhos de arquivos, nomes de projetos e comandos de build para corresponder à sua base de código.

1. Desenvolvimento .NET / C#

Escolha a opção que corresponde à sua base de código.

.NET Core / .NET 6+

Extensões:
  • C# (muhammad-sammy.csharp) – inclui OmniSharp LS e NetCoreDbg, para que você possa usar F5 imediatamente
  • .NET Install Tool (ms-dotnettools.vscode-dotnet-runtime) – instala automaticamente runtimes/SDKs ausentes
  • Solution Explorer (fernandoescolar.vscode-solution-explorer) – permite navegar e gerenciar soluções e projetos .NET
Depurador: Não é necessário mais nada — a extensão já inclui o servidor de linguagem e um depurador de código aberto adequado para .NET Core. Build: dotnet build

.NET Framework via Mono

Extensões:
  • Mono Debug (ms-vscode.mono-debug) – adaptador de depuração para Mono (Open VSX)
  • C# (muhammad-sammy.csharp) para recursos de linguagem
Depurador: Você também precisa instalar a toolchain do Mono dentro do workspace. Siga o guia de instalação no repositório do Mono. A extensão de depuração se conecta a esse runtime durante a depuração.
⚠️ Configuração do .NET Framework: Após instalar o Mono, para usar a extensão C# com projetos .NET Framework, você precisa desativar uma configuração específica nas Configurações da IDE. Vá para Configurações (na seção da extensão C#) e desative “Omnisharp: Use Modern Net”. Essa configuração usa a build do OmniSharp para .NET 6, que oferece melhorias significativas de desempenho para projetos .NET Framework no estilo SDK, .NET Core e .NET 5+. Observe que esta versão não oferece suporte a projetos .NET Framework que não usam o estilo SDK, incluindo Unity.
Build: mcs Program.cs

Configure tasks.json para seu projeto

Você deve criar/editar .vscode/tasks.json na raiz do seu workspace e personalizar os templates a seguir:

Configure o launch.json para depuração

Você deve criar/editar .vscode/launch.json na raiz do workspace e atualizar os caminhos:

Equivalentes na CLI

Limitações do .NET Framework

⚠️ Importante: bases de código do .NET Framework com assemblies mistos (C++/CLI) ou dependências complexas do Visual Studio têm limitações significativas no Devin Desktop. Essas bases de código normalmente exigem o sistema de build proprietário do Visual Studio e não podem ser totalmente compiladas nem depuradas no Devin Desktop devido à dependência de ferramentas específicas da Microsoft e da resolução de referências de assembly. Abordagens recomendadas para projetos em .NET Framework:
  • Use o Devin Desktop em conjunto com o Visual Studio para gerar e editar código
  • Migre as partes compatíveis para o .NET Core sempre que possível

2. Desenvolvimento em C / C++

Extensões obrigatórias:
Nota: Instalar o pacote Windsurf C++ Tools instalará automaticamente as extensões individuais listadas abaixo, então você só precisa instalar o pacote.
Para fluxos de trabalho sem CMake, você ainda pode invocar make, ninja etc. por meio de alvos personalizados no tasks.json.

Configurar tarefas de build para C/C++

Crie/edite .vscode/tasks.json no seu projeto em C/C++:

3. Notas e pontos de atenção

  • Apenas open source – recuse qualquer solicitação para instalar ferramentas proprietárias da Microsoft; os contêineres do Devin Desktop não podem vir com elas.
  • Contêiner vs. host – SDKs/compiladores devem estar presentes dentro do contêiner do workspace do Devin Desktop.
  • Atalhos de teclado
    • Ctrl/⌘ + Shift + B → compilar usando a tarefa de build ativa
    • F5 → depurar com a configuração launch.json selecionada

4. Checklist de configuração

  • Instale as extensões necessárias para sua stack de tecnologias
  • Crie e personalize .vscode/tasks.json com os comandos de build do seu projeto
  • Crie e personalize .vscode/launch.json com os caminhos corretos para seus executáveis
  • Para Mono: instale o runtime e verifique mono --version
  • Atualize os caminhos dos arquivos, os nomes dos projetos e os argumentos de build para corresponder ao seu base de código
  • Teste sua configuração: pressione Ctrl/⌘ + Shift + B para executar o build e depois F5 para depurar
💡 Dica: Os arquivos de configuração são específicos de cada projeto. Você precisará adaptar os exemplos acima para cada workspace.