DotNetCoreInstaller@1 - Attività .NET Core SDK/runtime installer v1

Usare questa attività per acquisire una versione specifica di .NET Core SDK da Internet o dalla cache locale e aggiungerla al percorso.

Importante

Questa attività è deprecata e verrà ritirata il 31 gennaio 2024. Usare UseDotNet@2.

Sintassi

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #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.

Input

packageType - Pacchetto da installare
string. Obbligatorio. Valori consentiti: runtime (Solo runtime), sdk (SDK (contiene runtime)). Valore predefinito: sdk.

Specifica se installare solo Runtime o l'SDK completo.

version - Versione
string. Obbligatorio. Valore predefinito: 2.2.x.

Specifica la versione di .NET Core SDK o runtime da installare.

Usare il formato seguente per specificare la versione:

• 2.x: installa la versione più recente nella versione principale.
• 2.2.x: installa la versione più recente nella versione principale e secondaria.
• 2.2.104: installa la versione esatta.

Trovare il valore di per l'installazione di version SDK/Runtime nel file releases-index.

includePreviewVersions - Includi versioni di anteprima
boolean. Valore predefinito: false.

Specifica se si desidera includere le versioni di anteprima durante la ricerca delle versioni più recenti. 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): determina la versione da memorizzare nella cache nell'agente perché questa directory non viene pulita tra le pipeline. Tutte le pipeline in esecuzione nell'agente avrebbero accesso alle versioni installate in precedenza usando l'agente.
• $(Agent.TempDirectory): ciò consente di assicurarsi che una pipeline non usi alcuna versione memorizzata nella cache di .NET Core perché questa cartella viene pulita dopo ogni pipeline.
• Qualsiasi altro percorso: è possibile configurare qualsiasi altro percorso, dato che 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.

È anche possibile configurare l'impostazione Ricerca a più livelli. Questa impostazione può configurare l'host .NET per eseguire il probe per una versione appropriata.

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

Questo input è applicabile solo agli agenti basati su Windows. Questo input configura il comportamento dei processi host .NET per la ricerca di un framework condiviso appropriato. False significa che solo le versioni presenti nella cartella specificata in questa attività verranno esaminate dal processo host. True significa che l'host tenterà di cercare in posizioni globali predefinite usando La ricerca a più livelli.

Per Windows, i percorsi globali predefiniti sono:

• C:\Program Files\dotnet (processi a 64 bit)
• C:\Program Files (x86)\dotnet (processo a 32 bit)

Per altre informazioni, vedere Ricerca SharedFX a più livelli.

Opzioni di controllo delle attività

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

Variabili di output

Nessuno.

Osservazioni

Si tratta di un'attività deprecata. Usare @UseDotNet2.

Novità di questa versione dell'attività.

• Supporto per l'installazione affiancata di più versioni.
• Supporto per i modelli nella versione per recuperare la versione più recente nella versione secondaria/principale.
• Limitare la ricerca a più livelli.

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	Tutte le versioni dell'agente supportate.
Categoria attività	Strumento