Поделиться через


DotNetCoreInstaller@1 — задача пакета SDK для .NET Core или установщика среды выполнения версии 1

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

Важно!

Эта задача устарела и будет прекращена 31 января 2024 г. Используйте UseDotNet@2.

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

Важно!

TЭтая задача является устаревшей. Используйте @UseDotNet2.

Получает определенную версию пакета SDK для .NET Core из Интернета или локального кэша и добавляет ее в PATH.

Синтаксис

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #includePreviewVersions: false # boolean. Include Preview Versions. Default: false.
  # Advanced
    #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.

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


version - Версия
string. Обязательный. Значение по умолчанию: 2.2.x.

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

Используйте следующий формат, чтобы указать версию:

  • 2.x: устанавливает последнюю в основной версии.
  • 2.2.x. Устанавливает последнюю версию в основной и дополнительной версиях.
  • 2.2.104: устанавливает точную версию.

Найдите значение version для установки пакета SDK или среды выполнения в файле releases-index.


includePreviewVersions - Включить предварительные версии
boolean. Значение по умолчанию: false.

Указывает, нужно ли включать предварительные версии при поиске последних версий. Этот параметр игнорируется при указании точной версии, например 3.0.100-preview3-010431.


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

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

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

Вы также можете настроить параметр Многоуровневый уточняющий запрос. Этот параметр позволяет настроить узел .NET для проверки подходящей версии.


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

Эти входные данные применимы только к агентам windows. Эти входные данные настраивают поведение хост-процессов .NET для поиска подходящей общей платформы. False означает, что ведущем процессе будут искаться только версии, имеющиеся в папке, указанной в этой задаче. True означает, что узел попытается выполнить поиск в предварительно определенных глобальных расположениях с помощью многоуровневого поиска.

Для Windows глобальные расположения по умолчанию:

  • C:\Program Files\dotnet (64-разрядные процессы)
  • C:\Program Files (x86)\dotnet (32-разрядный процесс)

Дополнительные сведения см. в разделе Multi-level SharedFX Lookup.


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

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

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

Нет.

Remarks

Эта задача является устаревшей. Используйте @UseDotNet2.

Новые возможности этой версии задачи.

  • Поддержка параллельной установки нескольких версий.
  • Поддержка шаблонов в версии для получения последних дополнительных или основных версий.
  • Ограничение многоуровневого поиска.

Требования

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