ny installation av dotnet

  • Artikel

Den här artikeln gäller för: ✔️ .NET Core 3.1 SDK och senare versioner

Namn

dotnet new install – installerar ett mallpaket.

Synopsis

dotnet new install <PATH|NUGET_ID>  [--interactive] [--add-source|--nuget-source <SOURCE>] [--force] 
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Description

Kommandot dotnet new install installerar ett mallpaket från eller NUGET_ID tillhandahållsPATH. Om du vill installera en specifik version eller förhandsversion av ett mallpaket anger du versionen i formatet <package-name>::<package-version>. Som standard dotnet new godkänns * för versionen, som representerar den senaste stabila paketversionen. Mer information finns i avsnittet Exempel .

Om en version av mallpaketet redan installerades när du kör det här kommandot uppdateras mallpaketet till den angivna versionen. Om ingen version anges uppdateras paketet till den senaste stabila versionen. Från och med .NET SDK 6.0.100, om argumentet anger versionen och den versionen av NuGet-paketet redan är installerad, installeras den inte om. Om argumentet är ett PATH och det redan är installerat installeras det inte om.

Före .NET SDK 6.0.100 hanterades mallpaket individuellt för varje .NET SDK-version, inklusive korrigeringsversioner. Om du till exempel installerar mallpaketet med . dotnet new --install NET SDK 5.0.100 installeras det endast för .NET SDK 5.0.100. Mallar från paketet är inte tillgängliga i andra .NET SDK-versioner som är installerade på datorn.

Från och med .NET SDK 6.0.100 är installerade mallpaket tillgängliga i senare .NET SDK-versioner installerade på datorn. Ett mallpaket som är installerat i .NET SDK 6.0.100 är också tillgängligt i .NET SDK 6.0.101, .NET SDK 6.0.200 och så vidare. Dessa mallpaket är dock inte tillgängliga i .NET SDK-versioner före .NET SDK 6.0.100. Om du vill använda ett mallpaket som installerats i .NET SDK 6.0.100 eller senare i tidigare .NET SDK-versioner måste du installera det med den dotnet new install .NET SDK-versionen.

Anteckning

Från och med .NET 7 SDK har syntaxen dotnet new ändrats:

  • Alternativen --list, --search, --installoch --uninstall blev list, search, installoch uninstall underkommandon.
  • Alternativet --update-apply blev update underkommandot.
  • Om du vill använda --update-checkanvänder du update underkommandot med --check-only alternativet .

Andra alternativ som var tillgängliga tidigare är fortfarande tillgängliga för användning med respektive underkommandon. Separat hjälp för varje underkommando är tillgänglig via -h alternativet eller --help : dotnet new <subcommand> --help visar alla alternativ som stöds för underkommandot.

Dessutom är tabbavslut nu tillgängligt för dotnet new. Den stöder slutförande för installerade mallnamn och för de alternativ som en vald mall tillhandahåller. Information om hur du aktiverar flikslutsättning för .NET SDK finns i Aktivera flikslutsättning.

Exempel på gammal syntax:

  • Installera den senaste versionen av projektmallspaketet för Azure-webbjobb:

    dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates

Argument

  • <PATH|NUGET_ID>

    Mappen i filsystemet eller NuGet-paketidentifieraren som mallpaketet ska installeras från. dotnet new försöker installera NuGet-paketet från NuGet-källorna som är tillgängliga för den aktuella arbetskatalogen och de källor som anges via --add-source alternativet . Om du vill installera en specifik version eller förhandsversion av ett mallpaket från NuGet-källan anger du versionen i formatet <package-name>::<package-version>.

Alternativ

  • --add-source|--nuget-source <SOURCE>

    Som standard dotnet new install använder hierarkin för NuGet-konfigurationsfiler från den aktuella katalogen för att fastställa den NuGet-källa som paketet kan installeras från. Om --nuget-source anges läggs källan till i listan över källor som ska kontrolleras.
    Om du vill kontrollera de konfigurerade källorna för den aktuella katalogen använder du dotnet nuget list source. Mer information finns i Vanliga NuGet-konfigurationer

    Anteckning

    Efter NuGets Https Everywhere-initiativdotnet new fasas ut http feeds. Om en http feed skickas efterfrågas den inte för paket och en varning visas. Alternativet --force kan användas för att åsidosätta det här beteendet om det behövs.

  • -d|--diagnostics

    Aktiverar diagnostikutdata. Tillgängligt sedan .NET SDK 7.0.100.

  • --force

    Tillåter installation av mallpaket från de angivna källorna även om de skulle åsidosätta ett mallpaket från en annan källa. Tillgängligt sedan .NET SDK 7.0.100.

  • -h|--help

    Skriver ut hjälp för installationskommandot. Tillgängligt sedan .NET SDK 7.0.100.

  • --interactive

    Tillåter att kommandot stoppar och väntar på användarindata eller åtgärd. Till exempel för att slutföra autentiseringen. Tillgängligt sedan .NET 5.0 SDK.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal]och diag[nostic]. Tillgängligt sedan .NET SDK 7.0.100.

Exempel

  • Installera den senaste versionen av SPA-mallar för ASP.NET Core:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates

  • Installera version 2.0 av SPA-mallarna för ASP.NET Core:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0

  • Installera version 2.0 av SPA-mallarna för ASP.NET Core från en anpassad NuGet-källa med hjälp av interaktivt läge:

    dotnet new --install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive

Se även