Vai al contenuto principale

Guida alla configurazione dell’ambiente di sviluppo di Devin Desktop

Panoramica

I workspace di Devin Desktop si basano esclusivamente su strumenti open source per la compilazione, il linting e il debug. I componenti proprietari di Microsoft Visual Studio non possono essere ridistribuiti, quindi integriamo invece language server, debugger e compilatori mantenuti dalla community. Questa guida copre due stack:
  1. .NET / C# – per .NET Core e .NET Framework (tramite Mono)
  2. C / C++ – con strumenti basati su clang
Puoi installarne uno o entrambi nello stesso workspace.
⚠️ Importante: gli esempi riportati di seguito sono template che devi personalizzare per il tuo progetto specifico. Dovrai modificare i percorsi dei file, i nomi dei progetti e i comandi di build in modo che corrispondano alla tua codebase.

1. Sviluppo .NET / C#

Scegli l’opzione più adatta alla tua codebase.

.NET Core / .NET 6+

Estensioni:
  • C# (muhammad-sammy.csharp) – include OmniSharp LS e NetCoreDbg, così puoi premere F5 subito
  • .NET Install Tool (ms-dotnettools.vscode-dotnet-runtime) – installa automaticamente i runtime/SDK mancanti
  • Solution Explorer (fernandoescolar.vscode-solution-explorer) – per navigare e gestire soluzioni e progetti .NET
Debugger: Non serve altro: l’estensione include già il language server e un debugger open source adatto a .NET Core. Build: dotnet build

.NET Framework tramite Mono

Estensioni:
  • Mono Debug (ms-vscode.mono-debug) – adattatore di debug per Mono (Open VSX)
  • C# (muhammad-sammy.csharp) per le funzionalità del linguaggio
Debugger: Devi anche installare la toolchain di Mono all’interno del workspace. Segui la guida all’installazione nel repo di Mono. L’estensione del debugger si connette a quel runtime durante il debug.
⚠️ Configurazione di .NET Framework: Dopo aver installato Mono, per usare l’estensione C# con progetti .NET Framework, devi disattivare un’impostazione specifica nelle Settings dell’IDE. Vai in Settings (nella sezione dell’estensione C#) e disattiva “Omnisharp: Use Modern Net”. Questa impostazione usa la build di OmniSharp per .NET 6, che offre notevoli miglioramenti delle prestazioni per i progetti Framework in stile SDK, .NET Core e .NET 5+. Tieni presente che questa versione non supporta i progetti .NET Framework non in stile SDK, inclusi quelli di Unity.
Build: mcs Program.cs

Configura tasks.json per il tuo progetto

Devi creare o modificare .vscode/tasks.json nella radice del workspace e personalizzare questi template:

Configura launch.json per il debug

Devi creare/modificare .vscode/launch.json nella radice del workspace e aggiornare i percorsi:

Equivalenti nella CLI

Limitazioni di .NET Framework

⚠️ Importante: le codebase .NET Framework con assembly misti (C++/CLI) o dipendenze complesse da Visual Studio presentano limitazioni significative in Devin Desktop. In genere, queste codebase richiedono il sistema di build proprietario di Visual Studio e non possono essere compilate né sottoposte completamente a debug in Devin Desktop, a causa della dipendenza da strumenti specifici di Microsoft e della risoluzione dei riferimenti agli assembly. Approcci consigliati per i progetti .NET Framework:
  • Usa Devin Desktop insieme a Visual Studio per generare e modificare il codice
  • Se possibile, migra le parti compatibili a .NET Core

2. Sviluppo C / C++

Estensioni richieste:
Nota: l’installazione del bundle Windsurf C++ Tools installerà automaticamente le singole estensioni elencate di seguito, quindi ti basta installare il bundle.
Per i flussi di lavoro non basati su CMake, puoi comunque invocare make, ninja e così via tramite target personalizzati in tasks.json.

Configura le attività di build C/C++

Crea o modifica .vscode/tasks.json per il tuo progetto C/C++:

3. Note e avvertenze

  • Solo open source – rifiuta qualsiasi richiesta di installare strumenti Microsoft proprietari; i container di Devin Desktop non possono includerli.
  • Container vs host – SDK e compilatori devono essere presenti all’interno del container del workspace di Devin Desktop.
  • Scorciatoie da tastiera
    • Ctrl/⌘ + Shift + B → compila usando l’attività di build attiva
    • F5 → avvia il debug usando la configurazione launch.json selezionata

4. Checklist di configurazione

  • Installa le estensioni richieste per il tuo stack di linguaggi
  • Crea e personalizza .vscode/tasks.json con i comandi di build del progetto
  • Crea e personalizza .vscode/launch.json con i percorsi corretti per gli eseguibili
  • Per Mono: installa il runtime e verifica mono --version
  • Aggiorna i percorsi dei file, i nomi dei progetti e gli argomenti di build in base alla codebase del progetto
  • Verifica la configurazione: premi Ctrl/⌘ + Shift + B per eseguire la build, poi F5 per avviare il debug
💡 Suggerimento: I file di configurazione sono specifici del progetto. Dovrai adattare gli esempi sopra per ogni workspace.