DotNetCoreInstaller@1 - .NET Core SDK/运行时安装程序 v1 任务

使用此任务从 Internet 或本地缓存获取特定版本的 .NET Core SDK,并将其添加到 PATH。

重要

此任务已弃用,将于 2024 年 1 月 31 日停用。 使用 UseDotNet@2

使用此任务从 Internet 或本地缓存获取特定版本的 .NET Core SDK,并将其添加到 PATH。

重要

T 此任务已弃用。 使用 @UseDotNet2

从 Internet 或本地缓存获取特定版本的 .NET Core SDK,并将其添加到 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 (包含 runtime) ) 。 默认值:sdk

指定是仅安装运行时还是完整 SDK。


version - 版本
string. 必需。 默认值:2.2.x

指定要安装的 .NET Core SDK 或运行时的版本。

使用以下格式指定版本:

  • 2.x:安装主版本中的最新版本。
  • 2.2.x:安装主版本和次要版本的最新版。
  • 2.2.104:安装确切版本。

releases-index 文件中查找 用于安装 SDK/运行时的值version


includePreviewVersions - 包括预览版
boolean. 默认值:false

指定在搜索最新版本时是否希望预览版包含在内。 如果指定确切的版本(例如 3.0.100-preview3-010431),则忽略此设置。


installationPath - 安装.Net Core的路径
string. 默认值:$(Agent.ToolsDirectory)/dotnet

指定应安装 .NET Core SDK/运行时的位置。 不同的路径可能会对 产生以下影响。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、经典版本、经典版本
运行平台 Agent、DeploymentGroup
需求
功能 运行此任务满足同一作业中任何后续任务的以下 要求 :DotNetCore
命令限制 任意
可设置变量 任意
代理版本 所有支持的代理版本。
任务类别 工具