Självstudie: Installera och använda ett globalt .NET-verktyg med .NET CLI

Artikel
07/27/2023

Den här artikeln gäller för: ✔️ .NET Core 2.1 SDK och senare versioner

I den här självstudien lär du dig hur du installerar och använder ett globalt verktyg. Du använder ett verktyg som du skapar i den första självstudien i den här serien.

Förutsättningar

Slutför den första självstudien i den här serien.

Använda verktyget som ett globalt verktyg

Installera verktyget från paketet genom att köra kommandot dotnet tool install i projektmappen microsoft.botsay :
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
Parametern --global instruerar .NET CLI att installera verktygsbinärfilerna på en standardplats som läggs till automatiskt i PATH-miljövariabeln.

Parametern --add-source instruerar .NET CLI att tillfälligt använda katalogen ./nupkg som ytterligare en källfeed för NuGet-paket. Du gav paketet ett unikt namn för att se till att det bara finns i katalogen ./nupkg , inte på Nuget.org-webbplatsen.

Utdata visar kommandot som används för att anropa verktyget och den installerade versionen:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
Anteckning

Som standard representerar arkitekturen för de .NET-binärfiler som ska installeras den operativsystemarkitektur som körs. Information om hur du anger en annan OPERATIVSYSTEM-arkitektur finns i dotnet tool install, --arch option.
Anropa verktyget:
```
botsay hello from the bot
```
Anteckning

Om det här kommandot misslyckas kan du behöva öppna en ny terminal för att uppdatera PATH.
Ta bort verktyget genom att köra avinstallationskommandot för dotnet-verktyget :
```
dotnet tool uninstall -g microsoft.botsay
```

Använda verktyget som ett globalt verktyg installerat på en anpassad plats

Installera verktyget från paketet.

I Windows:
```
dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg microsoft.botsay
```
I Linux eller macOS:
```
dotnet tool install --tool-path ~/bin --add-source ./nupkg microsoft.botsay
```
Parametern --tool-path instruerar .NET CLI att installera verktygsbinärfilerna på den angivna platsen. Om katalogen inte finns skapas den. Den här katalogen läggs inte automatiskt till i PATH-miljövariabeln.

Utdata visar kommandot som används för att anropa verktyget och den installerade versionen:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```

Anropa verktyget:

I Windows:

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

I Linux eller macOS:

~/bin/botsay hello from the bot

Ta bort verktyget genom att köra avinstallationskommandot för dotnet-verktyget :

I Windows:

dotnet tool uninstall --tool-path c:\dotnet-tools microsoft.botsay

I Linux eller macOS:

dotnet tool uninstall --tool-path ~/bin microsoft.botsay

Felsöka

Om du får ett felmeddelande när du följer självstudien kan du läsa Felsöka problem med .NET-verktygsanvändning.

Nästa steg

I den här självstudien har du installerat och använt ett verktyg som ett globalt verktyg. Mer information om hur du installerar och använder globala verktyg finns i Hantera globala verktyg. Om du vill installera och använda samma verktyg som ett lokalt verktyg går du vidare till nästa självstudie.

Installera och använda lokala verktyg

Dela via