Esercitazione: Installare e usare uno strumento globale .NET con l'interfaccia della riga di comando di .NET

Articolo
03/01/2024

Questo articolo si applica a: ✔️ .NET Core 2.1 SDK e versioni successive

Questa esercitazione illustra come installare e usare uno strumento globale. Si usa uno strumento creato nella prima esercitazione di questa serie.

Prerequisiti

Completare la prima esercitazione di questa serie.

Usare lo strumento come strumento globale

Installare lo strumento dal pacchetto eseguendo il comando dotnet tool install nella cartella del progetto microsoft.botsay:
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
Il parametro --global indica all'interfaccia della riga di comando di .NET di installare i file binari dello strumento in una posizione predefinita aggiunta automaticamente alla variabile di ambiente percorso.

Il parametro --add-source indica all'interfaccia della riga di comando di .NET di usare temporaneamente la directory./nupkg come feed di origine per i pacchetti NuGet. Al pacchetto è stato assegnato un nome univoco per essere sicuri che venga trovato solo nella directory ./nupkg, non nel sito Nuget.org.

L'output mostra il comando usato per chiamare lo strumento e la versione installata.
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
Nota

Per impostazione predefinita, l'architettura dei file binari .NET da installare rappresenta l'architettura del sistema operativo attualmente in esecuzione. Per specificare un'architettura del sistema operativo diversa, vedere dotnet tool install, --opzione arch..
Richiamare lo strumento:
```
botsay hello from the bot
```
Nota

Se questo comando non riesce, potrebbe essere necessario aprire un nuovo terminale per aggiornare il percorso.
Rimuovere lo strumento eseguendo il comando dotnet tool uninstall.
```
dotnet tool uninstall -g microsoft.botsay
```

Usare lo strumento come strumento globale installato in una posizione personalizzata

Installare lo strumento dal pacchetto.

In Windows:
```
dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg microsoft.botsay
```
In Linux o macOS:
```
dotnet tool install --tool-path ~/bin --add-source ./nupkg microsoft.botsay
```
Il parametro--tool-path indica all'interfaccia della riga di comando di .NET di installare i file binari dello strumento nella posizione specificata. Se la directory non esiste, viene creata. Questa directory non viene aggiunta automaticamente alla variabile di ambiente percorso.

L'output mostra il comando usato per chiamare lo strumento e la versione installata.
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```

Richiamare lo strumento:

In Windows:

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

In Linux o macOS:

~/bin/botsay hello from the bot

Rimuovere lo strumento eseguendo il comando dotnet tool uninstall.

In Windows:

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

In Linux o macOS:

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

Risoluzione dei problemi

Se viene visualizzato un messaggio di errore durante l'esercitazione, vedere Risolvere i problemi di utilizzo degli strumenti .NET..

Passaggi successivi

In questa esercitazione è stato installato e usato uno strumento come strumento globale. Per altre informazioni su come installare e usare gli strumenti globali, vedere Gestione degli strumenti globali. Per installare e usare lo stesso strumento di uno strumento locale, passare all'esercitazione successiva.

Installare e usare uno strumento locale