dotnet eszköz telepítése
Ez a cikk a következőre vonatkozik: ✔️ .NET Core 3.1 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] [-a|--arch <ARCHITECTURE>]
[--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
[--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease]
[--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
[--version <VERSION_NUMBER>]
dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
[--allow-downgrade] [-a|--arch <ARCHITECTURE>]
[--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
[--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease]
[--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
[--version <VERSION_NUMBER>]
dotnet tool install <PACKAGE_NAME> [--local]
[--allow-downgrade] [-a|--arch <ARCHITECTURE>]
[--add-source <SOURCE>] [--configfile <FILE>]
[--create-manifest-if-needed] [--disable-parallel]
[--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease]
[--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
--tool-path
a--global
beállításokat.
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
OS | 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 tool
telepí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 Bash
ez 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. Ha még nem létezik jegyzékfájl, hozza létre a --create-manifest-if-needed
beállítással vagy 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.
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."
-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őrewin-x86
van adva--arch x86
: .
--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
Helyi eszközökre vonatkozik. A .NET 8 SDK-tól kezdve érhető el. Jegyzék kereséséhez a keresési algoritmus megkeresi a könyvtárfát
dotnet-tools.json
vagy egy.config
dotnet-tools.json
fájlt tartalmazó mappát.Ha nem található eszközjegyzék, és a
--create-manifest-if-needed
beállítás értéke hamis, aCannotFindAManifestFile
hiba bekövetkezik.Ha nem található eszközjegyzék, és a
--create-manifest-if-needed
beállítás értéke igaz, 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
.git
több fájlt tartalmazó könyvtárat.sln
. 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.
- Keresse meg az almappával rendelkező
--disable-parallel
Több projekt párhuzamos visszaállításának megakadályozása.
--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.
-?|-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
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ők
q[uiet]
: ,m[inimal]
,n[ormal]
d[etailed]
ésdiag[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.0-tól
--version Major.Minor.Patch
kezdve egy adott fő-/alverzió-/javításverzióra hivatkozik, beleértve a nem listázatlan 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 dotnetsay
Telepíti a dotnetsay-t az aktuális könyvtár helyi eszközeként.
dotnet tool install -g --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.