/Build (devenv.exe)

使用指定解决方案配置文件来生成解决方案或项目。

语法

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

自变量

  • SolutionName

    必需。 解决方案文件的路径和名称,相对于解决方案的目录。

  • SolnConfigName

    可选。 要用于生成 SolutionName 中命名的解决方案的解决方案配置的名称(如 DebugRelease)。 如果有多个解决方案平台可用,还必须指定平台(例如,Debug|Win32)。 如果未指定此参数或字符串为空 (""),工具便会使用解决方案的有效配置。

  • /Project ProjName

    可选。 解决方案中项目文件的路径和名称。 可以输入从 SolutionName 文件夹到项目文件的相对路径、项目的显示名称或项目文件的完整路径和名称

  • /ProjectConfig ProjConfigName

    可选。 要在生成已命名项目时使用的项目生成配置的名称(如 DebugRelease)。 如果有多个解决方案平台可用,还必须指定平台(例如,Debug|Win32)。 如果此开关已指定,它会替代 SolnConfigName 参数。

  • /Out OutputFilename

    可选。 要将工具输出发送到的文件的文件名。 如果文件已有,工具将输出追加到文件末尾。

注解

  • 在集成开发环境 (IDE) 中,/Build 开关执行与“生成解决方案”菜单命令相同的功能。

  • 用双引号将含有空格的字符串引起来。

  • 与生成相关的摘要信息(包括错误)可以显示在“命令”窗口中,也可以显示在使用 /Out 开关指定的任何日志文件中。

  • /Build 开关仅生成自上次生成后发生变化的项目。 若要生成解决方案中的所有项目,请改用 /rebuild

  • 如果看到错误消息“项目配置无效”,请确保已指定解决方案平台或项目平台(例如,Debug|Win32)。

示例

下面的命令使用 MySolution 中的 Debug 项目生成配置来生成项目 CSharpWinApp

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

清理所有生成文件:

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

生成安装项目

若要生成安装程序(.msi文件),需要一个具有.vdproj项目文件的安装程序项目,但要生成它,首先需要应用设置特定注册表项的解决方法。 在 Visual Studio 开发人员命令提示符下,从文件夹 Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild 中运行可执行文件DisableOutOfProcBuild.exe。 如果没有此解决方法,可能会收到错误: ERROR: An error occurred while validating. HRESULT = '8000000A' 该命令会影响当前用户,因此对于生成代理方案,请务必从运行生成的同一帐户运行它。 有关详细信息,请参阅 同一文件夹中README.txt 文件。

此外,在 Visual Studio 中,可以根据配置创建新配置SetupRelease,并选择安装项目作为要生成的项目。 默认情况下,设置项目不包括在默认配置中, Debug 并且 Release。 定义配置后 Setup ,以下命令生成项目 WindowsFormsApp1 及其关联的安装项目以生成 .msi 文件:

devenv WindowsFormsApp1.sln /build Setup

如果解决方案已使用 “发布” 配置生成,则此命令只会生成安装项目。

另请参阅