dotnet eszköz telepítése

  • Cikk

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.

--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őre win-x86van 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 .configdotnet-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, a CannotFindAManifestFile 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.

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

Lásd még