Dela via

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

  • Artikel

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ägga till den i PATH.

Viktigt!

Den här uppgiften är inaktuell och kommer att 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ägga till den i PATH.

Viktigt!

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

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.

Ingångar

packageType - paket för att installera
string. Obligatoriskt. Tillåtna värden: runtime (Endast Körning), sdk (SDK (innehåller körning)). Standardvärde: sdk.

Anger om du bara ska installera Runtime eller det fullständiga SDK:t.


version - version
string. Obligatoriskt. 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 den senaste versionen i huvudversionen.
  • 2.2.x: Installerar den senaste i större och lägre version.
  • 2.2.104: Installerar den exakta versionen.

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


includePreviewVersions - ta med 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.
  • Alla andra sökvägar: Du kan konfigurera andra sökvägar med tanke på att 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 uppslag på flera nivåer
boolean. Standardvärde: false.

Den här indatan gäller endast för Windows-baserade agenter. Den här indatan konfigurerar beteendet för .NET-värdprocesser för att leta upp 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

Ingen.

Anmärkningar

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 den senaste versionen i mindre/större version.
  • Begränsa sökning på flera nivåer.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
kräver Ingen
funktioner Om du kör den här uppgiften uppfyller följande krav för efterföljande aktiviteter i samma jobb: DotNetCore
Kommandobegränsningar Vilken som helst
variabler som kan Vilken som helst
Agentversion Alla agentversioner som stöds.
Aktivitetskategori Verktyg