/Build (devenv.exe)
使用指定的解决方案配置文件生成解决方案或项目。
语法
devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig ProjConfigName]] [/Out OutputFilename]]
参数
SolutionName
必填。 解决方案文件的路径和名称,相对于解决方案的目录。
SolnConfigName
自选。 解决方案配置(如
Debug
或Release
)的名称,用于生成 SolutionName中命名的解决方案。 如果有多个解决方案平台可用,则还必须指定平台(例如,Debug|Win32
)。 如果未指定此参数或空字符串(""
),该工具将使用解决方案的活动配置。/Project
ProjName自选。 解决方案中项目文件的路径和名称。 可以将 SolutionName 文件夹中的相对路径输入到项目文件、项目的显示名称或项目文件的完整路径和名称。
/ProjectConfig
ProjConfigName自选。 生成命名项目时要使用的项目生成配置的名称(如
Debug
或Release
)。 如果有多个解决方案平台可用,则还必须指定平台(例如,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
),并选择安装项目作为要生成的项目。 默认情况下,设置项目不包括在默认配置中,Debug
和 Release
。 定义 Setup
配置后,以下命令将生成项目 WindowsFormsApp1
及其关联的安装项目以生成 .msi
文件:
devenv WindowsFormsApp1.sln /build Setup
如果解决方案已使用 Release 配置生成,则此命令将生成安装项目。