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

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

In deze zelfstudie leert u hoe u een algemeen hulpprogramma installeert en gebruikt. Het hulpprogramma dat u gebruikt, is het 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 dotnet-env --add-source ./nupkg
   

   De parameter --add-source vertelt de .NET CLI om de map ./nupkg 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 map dotnet-env project:

   dotnet tool install --global --add-source ./nupkg dotnet-env
   

   De parameter --global 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 NuGet.org.

   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: dotnet-env
   Tool 'dotnet-env' (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:

   dotnet-env
   

   Opmerking

   Als de opdracht mislukt, opent u een nieuwe terminal om de PATH omgevingsvariabele te vernieuwen.

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

   dotnet tool uninstall -g dotnet-env
   

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 dotnet-env
   

   In Linux of macOS:

   dotnet tool install --tool-path ~/bin --add-source ./nupkg dotnet-env
   

   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. De map wordt niet automatisch toegevoegd aan de PATH omgevingsvariabele.

   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: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

2. Roep het hulpprogramma aan:

   In Windows:

   c:\dotnet-tools\dotnet-env
   

   In Linux of macOS:

   ~/bin/dotnet-env
   

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

   In Windows:

   dotnet tool uninstall --tool-path c:\dotnet-tools dotnet-env
   

   In Linux of macOS:

   dotnet tool uninstall --tool-path ~/bin dotnet-env
   

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.