VCBuild Task
Повторно выполняет файл vcbuild.exe, с помощью которого создаются проекты и решения Visual C++, содержащие проекты Visual C++.Дополнительные сведения см. в разделе Справочник VCBUILD.
Параметры
В следующей таблице описаны параметры задачи VCBuild.
Параметр |
Свойство |
|---|---|
AdditionalLibPaths |
Необязательный параметр типа ITaskItem[]. Задает дополнительные пути для переменной среды LIBPATH перед выполнением vcbuild.exe. |
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).Если значение этого параметра не задано, используется путь установки пакета SDK, соответствующий версии среды, в которой выполняется MSBuild.Если в качестве целевой платформы используется .NET 3.5, vcbuild.exe — это 32-разрядный исполняемый модуль, поэтому этот путь должен указывать на Program Files (x86). |
UseEnvironment |
Необязательный параметр Boolean. Значение true следует задать, если требуется использовать переменные среды для путей INCLUDE и LIB; в противном случае необходимо установить значение false. |
AdditionalLinkLibraryPaths |
Необязательный параметр String. Задает дополнительные местоположения ссылок для переменной среды LIB.Файл Link.exe использует путь LIB при выполнении поиска файла, указанного в командной строке ссылки, например файла объекта или библиотеки.Переменная среды не используется файлом Lib.exe. |
Пример
В следующем примере задача VCBuild используется для построения проектов, определяемых коллекцией элементов vcprojects.
<VCBuild
Projects="@(vcprojects)"
Configuration="$(configuration)"
Rebuild="true"/>