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

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

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

Vereiste voorwaarden

• Voltooi de eerste zelfstudie van deze reeks.
• .NET 10.0.100 SDK of hoger (voor dnx) - optioneel, maar aanbevolen.

Het hulpprogramma uitvoeren zonder installatie (aanbevolen)

Vanaf .NET 10.0.100 kunt u .NET-hulpprogramma's uitvoeren zonder permanente installatie met behulp van dnx:

1. Voer het hulpprogramma rechtstreeks uit met behulp van dnx (vereenvoudigde syntaxis):

   dnx microsoft.botsay --add-source ./nupkg microsoft.botsay hello from the bot
   

   De --add-source parameter geeft de .NET CLI opdracht om de ./nupkg-map te gebruiken als een extra bronfeed voor NuGet-pakketten wanneer het hulpprogramma niet beschikbaar is op NuGet.org.

Het hulpprogramma gebruiken als een algemeen hulpprogramma (traditionele installatie)

Als u de voorkeur geeft aan permanente installatie voor frequent gebruik:

1. 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-parameterveld vertelt de .NET CLI om de ./nupkg directory tijdelijk als een extra bronfeed voor NuGet-pakketten te gebruiken. U hebt uw pakket een unieke naam gegeven om ervoor te zorgen dat het alleen wordt gevonden in de map ./nupkg , niet op de Nuget.org site.

   In de uitvoer ziet u de opdracht die wordt gebruikt om het hulpprogramma aan te roepen en de geïnstalleerde versie:

   You can invoke the tool using the following command: botsay
   Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
   

   Opmerking

   De architectuur van de binaire .NET-bestanden die moeten worden geïnstalleerd, vertegenwoordigt standaard de huidige besturingssysteemarchitectuur. Als u een andere besturingssysteemarchitectuur wilt opgeven, raadpleegt u de optie dotnet tool install, --arch.

2. Roep het hulpprogramma aan:

   botsay hello from the bot
   

   Opmerking

   Als deze opdracht mislukt, moet u mogelijk een nieuwe terminal openen om het PAD te vernieuwen.

3. 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

1. 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 vertelt de .NET CLI om de binaire bestanden van het hulpprogramma op de opgegeven locatie te installeren. Als de map niet bestaat, wordt deze gemaakt. Deze map wordt niet automatisch toegevoegd aan de omgevingsvariabele PATH.

   In de uitvoer ziet u de opdracht die wordt gebruikt om het hulpprogramma aan te roepen en de geïnstalleerde versie:

   You can invoke the tool using the following command: botsay
   Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
   

2. Roep het hulpprogramma aan:

   In Windows:

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

   In Linux of macOS:

   ~/bin/botsay hello from the bot
   

3. 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
   

Troubleshoot

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 Algemene 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