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"/>