Задача VCBuild
Обновлен: Ноябрь 2007
Повторно выполняет файл 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. |
UseEnvironment |
Дополнительный параметр Boolean. Значение true следует задать, если требуется использовать переменные среды для путей INCLUDE и LIB; в противном случае необходимо установить значение false. |
AdditionalLinkLibraryPaths |
Дополнительный параметр String. Задает дополнительные местоположения ссылок для переменной среды LIB. Файл Link.exe использует путь LIB при выполнении поиска файла, указанного в командной строке ссылки, например файла объекта или библиотеки. Переменная среды не используется файлом Lib.exe. |
Пример
В следующем примере задача VCBuild используется для построения проектов, определяемых коллекцией элементов vcprojects.
<VCBuild
Projects="@(vcprojects)"
Configuration="$(configuration)"
Rebuild="true"/>