UseDotNet@2 – Dotnet v2-Aufgabe verwenden

Verwenden Sie diese Aufgabe, um eine bestimmte Version des .NET Core SDK aus dem Internet oder dem lokalen Cache abzurufen und dem PATH 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.
    #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.

Eingänge

packageType - Paket zum Installieren von
string. Zulässige Werte: runtime, sdk (SDK (enthält Laufzeit)). Standardwert: sdk.

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

useGlobalJson - Verwenden von globalen JSON-
boolean. Wahlfrei. Wird verwendet, wenn packageType = sdk. Standardwert: false.

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

Das 6.x- und 6.1.x-Format (unter Verwendung von .x als Wildcard), das in der UseDotNet@2.version Eingabe beschrieben ist, ist für die Verwendung in der version Eingabe in der Aufgabe, nicht der sdk.version Parameter 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. erhalten und global.jsonverwenden, überprüfen Sie die sdk.version in Ihrer global.json.

Weitere Informationen zu global.jsonfinden Sie unter Wählen Sie die .NET-Version aus, umzu verwenden.

workingDirectory - Arbeitsverzeichnis-
string. Wahlfrei. Wird verwendet, wenn useGlobalJson = true.

Gibt den Pfad an, von dem global.json Dateien bei Verwendung von useGlobalJsondurchsucht werden sollen. Wenn der Wert leer ist, wird system.DefaultWorkingDirectory als Stammpfad betrachtet.

version - Version
string. Wahlfrei. Wird verwendet, wenn useGlobalJson = false || packageType = runtime.

Gibt die Version des zu installierenden .NET Core SDK oder der Laufzeit an. Die Versionswertformate werden mit Beispielen gezeigt:

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

Die Versionswerte für SDK- oder Laufzeitinstallationen befinden sich in der datei releases.json. Der Link zum releases.json einer Haupt-/Nebenversion befindet sich in der Versionsindexdatei Datei. Beispielsweise der Link zur releases.json Datei 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. B. 16.6.4, 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 zum releases.json einer Haupt-/Nebenversion befindet sich in der Versionsindexdatei Datei. Beispielsweise der Link zur releases.json Datei für Version 3.1.

includePreviewVersions - Vorschauversionen einschließen
boolean. Wahlfrei. Wird verwendet, wenn useGlobalJson = false || packageType = runtime. Standardwert: false.

Wenn diese Einstellung auf truefestgelegt ist, enthält Vorschauversionen, wenn die Aufgabe nach neuesten Laufzeit-/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 - Pfad zum Installieren von .Net Core-
string. Standardwert: $(Agent.ToolsDirectory)/dotnet.

Gibt an, wo das .NET Core SDK/Runtime installiert werden soll. Verschiedene Pfade können sich auf folgende Auswirkungen auswirken. NET-Verhalten.

• $(Agent.ToolsDirectory): Die Verwendung dieses Pfads speichert die Installation auf dem Agent zwischen, da dieses Verzeichnis nicht über Pipelines hinweg bereinigt wird. Alle pipelines, die auf dem Agent ausgeführt werden, haben Zugriff auf die zuvor installierten Versionen.
• $(Agent.TempDirectory): Durch die Verwendung dieses Pfads wird sichergestellt, dass eine Pipeline keine zwischengespeicherte Version von .NET Core verwendet, da dieser Ordner nach jeder Pipeline bereinigt wird.
• Ein anderer Pfad: Sie können einen beliebigen Pfad verwenden, wenn der Agentprozess Zugriff auf den Pfad hat. Dadurch wird der Zustand des Computers geändert und sich auf alle prozesse auswirken, die darauf ausgeführt werden.

Anmerkung

Sie können die Einstellung für die Suche auf mehreren Ebenen performMultiLevelLookupverwenden, um zu konfigurieren, wie der .NET-Host nach Versionen sucht.

performMultiLevelLookup - Nachschlagevorgang auf mehreren Ebenen
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 im Ordner vorhanden sind, der von der Aufgabe angegeben wird.
• true: Der Hostprozess sucht an vordefinierten globalen Standorten mithilfe der mehrstufigen Suche. Die standardmäßigen globalen Speicherorte sind:
  • C:\Program Files\dotnet (64-Bit-Prozesse)
  • C:\Program Files (x86)\dotnet (32-Bit-Prozesse)

Erfahren Sie mehr über mehrstufige SharedFX-Suche.

Anmerkung

performMultiLevelLookup gilt nur für Windows-basierte Agents.

requestTimeout - Timeout für paketdownloadanforderungs- festlegen
string. Standardwert: 300000.

Stellen Sie einen Timeoutwert für HTTP-Anforderungen bereit, die die Aufgabe zum Abrufen des .NET-Pakets vorgibt. Der Wert ist in Millisekunden. Der Standardwert ist 300000 Millisekunden (5 Minuten). Maximal 600000 Millisekunden (10 Minuten).

Aufgabensteuerungsoptionen

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

Ausgabevariablen

Nichts.

Bemerkungen

Die .NET Core-Aufgabe verwendet eine bestimmte Version von .NET Core aus dem Internet oder dem Toolscache 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@2verwendet wird. Durch das 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 wäre.

Der Ansatz des Toolinstallationsprogramms ermöglicht ihnen auch die Entkoppelung von den Agent-Updatezyklen. Wenn die gesuchte .NET Core-Version im Azure Pipelines-Agent (gehostet oder privat) fehlt, können Sie diese Aufgabe verwenden, um die richtige Version auf dem Agent zu installieren.

Anforderungen

Anforderung	Beschreibung
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Das Ausführen dieser Aufgabe erfüllt die folgenden Anforderungen für nachfolgende Aufgaben im selben Auftrag: DotNetCore
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.144.0 oder höher
Vorgangskategorie	Werkzeug