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

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

Den här självstudien visar hur du installerar och använder ett globalt verktyg. Verktyget du använder är det du skapar i den första handledningen i denna serie.

Förutsättningar

• Slutför den första handledning i den här serien.
• .NET 10.0.100 SDK eller senare (för dnx) – valfritt men rekommenderas.

Kör verktyget utan installation (rekommenderas)

Från och med .NET 10.0.100 kan du köra .NET-verktyg utan permanent installation med hjälp av dnx:

1. Kör verktyget direkt med dnx (förenklad syntax):

   dnx dotnet-env --add-source ./nupkg
   

   Parametern --add-source instruerar .NET CLI att använda katalogen ./nupkg som ytterligare källflöde för NuGet-paket när verktyget inte är tillgängligt på NuGet.org.

Använd verktyget som ett globalt verktyg (traditionell installation)

Om du föredrar permanent installation för frekvent användning:

1. Installera verktyget från paketet genom att köra kommandot dotnet tool install i projektmappen dotnet-env :

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

   Parametern --global instruerar .NET CLI att installera verktygets binärfiler på en standardplats som automatiskt läggs till i miljövariabeln PATH.

   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.

   Utdata visar kommandot som används för att anropa verktyget och den installerade versionen:

   You can invoke the tool using the following command: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

   Anmärkning

   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.

2. Anropa verktyget:

   dotnet-env
   

   Anmärkning

   Om kommandot misslyckas öppnar du en ny terminal för att uppdatera PATH miljövariabeln.

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

   dotnet tool uninstall -g dotnet-env
   

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

1. Installera verktyget från paketet.

   På Windows:

   dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg dotnet-env
   

   I Linux eller macOS:

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

   Parametern --tool-path instruerar .NET CLI att installera verktygsbinärfilerna på den angivna platsen. Om katalogen inte finns skapas den. 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: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

2. Anropa verktyget:

   På Windows:

   c:\dotnet-tools\dotnet-env
   

   I Linux eller macOS:

   ~/bin/dotnet-env
   

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

   På Windows:

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

   I Linux eller macOS:

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

Felsökning

Om du får ett felmeddelande när du följer självstudien, se Felsöka problem med användningen av .NET-verktyg.

Nästa steg

I den här handledningen har du installerat och använt ett verktyg som 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 fortsätter du till nästa handledning.