UseDotNet@2: dotnet v2-taak gebruiken

Gebruik deze taak om een specifieke versie van de .NET Core SDK van internet of de lokale cache te verkrijgen en deze toe te voegen aan het PAD. Gebruik deze taak om de versie van .NET Core te wijzigen die in volgende taken wordt gebruikt. Deze taak biedt ook proxyondersteuning.

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.

Invoerwaarden

packageType - Pakket om te installeren
string. Toegestane waarden: runtime, sdk (SDK (bevat runtime)). Standaardwaarde: sdk.

Hiermee geeft u op of alleen de .NET-runtime of de SDK moet worden geïnstalleerd.

useGlobalJson - Globale json gebruiken
boolean. Optioneel. Gebruik wanneer packageType = sdk. Standaardwaarde: false.

Installeert alle SDK's uit global.json bestanden. Deze bestanden worden doorzocht vanuit system.DefaultWorkingDirectory. U kunt het hoofdpad van de zoekopdracht wijzigen door de invoer van de werkmap in te stellen.

De 6.x indeling en 6.1.x (met behulp van .x als jokerteken) die in de UseDotNet@2.version invoer wordt beschreven, is bedoeld voor gebruik in de version invoer in de taak, niet voor de sdk.version parameter in global.json.

Als u een foutbericht ontvangt zoals ##[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. en u gebruikt global.json, controleert u de sdk.version in uw global.json.

Zie De te gebruiken .NET-versie selecteren voor meer informatie.global.json

workingDirectory - Werkmap
string. Optioneel. Gebruik wanneer useGlobalJson = true.

Hiermee geeft u het pad op van waaruit global.json bestanden moeten worden doorzocht bij gebruik van useGlobalJson. Als de waarde leeg is, system.DefaultWorkingDirectory wordt dit beschouwd als het hoofdpad.

version - Versie
string. Optioneel. Gebruik wanneer useGlobalJson = false || packageType = runtime.

Hiermee geeft u de versie van de .NET Core SDK of runtime te installeren. De indelingen voor versiewaarden worden weergegeven met voorbeelden:

• 2.x: installeert de meest recente SDK of runtime met de opgegeven primaire versie, 2.
• 3.1.x: installeert de nieuwste SDK of runtime met de opgegeven primaire en secundaire versies, 3 en 1.
• 3.1.402: installeert de opgegeven SDK of runtimeversie, 3.1.402.

De versiewaarden voor SDK- of runtime-installaties bevinden zich in het releases.json bestand. De koppeling naar de releases.json van een primaire/secundaire versie bevindt zich in het bestand releases-index . Bijvoorbeeld de koppeling naar het bestand releases.json voor versie 3.1.

vsVersion - Compatibele Versie van Visual Studio
string.

Hiermee geeft u een compatibele Versie van Visual Studio op voor een bijbehorende .NET Core SDK-installatie. De waarde moet een volledig versienummer zijn, zoals 16.6.4, dat een primaire versie, een secundaire versie en een patchnummer bevat.

De versiewaarden voor SDK- of runtime-installaties, die worden gebruikt voor de version tekenreeks, bevinden zich in het releases.json bestand. De koppeling naar de releases.json van een primaire/secundaire versie bevindt zich in het bestand releases-index . Bijvoorbeeld de koppeling naar het bestand releases.json voor versie 3.1.

includePreviewVersions - Preview-versies opnemen
boolean. Optioneel. Gebruik wanneer useGlobalJson = false || packageType = runtime. Standaardwaarde: false.

Als dit is ingesteld op true, bevat preview-versies wanneer de taak zoekt naar de nieuwste runtime-/SDK-versies, zoals zoeken naar 2.2.x of 3.1.x. Deze instelling wordt genegeerd als u een exacte versie opgeeft, zoals 3.0.100-preview3-010431.

installationPath - Pad om .NET Core te installeren
string. Standaardwaarde: $(Agent.ToolsDirectory)/dotnet.

Hiermee geeft u op waar de .NET Core SDK/Runtime moet worden geïnstalleerd. Verschillende paden kunnen de volgende invloed hebben op . Het gedrag van NET.

• $(Agent.ToolsDirectory): met behulp van dit pad wordt de installatie op de agent in de cache opgeslagen, omdat deze map niet wordt opgeschoond in pijplijnen. Alle pijplijnen die op de agent worden uitgevoerd, hebben toegang tot de eerder geïnstalleerde versies.
• $(Agent.TempDirectory): Als u dit pad gebruikt, zorgt u ervoor dat een pijplijn geen cacheversie van .NET Core gebruikt, omdat deze map na elke pijplijn wordt opgeschoond.
• Een ander pad: u kunt elk pad gebruiken als het agentproces toegang heeft tot het pad. Dit verandert de status van de machine en heeft invloed op alle processen die erop worden uitgevoerd.

Notitie

U kunt de instelling Opzoeken op meerdere niveaus, performMultiLevelLookup, gebruiken om te configureren hoe de .NET-host naar versies zoekt.

performMultiLevelLookup - Zoekactie met meerdere niveaus uitvoeren
boolean. Standaardwaarde: false.

Hiermee configureert u het gedrag van het .NET-hostproces wanneer wordt gezocht naar een geschikt gedeeld framework. De waarden zijn:

• false: het hostproces zoekt alleen naar versies die aanwezig zijn in de map die is opgegeven door de taak.
• true: het hostproces zoekt in vooraf gedefinieerde globale locaties met behulp van zoeken op meerdere niveaus. De standaard globale locaties zijn:
  • C:\Program Files\dotnet (64-bits processen)
  • C:\Program Files (x86)\dotnet (32-bits processen)

Meer informatie over SharedFX-zoekacties met meerdere niveaus.

Notitie

performMultiLevelLookup is alleen van toepassing op Windows-agents.

Opties voor taakbeheer

Alle taken hebben naast de taakinvoer besturingsopties. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

De taak .NET Core gebruiken verkrijgt een specifieke versie van .NET Core via internet of de cache van de hulpprogramma's en voegt deze toe aan het PAD van de Azure Pipelines-agent (gehost of privé). Gebruik deze taak om de versie van .NET Core te wijzigen die wordt gebruikt in volgende taken, zoals DotNetCoreCLI@2. Als u deze taak toevoegt vóór de DotNetCoreCLI@2 in een builddefinitie, zorgt u ervoor dat de versie beschikbaar is op het moment dat uw app wordt gebouwd, getest en gepubliceerd.

Met de methode van het hulpprogramma-installatieprogramma kunt u ook loskoppelen van de updatecycli van de agent. Als de .NET Core-versie die u zoekt ontbreekt in de Azure Pipelines-agent (Gehost of Privé), kunt u deze taak gebruiken om de juiste versie op de agent te installeren.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Het uitvoeren van deze taak voldoet aan de volgende vereisten voor eventuele volgende taken in dezelfde taak: DotNetCore
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.144.0 of hoger
Taakcategorie	Hulpprogramma