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 d’accès et nom du fichier solution, par rapport au répertoire de la solution.

  • SolnConfigName

    Optionnel. Nom de la configuration de la 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 spécifier la plateforme (par exemple, Debug|Win32). Si cet argument n’est pas spécifié ou si une chaîne vide (""), l’outil utilise la configuration active de la solution.

  • /Project ProjName

    Optionnel. Chemin d’accès et nom d’un fichier projet dans la solution. Vous pouvez entrer un chemin relatif à partir du dossier SolutionName vers le fichier projet, ou le nom complet du projet, ou le chemin complet et le nom du fichier projet.

  • /ProjectConfig ProjConfigName

    Optionnel. 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 spécifier la plateforme (par exemple, Debug|Win32). Si ce commutateur est spécifié, il remplace l’argument SolnConfigName.

  • /Out OutputFilename

    Optionnel. Nom d’un 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.

Remarques

  • Le commutateur /Build effectue la même fonction que la commande de menu Build Solution dans l’environnement de développement intégré (IDE).

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

  • Les informations récapitulatives pour les builds, y compris les erreurs, peuvent être affichées dans la fenêtre de commande ou dans n’importe quel fichier journal spécifié avec le commutateur /Out.

  • Le commutateur /Build génère uniquement les projets qui ont changé depuis la dernière génération. Pour générer tous les projets dans une solution, utilisez /rebuild à la place.

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

Exemples

La commande suivante génère le projet CSharpWinApp, à l’aide de la configuration de build de projet Debug 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 (fichier.msi), vous avez besoin d’un projet d’installation , qui a un fichier projet .vdproj, 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 nouvelle configuration, par exemple Setup, en fonction de la configuration Release, puis 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, Debug et Release. Une fois la configuration Setup définie, les commandes suivantes créent un projet WindowsFormsApp1 et son projet d’installation associé pour générer le fichier .msi :

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