共用方式為

DotNetCoreInstaller@1 - .NET Core SDK/運行時間安裝程式 v1 工作

  • 發行項

使用此工作可從因特網或本機快取取得特定版本的 .NET Core SDK，並將其新增至PATH。

這很重要

此工作已被取代，且將於 2024 年 1 月 31 日淘汰。 使用 UseDotNet@2。

使用此工作可從因特網或本機快取取得特定版本的 .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.

輸入

要安裝 packageType - 套件
string。 必須的。 允許的值：runtime（只限執行時間）、sdk （包含執行時間） 。 預設值：sdk。

指定只安裝 Runtime 或完整 SDK。


version - 版本
string。 必須的。 預設值：2.2.x。

指定要安裝的 .NET Core SDK 或運行時間版本。

使用下列格式來指定版本：

  • 2.x：安裝主要版本中的最新版本。
  • 2.2.x：安裝主要和次要版本中的最新版本。
  • 2.2.104：安裝確切的版本。

在 releases-index 檔案中尋找 version 的值，以在中安裝 SDK/運行時間。


includePreviewVersions - 包含預覽版本
boolean。 預設值：false。

指定是否要在搜尋最新版本時包含預覽版本。 如果您指定確切的版本，例如 3.0.100-preview3-010431，則會忽略此設定。


安裝 .Net Core的 installationPath - 路徑
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。

此工作版本的新功能。

  • 支援並存安裝多個版本。
  • 支援版本中的模式，以擷取次要/主要版本中的最新模式。
  • 限制多層級查閱。

需求

要求 說明
管線類型 YAML、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
需求 沒有
功能 執行此工作符合下列 要求， 相同作業中的任何後續工作：DotNetCore
命令限制 任意
Settable 變數 任意
代理程式版本 所有支援的代理程式版本。
工作類別 工具