/Build (devenv.exe)

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

语法

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

参数

  • SolutionName

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

  • SolnConfigName

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

  • /Project ProjName

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

  • /ProjectConfig ProjConfigName

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

  • /Out OutputFilename

    自选。 要向其发送工具输出的文件的名称。 如果文件已存在,该工具会将输出追加到文件的末尾。

言论

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

  • 将包含空格的字符串括在双引号中。

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

  • /Build 开关仅生成自上次生成以来已更改的项目。 若要生成解决方案中的所有项目,请改用 /重新生成

  • 如果收到错误消息,指出 项目配置无效,请确保已指定解决方案平台或项目平台(例如,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 Developer 命令提示符下,从 common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild 文件夹中运行可执行文件 DisableOutOfProcBuild.exe。 如果没有此解决方法,可能会收到错误:ERROR: An error occurred while validating. HRESULT = '8000000A'。 该命令会影响当前用户,因此对于生成代理方案,请务必从运行生成的同一帐户运行它。 有关详细信息,请参阅同一文件夹中 README.txt 文件。

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

devenv WindowsFormsApp1.sln /build Setup

如果解决方案已使用 Release 配置生成,则此命令将生成安装项目。

另请参阅