VCBuild 任务

更新:2007 年 11 月

包装 vcbuild.exe,该执行程序生成 Visual C++ 项目和包含 Visual C++ 项目的解决方案。有关更多信息,请参见 VCBUILD 参考

参数

下表描述了 VCBuild 任务的参数。

参数

说明

AdditionalLibPaths

可选的 ITaskItem[] 参数。

指定要在执行 vcbuild.exe 之前追加到 LIBPATH 环境变量的附加路径。

AdditionalOptions

可选的 String 参数。

指定没有专用任务参数的附加命令行开关。

Clean

可选的 Boolean 参数。

如果为 true,则指定任务将仅仅输出干净的生成输出。如果 Rebuild 参数为 true,将重写此参数。

Configuration

可选的 String 参数。

指定生成时使用的配置和平台的名称。

例如:Debug|Win32。

此参数还可以用于仅指定配置名称。

Override

可选的 ITaskItem 参数。

指定重写项目文件设置的 VCBuild 属性表文件的位置。

Platform

可选的 String 参数。

指定生成所针对的平台的名称。

Projects

必选的 ITaskItem[] 参数。

指定要生成的项目。

Rebuild

可选的 Boolean 参数。

如果为 true,则指定任务在执行生成之前会清理生成输出。此参数重写 Clean 参数。

SolutionFile

可选的 ITaskItem 参数。

指定生成解决方案时的解决方案文件的完整路径。此参数用于解析解决方案相关的 Visual C++ 项目宏。

Timeout

可选的 Int32 参数。

指定在多少毫秒后终止任务可执行文件。默认值为 Int.MaxValue,这表示没有超时期限。

ToolPath

可选的 String 参数。

指定任务将从什么位置加载基础可执行文件 (vcbuild.exe)。如果未指定此参数,任务将使用与运行 MSBuild 的 Framework 版本对应的 SDK 安装路径。

UseEnvironment

可选的 Boolean 参数。

若要对 INCLUDE 和 LIB 路径使用环境变量,则为 true;否则为 false。

AdditionalLinkLibraryPaths

可选的 String 参数。

指定要追加到 LIB 环境变量的附加引用位置。Link.exe 在搜索 Link 命令行上指定的文件(如对象或库)时,使用 LIB 路径。Lib.exe 不使用环境变量。

示例

下面的示例使用 VCBuild 任务生成 vcprojects 项集合指定的项目。

<VCBuild
   Projects="@(vcprojects)"
   Configuration="$(configuration)"
   Rebuild="true"/>

请参见

概念

MSBuild 任务

MSBuild

其他资源

MSBuild 任务参考