Oktatóanyag: .NET globális eszköz telepítése és használata a .NET CLI használatával

Cikk
07/27/2023

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

Ez az oktatóanyag bemutatja, hogyan telepíthet és használhat globális eszközöket. A sorozat első oktatóanyagában létrehozott eszközt használja.

Előfeltételek

Fejezze be a sorozat első oktatóanyagát.

Az eszköz használata globális eszközként

Telepítse az eszközt a csomagból a dotnet tool install parancs futtatásával a microsoft.botsay projektmappában:
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
A --global paraméter arra utasítja a .NET CLI-t, hogy telepítse az eszköz bináris fájljait egy alapértelmezett helyre, amely automatikusan hozzá lesz adva a PATH környezeti változóhoz.

A --add-source paraméter arra utasítja a .NET CLI-t, hogy ideiglenesen használja a ./nupkg könyvtárat további forráscsatornaként a NuGet-csomagokhoz. Egyedi nevet adott a csomagnak, így meggyőződhet arról, hogy csak a ./nupkg könyvtárban található, nem a Nuget.org webhelyen.

A kimenet az eszköz meghívásához használt parancsot és a telepített verziót jeleníti meg:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
Megjegyzés

Alapértelmezés szerint a telepíteni kívánt .NET bináris fájlok architektúrája a jelenleg futó operációsrendszer-architektúrát jelöli. Ha másik operációsrendszer-architektúrát szeretne megadni, tekintse meg a dotnet eszköz telepítésének --arch beállítását ismertető cikket.
Az eszköz meghívása:
```
botsay hello from the bot
```
Megjegyzés

Ha ez a parancs nem sikerül, előfordulhat, hogy meg kell nyitnia egy új terminált a PATH frissítéséhez.
Távolítsa el az eszközt a dotnet eszköz eltávolítási parancsának futtatásával:
```
dotnet tool uninstall -g microsoft.botsay
```

Az eszköz használata egy egyéni helyen telepített globális eszközként

Telepítse az eszközt a csomagból.

Windows rendszeren:
```
dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg microsoft.botsay
```
Linux vagy macOS rendszeren:
```
dotnet tool install --tool-path ~/bin --add-source ./nupkg microsoft.botsay
```
A --tool-path paraméter arra utasítja a .NET CLI-t, hogy telepítse az eszköz bináris fájljait a megadott helyre. Ha a könyvtár nem létezik, létrejön. Ez a könyvtár nem lesz automatikusan hozzáadva a PATH környezeti változóhoz.

A kimenet az eszköz meghívásához használt parancsot és a telepített verziót jeleníti meg:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```

Az eszköz meghívása:

Windows rendszeren:

c:\dotnet-tools\botsay hello from the bot

Linux vagy macOS rendszeren:

~/bin/botsay hello from the bot

Távolítsa el az eszközt a dotnet eszköz eltávolítási parancsának futtatásával:

Windows rendszeren:
```
dotnet tool uninstall --tool-path c:\dotnet-tools microsoft.botsay
```
Linux vagy macOS rendszeren:
```
dotnet tool uninstall --tool-path ~/bin microsoft.botsay
```

Hibaelhárítás

Ha hibaüzenet jelenik meg az oktatóanyag követése közben, olvassa el a .NET-eszközök használati problémáinak elhárítása című témakört.

Következő lépések

Ebben az oktatóanyagban egy eszközt telepített és használt globális eszközként. A globális eszközök telepítésével és használatával kapcsolatos további információkért lásd: Globális eszközök kezelése. Ha ugyanazt az eszközt szeretné telepíteni és használni, mint egy helyi eszközt, lépjen tovább a következő oktatóanyagra.

Helyi eszközök telepítése és használata