Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Ten artykuł dotyczy: ✔️ .NET 6 zestawu SDK i nowszych wersji
Nazwa
dotnet new install — instaluje pakiet szablonu.
Streszczenie
dotnet new install <PATH|NUGET_ID> [--interactive] [--add-source|--nuget-source <SOURCE>] [--force] [--prerelease]
[-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>. (Separator :: dwukropka był przestarzały na rzecz @ znaku w zestawie SDK platformy .NET 9.0.200). 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 nie określono żadnej wersji, pakiet zostanie zaktualizowany do najnowszej stabilnej wersji, chyba że zostanie określona --prerelease opcja.
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--uninstallstały sięlist,search,installi podpoleceniauninstall. - Opcja
--update-applystała się podpoleceniaupdate. - Aby użyć
--update-check, użyj podpoleceniaupdatez 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
Ostrzeżenie
Szablony mogą uruchamiać kod MSBuild i inny dowolny kod po wyzwoleniu. Nie instaluj ani nie uruchamiaj niezaufanych szablonów platformy .NET.
Weryfikacja podpisu pakietu
Po włączeniu dotnet new install weryfikacji podpisu przed instalacją weryfikuje podpisane pakiety szablonów pobrane ze źródeł NuGet. Weryfikacja dotyczy skonfigurowanych i dodatkowych źródeł NuGet, ale nie pakietów zainstalowanych bezpośrednio z lokalnego .nupkg pliku lub folderu.
Weryfikacja zależy od systemu operacyjnego:
| System operacyjny | Działanie domyślne | Configuration |
|---|---|---|
| Windows | Enabled | Nie można wyłączyć za pomocą polecenia DOTNET_NUGET_SIGNATURE_VERIFICATION. |
| Linux | Enabled | Ustaw DOTNET_NUGET_SIGNATURE_VERIFICATION=false wartość , aby wyłączyć weryfikację. |
| macOS | Disabled | Ustaw wartość DOTNET_NUGET_SIGNATURE_VERIFICATION=true , aby włączyć weryfikację. Aby uzyskać informacje o ograniczeniach platformy, zobacz Weryfikacja podpisanych pakietów NuGet . |
Po włączeniu weryfikacji niepodpisane pakiety są akceptowane, chyba że odpowiednie zestawy signatureValidationMode konfiguracji NuGet na require, lub źródło deklaruje, że wszystkie jego pakiety są podpisane przez repozytorium. Aby uzyskać informacje na temat konfigurowania zasad klienta, zobacz signatureValidationMode.
Jeśli weryfikacja podpisu nie powiedzie się, pakiet nie jest zainstalowany. Opcja --force nie pomija weryfikacji podpisu. Uruchom polecenie z poleceniem , --diagnostics aby wyświetlić szczegóły weryfikacji. Aby uzyskać informacje o wymaganiach dotyczących magazynu certyfikatów i rozwiązywaniu problemów, zobacz Weryfikacja podpisanych pakietów NuGet. Możesz również zweryfikować pobrany pakiet jawnie za pomocą polecenia dotnet nuget verify.
Pomyślna weryfikacja nie gwarantuje, że szablon jest bezpieczny do uruchomienia. Aby uzyskać więcej informacji na temat tej zmiany zachowania i pasm funkcji zestawu SDK, zobacz Instalacja pakietu szablonu weryfikuje podpisy NuGet.
Argumenty
<PATH|NUGET_ID>Folder w systemie plików lub identyfikator pakietu NuGet do zainstalowania pakietu szablonu.
dotnet newpróbuje zainstalować pakiet NuGet ze źródeł NuGet dostępnych dla bieżącego katalogu roboczego i źródeł określonych za pośrednictwem--add-sourceopcji . 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>. (Separator::dwukropka był przestarzały na rzecz@znaku w zestawie SDK platformy .NET 9.0.200).
Opcje
--add-source|--nuget-source <SOURCE>Domyślnie
dotnet new installużywa hierarchii plików konfiguracji NuGet z bieżącego katalogu w celu określenia źródeł NuGet dla operacji. Określ--nuget-source, aby używać źródła oprócz skonfigurowanych źródeł. Aby sprawdzić skonfigurowane źródła dla bieżącego katalogu, użyj poleceniadotnet nuget list source. Aby uzyskać więcej informacji, zobacz Common NuGet Configurations.Nuta
Po inicjatywie Https Everywhere NuGet
dotnet newwycofywanie kanałów informacyjnychhttp. Jeśli kanał informacyjnyhttpzostanie 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|--diagnosticsWłącza dane wyjściowe diagnostyczne. Dostępne od wersji 7.0.100 zestawu .NET SDK.
--forceUmoż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.
Ta opcja nie pomija weryfikacji podpisu pakietu.
-
-?|-h|--helpWyświetla opis sposobu używania polecenia .
-
--interactiveUmożliwia zatrzymanie polecenia i oczekiwanie na wprowadzenie lub działanie użytkownika. Na przykład w celu ukończenia uwierzytelniania.
--prereleaseWybiera najnowszą dostępną wersję, w tym wersje wstępne, jeśli nie określisz wersji pakietu szablonu. Jeśli określisz wersję pakietu, taką jak
Contoso.Templates@2.0.0-preview.3, polecenie wybierze tę dokładną wersję. Dostępne od .NET zestawu SDK 11.-
-v|--verbosity <LEVEL>Ustawia poziom szczegółowości polecenia. Dozwolone wartości to
q[uiet],m[inimal],n[ormal],d[etailed]idiag[nostic]. Aby uzyskać więcej informacji, zobacz LoggerVerbosity.
Przykłady
Zainstaluj najnowszą wersję szablonów SPA dla ASP.NET Core:
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplatesZainstaluj wersję 2.0 szablonów SPA dla ASP.NET Core:
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates@2.0.0Zainstaluj 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