Esercitazione: Installare e usare uno strumento globale .NET con la CLI .NET

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

Questa esercitazione illustra come installare e usare uno strumento globale. Lo strumento usato è quello creato nella prima esercitazione di questa serie.

Prerequisiti

• Completare la prima esercitazione di questa serie.
• .NET 10.0.100 SDK o versione successiva (per dnx) - facoltativo ma consigliato.

Eseguire lo strumento senza installazione (scelta consigliata)

A partire da .NET 10.0.100, è possibile eseguire strumenti .NET senza l'installazione permanente usando dnx:

1. Eseguire lo strumento direttamente usando dnx (sintassi semplificata):

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

   Il parametro --add-source indica all'interfaccia della riga di comando di .NET di usare la directory ./nupkg come feed di origine aggiuntivo per i pacchetti NuGet quando lo strumento non è disponibile in NuGet.org.

Usare lo strumento come strumento globale (installazione tradizionale)

Se si preferisce l'installazione permanente per un uso frequente:

1. Installare lo strumento dal pacchetto eseguendo il comando dotnet tool install nella cartella del progetto dotnet-env :

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

   Il parametro --global indica all'interfaccia della riga di comando di .NET di installare i file binari dello strumento in un percorso predefinito aggiunto automaticamente alla variabile di ambiente PATH.

   Il --add-source parametro indica all'interfaccia della riga di comando di .NET di usare temporaneamente la directory ./nupkg come feed di origine aggiuntivo per i pacchetti NuGet. Al pacchetto è stato assegnato un nome univoco per assicurarsi che sia presente solo nella directory ./nupkg , non in 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: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

   Annotazioni

   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 l'opzione dotnet tool install, --arch.

2. Richiamare lo strumento:

   dotnet-env
   

   Annotazioni

   Se il comando non riesce, aprire un nuovo terminale per aggiornare la PATH variabile di ambiente.

3. Rimuovere lo strumento eseguendo il comando di disinstallazione dello strumento dotnet :

   dotnet tool uninstall -g dotnet-env
   

Usare lo strumento come strumento globale installato in un percorso personalizzato

1. Installare lo strumento dal pacchetto.

   In Windows:

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

   In Linux o macOS:

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

   Il --tool-path parametro indica all'interfaccia della riga di comando di .NET di installare i file binari dello strumento nel percorso specificato. Se la directory non esiste, viene creata. La directory non viene aggiunta automaticamente alla PATH variabile di ambiente.

   L'output mostra il comando usato per chiamare lo strumento e la versione installata:

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

2. Richiamare lo strumento:

   In Windows:

   c:\dotnet-tools\dotnet-env
   

   In Linux o macOS:

   ~/bin/dotnet-env
   

3. Rimuovere lo strumento eseguendo il comando di disinstallazione dello strumento dotnet :

   In Windows:

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

   In Linux o macOS:

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

Troubleshoot

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

Passaggi successivi

In questo tutorial, hai installato e utilizzato un tool come strumento globale. Per altre informazioni sull'installazione e l'uso di strumenti globali, vedere Gestione degli strumenti globali. Per installare e usare lo stesso strumento come strumento locale, passare all'esercitazione successiva.

Installare e usare gli strumenti locali