使用此任务可从 Internet 或本地缓存获取特定版本的 .NET Core SDK,并将其添加到 PATH。
重要
此任务已弃用,将于 2024 年 1 月 31 日停用。 使用 UseDotNet@2。
使用此任务可从 Internet 或本地缓存获取特定版本的 .NET Core SDK,并将其添加到 PATH。
重要
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.
输入
要安装 的
string。 必填。 允许的值:runtime(仅运行时)、sdk(SDK(包含运行时))。 默认值:sdk。
指定是仅安装运行时还是完整 SDK。
version
-
版本
string。 必填。 默认值:2.2.x。
指定要安装的 .NET Core SDK 或运行时的版本。
使用以下格式指定版本:
- 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。
指定应安装 .NET Core SDK/Runtime 的位置。 不同的路径可能会对以下问题产生影响。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。
此任务版本中的新增功能。
- 支持并行安装多个版本。
- 支持版本中的模式以提取次要/主版本中的最新模式。
- 限制多级查找。