UseDotNet@2 . Использование задачи dotnet версии 2

Используйте эту задачу, чтобы получить определенную версию пакета SDK для .NET Core из Интернета или локального кэша и добавить ее в PATH. Эта задача используется для изменения версии .NET Core, используемой в последующих задачах. Эта задача также обеспечивает поддержку прокси-сервера.

Синтаксис

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Входные данные

packageType - Пакет для установки
string. Допустимые значения: runtime, sdk (пакет SDK (содержит среду выполнения)). Значение по умолчанию: sdk.

Указывает, следует ли устанавливать только среду выполнения .NET или пакет SDK.

useGlobalJson - Использование глобального json
boolean. Необязательный элемент. Используйте при packageType = sdk. Значение по умолчанию: false.

Устанавливает все пакеты SDK из global.json файлов. Поиск в этих файлах выполняется из system.DefaultWorkingDirectory. Вы можете изменить корневой путь поиска, задав входные данные рабочего каталога.

Формат 6.x и 6.1.x (с использованием .x в качестве подстановочного знака), описанный во UseDotNet@2.version входных данных, предназначен для использования во version входных данных задачи, а sdk.version не параметр в global.json.

Если вы получаете сообщение об ошибке, например ##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. , и используете global.json, проверьте sdk.version в .global.json

Дополнительные сведения о global.jsonсм. в разделе Выбор используемой версии .NET.

workingDirectory - Рабочий каталог
string. Необязательный элемент. Используйте при useGlobalJson = true.

Указывает путь, из которого global.json следует искать файлы при использовании useGlobalJson. Если значение пустое, system.DefaultWorkingDirectory будет рассматриваться как корневой путь.

version - Версия
string. Необязательный элемент. Используйте при useGlobalJson = false || packageType = runtime.

Указывает версию пакета SDK для .NET Core или среды выполнения для установки. Форматы значений версии показаны с примерами:

• 2.x: устанавливает последнюю версию пакета SDK или среды выполнения с указанной основной версией . 2
• 3.1.x: устанавливает последнюю версию пакета SDK или среды выполнения с указанными основными и дополнительными версиями и 31.
• 3.1.402: устанавливает указанную версию пакета SDK или среды выполнения. 3.1.402

Значения версий для установки пакета SDK или среды выполнения находятся в releases.json файле . Ссылка на releases.json основную или дополнительную версию находится в файле releases-index . Например, ссылка на файл releases.json для версии 3.1.

vsVersion - Совместимая версия Visual Studio
string.

Указывает совместимую версию Visual Studio для соответствующей установки пакета SDK для .NET Core. Значение должно быть полным номером версии, например 16.6.4, который содержит основную версию, дополнительный номер версии и номер исправления.

Значения версий для установок пакета SDK или среды выполнения, которые используются для version строки, находятся в releases.json файле . Ссылка на releases.json основную или дополнительную версию находится в файле releases-index . Например, ссылка на файл releases.json для версии 3.1.

includePreviewVersions - Включить предварительные версии
boolean. Необязательный элемент. Используйте при useGlobalJson = false || packageType = runtime. Значение по умолчанию: false.

Если задано значение true, включает предварительные версии, когда задача ищет последние версии среды выполнения или пакета SDK, например поиск 2.2.x или 3.1.x. Этот параметр игнорируется при указании точной версии, например 3.0.100-preview3-010431.

installationPath - Путь к установке .Net Core
string. Значение по умолчанию: $(Agent.ToolsDirectory)/dotnet.

Указывает, где должен быть установлен пакет SDK или среда выполнения для .NET Core. Различные пути могут иметь следующее влияние на . Поведение NET.

• $(Agent.ToolsDirectory): использование этого пути кэширует установку на агенте, так как этот каталог не очищается в конвейерах. Все конвейеры, работающие в агенте, имеют доступ к ранее установленным версиям.
• $(Agent.TempDirectory): использование этого пути гарантирует, что конвейер не использует кэшированную версию .NET Core, так как эта папка очищается после каждого конвейера.
• Другой путь. Вы можете использовать любой путь, если процесс агента имеет доступ к пути. Это изменит состояние компьютера и повлияет на все выполняемые на нем процессы.

Примечание

Чтобы настроить поиск версий узла .NET, performMultiLevelLookupможно использовать параметр Многоуровневый уточняющий запрос.

performMultiLevelLookup - Выполнение многоуровневого поиска
boolean. Значение по умолчанию: false.

Настраивает поведение хост-процесса .NET при поиске подходящей общей платформы. Значения качества производительности:

• false: ведущий процесс ищет только версии, которые присутствуют в папке, указанной задачей.
• true: хост-процесс выполняет поиск в предопределенных глобальных расположениях с помощью многоуровневого поиска. Глобальные расположения по умолчанию:
  • C:\Program Files\dotnet (64-разрядные процессы)
  • C:\Program Files (x86)\dotnet (32-разрядные процессы)

Узнайте больше о многоуровневом поиске SharedFX.

Примечание

performMultiLevelLookup применяется только к агентам на основе Windows.

Параметры управления задачами

Все задачи имеют параметры управления в дополнение к входным данным задачи. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Задача Использование .NET Core получает определенную версию .NET Core из Интернета или кэша инструментов и добавляет ее в ПУТЬ агента Azure Pipelines (размещенного или закрытого). Используйте эту задачу для изменения версии .NET Core, используемой в последующих задачах, таких как DotNetCoreCLI@2. Добавление этой задачи перед DotNetCoreCLI@2 в определении сборки гарантирует, что версия будет доступна во время сборки, тестирования и публикации приложения.

Подход установщика инструментов также позволяет отделять от циклов обновления агента. Если в агенте Azure Pipelines отсутствует версия .NET Core (размещенная или частная), вы можете использовать эту задачу, чтобы получить нужную версию, установленную в агенте.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	Нет
Capabilities	Выполнение этой задачи удовлетворяет следующим требованиям для всех последующих задач в том же задании: DotNetCore
Ограничения команд	Любой
Устанавливаемые переменные	Любой
Версия агента	2.144.0 или более поздней версии
Категория задач	Инструмент