dotnet új telepítése
Ez a cikk a következőre vonatkozik: ✔️ .NET Core 3.1 SDK és újabb verziók
Név
dotnet new install
– sabloncsomagot telepít.
Áttekintés
dotnet new install <PATH|NUGET_ID> [--interactive] [--add-source|--nuget-source <SOURCE>] [--force]
[-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]
Leírás
A dotnet new install
parancs egy sabloncsomagot telepít a megadott PATH
vagy NUGET_ID
. Ha egy sabloncsomag egy adott verzióját vagy előzetes verzióját szeretné telepíteni, adja meg a verziót <package-name>::<package-version>
formátumban. Alapértelmezés szerint dotnet new
* értéket ad át a verziónak, amely a legújabb stabil csomagverziót jelöli. További információ: Példák szakasz.
Ha a parancs futtatásakor a sabloncsomag egy verziója már telepítve van, a sabloncsomag a megadott verzióra frissül. Ha nincs megadva verzió, a csomag a legújabb stabil verzióra frissül.
A .NET SDK 6.0.100-tól kezdődően, ha az argumentum megadja a verziót, és a NuGet-csomag ezen verziója már telepítve van, akkor az nem lesz újratelepítve.
Ha az argumentum egy PATH
, és már telepítve van, a rendszer nem fogja újratelepíteni.
A .NET SDK 6.0.100-as verziója előtt a sabloncsomagokat egyenként kezelték minden .NET SDK-verzióhoz, beleértve javításverziókat.
Ha például a sabloncsomagot a .NET SDK 5.0.100-as dotnet new --install
használatával telepíti, az csak a .NET SDK 5.0.100-ra lesz telepítve. A csomagból származó sablonok nem lesznek elérhetők a számítógépre telepített más .NET SDK-verziókban.
A .NET SDK 6.0.100-tól kezdve a telepített sabloncsomagok a számítógépre telepített későbbi .NET SDK-verziókban érhetők el. A .NET SDK 6.0.100-ban telepített sabloncsomag a .NET SDK 6.0.101-ben, a .NET SDK 6.0.200-ban és így tovább is elérhető lesz. Ezek a sabloncsomagok azonban nem érhetők el a .NET SDK 6.0.100 előtti verzióiban. Ha a .NET SDK korábbi verzióiban a .NET SDK 6.0.100-as vagy újabb verzióiban telepített sabloncsomagot szeretne használni, telepítenie kell azt az adott .NET SDK-verzió dotnet new install
használatával.
Jegyzet
A .NET 7 SDK-tól kezdve a dotnet new
szintaxisa megváltozott:
- A
--list
,--search
,--install
és--uninstall
lehetőségeklist
,search
,install
ésuninstall
alparancsok lettek. - A
--update-apply
lehetőség lett aupdate
alparancs. - A
--update-check
használatához használja aupdate
alparancsot a--check-only
beállítással.
A korábban elérhető egyéb lehetőségek továbbra is használhatók a megfelelő alparancsokkal.
Az egyes alparancsokhoz külön súgó érhető el a -h
vagy --help
lehetőséggel: dotnet new <subcommand> --help
felsorolja az alparancs összes támogatott beállítását.
Emellett a tabulátorkiegészítés már elérhető dotnet new
. Támogatja a telepített sablonnevek befejezését, valamint a kiválasztott sablon által biztosított beállításokat.
A .NET SDK lapkiegészítésének aktiválásához lásd: Lapkiegészítés engedélyezése.
Példák a régi szintaxisra:
Telepítse az Azure webfeladatok projektsabloncsomagjának legújabb verzióját:
dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates
Érvek
<PATH|NUGET_ID>
A fájlrendszer mappája vagy a NuGet-csomag azonosítója a sabloncsomag telepítéséhez.
dotnet new
megpróbálja telepíteni a NuGet-csomagot az aktuális munkakönyvtárhoz elérhető NuGet-forrásokból és a--add-source
beállítással megadott forrásokból. Ha a NuGet-forrásból szeretné telepíteni egy sabloncsomag adott verzióját vagy előzetes verzióját, adja meg a verziót<package-name>::<package-version>
formátumban.
Beállítások
--add-source|--nuget-source <SOURCE>
Alapértelmezés szerint
dotnet new install
az aktuális könyvtárból származó NuGet-konfigurációs fájlok hierarchiáját használja annak meghatározásához, hogy a csomag melyik NuGet-forrásból telepíthető. Ha--nuget-source
van megadva, a forrás hozzá lesz adva az ellenőrizendő források listájához. Az aktuális könyvtárhoz konfigurált források ellenőrzéséhez használja adotnet nuget list source
. További információ: Common NuGet Configurations.Jegyzet
A NuGet Https Everywhere kezdeményezését követve
dotnet new
fokozatosanhttp
hírcsatornákat. Ha egyhttp
-hírcsatornát ad át, a rendszer nem kérdezi le a csomagokat, és figyelmeztetés jelenik meg. A--force
lehetőséggel szükség esetén felülbírálhatja ezt a viselkedést.-d|--diagnostics
Engedélyezi a diagnosztikai kimenetet. A .NET SDK 7.0.100 óta érhető el.
--force
Lehetővé teszi a sabloncsomagok telepítését a megadott forrásokból, még akkor is, ha felülbírálnának egy sabloncsomagot egy másik forrásból. A .NET SDK 7.0.100 óta érhető el.
-h|--help
Kiírja a telepítési parancs súgóját. A .NET SDK 7.0.100 óta érhető el.
--interactive
Lehetővé teszi, hogy a parancs leálljon, és várja meg a felhasználói bemenetet vagy műveletet. Például a hitelesítés befejezéséhez. A .NET 5.0 SDK óta érhető el.
-v|--verbosity <LEVEL>
A parancs részletességi szintjét állítja be. Az engedélyezett értékek a következők:
q[uiet]
,m[inimal]
,n[ormal]
ésdiag[nostic]
. A .NET SDK 7.0.100 óta érhető el.
Példák
Telepítse az SPA-sablonok legújabb verzióját a ASP.NET Core-hoz:
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
Telepítse a ASP.NET Core SPA-sablonjainak 2.0-s verzióját:
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0
Telepítse a ASP.NET Core-hoz készült SPA-sablonok 2.0-s verzióját egy egyéni NuGet-forrásból interaktív módban:
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive