Guide de configuration de l’environnement de développement pour Devin Desktop

Vue d’ensemble

Les espaces de travail Devin Desktop reposent exclusivement sur des outils open source pour la compilation, le linting et le débogage. Les composants propriétaires de Microsoft Visual Studio ne peuvent pas être redistribués. Nous intégrons donc à la place des serveurs de langage, des débogueurs et des compilateurs maintenus par la communauté. Ce guide couvre deux stacks :

.NET / C# – avec prise en charge de .NET Core et de .NET Framework (via Mono)
C / C++ – avec des outils basés sur clang

Vous pouvez installer l’une, l’autre ou les deux dans le même espace de travail.

⚠️ Important : Les exemples ci-dessous sont des modèles que vous devez adapter à votre projet spécifique. Vous devrez modifier les chemins de fichiers, les noms de projet et les commandes de build pour qu’ils correspondent à votre base de code.

1. Développement .NET / C#

Choisissez l’option qui correspond à votre base de code.

.NET Core / .NET 6+

Extensions :

C# (muhammad-sammy.csharp) – inclut OmniSharp LS et NetCoreDbg, pour que vous puissiez appuyer sur F5 immédiatement
.NET Install Tool (ms-dotnettools.vscode-dotnet-runtime) – installe automatiquement les environnements d’exécution/SDK manquants
Solution Explorer (fernandoescolar.vscode-solution-explorer) – parcourir et gérer les solutions et projets .NET

Débogueur : Rien d’autre n’est requis — l’extension contient déjà le serveur de langage et un débogueur open source adapté à .NET Core. Build : dotnet build

.NET Framework via Mono

Extensions :

Mono Debug (chrisatwindsurf.mono-debug) – adaptateur de débogage pour Mono (Open VSX)
C# (muhammad-sammy.csharp) pour les fonctionnalités du langage

Débogueur : Vous devez également installer la chaîne d’outils Mono dans l’espace de travail. Suivez le guide d’installation dans le dépôt Mono. L’extension de débogage se connecte à cet environnement d’exécution lors du débogage.

⚠️ Configuration de .NET Framework : Après avoir installé Mono, pour utiliser l’extension C# avec des projets .NET Framework, vous devez désactiver un paramètre spécifique dans les Settings de l’IDE. Accédez à Settings (dans la section C# Extension) et désactivez “Omnisharp: Use Modern Net”. Ce paramètre utilise la build OmniSharp pour .NET 6, qui offre d’importants gains de performances pour les projets .NET Framework de type SDK, .NET Core et .NET 5+. Notez que cette version ne prend pas en charge les projets .NET Framework qui ne sont pas de type SDK, y compris Unity.

Build : mcs Program.cs

Configurer `tasks.json` pour votre projet

Vous devez créer ou modifier .vscode/tasks.json à la racine de votre espace de travail et personnaliser ces modèles :

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build-dotnet",
      "type": "shell",
      "command": "dotnet",
      "args": ["build", "YourProject.csproj"], // ← Modifiez ceci
      "group": "build",
      "problemMatcher": "$msCompile"
    },
    {
      "label": "build-mono",
      "type": "shell",
      "command": "mcs",
      "args": ["YourProgram.cs"], // ← Modifiez ceci
      "group": "build"
    }
  ]
}

Configurer `launch.json` pour le débogage

Vous devez créer ou modifier .vscode/launch.json à la racine de votre espace de travail et mettre à jour les chemins :

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": ".NET Core Launch",
      "type": "coreclr",
      "request": "launch",
      "preLaunchTask": "build-dotnet",
      "program": "${workspaceFolder}/bin/Debug/net6.0/YourApp.dll", // ← Modifiez ce chemin
      "cwd": "${workspaceFolder}",
      "args": [] // Ajoutez des arguments de ligne de commande si nécessaire
    },
    {
      "name": "Mono Launch",
      "type": "mono",
      "request": "launch",
      "preLaunchTask": "build-mono",
      "program": "${workspaceFolder}/YourProgram.exe", // ← Modifiez ce chemin
      "cwd": "${workspaceFolder}"
    }
  ]
}

Équivalents en ligne de commande

# .NET Core
$ dotnet build
$ dotnet run

# Mono / .NET Framework
$ mcs Program.cs
$ mono Program.exe

Limitations de .NET Framework

⚠️ Important : les bases de code .NET Framework avec des assemblies mixtes (C++/CLI) ou des dépendances complexes à Visual Studio présentent d’importantes limitations dans Devin Desktop. Ces bases de code nécessitent généralement le système de build propriétaire de Visual Studio et ne peuvent pas être entièrement compilées ni déboguées dans Devin Desktop en raison de leur dépendance à des outils spécifiques à Microsoft et à la résolution des références d’assembly. Approches recommandées pour les projets .NET Framework :

Utiliser Devin Desktop en complément de Visual Studio pour la génération et l’édition de code
Migrer les parties compatibles vers .NET Core lorsque possible

2. Développement C / C++

Extensions requises :

Extension	Objectif
Windsurf C++ Tools (`Codeium.windsurf-cpptools`)	Il s’agit d’un bundle regroupant les trois extensions que nous vous recommandons d’utiliser pour démarrer. Ce package inclut la prise en charge du LSP C/C++, du débogage et de CMake.

Remarque : L’installation du bundle Windsurf C++ Tools installe automatiquement les extensions individuelles listées ci-dessous ; il vous suffit donc d’installer le bundle.

Extension	Objectif
clangd (`llvm-vs-code-extensions.vscode-clangd`)	Intégration du serveur de langage clangd. Si `clangd` est absent, l’extension proposera de télécharger le binaire adapté à votre plateforme.
CodeLLDB (`vadimcn.vscode-lldb`)	Débogueur natif basé sur LLDB pour le code C/C++ et Rust.
CMake Tools (`ms-vscode.cmake-tools`)	Intégration de la configuration du projet, du build, des tests et du débogage pour les projets basés sur CMake.

Pour les workflows non basés sur CMake, vous pouvez quand même invoquer make, ninja, etc. via des cibles tasks.json personnalisées.

Configurer les tâches de build C/C++

Créez ou modifiez .vscode/tasks.json pour votre projet C/C++ :

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build-cpp",
      "type": "shell",
      "command": "clang++",
      "args": ["-g", "main.cpp", "-o", "main"], // ← Modifiez selon vos fichiers
      "group": "build",
      "problemMatcher": "$gcc"
    }
  ]
}

3. Remarques et pièges à éviter

Open source uniquement – rejetez toute demande d’installation d’outils Microsoft propriétaires ; les conteneurs Devin Desktop ne peuvent pas les embarquer.
Conteneur vs hôte – les SDK/compilateurs doivent être présents dans le conteneur d’espace de travail Devin Desktop.
Raccourcis clavier
- Ctrl/⌘ + Shift + B → compiler à l’aide de la tâche de build active
- F5 → déboguer à l’aide de la configuration launch.json sélectionnée

4. Checklist de configuration

Installez les extensions requises pour votre stack technique
Créez et personnalisez .vscode/tasks.json avec les commandes de build de votre projet
Créez et personnalisez .vscode/launch.json avec les chemins d’accès corrects vers vos exécutables
Pour Mono : installez l’environnement d’exécution et vérifiez mono --version
Mettez à jour les chemins de fichiers, les noms de projet et les arguments de build pour qu’ils correspondent à votre base de code
Testez votre configuration : appuyez sur Ctrl/⌘ + Shift + B pour lancer le build, puis sur F5 pour déboguer

💡 Conseil : Les fichiers de configuration sont propres à chaque projet. Vous devrez adapter les exemples ci-dessus pour chaque espace de travail.

Documentation Index

​Guide de configuration de l’environnement de développement pour Devin Desktop

​Vue d’ensemble

​1. Développement .NET / C#

​.NET Core / .NET 6+

​.NET Framework via Mono

​Configurer tasks.json pour votre projet

​Configurer launch.json pour le débogage

​Équivalents en ligne de commande

​Limitations de .NET Framework

​2. Développement C / C++

​Configurer les tâches de build C/C++

​3. Remarques et pièges à éviter

​4. Checklist de configuration