UseDotNet@2 - Usare l'attività dotnet v2

Usare questa attività per acquisire una versione specifica di .NET Core SDK da Internet o dalla cache locale e aggiungerla al percorso. Usare questa attività per modificare la versione di .NET Core usata nelle attività successive. Questa attività fornisce anche il supporto proxy.

Sintassi

# 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.

Ingressi

pacchetto packageType - per installare
string. Valori consentiti: runtime, sdk (SDK (contiene runtime)). Valore predefinito: sdk.

Specifica se installare solo il runtime .NET o l'SDK.

useGlobalJson - Usare json globale
boolean. Opzionale. Usare quando packageType = sdk. Valore predefinito: false.

Installa tutti gli SDK da global.json file. Questi file vengono cercati da system.DefaultWorkingDirectory. È possibile modificare il percorso radice di ricerca impostando l'input della directory di lavoro.

Il formato 6.x e 6.1.x (usando .x come carattere jolly) descritto nell'input UseDotNet@2.version è da usare nell'input version nell'attività, non nel parametro sdk.version in global.json.

Se viene visualizzato un messaggio di errore come ##[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. e si usa global.json, controllare il sdk.version nel global.json.

Per altre informazioni su global.json, vedere Selezionare la versione .NET da usare.

workingDirectory - directory di lavoro
string. Opzionale. Usare quando useGlobalJson = true.

Specifica il percorso da cui eseguire la ricerca dei file global.json quando si usa useGlobalJson. Se il valore è vuoto, system.DefaultWorkingDirectory verrà considerato come percorso radice.

version - versione
string. Opzionale. Usare quando useGlobalJson = false || packageType = runtime.

Specifica la versione di .NET Core SDK o del runtime da installare. I formati dei valori di versione vengono visualizzati con esempi:

• 2.x: installa l'SDK o il runtime più recente con la versione principale specificata, 2.
• 3.1.x: installa l'SDK o il runtime più recenti con le versioni principali e secondarie specificate, 3 e 1.
• 3.1.402: installa l'SDK o la versione di runtime specificata, 3.1.402.

I valori della versione per le installazioni SDK o runtime si trovano nel file releases.json. Il collegamento alla di una versione principale/secondaria si trova nel file release-index . Ad esempio, il collegamento al file releases.json per la versione 3.1.

vsVersion - versione compatibile di Visual Studio
string.

Specifica una versione compatibile di Visual Studio per un'installazione corrispondente di .NET Core SDK. Il valore deve essere un numero di versione completo, ad esempio 16.6.4, che contiene una versione principale, una versione secondaria e un numero di patch.

I valori della versione per le installazioni SDK o runtime, usati per la stringa version, si trovano nel file releases.json. Il collegamento alla di una versione principale/secondaria si trova nel file release-index . Ad esempio, il collegamento al file releases.json per la versione 3.1.

includePreviewVersions - includi versioni di anteprima
boolean. Opzionale. Usare quando useGlobalJson = false || packageType = runtime. Valore predefinito: false.

Se impostato su true, include le versioni di anteprima quando l'attività cerca le versioni più recenti di runtime/SDK, ad esempio la ricerca di 2.2.x o 3.1.x. Questa impostazione viene ignorata se si specifica una versione esatta, ad esempio 3.0.100-preview3-010431.

percorso installationPath - per installare .Net Core
string. Valore predefinito: $(Agent.ToolsDirectory)/dotnet.

Specifica dove deve essere installato .NET Core SDK/Runtime. I percorsi diversi possono avere l'impatto seguente su . Comportamento di NET.

• $(Agent.ToolsDirectory): l'uso di questo percorso memorizza nella cache l'installazione nell'agente, perché questa directory non viene pulita tra le pipeline. Tutte le pipeline in esecuzione nell'agente hanno accesso alle versioni installate in precedenza.
• $(Agent.TempDirectory): l'uso di questo percorso garantisce che una pipeline non usi una versione memorizzata nella cache di .NET Core, perché questa cartella viene pulita dopo ogni pipeline.
• Un altro percorso: è possibile usare qualsiasi percorso se il processo dell'agente ha accesso al percorso. Questo modificherà lo stato del computer e influirà su tutti i processi in esecuzione su di esso.

Nota

È possibile usare l'impostazione ricerca a più livelli, , per configurare il modo in cui l'host .NET cerca le versioni.

performMultiLevelLookup - eseguire di ricerca a più livelli
boolean. Valore predefinito: false.

Configura il comportamento del processo host .NET quando cerca un framework condiviso appropriato. I valori sono:

• false: il processo host cerca solo le versioni presenti nella cartella specificata dall'attività.
• true: il processo host cercherà in posizioni globali predefinite usando la ricerca a più livelli. Le posizioni globali predefinite sono:
  • C:\Program Files\dotnet (processi a 64 bit)
  • C:\Program Files (x86)\dotnet (processi a 32 bit)

Altre informazioni su ricerca SharedFX a più livelli.

Nota

performMultiLevelLookup è applicabile solo agli agenti basati su Windows.

requestTimeout - Impostare il timeout per la richiesta di download del pacchetto
string. Valore predefinito: 300000.

Specificare un valore di timeout per le richieste HTTP eseguite dall'attività per ottenere il pacchetto .NET. Il valore è espresso in millisecondi. Il valore predefinito è 300000 millisecondi (5 minuti). Non può essere superiore a 600000 millisecondi (10 minuti).

Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

L'attività Usa .NET Core acquisisce una versione specifica di .NET Core da Internet o dalla cache degli strumenti e la aggiunge al percorso dell'agente di Azure Pipelines (ospitato o privato). Usare questa attività per modificare la versione di .NET Core usata nelle attività successive, ad esempio DotNetCoreCLI@2. L'aggiunta di questa attività prima del DotNetCoreCLI@2 in una definizione di compilazione garantisce che la versione sia disponibile al momento della compilazione, del test e della pubblicazione dell'app.

L'approccio del programma di installazione dello strumento consente anche di separare i cicli di aggiornamento dell'agente. Se la versione di .NET Core che si sta cercando non è presente nell'agente di Azure Pipelines (ospitato o privato), è possibile usare questa attività per installare la versione corretta nell'agente.

Fabbisogno

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Nessuno
funzionalità di	L'esecuzione di questa attività soddisfa le richieste di seguenti per le attività successive nello stesso processo: DotNetCore
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	2.144.0 o versione successiva
Categoria attività	Strumento