dotnet új telepítése

Ez a cikk a következő verziókra vonatkozik: ✔️ .NET 6 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] [--prerelease]
    [-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. (A kettőspont elválasztó :: elavult a @ .NET 9.0.200 SDK-ban szereplő karakter javára.) Alapértelmezés szerint dotnet new a * értéket adja á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, hacsak nem adja meg a --prerelease beállítást. 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

Figyelmeztetés

A sablonok aktiválva futtathatják az MSBuild kódot és más tetszőleges kódot. Ne telepítse vagy futtassa a nem megbízható .NET-sablonokat.

É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. (A kettőspont elválasztó :: elavult a @ .NET 9.0.200 SDK-ban szereplő karakter javára.)

Beállítások

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

    Alapértelmezés szerint dotnet new install a nuGet-konfigurációs fájlok hierarchiáját használja az aktuális könyvtárból a művelet NuGet-forrásainak meghatározásához. Adja meg --nuget-source , hogy a konfigurált források mellett forrást is használjon. Az aktuális könyvtárhoz konfigurált források ellenőrzéséhez használja dotnet nuget list sourcea következőt: . 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

    A parancs használatának leírását nyomtatja ki.

  • --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.

  • --prerelease

    Kiválasztja a legújabb elérhető verziót, beleértve az előzetes verziókat is, ha nem ad meg sabloncsomag-verziót. Ha például csomagverziót ad meg, Contoso.Templates@2.0.0-preview.3a parancs ezt a verziót választja ki. .NET SDK 11 óta érhető el.

  • -v|--verbosity <LEVEL>

    A parancs részletességi szintjét állítja be. Az engedélyezett értékek a következőkq[uiet]: , m[inimal], n[ormal]d[etailed]és diag[nostic]. További információért lásd LoggerVerbosity.

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:

  • Last updated on