VSBuild@1 — задача сборки Visual Studio версии 1
Используйте эту задачу для сборки с помощью MSBuild и задания свойства версии Visual Studio. Дополнительные сведения об установке образов Visual Studio в Azure.
Синтаксис
# Visual Studio build v1
# Build with MSBuild and set the Visual Studio version property.
- task: VSBuild@1
inputs:
solution: '**\*.sln' # string. Required. Solution. Default: **\*.sln.
#vsVersion: 'latest' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '11.0'. Visual Studio Version. Default: latest.
#msbuildArgs: # string. MSBuild Arguments.
#platform: # string. Platform.
#configuration: # string. Configuration.
#clean: false # boolean. Clean. Default: false.
# Advanced
#maximumCpuCount: false # boolean. Build in Parallel. Default: false.
#restoreNugetPackages: false # boolean. Restore NuGet Packages. Default: false.
#msbuildArchitecture: 'x86' # 'x86' | 'x64'. MSBuild Architecture. Default: x86.
#logProjectEvents: true # boolean. Record Project Details. Default: true.
#createLogFile: false # boolean. Create Log File. Default: false.
#logFileVerbosity: 'normal' # 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic'. Optional. Use when createLogFile = true. Log File Verbosity. Default: normal.
#enableDefaultLogger: true # boolean. Enable Default Logger. Default: true.
#customVersion: # string. Custom Version.
# Visual Studio build v1
# Build with MSBuild and set the Visual Studio version property.
- task: VSBuild@1
inputs:
solution: '**\*.sln' # string. Required. Solution. Default: **\*.sln.
#vsVersion: 'latest' # 'latest' | '16.0' | '15.0' | '14.0' | '12.0' | '11.0'. Visual Studio Version. Default: latest.
#msbuildArgs: # string. MSBuild Arguments.
#platform: # string. Platform.
#configuration: # string. Configuration.
#clean: false # boolean. Clean. Default: false.
# Advanced
#maximumCpuCount: false # boolean. Build in Parallel. Default: false.
#restoreNugetPackages: false # boolean. Restore NuGet Packages. Default: false.
#msbuildArchitecture: 'x86' # 'x86' | 'x64'. MSBuild Architecture. Default: x86.
#logProjectEvents: true # boolean. Record Project Details. Default: true.
#createLogFile: false # boolean. Create Log File. Default: false.
#logFileVerbosity: 'normal' # 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic'. Optional. Use when createLogFile = true. Log File Verbosity. Default: normal.
Входные данные
solution
-
решения
string
. Обязательное. Значение по умолчанию: **\*.sln
.
Задает решение для задачи, используемой в процессе сборки.
Если вы хотите создать одно решение, нажмите кнопку ... и укажите решение.
Если вы хотите создать несколько решений, укажите условия поиска. Можно использовать подстановочные знаки с одной папкой (*
) и рекурсивные подстановочные знаки (**
). Например, **.sln
выполняет поиск всех .sln файлов во всех подкаталогах.
Убедитесь, что указанные решения скачиваются этим конвейером сборки. На вкладке репозитория:
- Если вы используете TFVC, убедитесь, что решение является дочерним элементом одного из сопоставлений на вкладке репозитория.
- Если вы используете Git, убедитесь, что проект или решение находится в репозитории Git и в ветви, которую вы создаете.
Подсказка
- Вы также можете создать файлы проекта MSBuild (.*proj).
- Если вы создаете настроенный файл проекта MSBuild, рекомендуется использовать задачу MSBuild вместо задачи сборки Visual Studio.
vsVersion
-
версии Visual Studio
string
. Допустимые значения: latest
, 17.0
(Visual Studio 2022), 16.0
(Visual Studio 2019), 15.0
(Visual Studio 2017), 14.0
(Visual Studio 2015), 12.0
(Visual Studio 2013), 11.0
(Visual Studio 2012). Значение по умолчанию: latest
.
Значение этого ввода должно соответствовать версии Visual Studio, используемой для создания решения.
Добавляет аргумент /p:VisualStudioVersion={numeric_visual_studio_version}
в команду MSBuild, выполняемую сборкой. Например, если указать Visual Studio 2015, /p:VisualStudioVersion=14.0
добавляется в команду MSBuild.
Azure Pipelines. Если ваша команда хочет использовать Visual Studio с агентами, размещенными корпорацией Майкрософт, выберите последние windows в качестве пула сборок по умолчанию. См. размещенных корпорацией Майкрософт агентов.
vsVersion
-
версии Visual Studio
string
. Допустимые значения: latest
, 16.0
(Visual Studio 2019), 15.0
(Visual Studio 2017), 14.0
(Visual Studio 2015), 12.0
(Visual Studio 2013), 11.0
(Visual Studio 2012). Значение по умолчанию: latest
.
Значение этого ввода должно соответствовать версии Visual Studio, используемой для создания решения.
Добавляет аргумент /p:VisualStudioVersion={numeric_visual_studio_version}
в команду MSBuild, выполняемую сборкой. Например, если указать Visual Studio 2015, /p:VisualStudioVersion=14.0
добавляется в команду MSBuild.
Azure Pipelines. Если ваша команда хочет использовать Visual Studio с агентами, размещенными корпорацией Майкрософт, выберите последние windows в качестве пула сборок по умолчанию. См. размещенных корпорацией Майкрософт агентов.
msbuildArgs
-
аргументы MSBuild
string
.
Передает дополнительные аргументы в MSBuild. Сведения о синтаксисе см. в справочнике по MSBuildCommand-Line.
platform
-
платформы
string
.
Указывает платформу, которую требуется создать, например Win32
, x86
, x64
или any cpu
.
Подсказка
- Если вы нацелены на файл проекта MSBuild (.*proj) вместо решения, укажите
AnyCPU
(без пробелов). - Объявите переменную сборки, например
BuildPlatform
на вкладке "Переменные" (выберите "Разрешить во время очереди") и сослаться на нее как$(BuildPlatform)
. Таким образом можно изменить платформу при очереди сборки и включить создание нескольких конфигураций.
конфигурации configuration
-
string
.
Указывает конфигурацию, которую требуется создать, например debug
или release
.
Подсказка
Объявите переменную сборки, например BuildConfiguration
на вкладке "Переменные" (выберите "Разрешить во время очереди") и сослаться на нее как $(BuildConfiguration)
. Таким образом можно изменить платформу при очереди сборки и включить создание нескольких конфигураций.
clean
-
Очистка
boolean
. Значение по умолчанию: false
.
Если задано значение false
, задача выполняет добавочную сборку. Этот параметр может сократить время сборки, особенно если база кода велика. Этот параметр не имеет практического эффекта, если вы также не установите для репозитория Clean значение false
.
Если задано значение true
, задача перестраивает весь код в проектах кода. Это эквивалентно аргументу MSBuild /target:clean
.
maximumCpuCount
-
сборка параллельного
boolean
. Значение по умолчанию: false
.
Необязательно. Если целевая конфигурация MSBuild совместима с сборкой параллельно, можно проверить эти входные данные, чтобы передать /m
переключиться на MSBuild (только Для Windows). Если целевая конфигурация несовместима с сборкой параллельно, проверка этого параметра может привести к возникновению ошибок использования файлов или периодических или несогласованных сбоев сборки.
restoreNugetPackages
-
восстановление пакетов NuGet
boolean
. Значение по умолчанию: false
.
Эти входные данные устарели. Чтобы восстановить пакеты NuGet, добавьте перед сборкой задачу установщика инструментов NuGet.
архитектуры MSBuild msbuildArchitecture
-
string
. Допустимые значения: x86
(MSBuild x86), x64
(MSBuild x64). Значение по умолчанию: x86
.
Необязательно. Предоставляет архитектуру (x86
или x64
) MSBuild для запуска.
Подсказка
Так как Visual Studio работает как 32-разрядное приложение, при обработке сборки агентом сборки, выполняющим 64-разрядную версию Team Foundation Build Service, могут возникнуть проблемы. Выбрав MSBuild x86
, вы можете устранить эти проблемы.
logProjectEvents
-
сведения о проекте записи
boolean
. Значение по умолчанию: true
.
Необязательно. Записывает сведения о временной шкале для каждого проекта.
createLogFile
-
создание файла журнала
boolean
. Значение по умолчанию: false
.
Необязательно. Создает файл журнала (только Для Windows).
logFileVerbosity
-
файлов журнала
string
. Необязательно. Используется при createLogFile = true
. Допустимые значения: quiet
, minimal
, normal
, detailed
, diagnostic
. Значение по умолчанию: normal
.
Указывает уровень детализации в файлах журнала.
enableDefaultLogger
-
включить средство ведения журнала по умолчанию
boolean
. Значение по умолчанию: true
.
Если задано значение true
, включает средство ведения журнала по умолчанию для MSBuild.
customVersion
-
настраиваемую версию
string
.
Задает пользовательскую версию Visual Studio. Примеры: 15.0
, 16.0
, 17.0
. Требуемая версия Visual Studio должна быть установлена в системе.
Azure Pipelines. Если ваша команда хочет использовать Visual Studio 2022 с агентами, размещенными корпорацией Майкрософт, выберите windows-2022
в качестве пула сборок по умолчанию. Дополнительные сведения см. в размещенных корпорацией Майкрософт агентов.
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.
Выходные переменные
Нет.
Замечания
Дополнительные сведения об установке образов Visual Studio в Azure.
Это важно
Эта задача поддерживается только в агентах под управлением Windows.
Требования
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка |
Выполняется в | Агент, DeploymentGroup |
требования | Локальные агенты должны иметь возможности, соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: msbuild, visualstudio |
возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
ограничения команд | Любое |
переменные settable | Любое |
Версия агента | 1.95.0 или более поздней версии |
Категория задач | Строить |