Installare gli strumenti client di NuGet

  • Articolo

Se servono istruzioni per installare un pacchetto, Vedere Modi per installare i pacchetti NuGet.

Per usare NuGet come consumer di pacchetti o creatore, è possibile usare gli strumenti dell'interfaccia della riga di comando e le funzionalità NuGet in Visual Studio. Questo articolo descrive brevemente le funzionalità dei diversi strumenti, come installarli e un confronto delle funzionalità disponibili.

Per iniziare a usare NuGet per utilizzare i pacchetti, vedere gli articoli seguenti:

Per iniziare a creare pacchetti NuGet, vedere gli articoli seguenti:

Strumento Descrizione Download
dotnet SDK Lo strumento dell'interfaccia della riga di comando per le librerie .NET Core e .NET Standard e per qualsiasi progetto di tipo SDK, ad esempio quello destinato a .NET Framework. Questo strumento dell'interfaccia della riga di comando è incluso in .NET Core SDK e offre funzionalità NuGet di base in tutte le piattaforme. In Visual Studio 2017 e versioni successive, l'interfaccia della riga di comando dotnet viene installata automaticamente con qualsiasi carico di lavoro correlato a .NET Core. ASP.NET Core SDK
nuget.exe Lo strumento dell'interfaccia della riga di comando per le librerie .NET Framework e per qualsiasi progetto non in stile SDK, ad esempio quello destinato alle librerie .NET Standard. Questo strumento dell'interfaccia della riga di comando offre tutte le funzionalità NuGet in Windows e la maggior parte delle funzionalità in Mac e Linux durante l'esecuzione in Mono. nuget.exe
Visual Studio In Windows il Gestione pacchetti NuGet è incluso in Visual Studio 2012 e versioni successive. Visual Studio offre l'interfaccia utente Gestione pacchetti e la console Gestione pacchetti (PowerShell in Windows). È possibile usare questi strumenti per eseguire la maggior parte delle operazioni NuGet. Visual Studio
Visual Studio per Mac In Mac alcune funzionalità NuGet sono integrate direttamente. Gestione pacchetti Console non è attualmente disponibile. Per altre funzionalità, usare dotnet SDK o nuget.exe gli strumenti dell'interfaccia della riga di comando. Visual Studio per Mac
Visual Studio Code In Windows, Mac e Linux, le funzionalità NuGet sono disponibili tramite le estensioni del marketplace o usano gli strumenti dotnet SDK o nuget.exe dell'interfaccia della riga di comando. Visual Studio Code

Nota

Visual Studio per Mac è prevista per il ritiro entro il 31 agosto 2024 in conformità con Criteri moderni relativi al ciclo di vita di Microsoft. Per altre informazioni, vedere What's happening to Visual Studio per Mac.

L'interfaccia della riga di comando di MSBuild ripristina e crea pacchetti. MSBuild non è uno strumento per utilizzo generico per l'uso con NuGet. Questo strumento dell'interfaccia della riga di comando è utile principalmente nei server di compilazione.

Gestione pacchetti i comandi della console funzionano solo in Visual Studio in Windows e non funzionano in altri ambienti di PowerShell.

Criteri di supporto

I criteri di supporto di Visual Studio per Windows sono disponibili in Ciclo di vita del prodotto e manutenzione di Visual Studio.

La versione più recente di NuGet.exe è completamente supportata e può essere basata su per correzioni di bug, aggiornamenti e miglioramenti. Per altre informazioni sui criteri di supporto di NuGet.exe, vedere i criteri moderni relativi al ciclo di vita di Microsoft.

I criteri di supporto di .NET SDK sono disponibili in Criteri di supporto di .NET e .NET Core.

Versioni patch

Le versioni con patch di NuGet.exe verranno rilasciate esclusivamente quando sono necessarie correzioni di sicurezza critiche per una versione LTS (Long-Term Support) di Visual Studio o .NET SDK.

Tutti i bug di sicurezza devono essere segnalati al Microsoft Security Response Center (MSRC) nella pagina del report di MSRC. Vedere anche i criteri di sicurezza nel repository NuGet.Client.

NuGet.exe l'annullamento dell'elenco

Le versioni di NuGet.exe non supportate, deprecate o vulnerabili verranno rimosse da tools.json.

Visual Studio

In Visual Studio 2017 e versioni successive il programma di installazione di Visual Studio include il Gestione pacchetti NuGet con qualsiasi carico di lavoro che usa .NET.

È anche possibile installare il Gestione pacchetti separatamente o verificare l'installazione. Eseguire il programma di installazione di Visual Studio e selezionare l'impostazione dell'opzione in Strumenti di codice singoli > Strumenti di codice > NuGet. Per altre informazioni, vedere Installare e gestire i pacchetti in Visual Studio usando il Gestione pacchetti NuGet.

Nota

Per le versioni precedenti di Visual Studio, è possibile scaricare le estensioni NuGet all'indirizzo https://dist.nuget.org/index.html.

Strumenti di interfaccia della riga di comando

È possibile usare l'interfaccia della riga di comando dotnet o l'interfaccia della nuget.exe riga di comando per supportare le funzionalità NuGet nell'IDE di Visual Studio. L'interfaccia della riga di comando dotnet viene installata con alcuni carichi di lavoro di Visual Studio, ad esempio .NET Core. L'interfaccia della riga di comando nuget.exe deve essere installata separatamente, come descritto in precedenza. Per un confronto delle funzionalità degli strumenti, vedere la sezione relativa alla disponibilità delle funzionalità.

  • Per usare .NET Core o .NET Standard come destinazione, usare lo strumento dell'interfaccia della riga di comando di dotnet SDK. Questa interfaccia della riga di comando è necessaria per il formato di progetto in stile SDK, che usa l'attributo SDK.

  • Per specificare come destinazione .NET Framework (solo progetto non in stile SDK), usare lo strumento dell'interfaccia della nuget.exe riga di comando. Se il progetto viene migrato da packages.config a PackageReference, usare invece lo strumento dell'interfaccia della riga di comando di dotnet SDK.

dotnet SDK

Dotnet SDK è lo strumento dell'interfaccia della riga di comando di .NET Core 2.0, che funziona su tutte le piattaforme (Windows, Mac e Linux) e offre funzionalità NuGet di base, ad esempio l'installazione, il ripristino e la pubblicazione di pacchetti. L'interfaccia della riga di comando dotnet offre l'integrazione diretta con i file di progetto .NET Core (ad esempio .csproj), che è utile nella maggior parte degli scenari. Questa interfaccia della riga di comando viene creata direttamente per ogni piattaforma e non richiede l'installazione di Mono.

Installare dotnet SDK

  • Nei computer degli sviluppatori installare .NET Core SDK. In Visual Studio 2017 e versioni successive, l'interfaccia della riga di comando dotnet viene installata automaticamente con qualsiasi carico di lavoro correlato a .NET Core.

  • Per i server di compilazione, seguire le istruzioni per usare .NET Core SDK e gli strumenti nell'integrazione continua.

Per informazioni su come usare i comandi di base con lo strumento dell'interfaccia della riga di comando di dotnet SDK, vedere Installare e gestire pacchetti NuGet con l'interfaccia della riga di comando dotnet.

Interfaccia della riga di comando nuget.exe

L'interfaccia della riga di comando di NuGet, nuget.exe, è l'utilità della riga di comando per Windows che fornisce tutte le funzionalità di NuGet. Questa interfaccia della riga di comando può essere eseguita anche in Mac OSX e Linux usando Mono con alcune limitazioni.

Per informazioni su come usare i comandi di base con lo strumento dell'interfaccia della nuget.exe riga di comando, vedere Gestire pacchetti NuGet con l'interfaccia della riga di comando di nuget.exe.

Installare nuget.exe

Installare sempre la versione più recente dello strumento che supporta la configurazione.

  • È possibile scaricare la versione consigliata più recente all'indirizzo https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
  • Se lo strumento dell'interfaccia della nuget.exe riga di comando è già installato, è possibile aggiornare lo strumento alla versione più recente con il comando nuget update -self.
  • Per la compatibilità con i sistemi di integrazione continua meno recenti, un URL precedente fornisce https://nuget.org/nuget.exe attualmente la versione deprecata 2.8.6 dello strumento dell'interfaccia della riga di comando.

  1. Visitare nuget.org/downloads e scaricare NuGet versione 3.3 o successiva.

    • La versione 5.0 e successive richiede .NET Framework versione 4.7.2 o successiva.
    • La versione 4.1.0 e successive è necessaria per pubblicare i pacchetti in nuget.org.
    • La versione 2.8.6 non è compatibile con Mono.

  2. Ogni download è direttamente il file nuget.exe. Indicare al browser di salvare il file in una cartella di propria scelta. Il file di download non è un programma di installazione, quindi non viene visualizzato nulla se si esegue il file direttamente dal browser.

  3. Per usare lo strumento dell'interfaccia della riga di comando da qualsiasi posizione, aggiungere il percorso della cartella per il nuget.exe file alla variabile di ambiente PATH.

Disponibilità di funzionalità

La tabella seguente confronta le funzionalità disponibili per gli strumenti dotnet e nuget.exe dell'interfaccia della riga di comando per le piattaforme supportate.

Funzionalità Interfaccia della riga di comando dotnet Interfaccia della riga di comando nuget (Windows) Interfaccia della riga di comando nuget (Mono) Visual Studio (Windows) Visual Studio per Mac
Ricerche nei pacchetti ✔ ✔ ✔ ✔ ✔
Installare/disinstallare pacchetti ✔ ✔ (1) ✔ ✔ ✔
Aggiornamento di pacchetti ✔ ✔ ✔ ✔
Ripristinare pacchetti ✔ ✔ ✔ (2) ✔ ✔
Gestire feed di pacchetti (origini) ✔ ✔ ✔ ✔ ✔
Gestire i pacchetti in un feed ✔ ✔ ✔
Impostare le chiavi API per i feed ✔ ✔
Creare pacchetti (3) ✔ ✔ ✔ (4) ✔
Pubblicare pacchetti ✔ ✔ ✔ ✔
Replicare pacchetti ✔ ✔
Gestire le cartelle global-packages e della cache ✔ ✔ ✔
Gestire la configurazione di NuGet ✔ ✔ ✔

Note sulla funzionalità

  • (1) Non influisce sui file di progetto. Usare invece lo strumento dell'interfaccia della riga di comando di dotnet SDK.
  • (2) Funziona solo con il file packages.config e non con file di soluzione (.sln).
  • (3) Varie funzionalità avanzate per i pacchetti sono disponibili solo tramite l'interfaccia della riga di comando, perché non sono rappresentate negli strumenti dell'interfaccia utente di Visual Studio.
  • (4) Funziona con i file .nuspec ma non con i file di progetto.

Funzionalità in arrivo

Se si vogliono visualizzare in anteprima le funzionalità NuGet future, installare un'anteprima di Visual Studio, che funziona side-by-side con le versioni stabili di Visual Studio. Per segnalare problemi o condividere idee per le anteprime, aprire un problema nel repository GitHub di NuGet.

Gli sviluppatori che lavorano su Windows possono anche esplorare Esplora pacchetti NuGet. Questa applicazione è uno strumento autonomo open source che consente di esplorare, creare e modificare pacchetti NuGet visivamente. È utile per molti scenari, ad esempio apportare modifiche sperimentali a una struttura del pacchetto senza ricompilare il pacchetto.