dotnet tool install

  • Articolo

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

Nome

dotnet tool install: installa lo strumento .NET specificato nel computer.

Riepilogo

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Descrizione

Il comando dotnet tool install consente di installare gli strumenti .NET nel computer. Per usare il comando, specificare una delle opzioni di installazione seguenti:

  • Per installare uno strumento globale nel percorso predefinito, usare l'opzione --global.
  • Per installare uno strumento globale in un percorso personalizzato, usare l'opzione --tool-path.
  • Per installare uno strumento locale, omettere le opzioni --global e --tool-path.

Percorsi di installazione

Strumenti globali

Gli strumenti globali vengono installati nelle directory seguenti per impostazione predefinita quando si specifica l'opzione -g (o --global):

Sistema operativo Percorso
Linux/macOS $HOME/.dotnet/tools
Finestre %USERPROFILE%\.dotnet\tools

I file eseguibili vengono generati in queste cartelle per ogni strumento installato a livello globale, anche se i file binari effettivi dello strumento sono annidati nella directory .store di pari livello.

Strumenti --tool-path

Gli strumenti con percorsi espliciti degli strumenti vengono archiviati nella posizione specificata come riferimento per il parametro --tool-path. Vengono archiviati in modo analogo agli strumenti globali: un file binario eseguibile con i file binari effettivi in una directory .store di pari livello.

Strumenti locali

Gli strumenti locali vengono archiviati nella directory globale di NuGet, indipendentemente da quanto impostato. Sono presenti file shim in $HOME/.dotnet/toolResolverCache per ogni strumento locale che puntano alla posizione in cui si trovano gli strumenti.

I riferimenti agli strumenti locali vengono aggiunti a un file dotnet-tools.json in una directory .config nella directory corrente. Se non esiste ancora un file manifesto, crearlo usando l'opzione --create-manifest-if-needed o eseguendo il comando seguente:

dotnet new tool-manifest

Per altre informazioni, vedere Installare uno strumento locale.

Argomenti

  • PACKAGE_NAME

    Nome/ID del pacchetto NuGet che contiene lo strumento .NET da installare.

Opzioni

  • --allow-downgrade

    Consenti il downgrade del pacchetto durante l'installazione o l'aggiornamento di un pacchetto di strumenti .NET. Elimina l'avviso " La versione richiesta x.x.x è inferiore alla versione esistente x.x.x".

  • -a|--arch <ARCHITECTURE>

    Specifica l'architettura di destinazione. Si tratta di una sintassi abbreviata per l'impostazione dell'identificatore di runtime (RID), in cui il valore fornito viene combinato con il RID predefinito. Ad esempio, in un computer win-x64, specificando --arch x86 si imposta il RID su win-x86.

  • --add-source <SOURCE>

    Aggiunge un'altra origine pacchetto NuGet da usare durante l'installazione. I feed sono accessibili in parallelo e non in sequenza secondo un ordine di precedenza. Se lo stesso pacchetto e la stessa versione si trovano in più feed, il feed più veloce vince. Per altre informazioni, vedere Cosa accade quando viene installato un pacchetto NuGet?.

  • --configfile <FILE>

    File di configurazione NuGet (nuget.config) da usare. Se si dispone di indicazione, verranno usate solo le impostazioni di questo file. Se non specificato, verrà usata la gerarchia dei file di configurazione dalla directory corrente. Per ulteriori informazioni, vedere Configurazioni NuGet comuni.

  • --create-manifest-if-needed

    Si applica agli strumenti locali. Disponibile a partire da .NET 8 SDK. Per trovare un manifesto, l'algoritmo di ricerca cerca nell'albero di directory dotnet-tools.json o una cartella .config che contiene un file dotnet-tools.json.

    Se non è possibile trovare un manifesto dello strumento e l'opzione --create-manifest-if-needed è impostata su false, si verifica l'errore CannotFindAManifestFile.

    Se non è possibile trovare un manifesto dello strumento e l'opzione --create-manifest-if-needed è impostata su true, lo strumento crea automaticamente un manifesto. Sceglie una cartella per il manifesto come indicato di seguito:

    • Spostarsi verso l'alto nell'albero di directory cercando una directory con una sottocartella .git. Se ne viene trovata una, creare il manifesto in tale directory.
    • Se il passaggio precedente non trova una directory, esaminare l'albero della directory cercando una directory con un .sln file o .git . Se ne viene trovata una, creare il manifesto in tale directory.
    • Se nessuno dei due passaggi precedenti trova una directory, creare il manifesto nella directory di lavoro corrente.

    Per altre informazioni sulla posizione dei manifesti, vedere Installare uno strumento locale.

  • --disable-parallel

    Impedisce il ripristino di più progetti in parallelo.

  • --framework <FRAMEWORK>

    Specifica il framework di destinazione per cui installare lo strumento. Per impostazione predefinita, .NET SDK prova a scegliere il framework di destinazione più appropriato.

  • -g|--global

    Specifica che l'installazione è a livello utente. Non può essere usata con l'opzione --tool-path. Omettendo sia --global sia --tool-path si specifica un'installazione dello strumento locale.

  • -?|-h|--help

    Stampa le istruzioni di utilizzo del comando.

  • --ignore-failed-sources

    Gestisce gli errori dell'origine dei pacchetti come avvisi.

  • --interactive

    Consente al comando di arrestarsi e attendere l'input o l'azione dell'utente, ad esempio il completamento dell'autenticazione.

  • --local

    Aggiorna lo strumento e il manifesto dello strumento locale. Non è possibile combinarla con l'opzione --global o l'opzione --tool-path.

  • --no-cache

    Non memorizza nella cache pacchetti e richieste HTTP.

  • --prerelease

    Include pacchetti non definitivi.

  • --tool-manifest <PATH>

    Percorso del file manifesto.

  • --tool-path <PATH>

    Specifica il percorso in cui disinstallare lo strumento globale. Il valore di PATH può essere assoluto o relativo. Se PATH non esiste, il comando tenta di creare la variabile. Omettendo sia --global sia --tool-path si specifica un'installazione dello strumento locale.

  • -v|--verbosity <LEVEL>

    Imposta il livello di dettaglio del comando. I valori consentiti sono q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. Per ulteriori informazioni, vedere LoggerVerbosity.

  • --version <VERSION_NUMBER>

    La versione dello strumento da installare. Per impostazione predefinita, viene installata la versione del pacchetto stabile più recente. Usare questa opzione per installare le versioni di anteprima o precedenti dello strumento.

    A partire da .NET 8.0, --version Major.Minor.Patch fa riferimento a una versione principale/secondaria/patch specifica, incluse le versioni non elencate. Per ottenere invece la versione più recente di una determinata versione principale/secondaria, usare --version Major.Minor.*.

Esempi

  • dotnet tool install -g dotnetsay

    Installa dotnetsay come strumento globale nel percorso predefinito.

  • dotnet tool install dotnetsay --tool-path c:\global-tools

    Installa dotnetsay come strumento globale in una directory di Windows specifica.

  • dotnet tool install dotnetsay --tool-path ~/bin

    Installa dotnetsay come strumento globale in una directory Linux/macOS specifica.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Installa la versione 2.0.0 di dotnetsay come strumento globale.

  • dotnet tool install dotnetsay

    Installa dotnetsay come strumento locale per la directory corrente.

  • dotnet tool install -g --verbosity minimal

    Installa dotnetsay come strumento globale con livello di dettaglio minimo. Il livello di dettaglio predefinito per lo strumento globale è quiet.

Vedi anche