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

Статья
03/24/2025

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

Это важно

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

Это важно

Задача TThis устарела. Используйте @UseDotNet2.

Синтаксис

# .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/Runtime в файла индекса выпусков.

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-разрядный процесс)

Дополнительные сведения см. в разделе Многоуровневый поиск SharedFX.

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

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

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

Нет.

Замечания

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

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

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

Требования

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

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