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 podanego PATH elementu 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 program 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 wersja nie zostanie określona, 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 elementem 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 wersji poprawek. Jeśli na przykład zainstalujesz pakiet szablonu przy użyciu dotnet new --install zestawu .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 we wcześniejszych wersjach zestawu .NET SDK, należy zainstalować go przy użyciu dotnet new install w tej wersji zestawu .NET SDK.

Uwaga

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

  • Opcje --list, --search, --installi --uninstall stały się listpoleceniami , installsearch, i uninstall .
  • Opcja --update-apply stała się update podpolecenia.
  • Aby użyć --update-checkpolecenia , użyj update podpolecenia 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 -h opcji lub --help : dotnet new <subcommand> --help wyświetla listę wszystkich obsługiwanych opcji dla podpolecenia.

Ponadto uzupełnianie karty jest teraz dostępne dla programu dotnet new. Obsługuje uzupełnianie 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ń Web Jobs 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 --add-source opcji . 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 program używa hierarchii plików konfiguracji NuGet z bieżącego katalogu, aby określić źródło NuGet, z poziomu których można zainstalować pakiet. Jeśli --nuget-source zostanie określony, źródło zostanie dodane do listy źródeł do sprawdzenia.
    Aby sprawdzić skonfigurowane źródła dla bieżącego katalogu, użyj polecenia dotnet nuget list source. Aby uzyskać więcej informacji, zobacz Typowe konfiguracje NuGet

    Uwaga

    Po inicjatywie dotnet newHttps Everywhere programu NuGet wycofuje http się z kanałów informacyjnych. http Jeśli kanał informacyjny jest przekazywany, nie jest odpytywane pod kątem pakietów i zostanie wyświetlone ostrzeżenie. Tej --force opcji można użyć do zastąpienia tego zachowania w razie potrzeby.

  • -d|--diagnostics

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

  • --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 .NET SDK 7.0.100.

  • -h|--help

    Drukuje pomoc dotyczącą polecenia instalacji. Dostępne od wersji .NET SDK 7.0.100.

  • --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 zestawu .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 .NET SDK 7.0.100.

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ż