Freigeben über


Tutorial: Installieren und Verwenden eines globalen .NET-Tools mithilfe der .NET-CLI

Dieser Artikel gilt für: ✔️ .NET Core 2.1 SDK und neuere Versionen

In diesem Tutorial erfahren Sie, wie ein globales Tools installiert und verwendet wird. Sie verwenden ein Tool, das Sie im ersten Tutorial dieser Reihe erstellen.

Voraussetzungen

Verwenden des Tools als globales Tool

  1. Installieren Sie das Tool aus dem Paket, indem Sie den Befehl dotnet tool install im Projektordner microsoft.botsay ausführen:

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

    Der Parameter --global weist die .NET-CLI an, die Binärdateien des Tools an einem Standardspeicherort zu installieren, der automatisch zur Umgebungsvariablen PATH hinzugefügt wird.

    Der Parameter --add-source weist die .NET-CLI an, vorübergehend das Verzeichnis ./nupkg als zusätzlichen Quellfeed für NuGet-Pakete zu verwenden. Sie haben Ihr Paket mit einem eindeutigen Namen versehen, um sicherzustellen, dass es nur im Verzeichnis ./nupkg und nicht auf der Website Nuget.org gefunden wird.

    Die Ausgabe zeigt den zum Aufrufen des Tools verwendeten Befehl und die installierte Version:

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

    Hinweis

    Standardmäßig stellt die Architektur der zu installierenden .NET-Binärdateien die derzeit ausgeführte Betriebssystemarchitektur dar. Informationen zum Angeben einer anderen Betriebssystemarchitektur finden Sie unter dotnet tool install, --arch (Option).

  2. Rufen Sie das Tool auf:

    botsay hello from the bot
    

    Hinweis

    Wenn dieser Befehl fehlschlägt, müssen Sie möglicherweise ein neues Terminal öffnen, um PATH zu aktualisieren.

  3. Entfernen Sie das Tool, indem Sie den Befehl dotnet tool uninstall ausführen:

    dotnet tool uninstall -g microsoft.botsay
    

Verwenden des an einem benutzerdefinierten Speicherort installierten Tools als globales Tool

  1. Installieren Sie das Toll aus dem Paket.

    Unter Windows:

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

    Unter Linux oder macOS:

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

    Der Parameter --tool-path weist die .NET-CLI an, die Binärdateien des Tools am angegebenen Speicherort zu installieren. Wenn das Verzeichnis noch nicht vorhanden ist, wird es erstellt. Dieses Verzeichnis wird nicht automatisch zur Umgebungsvariablen PATH hinzugefügt.

    Die Ausgabe zeigt den zum Aufrufen des Tools verwendeten Befehl und die installierte Version:

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

    Unter Windows:

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

    Unter Linux oder macOS:

    ~/bin/botsay hello from the bot
    
  3. Entfernen Sie das Tool, indem Sie den Befehl dotnet tool uninstall ausführen:

    Unter Windows:

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

    Unter Linux oder macOS:

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

Problembehandlung

Falls im Verlauf des Tutorials eine Fehlermeldung angezeigt wird, finden Sie unter Behandlung von Problemen bei der Nutzung von .NET-Tools weitere Informationen.

Nächste Schritte

In diesem Tutorial haben Sie ein Tool als globales Tool installiert und verwendet. Weitere Informationen zum Installieren und Verwenden globaler Tools finden Sie unter Verwalten globaler Tools. Um dasselbe Tool als lokales Tool zu installieren und zu verwenden, fahren Sie mit dem nächsten Tutorial fort.