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

Input

packageType - Pacchetto da 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. Facoltativa. Usare quando packageType = sdk. Valore predefinito: false.

Installa tutti gli SDK dai 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 6.x formato e 6.1.x (usando .x come carattere jolly) descritto nell'input è destinato all'uso UseDotNet@2.version nell'input nell'attività version , non nel sdk.version parametro in global.json.

Se viene visualizzato un messaggio di errore simile ##[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. a e si usa global.json, controllare in sdk.versionglobal.json.

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

workingDirectory - Directory di lavoro
string. Facoltativa. Usare quando useGlobalJson = true.

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

version - Versione
string. Facoltativa. 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ù recente con le versioni 3 principali e secondarie specificate e 1.
• 3.1.402: installa l'SDK o la versione di runtime specificata, 3.1.402.

I valori di versione per le installazioni SDK o runtime si trovano nel releases.json file . Il collegamento a releases.json di una versione principale/secondaria si trova nel file releases-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 version stringa, si trovano nel releases.json file . Il collegamento a releases.json di una versione principale/secondaria si trova nel file releases-index . Ad esempio, il collegamento al file releases.json per la versione 3.1.

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

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

installationPath - Percorso 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 , performMultiLevelLookup, per configurare il modo in cui l'host .NET cerca le versioni.

performMultiLevelLookup - Eseguire una ricerca a più livelli
boolean. Valore predefinito: false.

Configura il comportamento del processo host .NET quando cerca un framework condiviso appropriato. I valori possibili 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 sulla ricerca SharedFX a più livelli.

Nota

performMultiLevelLookup è applicabile solo agli agenti basati su Windows.

Opzioni di controllo attività

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

Variabili di output

No.

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 degli strumenti 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.

Requisiti

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