DotNetCoreInstaller@1 – .NET Core SDK/runtime installer v1-uppgift

Artikel
05/16/2024

Använd den här uppgiften för att hämta en specifik version av .NET Core SDK från Internet eller lokal cache och lägg till den i PATH.

Viktigt

Den här uppgiften är inaktuell och dras tillbaka den 31 januari 2024. Använd UseDotNet@2.

Använd den här uppgiften för att hämta en specifik version av .NET Core SDK från Internet eller lokal cache och lägg till den i PATH.

Viktigt

Den här uppgiften är inaktuell. Använd @UseDotNet2.

Hämtar en specifik version av .NET Core SDK från Internet eller lokal cache och lägger till den i PATH.

Syntax

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

Indata

packageType - Paket som ska installeras
string. Krävs. Tillåtna värden: runtime (Endast Runtime), sdk (SDK (innehåller runtime)). Standardvärde: sdk.

Anger om du bara vill installera Runtime eller hela SDK:t.

version - Version
string. Krävs. Standardvärde: 2.2.x.

Anger vilken version av .NET Core SDK eller Runtime som ska installeras.

Använd följande format för att ange versionen:

2.x: Installerar det senaste i huvudversion.
2.2.x: Installerar det senaste i huvudversion och delversion.
2.2.104: Installerar den exakta versionen.

Hitta värdet version för för att installera SDK/Runtime i filen releases-index.

includePreviewVersions - Inkludera förhandsversioner
boolean. Standardvärde: false.

Anger om du vill att förhandsversioner ska inkluderas när du söker efter de senaste versionerna. Den här inställningen ignoreras om du anger en exakt version, till exempel 3.0.100-preview3-010431.

installationPath - Sökväg för att installera .Net Core
string. Standardvärde: $(Agent.ToolsDirectory)/dotnet.

Anger var .NET Core SDK/Runtime ska installeras. Olika sökvägar kan ha följande inverkan på . NET:s beteende:

$(Agent.ToolsDirectory): Detta avgör vilken version som ska cachelagras på agenten eftersom den här katalogen inte rensas över pipelines. Alla pipelines som körs på agenten skulle ha åtkomst till de versioner som installerades tidigare med hjälp av agenten.
$(Agent.TempDirectory): Detta kan säkerställa att en pipeline inte använder någon cachelagrad version av .NET Core eftersom den här mappen rensas efter varje pipeline.
Valfri annan sökväg: Du kan konfigurera valfri annan sökväg, eftersom agentprocessen har åtkomst till sökvägen. Detta ändrar datorns tillstånd och påverkar alla processer som körs på den.

Du kan också konfigurera uppslagsinställningen för flera nivåer. Den här inställningen kan konfigurera .NET-värden att söka efter en lämplig version.

performMultiLevelLookup - Utföra sökning på flera nivåer
boolean. Standardvärde: false.

Dessa indata gäller endast för Windows-baserade agenter. Dessa indata konfigurerar beteendet för .NET-värdprocesser för att söka efter ett lämpligt delat ramverk. False innebär att endast versioner som finns i mappen som anges i den här uppgiften skulle granskas av värdprocessen. True innebär att värden försöker söka på fördefinierade globala platser med hjälp av uppslag på flera nivåer.

För Windows är de globala standardplatserna:

C:\Program Files\dotnet (64-bitarsprocesser)
C:\Program Files (x86)\dotnet (32-bitarsprocess)

Mer information finns i SharedFX-sökning på flera nivåer.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Den här uppgiften är inaktuell. Använd @UseDotNet2.

Nyheter i den här uppgiftsversionen.

Stöd för att installera flera versioner sida vid sida.
Stöd för mönster i version för att hämta senaste i del-/huvudversion.
Begränsa sökning på flera nivåer.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Om du kör den här uppgiften uppfyller du följande krav för efterföljande aktiviteter i samma jobb: DotNetCore
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	Alla agentversioner som stöds.
Uppgiftskategori	Verktyg

Dela via