Share via

dotnet új telepítése

  • Cikk

Ez a cikk a következő kiadásokra vonatkozik: ✔️ .NET Core 3.1 SDK és újabb verziók

Name

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 vagy NUGET_ID a PATH megadott fájlból. Ha egy sabloncsomag egy adott verzióját vagy előzetes verzióját szeretné telepíteni, adja meg a verziót a következő formátumban <package-name>::<package-version>: . Alapértelmezés szerint dotnet new a * értéket adja meg 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 már telepítve van a sabloncsomag egy verziója, 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, nem lesz újratelepítve. Ha az argumentum egy PATH , és már telepítve van, nem lesz újratelepítve.

A .NET SDK 6.0.100-as verziója előtt a sabloncsomagokat egyenként kezeltük minden .NET SDK-verzióhoz, beleértve a javításverziókat is. Ha például a sabloncsomagot dotnet new --install a .NET SDK 5.0.100 használatával telepíti, az csak a .NET SDK 5.0.100-as verzióra lesz telepítve. A csomag sablonjai 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-as verziójá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-as verzióban telepített sabloncsomag a .NET SDK 6.0.101-ben, a .NET SDK 6.0.200-as és így tovább. Ezek a sabloncsomagok azonban nem érhetők el a .NET SDK 6.0.100 előtti verziókban. Ha a .NET SDK korábbi verzióiban a .NET SDK 6.0.100-as vagy újabb verziójában telepített sabloncsomagot szeretne használni, akkor azt az adott .NET SDK-verzióval dotnet new install kell telepítenie.

Megjegyzés

A .NET 7 SDK-tól kezdve a dotnet new szintaxis megváltozott:

  • A --list, --search, --installés --uninstall lehetőség lett list, search, , installés uninstall alparancs.
  • A --update-apply lehetőség lett az update alparancs.
  • A használatához --update-checkhasználja az 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 vagy --help a -h beállításon keresztül: dotnet new <subcommand> --help az alparancs összes támogatott beállítását felsorolja.

Emellett a lapkiegészítés is elérhető a következőhöz: dotnet new. Támogatja a telepített sablonnevek befejezését, valamint a kiválasztott sablon által biztosított lehetőségeket. 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 webfeladat-projektsablon-csomagjának legújabb verzióját:

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

Argumentumok

  • <PATH|NUGET_ID>

    A fájlrendszer mappája vagy a NuGet-csomag azonosítója, amelyből telepíteni szeretné a sabloncsomagot. dotnet new megpróbálja telepíteni a NuGet-csomagot az aktuális munkakönyvtárhoz elérhető NuGet-forrásokból és a beállítással --add-source megadott forrásokból. Ha a NuGet-forrásból származó sabloncsomag egy adott verzióját vagy előzetes verzióját szeretné telepíteni, adja meg a verziót a következő formátumban <package-name>::<package-version>: .

Beállítások

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

    Alapértelmezés szerint a nuGet-konfigurációs fájlok hierarchiáját használja az aktuális könyvtárból annak meghatározásához, dotnet new install hogy a csomag melyik NuGet-forrásból telepíthető. Ha --nuget-source meg van adva, 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 következőt dotnet nuget list source: . További információ: Gyakori NuGet-konfigurációk

    Megjegyzés

    A NuGet Https Everywhere kezdeményezését dotnet new követve fokozatosan kiépülnek http a hírcsatornák. Ha egy http hírcsatornát átadnak, a rendszer nem kérdezi le a csomagokat, és figyelmeztetés jelenik meg. A --force beállítással 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 másik forrásból származó sabloncsomagot. 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 bevitelt vagy műveletet. Például a hitelesítés befejezéséhez. A .NET 5.0 SDK óta érhető el.

  • -v|--verbosity <LEVEL>

    Beállítja a parancs részletességi szintjét. 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 ASP.NET Core:

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

  • Telepítse az SPA-sablonok 2.0-s verzióját ASP.NET Core:

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

  • Telepítse az SPA-sablonok 2.0-s verzióját ASP.NET Core 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