UseDotNet@2 – Dotnet v2-feladat használata

Ezzel a feladatsal beszerezheti a .NET Core SDK egy adott verzióját az internetről vagy a helyi gyorsítótárból, és hozzáadhatja azt a PATH-hoz. Ezzel a feladatsal módosíthatja a későbbi feladatokban használt .NET Core-verziót. Ez a feladat proxytámogatást is biztosít.

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.

Bevitelek

packageType - Telepítendő csomag
string. Engedélyezett értékek: runtime, sdk (SDK (futtatókörnyezetet tartalmaz)). Alapértelmezett érték: sdk.

Meghatározza, hogy csak a .NET-futtatókörnyezetet vagy az SDK-t telepítse-e.

useGlobalJson - Globális JSON használata
boolean. Választható. Használja a következőt: packageType = sdk. Alapértelmezett érték: false.

Minden SDK-t fájlból global.json telepít. Ezekre a fájlokra a rendszer a következő webhelyen system.DefaultWorkingDirectorykeres rá: . A keresési gyökér elérési útját a munkakönyvtár bemenetének beállításával módosíthatja.

A 6.x bemenetben UseDotNet@2.version leírt és 6.1.x formátum (helyettesítő karakterként való használat.x) a version tevékenység bemenetében használható, nem pedig a sdk.version paraméterbenglobal.json.

Ha egy ehhez hasonló ##[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. hibaüzenetet kap, és használja a parancsot global.json, ellenőrizze a következőt: sdk.versionglobal.json.

További információ: global.jsonVálassza ki a használni kívánt .NET-verziót.

workingDirectory - Munkakönyvtár
string. Választható. Használja a következőt: useGlobalJson = true.

Azt az elérési utat adja meg, ahol global.json a fájlokat keresni kell a használata useGlobalJsonsorán. Ha az érték üres, system.DefaultWorkingDirectory akkor a rendszer gyökérútvonalnak tekinti.

version - Változat
string. Választható. Használja a következőt: useGlobalJson = false || packageType = runtime.

Megadja a telepíteni kívánt .NET Core SDK vagy futtatókörnyezet verzióját. A verzióérték-formátumok példákkal jelennek meg:

• 2.x: Telepíti a legújabb SDK-t vagy futtatókörnyezetet a megadott főverzióval( 2).
• 3.1.x: Telepíti a legújabb SDK-t vagy futtatókörnyezetet a megadott fő- és alverziókkal, 3 és 1.
• 3.1.402: Telepíti a megadott SDK-t vagy futtatókörnyezeti verziót( 3.1.402).

Az SDK- vagy futtatókörnyezet-telepítések verzióértékei a releases.json fájlban találhatók. A főverzió/alverzió hivatkozása releases.json a releases-index fájlban található. Például a 3.1-es verzió releases.json fájljára mutató hivatkozás.

vsVersion - Kompatibilis Visual Studio-verzió
string.

Egy kompatibilis Visual Studio-verziót ad meg a megfelelő .NET Core SDK-telepítéshez. Az értéknek teljes verziószámnak kell lennie, például 16.6.4: , amely egy főverziót, egy alverziót és egy javítási számot tartalmaz.

A sztringhez version használt SDK- vagy futtatókörnyezet-telepítések verzióértékei a releases.json fájlban találhatók. A főverzió/alverzió hivatkozása releases.json a releases-index fájlban található. Például a 3.1-es verzió releases.json fájljára mutató hivatkozás.

includePreviewVersions - Előzetes verzió belefoglalása
boolean. Választható. Használja a következőt: useGlobalJson = false || packageType = runtime. Alapértelmezett érték: false.

Ha a értékre truevan állítva, akkor az előzetes verziókat is tartalmazza, amikor a feladat a legújabb futtatókörnyezeti/SDK-verziókat keresi, például a vagy 3.1.xa verziót2.2.x. Ez a beállítás figyelmen kívül lesz hagyva, ha pontos verziót ad meg, például 3.0.100-preview3-010431: .

installationPath - A .Net Core telepítésének elérési útja
string. Alapértelmezett érték: $(Agent.ToolsDirectory)/dotnet.

Megadja, hogy hol kell telepíteni a .NET Core SDK-t/futtatókörnyezetet. A különböző elérési utak a következő hatással lehetnek a következőre: . A NET viselkedése.

• $(Agent.ToolsDirectory): Ezzel az elérési úttal gyorsítótárazza a telepítést az ügynökön, mivel ez a könyvtár nem lesz megtisztítva a folyamatok között. Az ügynökön futó összes folyamat hozzáfér a korábban telepített verziókhoz.
• $(Agent.TempDirectory): Ezzel az elérési úttal biztosítható, hogy a folyamatok ne használják a .NET Core gyorsítótárazott verzióját, mivel ez a mappa minden folyamat után törlődik.
• Másik elérési út: Bármilyen elérési utat használhat, ha az ügynökfolyamat hozzáfér az elérési úthoz. Ez megváltoztatja a gép állapotát, és hatással lesz a rajta futó összes folyamatra.

Megjegyzés

A többszintű keresés beállításával konfigurálhatja, performMultiLevelLookuphogy a .NET-gazdagép hogyan keressen verziókat.

performMultiLevelLookup - Többszintű keresés végrehajtása
boolean. Alapértelmezett érték: false.

Konfigurálja a .NET-gazdagépfolyamat viselkedését, amikor megfelelő megosztott keretrendszert keres. Az értékek a következők:

• false: A gazdagépfolyamat csak azokat a verziókat keresi, amelyek a feladat által megadott mappában találhatók.
• true: A gazdagépfolyamat előre meghatározott globális helyeken keres többszintű kereséssel. Az alapértelmezett globális helyek a következők:
  • C:\Program Files\dotnet (64 bites folyamatok)
  • C:\Program Files (x86)\dotnet (32 bites folyamatok)

További információ a többszintű SharedFX-keresésről.

Megjegyzés

performMultiLevelLookup csak Windows-alapú ügynökökre vonatkozik.

Tevékenységvezérlési beállítások

A tevékenységbemeneteken kívül minden tevékenység rendelkezik vezérlési lehetőségekkel. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

A .NET Core használata feladat beszerzi a .NET Core egy adott verzióját az internetről vagy az eszközök gyorsítótárából, és hozzáadja azt az Azure Pipelines-ügynök PATH -hoz (üzemeltetett vagy privát). Ezzel a feladatsal módosíthatja a .NET Core későbbi feladatokban, például a DotNetCoreCLI@2 használt verzióját. Ha ezt a feladatot a builddefinícióban szereplő DotNetCoreCLI@2 előtt adja hozzá, akkor a verzió elérhető lesz az alkalmazás létrehozása, tesztelése és közzététele során.

Az eszköztelepítő módszer lehetővé teszi az ügynök frissítési ciklusainak leválasztására is. Ha a keresett .NET Core-verzió hiányzik az Azure Pipelines-ügynökből (üzemeltetett vagy privát), akkor ezzel a feladatsal telepítheti a megfelelő verziót az ügynökre.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	A feladat futtatása megfelel a következő követelményeknek az ugyanabban a feladatban lévő összes további tevékenységre vonatkozóan: DotNetCore
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	2.144.0 vagy újabb
Feladatkategória	Eszköz