dotnet eszköz telepítése

Ez a cikk a következő verziókra vonatkozik: ✔️ .NET 6 SDK és újabb verziók

Név

dotnet tool install – Telepíti a megadott .NET-eszközt a számítógépre.

Szinopszis

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Leírás

A dotnet tool install parancs lehetővé teszi a .NET-eszközök telepítését a gépére. A parancs használatához a következő telepítési lehetőségek egyikét kell megadnia:

• Ha globális eszközt szeretne telepíteni az alapértelmezett helyre, használja a --global lehetőséget.
• Ha egy globális eszközt egyéni helyre szeretne telepíteni, használja a --tool-path lehetőséget.
• Helyi eszköz telepítéséhez hagyja ki a beállításokat és --global a --tool-path beállításokat.

Figyelmeztetés

Győződjön meg arról, hogy a beállítással --tool-path megadott könyvtár biztonságos. Az ezen a helyen telepített eszközök közvetlenül végrehajthatók, így a nem megbízható vagy megosztott elérési út használata biztonsági kockázatokat okozhat.

Telepítési helyek

Globális eszközök

A globális eszközök alapértelmezés szerint a következő könyvtárakba vannak telepítve, amikor megadja a -g beállítást:--global

Operációs rendszer	Elérési út
Linux/macOS	$HOME/.dotnet/tools
Windows	%USERPROFILE%\.dotnet\tools

Ezekben a mappákban végrehajtható elemek jönnek létre minden globálisan telepített eszközhöz, bár a tényleges eszköz bináris fájljai mélyen a testvérkönyvtárba .store vannak beágyazva.

Feljegyzés

Linuxon egy parancssori eszköz dotnet tooltelepítése után az eszköz csak az $HOME/.dotnet/tools elérési útról hajtható végre. Ha az eszközt bármely könyvtárból végrehajthatóvá szeretné tenni, frissítse a környezeti változót PATH . Ha a frissített PATH környezeti változót állandóvá szeretné tenni a rendszerhéjban, frissítse a rendszerhéj beállításait. Mert Bashez a $HOME/.bashrc fájl.

--tool-path Eszközök

Az explicit eszközútvonalakkal rendelkező eszközöket a rendszer mindenhol tárolja, ahol a paramétert --tool-path a mutatóhoz adta meg. A rendszer ugyanúgy tárolja őket, mint a globális eszközöket: egy végrehajtható bináris fájlt, amelyben a bináris fájlok egy testvérkönyvtárban .store találhatók.

Helyi eszközök

A helyi eszközök a NuGet globális könyvtárában vannak tárolva, bármilyen legyen is. Minden helyi eszközben vannak shim fájlok $HOME/.dotnet/toolResolverCache , amelyek arra mutatnak, hogy hol találhatók az eszközök ezen a helyen.

A rendszer helyi eszközökre mutató hivatkozásokat ad hozzá egy dotnet-tools.json fájlhoz az aktuális könyvtár alatti .config könyvtárban. A .NET 10-től kezdve, ha egy jegyzékfájl még nem létezik, a rendszer automatikusan létrehoz egyet. Manuálisan is létrehozhat egyet a következő parancs futtatásával:

dotnet new tool-manifest

További információ: Helyi eszköz telepítése.

Argumentumok

• PACKAGE_NAME

  A telepíteni kívánt .NET-eszközt tartalmazó NuGet-csomag neve/azonosítója.

  A .NET 10.0.100 SDK-tól kezdve használja a nevet/azonosítót és a .NET-eszköz telepítésével elválasztott @ verziót.

Beállítások

• --allow-downgrade

  A .NET-eszközcsomagok telepítésekor vagy frissítésekor engedélyezheti a csomag-visszalépést. Letiltja a következő figyelmeztetést: "A kért x.x.x verzió alacsonyabb, mint a meglévő x.x.x.x."

• --allow-roll-forward

  A .NET 9.0 SDK-tól kezdve érhető el. Engedélyezi az eszköznek, hogy a .NET-futtatókörnyezet újabb verzióját használja, ha a célként megadott futtatókörnyezet nincs telepítve.

• -a|--arch <ARCHITECTURE>

  A célarchitektúra megadása. Ez egy rövidített szintaxis a futtatókörnyezet azonosítójának (RID) beállításához, ahol a megadott érték az alapértelmezett RID-vel van kombinálva. Egy gépen például win-x64 a RID beállítása a következőre --arch x86van advawin-x86: . Ha ezt a lehetőséget használja, ne használja a -r|--runtime beállítást. Elérhető a .NET 6 7. előzetes verziója óta.

• --add-source <SOURCE>

  Hozzáad egy további NuGet-csomagforrást, amelyet a telepítés során használhat. A hírcsatornák elérése párhuzamosan, nem sorrendben, bizonyos sorrendben érhető el. Ha ugyanaz a csomag és verzió több hírcsatornában található, a leggyorsabb hírcsatorna nyer. További információ: Mi történik a NuGet-csomag telepítésekor?

• --configfile <FILE>

  A használni kívánt NuGet-konfigurációs fájl (nuget.config). Ha meg van adva, a rendszer csak a fájlból származó beállításokat használja. Ha nincs megadva, a rendszer az aktuális könyvtárból származó konfigurációs fájlok hierarchiáját használja. További információ: Common NuGet Configurations.

• --create-manifest-if-needed

  A .NET 8 SDK-tól kezdve érhető el.

  Helyi eszközökre vonatkozik. Jegyzék kereséséhez a keresési algoritmus megkeresi a könyvtárfát dotnet-tools.json vagy egy .configdotnet-tools.json fájlt tartalmazó mappát.

  Ha egy eszközjegyzék nem található, és a --create-manifest-if-needed beállítás értéke be van állítva false, a CannotFindAManifestFile hiba bekövetkezik.

  Ha nem található eszközjegyzék, és a --create-manifest-if-needed beállítás értéke true (vagy .NET 10-ben vagy újabb verziókban, ha nincs megadva), az eszköz automatikusan létrehoz egy jegyzékfájlt. Az alábbiak szerint választja ki a jegyzékmappát:

  • Keresse meg az almappával rendelkező .git könyvtárfát. Ha talál ilyet, hozza létre a jegyzékfájlt abban a könyvtárban.
  • Ha az előző lépés nem talál könyvtárat, keresse meg a könyvtárfát, és keressen egy vagy .sln több fájlt tartalmazó könyvtárat.git. Ha talál ilyet, hozza létre a jegyzékfájlt abban a könyvtárban.
  • Ha az előző két lépés közül egyik sem talál könyvtárat, hozza létre a jegyzékfájlt az aktuális munkakönyvtárban.

  A jegyzékek helyéről további információt a Helyi eszköz telepítése című témakörben talál.

  A .NET 10-től kezdve a rendszer automatikusan létrehoz egy jegyzékfájlt, ha nem található eszközjegyzék. Ez a változás kompatibilitástörő változás lehet. A leiratkozást az átadással --create-manifest-if-needed=falseteheti meg.

  Figyelmeztetés

  Ne futtasson eszközparancsokat a Letöltések mappából vagy bármely megosztott helyről. A parancssori felület felfelé halad a könyvtárfán, és megkeres egy eszközjegyzéket, ami miatt nem várt jegyzékfájlt használhat. Mindig futtassa az eszközparancsokat egy megbízható, projektspecifikus könyvtárból.

• --disable-parallel

  Megakadályozza több projekt párhuzamos visszaállítását.

• --framework <FRAMEWORK>

  Megadja az eszközt telepítendő cél keretrendszert . Alapértelmezés szerint a .NET SDK megpróbálja kiválasztani a legmegfelelőbb cél keretrendszert.

• -g|--global

  Megadja, hogy a telepítés felhasználószintű-e. Nem kombinálható a --tool-path beállítással. Kihagyja mindkettőt --global , és --tool-path megadja a helyi eszköztelepítést.

• --source <SOURCE>

  Megadja a NuGet-csomagok forrását.

• -?|-h|--help

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

• --ignore-failed-sources

  A csomag forráshibáinak kezelése figyelmeztetésként.

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

• --local

  Frissítse az eszközt és a helyi eszközjegyzéket. Nem kombinálható a beállítással vagy a --global--tool-path beállítással.

• --no-cache vagy --no-http-cache

  Ne gyorsítótárazza a csomagokat és a HTTP-kéréseket.

• --prerelease

  Előzetes csomagok belefoglalása.

• --tool-manifest <PATH>

  A jegyzékfájl elérési útja.

• --tool-path <PATH>

  Megadja a globális eszköz telepítésének helyét. A PATH lehet abszolút vagy relatív. Ha a PATH nem létezik, a parancs megpróbálja létrehozni. Kihagyja mindkettőt --global , és --tool-path megadja a helyi eszköztelepítést.

• -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ó: LoggerVerbosity.

• --version <VERSION_NUMBER>

  A telepíteni kívánt eszköz verziója. Alapértelmezés szerint a legújabb stabil csomagverzió van telepítve. Ezzel a beállítással telepítheti az eszköz előzetes vagy régebbi verzióit.

  A .NET 8-tól --version Major.Minor.Patch kezdve egy adott főverzióra/alverzióra/javításra hivatkozik, beleértve a nem támogatott verziókat is. Ha egy adott főverzió/alverzió legújabb verzióját szeretné lekérni, használja a következőt --version Major.Minor.*: .

Példák

• dotnet tool install -g dotnetsay

  Telepíti a dotnetsay-t globális eszközként az alapértelmezett helyen.

• dotnet tool install dotnetsay --tool-path c:\global-tools

  Telepíti a dotnetsay-t globális eszközként egy adott Windows-címtárban.

• dotnet tool install dotnetsay --tool-path ~/bin

  Telepíti a dotnetsay-t globális eszközként egy adott Linux/macOS könyvtárban.

• dotnet tool install -g dotnetsay --version 2.0.0

  A dotnetsay 2.0.0-s verzióját telepíti globális eszközként.

• dotnet tool install -g dotnetsay@2.1.7

  A dotnetsay 2.1.7-es verzióját telepíti globális eszközként.

• dotnet tool install dotnetsay

  Telepíti a dotnetsay-t az aktuális könyvtár helyi eszközeként.

• dotnet tool install dotnetsay@2.1.7

  Telepíti a dotnetsay 2.1.7-es verzióját az aktuális könyvtár helyi eszközeként.

• dotnet tool install -g dotnetsay --verbosity minimal

  A dotnetsay-t globális eszközként telepíti, minimális részletességgel. A globális eszköz alapértelmezett részletessége a csendes.

• dotnet tool install -g dotnetsay --allow-roll-forward

  Telepíti a dotnetsay-t globális eszközként, és lehetővé teszi az újabb .NET-verziók futtatását, ha a cél futtatókörnyezet nem érhető el.

Lásd még

• .NET-eszközök
• Oktatóanyag: .NET globális eszköz telepítése és használata a .NET parancssori felülettel
• Oktatóanyag: .NET helyi eszköz telepítése és használata a .NET parancssori felülettel