UseDotNet@2: Verwenden eines dotnet v2-Tasks

Verwenden Sie diese Aufgabe, um eine bestimmte Version des .NET Core SDK aus dem Internet oder dem lokalen Cache zu erhalten und sie dem PFAD hinzuzufügen. Verwenden Sie diese Aufgabe, um die Version von .NET Core zu ändern, die in nachfolgenden Aufgaben verwendet wird. Diese Aufgabe bietet auch Proxyunterstützung.

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.

Eingaben

packageType - Zu installierende Paket
string. Zulässige Werte: runtime, sdk (SDK (enthält Runtime)). Standardwert. sdk.

Gibt an, ob nur die .NET-Runtime oder das SDK installiert werden soll.

useGlobalJson - Verwenden eines globalen JSON-Codes
boolean. Optional. Verwenden Sie , wenn packageType = sdk. Standardwert. false.

Installiert alle SDKs aus global.json Dateien. Diese Dateien werden von system.DefaultWorkingDirectorygesucht. Sie können den Suchstammpfad ändern, indem Sie die Arbeitsverzeichniseingabe festlegen.

Das 6.x in der UseDotNet@2.version Eingabe beschriebene Format und 6.1.x (mit .x einem Feldhalter) dient der Verwendung in der version Eingabe in der Aufgabe, nicht des sdk.version Parameters in global.json.

Wenn Sie eine Fehlermeldung wie ##[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. und Sie verwenden global.json, aktivieren Sie die sdk.version in Ihrem global.json.

Weitere Informationen zu global.jsonfinden Sie unter Auswählen der zu verwendenden .NET-Version.

workingDirectory - Arbeitsverzeichnis
string. Optional. Verwenden Sie , wenn useGlobalJson = true.

Gibt den Pfad an, von dem global.json aus Dateien durchsucht werden sollen, wenn verwendet useGlobalJsonwird. Wenn der Wert leer ist, system.DefaultWorkingDirectory wird als Stammpfad betrachtet.

version - Version
string. Optional. Verwenden Sie , wenn useGlobalJson = false || packageType = runtime.

Gibt die Zu installierende Version des .NET Core SDK oder der Runtime an. Die Versionswertformate werden anhand von Beispielen dargestellt:

• 2.x: Installiert das neueste SDK oder die neueste Runtime mit der angegebenen Hauptversion. 2
• 3.1.x: Installiert das neueste SDK oder die neueste Runtime mit den angegebenen Haupt- und Nebenversionen und 31.
• 3.1.402: Installiert das angegebene SDK oder die angegebene Laufzeitversion. 3.1.402

Die Versionswerte für SDK- oder Laufzeitinstallationen befinden sich in der releases.json Datei. Der Link zu releases.json einer Haupt-/Nebenversion befindet sich in der Datei releases-index . Beispielsweise der Link zur Datei releases.json für Version 3.1.

vsVersion - Kompatible Visual Studio-Version
string.

Gibt eine kompatible Visual Studio-Version für eine entsprechende .NET Core SDK-Installation an. Der Wert muss eine vollständige Versionsnummer sein, z 16.6.4. B. , die eine Hauptversion, eine Nebenversion und eine Patchnummer enthält.

Die Versionswerte für SDK- oder Laufzeitinstallationen, die für die version Zeichenfolge verwendet werden, befinden sich in der releases.json Datei. Der Link zu releases.json einer Haupt-/Nebenversion befindet sich in der Datei releases-index . Beispielsweise der Link zur Datei releases.json für Version 3.1.

includePreviewVersions - Vorschauversionen einschließen
boolean. Optional. Verwenden Sie , wenn useGlobalJson = false || packageType = runtime. Standardwert. false.

Wenn auf truefestgelegt ist, schließt Vorschauversionen ein, wenn der Task nach den neuesten Runtime-/SDK-Versionen sucht, z. B. nach 2.2.x oder 3.1.x. Diese Einstellung wird ignoriert, wenn Sie eine genaue Version angeben, z. B 3.0.100-preview3-010431. .

installationPath - Installationspfad .NET Core
string. Standardwert. $(Agent.ToolsDirectory)/dotnet.

Gibt an, wo das .NET Core SDK/Runtime installiert werden soll. Verschiedene Pfade können die folgenden Auswirkungen auf haben. Net-Verhalten.

• $(Agent.ToolsDirectory): Mithilfe dieses Pfads wird die Installation auf dem Agent zwischengespeichert, da dieses Verzeichnis nicht pipelineübergreifend bereinigt wird. Alle Pipelines, die auf dem Agent ausgeführt werden, haben Zugriff auf die zuvor installierten Versionen.
• $(Agent.TempDirectory): Mithilfe dieses Pfads wird sichergestellt, dass eine Pipeline keine zwischengespeicherte Version von .NET Core verwendet, da dieser Ordner nach jeder Pipeline bereinigt wird.
• Anderer Pfad: Sie können einen beliebigen Pfad verwenden, wenn der Agentprozess Zugriff auf den Pfad hat. Dadurch ändert sich der Zustand des Computers und wirkt sich auf alle prozesse aus, die darauf ausgeführt werden.

Hinweis

Sie können die Multi-Level-Lookup-Einstellung verwenden, um zu konfigurieren, performMultiLevelLookupwie der .NET-Host nach Versionen sucht.

performMultiLevelLookup - Ausführen von Mehrebenensuche
boolean. Standardwert. false.

Konfiguriert das Verhalten des .NET-Hostprozesses, wenn er nach einem geeigneten freigegebenen Framework sucht. Die Werte sind:

• false: Der Hostprozess sucht nur nach Versionen, die in dem ordner vorhanden sind, der von der Aufgabe angegeben wird.
• true: Der Hostprozess sucht in vordefinierten globalen Speicherorten mithilfe von Suche auf mehreren Ebenen. Die globalen Standardspeicherorte sind:
  • C:\Program Files\dotnet (64-Bit-Prozesse)
  • C:\Program Files (x86)\dotnet (32-Bit-Prozesse)

Erfahren Sie mehr über die Mehrebenen-SharedFX-Suche.

Hinweis

performMultiLevelLookup gilt nur für Windows-basierte Agents.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu den Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Bemerkungen

Der Task .NET Core verwenden ruft eine bestimmte Version von .NET Core über das Internet oder den Toolscache ab und fügt sie dem PFAD des Azure Pipelines-Agents (gehostet oder privat) hinzu. Verwenden Sie diese Aufgabe, um die Version von .NET Core zu ändern, die in nachfolgenden Aufgaben wie DotNetCoreCLI@2 verwendet wird. Durch Hinzufügen dieser Aufgabe vor dem DotNetCoreCLI@2 in einer Builddefinition wird sichergestellt, dass die Version zum Zeitpunkt des Erstellens, Testens und Veröffentlichens Ihrer App verfügbar ist.

Mit dem Ansatz des Toolinstallationsprogramms können Sie sich auch von den Agent-Updatezyklen entkoppeln. Wenn die gesuchte .NET Core-Version im Azure Pipelines-Agent (gehostet oder privat) fehlt, können Sie mit dieser Aufgabe die richtige Version auf dem Agent installieren.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Das Ausführen dieser Aufgabe erfüllt die folgenden Anforderungen für alle nachfolgenden Aufgaben im gleichen Auftrag: DotNetCore
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	2.144.0 oder höher
Aufgabenkategorie	Tool