UseDotNet@2 – Použití úlohy dotnet v2

Pomocí této úlohy získáte konkrétní verzi sady .NET Core SDK z internetu nebo místní mezipaměti a přidáte ji do cesty. Pomocí této úlohy můžete změnit verzi .NET Core, která se použije v následujících úlohách. Tato úloha také poskytuje podporu proxy serveru.

Syntax

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Vstupy

packageType - Balíček k instalaci
string. Povolené hodnoty: runtime, sdk (SADA SDK (obsahuje modul runtime)). Výchozí hodnota: sdk.

Určuje, jestli se má nainstalovat pouze modul runtime .NET nebo sada SDK.

useGlobalJson - Použití globálního kódu JSON
boolean. Nepovinný parametr. Použijte, když packageType = sdk. Výchozí hodnota: false.

Nainstaluje všechny sady SDK ze global.json souborů. Tyto soubory se prohledávají z system.DefaultWorkingDirectory. Kořenovou cestu hledání můžete změnit nastavením vstupu pracovního adresáře.

Formát 6.x a 6.1.x (použití .x jako zástupný znak) popsaný ve UseDotNet@2.version vstupu slouží k použití ve version vstupu v úkolu, nikoli parametru sdk.version v global.json.

Pokud se zobrazí chybová zpráva typu ##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. a používáte global.json, zkontrolujte sdk.versionglobal.jsonv .

Další informace o global.jsonnajdete v tématu Výběr verze rozhraní .NET, která se má použít.

workingDirectory - Pracovní adresář
string. Nepovinný parametr. Použijte, když useGlobalJson = true.

Určuje cestu, ze které global.json se mají hledat soubory při použití příkazu useGlobalJson. Pokud je hodnota prázdná, system.DefaultWorkingDirectory bude považována za kořenovou cestu.

version - Verze
string. Nepovinný parametr. Použijte, když useGlobalJson = false || packageType = runtime.

Určuje verzi sady .NET Core SDK nebo modulu runtime, který se má nainstalovat. Formáty hodnot verze jsou zobrazeny s příklady:

• 2.x: Nainstaluje nejnovější sadu SDK nebo modul runtime se zadanou hlavní verzí 2.
• 3.1.x: Nainstaluje nejnovější sadu SDK nebo modul runtime se zadanými hlavními verzemi a podverzemi 3 a 1.
• 3.1.402: Nainstaluje zadanou sadu SDK nebo verzi 3.1.402modulu runtime .

Hodnoty verze pro sady SDK nebo instalace modulu runtime jsou v releases.json souboru . Odkaz na releases.json hlavní nebo podverzi je v souboru releases-index . Například odkaz na soubor releases.json pro verzi 3.1.

vsVersion - Kompatibilní verze sady Visual Studio
string.

Určuje kompatibilní verzi sady Visual Studio pro odpovídající instalaci sady .NET Core SDK. Hodnota musí být celé číslo verze, například 16.6.4, které obsahuje hlavní verzi, podverzi a číslo opravy.

Hodnoty verzí pro sady SDK nebo instalace modulu runtime, které se používají pro version řetězec, jsou v releases.json souboru . Odkaz na releases.json hlavní nebo podverzi je v souboru releases-index . Například odkaz na soubor releases.json pro verzi 3.1.

includePreviewVersions - Zahrnout verze Preview
boolean. Nepovinný parametr. Použijte, když useGlobalJson = false || packageType = runtime. Výchozí hodnota: false.

Pokud je nastavená na truehodnotu , zahrne verze Preview, když úloha hledá nejnovější verze modulu runtime nebo sady SDK, jako 2.2.x je hledání nebo 3.1.x. Toto nastavení se ignoruje, pokud zadáte přesnou verzi, například 3.0.100-preview3-010431.

installationPath - Cesta k instalaci .Net Core
string. Výchozí hodnota: $(Agent.ToolsDirectory)/dotnet.

Určuje, kde se má nainstalovat sada .NET Core SDK/Runtime. Různé cesty můžou mít následující vliv na . Chování sítě NET.

• $(Agent.ToolsDirectory): Při použití této cesty se instalace agenta ukládá do mezipaměti, protože tento adresář se nevyčistí napříč kanály. Všechny kanály spuštěné v agentu mají přístup k dříve nainstalovaným verzím.
• $(Agent.TempDirectory): Použitím této cesty zajistíte, že kanál nepoužívá verzi .NET Core uloženou v mezipaměti, protože tato složka se po každém kanálu vyčistí.
• Jiná cesta: Pokud má proces agenta přístup k cestě, můžete použít libovolnou cestu. Tím se změní stav počítače a ovlivní se všechny procesy, které na něm běží.

Poznámka

Pomocí nastavení víceúrovňového vyhledávání můžete nakonfigurovat, performMultiLevelLookupjak hostitel .NET hledá verze.

performMultiLevelLookup - Provést víceúrovňové vyhledávání
boolean. Výchozí hodnota: false.

Konfiguruje chování hostitelského procesu .NET při hledání vhodné sdílené architektury. Hodnoty jsou:

• false: Hostitelský proces vyhledá jenom verze, které jsou přítomné ve složce určené úlohou.
• true: Hostitelský proces bude vyhledávat v předdefinovaných globálních umístěních pomocí víceúrovňového vyhledávání. Výchozí globální umístění jsou:
  • C:\Program Files\dotnet (64bitové procesy)
  • C:\Program Files (x86)\dotnet (32bitové procesy)

Přečtěte si další informace o vyhledávání sharedFX s více úrovněmi.

Poznámka

performMultiLevelLookup se vztahuje pouze na agenty systému Windows.

Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů i možnosti řízení. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Úloha Použít .NET Core získá konkrétní verzi .NET Core z internetu nebo mezipaměti nástrojů a přidá ji do cesty agenta Azure Pipelines (hostovaného nebo privátního). Pomocí této úlohy můžete změnit verzi rozhraní .NET Core použitou v následných úlohách , jako je DotNetCoreCLI@2. Přidáním této úlohy před DotNetCoreCLI@2 v definici sestavení zajistíte, že verze bude dostupná v době sestavování, testování a publikování aplikace.

Přístup k instalačnímu programu nástrojů vám také umožňuje oddělit se od cyklů aktualizace agenta. Pokud v agentovi Azure Pipelines (hostované nebo privátní) chybí hledaná verze .NET Core, můžete pomocí této úlohy nainstalovat správnou verzi agenta.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Spuštění této úlohy splňuje následující požadavky na všechny následné úkoly ve stejné úloze: DotNetCore
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	2.144.0 nebo vyšší
Kategorie úloh	Nástroj