Megosztás a következőn keresztül:


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égek list, search, installés uninstall alparancsok lettek.
  • A --update-apply lehetőség lett a update alparancs.
  • A --update-checkhasználatához használja a update 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 a dotnet nuget list source. További információ: Common NuGet Configurations.

    Jegyzet

    A NuGet Https Everywhere kezdeményezését követve dotnet new fokozatosan http hírcsatornákat. Ha egy http-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]és diag[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
    

Lásd még: