Dela via

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 Core 2.1 SDK och senare versioner

I den här guiden 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 handledningen i serien.

Förutsättningar

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 microsoft.botsay --add-source ./nupkg microsoft.botsay hello from the bot

    Parametern --add-source instruerar .NET CLI att använda katalogen ./nupkg som ytterligare en källfeed 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 installationskommandot för dotnet-verktyget i projektmappen microsoft.botsay :

    dotnet tool install --global --add-source ./nupkg microsoft.botsay

    Parametern --global instruerar .NET CLI att installera verktygets binärfiler 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.

    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:

    botsay hello from the bot

    Anmärkning

    Om det här kommandot misslyckas kan du behöva öppna en ny terminal för att uppdatera PATH.

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

    dotnet tool uninstall -g microsoft.botsay

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

  2. Anropa verktyget:

    I Windows:

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

    I Linux eller macOS:

    ~/bin/botsay hello from the bot

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

    På Windows:

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

    I Linux eller macOS:

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

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.

Installera och använda lokala verktyg