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.
# 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
#installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
#performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.
# Use dotnet 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.
#version: # string. Version.
#includePreviewVersions: false # boolean. Include Preview Versions. Default: false.
# Advanced
#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.DefaultWorkingDirectory
gesucht. 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.json
finden 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 useGlobalJson
wird. 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 und3
1
.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.
version
- Version
string
.
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 und3
1
.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 true
festgelegt 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
. .
includePreviewVersions
- Vorschauversionen einschließen
boolean
. Standardwert. false
.
Wenn auf true
festgelegt 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, performMultiLevelLookup
wie 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 |
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 | Alle unterstützten Agent-Versionen. |
Aufgabenkategorie | Tool |