Partager via

/Build (devenv.exe)

  • Article

Génère une solution ou un projet à l’aide d’un fichier de configuration de solution spécifié.

Syntaxe

devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig ProjConfigName]] [/Out OutputFilename]]

Arguments

  • SolutionName

    Obligatoire. Chemin et nom du fichier solution, par rapport au répertoire de la solution.

  • SolnConfigName

    facultatif. Nom de la configuration de solution (par exemple, Debug ou Release) à utiliser pour générer la solution nommée dans SolutionName. Si plusieurs plateformes de solution sont disponibles, vous devez également en spécifier une (par exemple, Debug|Win32). Si cet argument n’est pas spécifié ou consiste en une chaîne vide (""), l’outil utilise la configuration active de la solution.

  • /ProjectProjName

    facultatif. Chemin et nom d’un fichier projet dans la solution. Vous pouvez entrer un chemin relatif du dossier SolutionName au fichier projet, le nom d’affichage du projet, ou le chemin et le nom complet du fichier projet.

  • /ProjectConfigProjConfigName

    facultatif. Nom d’une configuration de build de projet (par exemple, Debug ou Release) à utiliser lors de la génération du projet nommé. Si plusieurs plateformes de solution sont disponibles, vous devez également en spécifier une (par exemple, Debug|Win32). Si ce commutateur est spécifié, il remplace l’argument SolnConfigName.

  • /OutOutputFilename

    facultatif. Nom du fichier auquel vous souhaitez envoyer la sortie de l’outil. Si le fichier existe déjà, l’outil ajoute la sortie à la fin du fichier.

Notes

  • Le commutateur /Build a la même fonction que la commande de menu Générer la solution dans l’environnement de développement intégré (IDE).

  • Placez les chaînes contenant des espaces entre des guillemets doubles.

  • Il est possible d’afficher une synthèse des informations de build, erreurs incluses, dans la fenêtre Commande et dans tous les fichiers journaux spécifiés avec le commutateur /Out.

  • Le commutateur /Build ne génère que les projets qui ont changé depuis la dernière build. Pour générer tous les projets d’une solution, utilisez plutôt /rebuild.

  • Si vous obtenez un message d’erreur indiquant Configuration de projet non valide, vérifiez que vous avez spécifié une plateforme de solution ou de projet (par exemple, Debug|Win32).

Exemples

La commande suivante génère le projet CSharpWinApp suivant la configuration de build de projet Debug présente dans MySolution.

devenv "%USERPROFILE%\source\repos\MySolution.sln" /build Debug /project "CSharpWinApp\CSharpWinApp.csproj" /projectconfig Debug

Et pour nettoyer tous les fichiers de build :

devenv "%USERPROFILE%\source\repos\MySolution.sln" /clean

Créer un projet d’installation

Pour générer un programme d’installation (.msi fichier), vous avez besoin d’un projet d’installation, qui a un .vdproj fichier projet, mais pour le générer, vous devez d’abord appliquer une solution de contournement qui définit une clé de Registre particulière. À partir de l’invite de commandes Développeur Visual Studio, exécutez le DisableOutOfProcBuild.exe exécutable à partir du dossier Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild. Sans cette solution de contournement, vous pouvez obtenir l’erreur : ERROR: An error occurred while validating. HRESULT = '8000000A'. La commande affecte l’utilisateur actuel. Par conséquent, pour les scénarios d’agent de build, veillez à l’exécuter à partir du même compte que celui qui exécute la build. Pour plus d’informations, consultez le fichier README.txt dans le même dossier.

En outre, dans Visual Studio, vous pouvez créer une configuration, par exemple Setup, en fonction de la Release configuration et sélectionner le projet d’installation en tant que projet à générer. Par défaut, les projets d’installation ne sont pas inclus dans les configurations par défaut et Debug Release. Une fois la Setup configuration définie, les commandes suivantes génèrent un projet WindowsFormsApp1 et son projet d’installation associé pour générer le .msi fichier :

devenv WindowsFormsApp1.sln /build Setup

Si la solution a déjà été créée avec la configuration Release , cette commande génère simplement le projet d’installation.

Voir aussi