UseDotNet@2 – Använda dotnet v2-uppgift

Använd denna uppgift för att hämta en specifik version av .NET Core SDK från internet eller den lokala cachen och lägga till den i PATH. Använd denna uppgift för att ändra versionen av .NET Core som används i efterföljande uppgifter. Den här uppgiften ger också proxystöd.

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.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version.
    #checkForExistingVersion: false # boolean. Check for existing installation. Default: false.
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

# 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.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # 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.

# 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.

Ingångar

packageType - Paket att installera
string. Tillåtna värden: runtime, sdk (SDK (innehåller runtime)). Standardvärde: sdk.

Specificerar om man endast ska installera .NET-runtime eller SDK:n.


useGlobalJson - Använd global json
boolean. Valfri. Använd när packageType = sdk. Standardvärde: false.

Installerar alla SDK:er från global.json filer. Dessa filer söks från system.DefaultWorkingDirectory. Du kan ändra sökvägen till sökroten genom att ange arbetskatalogindata.

Uppgiften läser också egenskapen sdk.rollForward från global.json och installerar den senaste versionen som uppfyller den angivna rollforward-policyn. Till exempel, om du global.json specificerar "version": "8.0.302" med "rollForward": "latestFeature", installerar uppgiften den senaste 8.0.x SDK:n istället för exakt version. Om sdk.rollForward inte finns installerar uppgiften exakt den version som anges i sdk.version, som matchar det tidigare beteendet. För mer information om stödda rollForward värden, se avsnittet Anmärkningar och global.json översikt.

Formatet 6.x och 6.1.x (som används .x som joker) som beskrivs i UseDotNet@2.version indata är för användning i version indata i uppgiften, inte parametern sdk.version i global.json.

Om du får ett felmeddelande som ##[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. och du använder global.json, kontrollera i sdk.version din global.json.

För mer information om global.json, se Välj den .NET versionen att använda.


workingDirectory - Arbetskatalog
string. Valfri. Använd när useGlobalJson = true.

Specificerar sökvägen från vilken global.json filer ska sökas när man använder useGlobalJson. Om värdet är tomt, system.DefaultWorkingDirectory kommer att betraktas som rotvägen.


version - version
string. Valfri. Använd när useGlobalJson = false || packageType = runtime.

Specificerar vilken version av .NET Core SDK eller runtime som ska installeras. Versionsvärdeformaten visas med exempel:

  • 2.x: Installerar den senaste SDK:n eller runtime med den angivna huvudversionen, 2.
  • 3.1.x: Installerar den senaste SDK:n eller runtime med de angivna huvud- och minorversionerna, 3 och 1.
  • 3.1.402: Installerar den angivna SDK- eller runtimeversionen, 3.1.402.

Versionsvärdena för SDK- eller runtime-installationer finns i filen releases.json . Länken till en releases.json major/minor-version finns i releases-index-filen . Till exempel länken till releases.json-filen för version 3.1.


vsVersion - kompatibel Visual Studio version
string.

Specificerar en kompatibel Visual Studio-version för en motsvarande .NET Core SDK-installation. Värdet måste vara ett komplett versionsnummer, såsom 16.6.4, som innehåller en huvudversion, en mindre version och ett patchnummer.

Versionsvärdena för SDK- eller runtime-installationer, som används för strängen version , finns i filen releases.json . Länken till en releases.json major/minor-version finns i releases-index-filen . Till exempel länken till releases.json-filen för version 3.1.


checkForExistingVersion - Kontrollera om installationen finns
boolean. Standardvärde: false.

Välj om du vill upptäcka om den angivna versionen redan är installerad innan du försöker ladda ner. Använd endast när installationPath är tom, dvs. satt till standardvärde.


includePreviewVersions - Inkludera förhandsversioner
boolean. Valfri. Använd när useGlobalJson = false || packageType = runtime. Standardvärde: false.

Om den är satt till true, inkluderar förhandsversioner när uppgiften söker efter de senaste runtime-/SDK-versionerna, såsom att söka efter 2.2.x eller 3.1.x. Denna inställning ignoreras om du anger en exakt version, såsom 3.0.100-preview3-010431.


installationPath - Väg till installation av .NET Core
string. Standardvärde: $(Agent.ToolsDirectory)/dotnet.

Specificerar var .NET Core SDK/Runtime ska installeras. Olika vägar kan ha följande påverkan på .NET:s beteende.

  • $(Agent.ToolsDirectory): Med denna sökväg cachas installationen på agenten, eftersom denna katalog inte rensas över pipelines. Alla pipelines som körs på agenten har åtkomst till de tidigare installerade versionerna.
  • $(Agent.TempDirectory): Att använda denna sökväg säkerställer att en pipeline inte använder en cachad version av .NET Core, eftersom denna mapp rensas efter varje pipeline.
  • En annan väg: Du kan använda vilken väg som helst om agentprocessen har tillgång till vägen. Detta ändrar datorns tillstånd och påverkar alla processer som körs på den.

Not

Du kan använda inställningen Multi-Level Lookup, performMultiLevelLookup, för att konfigurera hur .NET värd söker efter versioner.


performMultiLevelLookup - Utför flernivåuppslagning
boolean. Standardvärde: false.

konfigurerar beteendet hos .NET-värdprocessen när den söker efter ett lämpligt delat ramverk. Värdena är:

  • false: Värdprocessen söker endast efter versioner som finns i mappen som anges av uppgiften.
  • true: Värdprocessen kommer att söka på fördefinierade globala platser med hjälp av flernivåuppslag. De globala standardplatserna är:
    • C:\Program Files\dotnet (64-bitars processer)
    • C:\Program Files (x86)\dotnet (32-bitars processer)

Läs mer om flernivå-SharedFX-uppslag.

Not

performMultiLevelLookup gäller endast för Windows baserade agenter.


requestTimeout - Ange tidsgräns för pakethämtningsbegäran
string. Standardvärde: 300000.

Ange ett timeout-värde för HTTP-förfrågningar som uppgiften gör för att få .NET-paketet. Värdet är i millisekunder. Standardvärdet är 300000 millisekunder (5 minuter). Får inte vara mer än 600 000 millisekunder (10 minuter).


Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Uppgiften Use .NET Core hämtar en specifik version av .NET Core från inte rnet eller verktygscachen och lägger till den i PATH för Azure-pipelines-agenten (hostad eller privat). Använd denna uppgift för att ändra versionen av .NET Core som används i efterföljande uppgifter som DotNetCoreCLI@2. Att lägga till denna uppgift före DotNetCoreCLI@2 i en byggdefinition säkerställer att versionen är tillgänglig vid tidpunkten för byggande, testning och publicering av din app.

Med metoden för verktygsinstallation kan du också frikoppla från agentuppdateringscyklerna. Om .NET Core-versionen du letar efter saknas i Azure-pipelines-agenten (hostad eller privat), kan du använda denna uppgift för att få rätt version installerad på agenten.

Roll-forward-stöd med global.json

När useGlobalJson är satt till true, läser uppgiften egenskapen sdk.rollForward från din global.json fil och installerar den senaste SDK-versionen som uppfyller den angivna rollforward-policyn. För disable, patch, feature, och minor policys matchar detta hur .NET CLI löser SDK-versioner lokalt; major och latestMajor löses för närvarande inom samma huvudversion.

Om inte sdk.rollForward finns i din global.json, installerar uppgiften exakt den version som anges i sdk.version. Detta stämmer överens med det tidigare beteendet.

Följande tabell visar hur varje rollForward värde påverkar versionsupplösningen:

rollForward-värde Behavior Exempel: versionen 8.0.302 löses till
disable Installerar exakt den angivna versionen. 8.0.302
patch Installerar den senaste patchen inom samma funktionsområde. Senaste >=8.0.300 <8.0.400
latestPatch Samma som patch. Senaste >=8.0.300 <8.0.400
feature Installerar det senaste funktionsbandet i samma major.minor-version. Senaste 8.0.x
latestFeature Samma som feature. Senaste 8.0.x
minor Installerar den senaste mindre versionen inom samma huvudversion. Senaste 8.x
latestMinor Samma som minor. Senaste 8.x
major Installerar den senaste versionen i samma huvudversion. Senaste 8.x
latestMajor Samma som major. Senaste 8.x

Not

I UseDotNet@2 löses och latestMajor policys major för närvarande endast inom samma huvudversion. Upplösning på flera större versioner stöds ännu inte.

Om innehåller global.json ett icke-igenkänt rollForward värde loggar uppgiften en varning och återgår till att installera exakt den version som anges i sdk.version.

För fullständig specifikation av rollForward värden, se global.json översikt.

Examples

Installera det senaste funktionsbandet med hjälp av global.json

Följande global.json fil specificerar SDK-version 8.0.302 med rollForward satt till latestFeature. Uppgiften installerar det senaste 8.0.x tillgängliga SDK:t.

{
  "sdk": {
    "version": "8.0.302",
    "rollForward": "latestFeature"
  }
}

steps:
- task: UseDotNet@2
  displayName: 'Install .NET SDK from global.json'
  inputs:
    packageType: 'sdk'
    useGlobalJson: true

Installera den senaste patchen inom ett funktionsområde med hjälp av global.json

Följande global.json fil specificerar SDK-version 8.0.302 med rollForward satt till latestPatch. Uppgiften installerar den senaste SDK-versionen inom 8.0.3xx funktionsområdet.

{
  "sdk": {
    "version": "8.0.302",
    "rollForward": "latestPatch"
  }
}

steps:
- task: UseDotNet@2
  displayName: 'Install .NET SDK from global.json'
  inputs:
    packageType: 'sdk'
    useGlobalJson: true

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
kräver Ingen
Möjligheter Att köra denna uppgift uppfyller följande krav för eventuella efterföljande uppgifter i samma jobb: DotNetCore
Kommandobegränsningar Någon
variabler som kan Någon
Agentversion 2.144.0 eller senare
Aktivitetskategori Verktyg

Se även

  • Last updated on