UseDotNet@2 – Använda dotnet v2-uppgift

Använd den här uppgiften 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 den här uppgiften om du vill ändra den version 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. 
    #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 för att installera
string. Tillåtna värden: runtime, sdk (SDK (innehåller körning)). Standardvärde: sdk.

Anger om du bara ska installera .NET-körningen eller SDK:t.

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 genomsöks från system.DefaultWorkingDirectory. Du kan ändra sökvägen till sökroten genom att ange arbetskatalogindata.

Formatet 6.x och 6.1.x (med .x som jokertecken) som beskrivs i UseDotNet@2.version indata används i version indata i aktiviteten, 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.jsonkontrollerar du sdk.version i global.json.

Mer information om global.jsonfinns i Välj den .NET-version som ska användas.

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

Anger sökvägen där global.json filer ska sökas efter när du använder useGlobalJson. Om värdet är tomt betraktas system.DefaultWorkingDirectory som rotsökväg.

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

Anger vilken version av .NET Core SDK eller körning som ska installeras. Versionsvärdeformaten visas med exempel:

• 2.x: Installerar den senaste SDK:t eller körningen med den angivna huvudversionen 2.
• 3.1.x: Installerar den senaste SDK:t eller körningen med angivna större och mindre versioner, 3 och 1.
• 3.1.402: Installerar angiven SDK eller körningsversion 3.1.402.

Versionsvärdena för SDK- eller körningsinstallationer finns i filen releases.json. Länken till releases.json för en större/mindre version finns i filen releases-index. Till exempel länken till filen releases.json för version 3.1.

vsVersion - Kompatibel Visual Studio-version
string.

Anger en kompatibel Visual Studio-version för en motsvarande .NET Core SDK-installation. Värdet måste vara ett fullständigt versionsnummer, till exempel 16.6.4, som innehåller en huvudversion, en delversion och ett korrigeringsnummer.

Versionsvärdena för SDK- eller körningsinstallationer, som används för version strängen, finns i filen releases.json. Länken till releases.json för en större/mindre version finns i filen releases-index. Till exempel länken till filen releases.json för version 3.1.

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

Om värdet är inställt på true, innehåller förhandsversioner när uppgiften söker efter de senaste versionerna av runtime/SDK, till exempel sökning efter 2.2.x eller 3.1.x. Den här inställningen ignoreras om du anger en exakt version, till exempel 3.0.100-preview3-010431.

installationPath - sökväg för att installera .Net Core
string. Standardvärde: $(Agent.ToolsDirectory)/dotnet.

Anger var .NET Core SDK/Runtime ska installeras. Olika sökvägar kan ha följande inverkan på . NET:s beteende.

• $(Agent.ToolsDirectory): Om du använder den här sökvägen cachelagras installationen på agenten, eftersom den här katalogen inte rensas mellan pipelines. Alla pipelines som körs på agenten har åtkomst till de tidigare installerade versionerna.
• $(Agent.TempDirectory): Om du använder den här sökvägen ser du till att en pipeline inte använder en cachelagrad version av .NET Core, eftersom den här mappen rensas efter varje pipeline.
• En annan sökväg: Du kan använda valfri sökväg om agentprocessen har åtkomst till sökvägen. Detta ändrar datorns tillstånd och påverkar alla processer som körs på den.

Not

Du kan använda inställningen sökning på flera nivåer, performMultiLevelLookup, för att konfigurera hur .NET-värden söker efter versioner.

performMultiLevelLookup - utföra uppslag på flera nivåer
boolean. Standardvärde: false.

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

• false: Värdprocessen söker bara efter versioner som finns i mappen som anges av uppgiften.
• true: Värdprocessen söker på fördefinierade globala platser med hjälp av uppslag på flera nivåer. De globala standardplatserna är:
  • C:\Program Files\dotnet (64-bitarsprocesser)
  • C:\Program Files (x86)\dotnet (32-bitarsprocesser)

Läs mer om SharedFX-sökning på flera nivåer.

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-begäranden som aktiviteten gör för att hämta .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 Använd .NET Core hämtar en specifik version av .NET Core- från Internet eller verktygscachen och lägger till den i PATH för Azure Pipelines-agenten (värdbaserad eller privat). Använd den här uppgiften om du vill ändra den version av .NET Core som används i efterföljande uppgifter som DotNetCoreCLI@2. Genom att lägga till den här uppgiften före DotNetCoreCLI@2 i en versionsdefinition ser du till att versionen blir tillgänglig när du skapar, testar och publicerar din app.

Med metoden för verktygsinstallation kan du också frikoppla från agentuppdateringscyklerna. Om den .NET Core-version som du letar efter saknas i Azure Pipelines-agenten (värdbaserad eller privat) kan du använda den här uppgiften för att få rätt version installerad på agenten.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Om du kör den här uppgiften uppfyller följande krav för efterföljande aktiviteter i samma jobb: DotNetCore
Kommandobegränsningar	Någon
variabler som kan	Någon
Agentversion	2.144.0 eller senare
Aktivitetskategori	Verktyg