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。
此任务版本中的新增功能。
- 支持并行安装多个版本。
- 支持使用版本模式来提取次/主版本中的最新内容。
- 限制多级查找。