Udostępnij za pośrednictwem

dotnet new install

  • Artykuł

Ten artykuł dotyczy: ✔️ .NET Core 3.1 SDK i nowsze wersje

Nazwa

dotnet new install — instaluje pakiet szablonu.

Streszczenie

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

Opis

Polecenie dotnet new install instaluje pakiet szablonu z udostępnionej PATH lub NUGET_ID. Jeśli chcesz zainstalować określoną wersję lub wersję wstępną pakietu szablonu, określ wersję w formacie <package-name>::<package-version>. Domyślnie dotnet new przekazuje * dla wersji, która reprezentuje najnowszą stabilną wersję pakietu. Aby uzyskać więcej informacji, zobacz sekcję Przykłady.

Jeśli wersja pakietu szablonu została już zainstalowana podczas uruchamiania tego polecenia, pakiet szablonu zostanie zaktualizowany do określonej wersji. Jeśli nie określono żadnej wersji, pakiet zostanie zaktualizowany do najnowszej stabilnej wersji. Począwszy od zestawu .NET SDK 6.0.100, jeśli argument określa wersję, a ta wersja pakietu NuGet jest już zainstalowana, nie zostanie ponownie zainstalowana. Jeśli argument jest PATH i jest już zainstalowany, nie zostanie ponownie zainstalowany.

Przed zestawem .NET SDK 6.0.100 pakiety szablonów były zarządzane indywidualnie dla każdej wersji zestawu .NET SDK, w tym wersje poprawek . Jeśli na przykład zainstalujesz pakiet szablonu przy użyciu dotnet new --install w zestawie .NET SDK 5.0.100, zostanie on zainstalowany tylko dla zestawu .NET SDK 5.0.100. Szablony z pakietu nie będą dostępne w innych wersjach zestawu .NET SDK zainstalowanych na maszynie.

Począwszy od zestawu .NET SDK 6.0.100, zainstalowane pakiety szablonów są dostępne w nowszych wersjach zestawu .NET SDK zainstalowanych na maszynie. Pakiet szablonu zainstalowany w zestawie .NET SDK 6.0.100 będzie również dostępny w zestawie .NET SDK 6.0.101, .NET SDK 6.0.200 itd. Jednak te pakiety szablonów nie będą dostępne w wersjach zestawu .NET SDK przed zestawem .NET SDK 6.0.100. Aby użyć pakietu szablonu zainstalowanego w zestawie .NET SDK 6.0.100 lub nowszym w starszych wersjach zestawu .NET SDK, należy zainstalować go przy użyciu dotnet new install w tej wersji zestawu .NET SDK.

Nuta

Począwszy od zestawu .NET 7 SDK, składnia dotnet new uległa zmianie:

  • Opcje --list, --search, --installi --uninstall stały się list, search, installi podpolecenia uninstall.
  • Opcja --update-apply stała się podpolecenia update.
  • Aby użyć --update-check, użyj podpolecenia update z opcją --check-only.

Inne opcje, które były dostępne wcześniej, są nadal dostępne do użycia z odpowiednimi podpoleceniami. Oddzielna pomoc dla każdego podpolecenia jest dostępna za pośrednictwem opcji -h lub --help: dotnet new <subcommand> --help wyświetla listę wszystkich obsługiwanych opcji dla podpolecenia.

Ponadto ukończenie karty jest teraz dostępne dla dotnet new. Obsługuje uzupełnianie dla zainstalowanych nazw szablonów i opcji dostępnych przez wybrany szablon. Aby aktywować uzupełnianie kart dla zestawu .NET SDK, zobacz Włączanie uzupełniania kart.

Przykłady starej składni:

  • Zainstaluj najnowszą wersję pakietu szablonu projektu zadań internetowych platformy Azure:

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

Argumenty

  • <PATH|NUGET_ID>

    Folder w systemie plików lub identyfikator pakietu NuGet do zainstalowania pakietu szablonu. dotnet new próbuje zainstalować pakiet NuGet ze źródeł NuGet dostępnych dla bieżącego katalogu roboczego i źródeł określonych za pośrednictwem opcji --add-source. Jeśli chcesz zainstalować określoną wersję lub wersję wstępną pakietu szablonu ze źródła NuGet, określ wersję w formacie <package-name>::<package-version>.

Opcje

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

    Domyślnie dotnet new install używa hierarchii plików konfiguracji NuGet z bieżącego katalogu, aby określić źródło NuGet, z których można zainstalować pakiet. Jeśli określono --nuget-source, źródło zostanie dodane do listy źródeł do sprawdzenia. Aby sprawdzić skonfigurowane źródła dla bieżącego katalogu, użyj dotnet nuget list source. Aby uzyskać więcej informacji, zobacz Common NuGet Configurations.

    Nuta

    Po inicjatywie Https Everywhere NuGet dotnet new wycofywanie kanałów informacyjnych http. Jeśli kanał informacyjny http zostanie przekazany, nie zostanie wyświetlony monit o pakiety i zostanie wyświetlone ostrzeżenie. W razie potrzeby można przesłonić to zachowanie za pomocą opcji --force.

  • -d|--diagnostics

    Włącza dane wyjściowe diagnostyczne. Dostępne od wersji 7.0.100 zestawu .NET SDK.

  • --force

    Umożliwia instalowanie pakietów szablonów z określonych źródeł, nawet jeśli zastąpią pakiet szablonu z innego źródła. Dostępne od wersji 7.0.100 zestawu .NET SDK.

  • -h|--help

    Wyświetla pomoc dotyczącą polecenia instalacji. Dostępne od wersji 7.0.100 zestawu .NET SDK.

  • --interactive

    Umożliwia zatrzymanie polecenia i oczekiwanie na wprowadzenie lub działanie użytkownika. Na przykład w celu ukończenia uwierzytelniania. Dostępny od wersji .NET 5.0 SDK.

  • -v|--verbosity <LEVEL>

    Ustawia poziom szczegółowości polecenia. Dozwolone wartości to q[uiet], m[inimal], n[ormal]i diag[nostic]. Dostępne od wersji 7.0.100 zestawu .NET SDK.

Przykłady

  • Zainstaluj najnowszą wersję szablonów SPA dla ASP.NET Core:

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

  • Zainstaluj wersję 2.0 szablonów SPA dla ASP.NET Core:

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

  • Zainstaluj wersję 2.0 szablonów SPA dla ASP.NET Core z niestandardowego źródła NuGet przy użyciu trybu interaktywnego:

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

Zobacz też