Zelfstudie: Een algemeen .NET-hulpprogramma installeren en gebruiken met behulp van de .NET CLI

Artikel
07/27/2023

Dit artikel is van toepassing op: ✔️ .NET Core 2.1 SDK en latere versies

In deze zelfstudie leert u hoe u een algemeen hulpprogramma installeert en gebruikt. U gebruikt een hulpprogramma dat u in de eerste zelfstudie van deze reeks maakt.

Vereisten

Voltooi de eerste zelfstudie van deze reeks.

Het hulpprogramma gebruiken als een globaal hulpprogramma

Installeer het hulpprogramma vanuit het pakket door de opdracht dotnet tool install uit te voeren in de projectmap microsoft.botsay :
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
De --global parameter vertelt de .NET CLI om de binaire bestanden van het hulpprogramma te installeren op een standaardlocatie die automatisch wordt toegevoegd aan de omgevingsvariabele PATH.

De --add-source parameter vertelt de .NET CLI om de map ./nupkg tijdelijk te gebruiken als een extra bronfeed voor NuGet-pakketten. U hebt uw pakket een unieke naam gegeven om ervoor te zorgen dat het alleen te vinden is in de map ./nupkg , niet op de Nuget.org-site.

De uitvoer toont de opdracht die wordt gebruikt om het hulpprogramma aan te roepen en de versie die is geïnstalleerd:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
Notitie

De architectuur van de binaire .NET-bestanden die moeten worden geïnstalleerd, vertegenwoordigt standaard de architectuur van het besturingssysteem dat momenteel wordt uitgevoerd. Als u een andere architectuur van het besturingssysteem wilt opgeven, raadpleegt u dotnet-hulpprogramma installeren, --arch-optie.
Roep het hulpprogramma aan:
```
botsay hello from the bot
```
Notitie

Als deze opdracht mislukt, moet u mogelijk een nieuwe terminal openen om het PAD te vernieuwen.
Verwijder het hulpprogramma door de opdracht dotnet tool uninstall uit te voeren:
```
dotnet tool uninstall -g microsoft.botsay
```

Het hulpprogramma gebruiken als een algemeen hulpprogramma dat is geïnstalleerd op een aangepaste locatie

Installeer het hulpprogramma vanuit het pakket.

In Windows:
```
dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg microsoft.botsay
```
In Linux of macOS:
```
dotnet tool install --tool-path ~/bin --add-source ./nupkg microsoft.botsay
```
De --tool-path parameter geeft aan de .NET CLI door dat de binaire hulpprogrammabestanden op de opgegeven locatie moeten worden geïnstalleerd. Als de map niet bestaat, wordt deze gemaakt. Deze map wordt niet automatisch toegevoegd aan de omgevingsvariabele PATH.

De uitvoer toont de opdracht die wordt gebruikt om het hulpprogramma aan te roepen en de versie die is geïnstalleerd:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```

Roep het hulpprogramma aan:

In Windows:

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

In Linux of macOS:

~/bin/botsay hello from the bot

Verwijder het hulpprogramma door de opdracht dotnet tool uninstall uit te voeren:

In Windows:

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

In Linux of macOS:

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

Problemen oplossen

Als u een foutbericht krijgt tijdens het volgen van de zelfstudie, raadpleegt u Problemen met het gebruik van .NET-hulpprogramma's oplossen.

Volgende stappen

In deze zelfstudie hebt u een hulpprogramma geïnstalleerd en gebruikt als een algemeen hulpprogramma. Zie Globale hulpprogramma's beheren voor meer informatie over het installeren en gebruiken van globale hulpprogramma's. Als u hetzelfde hulpprogramma wilt installeren en gebruiken als een lokaal hulpprogramma, gaat u verder met de volgende zelfstudie.

Lokale hulpprogramma's installeren en gebruiken