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