Commutateurs de ligne de commande Devenv

  • Article

Devenv permet de définir différentes options pour l’environnement IDE et de générer, déboguer et déployer des projets en ligne de commande. Utilisez ces commutateurs pour exécuter l’environnement IDE à partir d’un script ou d’un fichier .bat (par exemple, un script de build nocturne) ou pour le lancer dans une configuration particulière.

Notes

Pour les tâches de build, nous recommandons d’utiliser MSBuild plutôt que devenv. Pour plus d’informations, consultez Informations de référence sur la ligne de commande MSBuild.

Pour obtenir plus d’informations sur les commutateurs principalement destinés au développement d’extensions Visual Studio, voir aussi Commutateurs de ligne de commande devenv pour le développement VSPackage.

Syntaxe des commutateurs devenv

Les commandes qui commencent par devenv sont gérées par l’utilitaire devenv.com, qui fournit ses sorties via des flux système standard, tels que stdout et stderr. L’utilitaire détermine la redirection d’E/S appropriée lors de la capture de la sortie, par exemple dans un fichier .txt.

Les commandes qui commencent par devenv.exe peuvent utiliser les mêmes commutateurs, mais l’utilitaire devenv.com est alors ignoré. L’utilisation de devenv.exe empêche l’affichage direct de la sortie sur la console.

Les règles syntaxiques des commutateurs devenv ressemblent à celles d’autres utilitaires de ligne de commande DOS. Les règles de syntaxe suivantes s’appliquent à tous les commutateurs devenv et leurs arguments :

  • Les commandes commencent par devenv.

  • Les commutateurs ne respectent pas la casse.

  • Pour spécifier un commutateur, on utilise un trait d’union («- ») ou une barre oblique (« / »).

  • Quand vous spécifiez une solution ou un projet, le premier argument est le nom du fichier solution ou projet, y compris le chemin du fichier.

  • Si le premier argument est un fichier qui n’est ni une solution ni un projet, ce fichier s’ouvre dans l’éditeur adapté, dans une nouvelle instance de l’environnement IDE.

  • Quand vous fournissez un nom de fichier projet au lieu d’un nom de fichier solution, une commande devenv recherche le dossier parent du fichier projet pour un fichier solution du même nom. Par exemple, la commande devenv myproject1.vbproj /build recherche le dossier parent d’un fichier solution nommé myproject1.sln.

    Notes

    Un seul fichier solution référençant ce projet doit se trouver dans son dossier parent. Si le dossier parent ne contient aucun fichier solution référençant ce projet, ou si le dossier parent contient deux fichiers solution ou plus qui le référencent, un fichier solution temporaire est créé.

  • Quand les chemins et les noms de fichier comportent des espaces, vous devez les placer entre des guillemets doubles (""). Par exemple : "c:\project a\".

  • Insérez un espace entre les commutateurs et les arguments de la même ligne. Par exemple, la commande devenv /log output.txt ouvre l’environnement IDE et écrit toutes les informations de journal de cette session dans le fichier output.txt.

  • Il n’est pas possible d’utiliser une syntaxe de type critères spéciaux dans les commandes devenv.

Commutateurs de devenv

Les commutateurs de ligne de commande suivants affichent l’environnement IDE et effectuent la tâche décrite.

Commutateur de ligne de commande Description
/Command Démarre l’IDE et exécute la commande spécifiée.

devenv /command "nav https://learn.microsoft.com/"
/DebugExe Charge un exécutable C++ sous le contrôle du débogueur. Ce commutateur n’est pas disponible pour les exécutables Visual Basic ou C#. Pour plus d’informations, consultez Démarrer automatiquement un processus dans le débogueur.

devenv /debugexe mysln.exe
/Diff Compare deux fichiers. Accepte quatre paramètres : SourceFile, TargetFile, SourceDisplayName (facultatif) et TargetDisplayName (facultatif).

devenv /diff File1 File2 Alias1 Alias2
/DoNotLoadProjects Ouvre la solution spécifiée sans charger de projets.

devenv /donotloadprojects mysln.sln
/Edit Ouvre les fichiers spécifiés dans une instance en cours d’exécution de cette application. S’il n’existe aucune instance en cours d’exécution, il démarre une nouvelle instance avec une disposition de fenêtre simplifiée.

devenv /edit File1 File2
/LCID ou /L Spécifie la langue par défaut pour l’IDE. Si la langue spécifiée n’est pas incluse dans votre installation de Visual Studio, ce paramètre est ignoré.

devenv /l 1033
/Log Démarre Visual Studio et enregistre toute l’activité dans le fichier journal.

devenv /log mylogfile.xml
/NoScale Ouvre l’environnement IDE en mode DPI désactivé qui permet une disposition plus précise dans le Concepteur Windows Forms.
/NoSplash Ouvre l’environnement IDE sans afficher l’écran de démarrage.

devenv /nosplash File1 File2
/ResetSettings Restaure les paramètres par défaut de Visual Studio. Éventuellement, réinitialise les paramètres dans le fichier .vssettings spécifié.

devenv /resetsettings mysettings.vssettings
/Run ou /R Compile et exécute la solution spécifiée.

devenv /run mysln.sln
/RunExit Compile et exécute la solution spécifiée, réduit l’IDE pendant l’exécution de la solution et ferme l’IDE une fois la solution exécutée.

devenv /runexit mysln.sln
/SafeMode Lance Visual Studio en mode sans échec. Ce commutateur charge uniquement l’environnement par défaut, les services par défaut et les versions commercialisées des packages tiers.

Ce commutateur ne prend aucun argument.
/TfsLink Ouvre Team Explorer et lance une visionneuse pour l’URI d’artefact fourni le cas échéant.
/UseEnv Force l’environnement IDE à utiliser les variables d’environnement PATH, INCLUDE, LIBPATH et LIB pour la compilation C++. Ce commutateur est installé avec la charge de travail Développement Desktop avec C++. Pour plus d'informations, consultez Setting the Path and Environment Variables for Command-Line Builds.

Les commutateurs de ligne de commande suivants n’affichent pas l’environnement IDE.

Commutateur de ligne de commande Description
/? Affiche l’aide des commutateurs devenv dans la fenêtre d’invite de commandes.

Ce commutateur ne prend aucun argument.
/Build Génère la solution ou le projet spécifié en fonction de la configuration de la solution indiquée.

devenv mysln.sln /build
/Clean Supprime tous les fichiers créés par la commande build, sans affecter les fichiers sources.

devenv mysln.sln /clean
/Deploy Génère la solution, ainsi que les fichiers nécessaires au déploiement, en fonction de la configuration de la solution.

devenv mysln.sln /deploy
/Out Permet de spécifier un fichier pour recevoir les erreurs pendant la génération.

devenv mysln.sln /build Debug /out log.txt
/Project Projet à générer, nettoyer ou déployer. Ce commutateur n’est utilisable que si le commutateur /Build, /Rebuild, /Clean ou /Deploy est également indiqué.

devenv mysln.sln /build Debug /project proj1
/ProjectConfig Spécifie la configuration de projet à générer ou déployer. Ce commutateur n’est utilisable que si le commutateur /Project est également indiqué.

devenv mysln.sln /build Release /project proj1 /projectconfig Release
/Rebuild Efface, puis génère la solution ou le projet spécifié en fonction de la configuration de la solution indiquée.

devenv mysln.sln /rebuild
/Setup Force Visual Studio à fusionner des métadonnées de ressources qui décrivent les menus, les barres d’outils et les groupes de commandes de tous les packages VSPackage disponibles. Vous pouvez uniquement exécuter cette commande en tant qu’administrateur.
/Upgrade Met à niveau le fichier solution spécifié et tous ses fichiers projet, ou le fichier projet spécifié, avec les formats Visual Studio actuels pour ces fichiers.

devenv mysln.sln /upgrade

Voir aussi