Installare e gestire i pacchetti in Visual Studio con Gestione pacchetti NuGetInstall and manage packages in Visual Studio using the NuGet Package Manager

L'interfaccia utente di Gestione pacchetti NuGet in Visual Studio in Windows consente di installare, disinstallare e aggiornare facilmente i pacchetti NuGet in progetti e soluzioni.The NuGet Package Manager UI in Visual Studio on Windows allows you to easily install, uninstall, and update NuGet packages in projects and solutions. Per l'esperienza in Visual Studio per Mac, vedere Inserimento di un pacchetto NuGet nel progetto.For the experience in Visual Studio for Mac, see Including a NuGet package in your project. L'interfaccia utente di Gestione pacchetti non è inclusa in Visual Studio Code.The Package Manager UI is not included with Visual Studio Code.

Nota

Se non si trova Gestione pacchetti NuGet in Visual Studio 2015, selezionare Strumenti > Estensioni e aggiornamenti e cercare l'estensione Gestione pacchetti NuGet.If you're missing the NuGet Package Manager in Visual Studio 2015, check Tools > Extensions and Updates... and search for the NuGet Package Manager extension. Se non si è in grado di usare il programma di installazione delle estensioni in Visual Studio, scaricare l'estensione direttamente da https://dist.nuget.org/index.html.If you're unable to use the extensions installer in Visual Studio, download the extension directly from https://dist.nuget.org/index.html.

A partire da Visual Studio 2017, NuGet e Gestione pacchetti NuGet vengono installati automaticamente con qualsiasi carico di lavoro correlato a NET.Starting in Visual Studio 2017, NuGet and the NuGet Package Manager are automatically installed with any .NET-related workloads. Per installarli singolarmente, selezionare Singoli componenti > Strumenti per il codice > Gestione pacchetti NuGet nel programma di installazione di Visual Studio.Install it individually by selecting the Individual components > Code tools > NuGet package manager option in the Visual Studio installer.

Trovare e installare un pacchettoFind and install a package

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti o su un progetto e scegliere Gestisci pacchetti NuGet.In Solution Explorer, right-click either References or a project and select Manage NuGet Packages....

    Opzione di menu Gestisci pacchetti NuGet

  2. La scheda Sfoglia visualizza i pacchetti in base alla popolarità dall'origine attualmente selezionata (vedere Origini dei pacchetti).The Browse tab displays packages by popularity from the currently selected source (see package sources). Cercare un pacchetto specifico usando la casella di ricerca in alto a sinistra.Search for a specific package using the search box on the upper left. Selezionare un pacchetto nell'elenco per visualizzarne le informazioni. In questo modo viene anche abilitato il pulsante Installa insieme a un elenco a discesa per la selezione della versione.Select a package from the list to display its information, which also enables the Install button along with a version-selection drop-down.

    Finestra di dialogo Gestisci pacchetti NuGet, scheda Sfoglia

  3. Selezionare la versione desiderata nell'elenco a discesa e selezionare Installa.Select the desired version from the drop-down and select Install. Visual Studio installa il pacchetto e le relative dipendenze nel progetto.Visual Studio installs the package and its dependencies into the project. Potrebbe essere richiesto di accettare le condizioni di licenza.You may be asked to accept license terms. Al termine dell'installazione, i pacchetti aggiunti verranno visualizzati nella scheda Installati. I pacchetti sono elencati anche nel nodo Riferimenti di Esplora soluzioni, a indicare che è possibile farvi riferimento nel progetto con istruzioni using.When installation is complete, the added packages appear on the Installed tab. Packages are also listed in the References node of Solution Explorer, indicating that you can refer to them in the project with using statements.

    Riferimenti in Esplora soluzioni

Suggerimento

Per includere le versioni preliminari nella ricerca e per rendere disponibili le versioni preliminari nell'elenco a discesa delle versioni, selezionare l'opzione Includi versione preliminare.To include prerelease versions in the search, and to make prerelease versions available in the version drop-down, select the Include prerelease option.

Disinstalla un pacchettoUninstall a package

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti o sul progetto desiderato e scegliere Gestisci pacchetti NuGet.In Solution Explorer, right-click either References or the desired project, and select Manage NuGet Packages....

  2. Selezionare la scheda Installati.Select the Installed tab.

  3. Selezionare il pacchetto da disinstallare (usando la ricerca per filtrare l'elenco, se necessario) e selezionare Disinstalla.Select the package to uninstall (using search to filter the list if necessary) and select Uninstall.

    Disinstallazione di un pacchetto

  4. Si noti che i controlli Includi versione preliminare e Origine pacchetto non hanno effetto quando si disinstallano i pacchetti.Note that the Include prerelease and Package source controls have no effect when uninstalling packages.

Aggiornare un pacchettoUpdate a package

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti o sul progetto desiderato e scegliere Gestisci pacchetti NuGet. (Nei progetti per siti Web fare clic con il pulsante destro del mouse sulla cartella Bin.)In Solution Explorer, right-click either References or the desired project, and select Manage NuGet Packages.... (In web site projects, right-click the Bin folder.)

  2. Selezionare la scheda Aggiornamenti per visualizzare i pacchetti con aggiornamenti disponibili dalle origini dei pacchetti selezionate.Select the Updates tab to see packages that have available updates from the selected package sources. Selezionare Includi versione preliminare per includere i pacchetti di versioni preliminari nell'elenco degli aggiornamenti.Select Include prerelease to include prerelease packages in the update list.

  3. Selezionare il pacchetto da aggiornare, selezionare la versione desiderata nell'elenco a discesa a destra e selezionare Aggiorna.Select the package to update, select the desired version from the drop-down on the right, and select Update.

    Aggiornamento di un pacchetto

  4. Per alcuni pacchetti, il pulsante Aggiorna è disabilitato e viene visualizzato un messaggio che informa che "Un SDK vi fa riferimento in modo implicito" (o "con riferimento automatico").For some packages, the Update button is disabled and a message appears saying that it's "Implicitly referenced by an SDK" (or "AutoReferenced"). Questo messaggio indica che il pacchetto fa parte di un framework o di un SDK più ampio e non deve essere aggiornato in modo indipendente.This message indicates that the package is part of a larger framework or SDK and should not be updated independently. (Questi pacchetti sono contrassegnati internamente con <IsImplicitlyDefined>True</IsImplicitlyDefined>.) Ad esempio, Microsoft.NETCore.App fa parte di .NET Core SDK e la versione del pacchetto non corrisponde alla versione del framework di runtime usato dall'applicazione.(Such packages are internally marked with <IsImplicitlyDefined>True</IsImplicitlyDefined>.) For example, Microsoft.NETCore.App is part of the .NET Core SDK, and the package version is not the same as the version of the runtime framework used by the application. È necessario aggiornare l'installazione di .NET Core per ottenere le nuove versioni del runtime di ASP.NET Core e .NET Core.You need to update your .NET Core installation to get new versions of the ASP.NET Core and .NET Core runtime. Per informazioni dettagliate sui metapacchetti e sul controllo delle versioni di .NET Core, vedere questo documento.See this document for more details on .NET Core metapackages and versioning. Si applica ai seguenti pacchetti di uso comune:This applies to the following commonly used packages:

    • Microsoft.AspNetCore.AllMicrosoft.AspNetCore.All
    • Microsoft.AspNetCore.AppMicrosoft.AspNetCore.App
    • Microsoft.NETCore.AppMicrosoft.NETCore.App
    • NETStandard.LibraryNETStandard.Library

    Pacchetto di esempio contrassegnato come con riferimento implicito o riferimento automatico

  5. Per aggiornare più pacchetti alle versioni più recenti, selezionarli nell'elenco e selezionare il pulsante Aggiorna sopra l'elenco.To update multiple packages to their newest versions, select them in the list and select the Update button above the list.

  6. È anche possibile aggiornare un singolo pacchetto dalla scheda Installati. In questo caso, i dettagli per il pacchetto includono un selettore di versione (soggetto all'opzione Includi versione preliminare) e un pulsante Aggiorna.You can also update an individual package from the Installed tab. In this case, the details for the package include a version selector (subject to the Include prerelease option) and an Update button.

Gestisci i pacchetti per la soluzioneManage packages for the solution

La gestione dei pacchetti per una soluzione è un metodo pratico per utilizzare più progetti contemporaneamente.Managing packages for a solution is a convenient means to work with multiple projects simultaneously.

  1. Scegliere Strumenti > Gestione pacchetti NuGet > Gestisci pacchetti NuGet per la soluzione oppure fare clic con il pulsante destro del mouse sulla soluzione e scegliere Gestisci pacchetti NuGet:Select the Tools > NuGet Package Manager > Manage NuGet Packages for Solution... menu command, or right-click the solution and select Manage NuGet Packages...:

    Gestisci pacchetti NuGet per la soluzione

  2. Quando si gestiscono i pacchetti per la soluzione, l'interfaccia utente consente di selezionare i progetti interessati dalle operazioni:When managing packages for the solution, the UI lets you select the projects that are affected by the operations:

    Selettore di progetto durante la gestione dei pacchetti per la soluzione

Scheda ConsolidaConsolidate tab

Gli sviluppatori in genere considerano una procedura non corretta l'uso di versioni diverse dello stesso pacchetto NuGet in progetti diversi nella stessa soluzione.Developers typically consider it bad practice to use different versions of the same NuGet package across different projects in the same solution. Quando si sceglie di gestire i pacchetti per una soluzione, l'interfaccia utente di Gestione pacchetti include una scheda Consolida in cui è possibile visualizzare facilmente i pacchetti con numeri di versione distinti usati da progetti diversi nella soluzione:When you choose to manage packages for a solution, the Package Manager UI provides a Consolidate tab on which you can easily see where packages with distinct version numbers are used by different projects in the solution:

Scheda Consolida dell'interfaccia utente di Gestione pacchetti

In questo esempio, il progetto ClassLibrary1 usa EntityFramework 6.2.0, mentre ConsoleApp1 usa EntityFramework 6.1.0.In this example, the ClassLibrary1 project is using EntityFramework 6.2.0, whereas ConsoleApp1 is using EntityFramework 6.1.0. Per consolidare le versioni dei pacchetti, seguire questa procedura:To consolidate package versions, do the following:

  • Selezionare i progetti da aggiornare nell'elenco dei progetti.Select the projects to update in the project list.
  • Selezionare la versione da usare in tutti i progetti nel controllo Versione, ad esempio EntityFramework 6.2.0.Select the version to use in all those projects in the Version control, such as EntityFramework 6.2.0.
  • Selezionare il pulsante Installa.Select the Install button.

Gestione pacchetti installa la versione del pacchetto selezionata in tutti i progetti selezionati e in seguito il pacchetto non compare più nella scheda Consolida.The Package Manager installs the selected package version into all selected projects, after which the package no longer appears on the Consolidate tab.

Origini dei pacchettiPackage sources

Per modificare l'origine da cui Visual Studio ottiene i pacchetti, selezionarne una nel selettore delle origini:To change the source from which Visual Studio obtains packages, select one from the source selector:

Selettore delle origini dei pacchetti nell'interfaccia utente di Gestione pacchetti

Per gestire le origini dei pacchetti:To manage package sources:

  1. Selezionare l'icona Impostazioni nell'interfaccia utente di Gestione pacchetti illustrata di seguito oppure usare il comando Strumenti > Opzioni e scorrere fino a Gestione pacchetti NuGet:Select the Settings icon in the Package Manager UI outlined below or use the Tools > Options command and scroll to NuGet Package Manager:

    Icona delle impostazioni dell'interfaccia utente di Gestione pacchetti

  2. Selezionare il nodo Origini pacchetti:Select the Package Sources node:

    Opzioni per le origini dei pacchetti

  3. Per aggiungere un'origine, selezionare + , modificare il nome, immettere l'URL o il percorso nel controllo Origine e selezionare Aggiorna.To add a source, select +, edit the name, enter the URL or path in the Source control, and select Update. L'origine viene ora visualizzata nell'elenco a discesa del selettore.The source now appears in the selector drop-down.

  4. Per modificare un'origine di pacchetti, selezionarla, apportare modifiche nelle caselle Nome e Origine e selezionare Aggiorna.To change a package source, select it, make edits in the Name and Source boxes, and select Update.

  5. Per disabilitare un'origine di pacchetti, deselezionare la casella a sinistra del nome nell'elenco.To disable a package source, clear the box to the left of the name in the list.

  6. Per rimuovere un'origine di pacchetti, selezionarla e quindi selezionare il pulsante X.To remove a package source, select it and then select the X button.

  7. L'uso dei pulsanti freccia su e giù non cambia l'ordine di priorità delle origini dei pacchetti.Using the up and down arrow buttons does not change the priority order of the package sources. Visual Studio ignora l'ordine delle origini dei pacchetti e usa il pacchetto da qualsiasi origine risponde per prima alle richieste.Visual Studio ignores the order of package sources, using the package from whichever source is first to respond to requests. Per altre informazioni, vedere Ripristino di pacchetti.For more information, see Package restore.

Suggerimento

Se un'origine di pacchetti viene visualizzata nuovamente dopo l'eliminazione, potrebbe essere elencata in un file NuGet.Config a livello di computer o di utente.If a package source reappears after deleting it, it may be listed in a computer-level or user-level NuGet.Config files. Vedere Configurazioni NuGet comuni per il percorso di questi file, quindi rimuovere l'origine modificando manualmente i file o usando il comando nuget sources.See Common NuGet configurations for the location of these files, then remove the source by editing the files manually or using the nuget sources command.

Controllo Opzioni di Gestione pacchettiPackage manager Options control

Quando si seleziona un pacchetto, l'interfaccia utente di Gestione pacchetti visualizza un piccolo controllo Opzioni espandibile sotto il selettore della versione (visualizzato nella figura sia compresso che espanso).When a package is selected, the Package Manager UI displays a small, expandable Options control below the version selector (shown here both collapsed and expanded). Si noti che per alcuni tipi di progetto viene visualizzata solo l'opzione Visualizza finestra di anteprima.Note that for some project types, only the Show preview window option is provided.

Opzioni di Gestione pacchetti

Nelle sezioni seguenti vengono illustrate queste opzioni.The following sections explain these options.

Visualizza finestra di anteprimaShow preview window

Quando questa opzione è selezionata, una finestra modale visualizza le dipendenze di un pacchetto scelto prima dell'installazione del pacchetto:When selected, a modal window displays which the dependencies of a chosen package before the package is installed:

Finestra di dialogo di anteprima di esempio

Opzioni di installazione e aggiornamentoInstall and Update Options

(Non disponibile per tutti i tipi di progetto.)(Not available for all project types.)

Comportamento dipendenza configura il modo in cui NuGet decide quali versioni dei pacchetti dipendenti installare:Dependency behavior configures how NuGet decides which versions of dependent packages to install:

  • Ignora dipendenze ignora l'installazione di eventuali dipendenze, che in genere può causare problemi di funzionamento per il pacchetto da installare.Ignore dependencies skips installing any dependencies, which typically breaks the package being installed.
  • Più bassa [impostazione predefinita] installa la dipendenza con il numero di versione minimo che soddisfa i requisiti del pacchetto scelto primario.Lowest [Default] installs the dependency with the minimal version number that meets the requirements of the primary chosen package.
  • Patch più alta installa la versione con gli stessi numeri di versione principale e secondaria, ma con il numero di patch più alto.Highest Patch installs the version with the same major and minor version numbers, but the highest patch number. Ad esempio, se viene specificata la versione 1.2.2, verrà installata la versione più recente che inizia con 1.2For example, if version 1.2.2 is specified then the highest version that starts with 1.2 will be installed
  • Minore più alta installa la versione con lo stesso numero di versione principale, ma con il numero di versione secondaria e il numero di patch più alti.Highest Minor installs the version with the same major version number but the highest minor number and patch number. Se si specifica la versione 1.2.2 verrà installata la versione più recente che inizia con 1If version 1.2.2 is specified, then the highest version that starts with 1 will be installed
  • Più alta installa la versione più alta disponibile del pacchetto.Highest installs the highest available version of the package.

Azione conflitto file specifica il modo in cui NuGet deve gestire i pacchetti già esistenti nel progetto o nel computer locale:File conflict action specifies how NuGet should handle packages that already exist in the project or local machine:

  • Chiedi conferma indica a NuGet di richiedere se si vogliono mantenere o sovrascrivere i pacchetti esistenti.Prompt instructs NuGet to ask whether to keep or overwrite existing packages.
  • Ignora tutto indica a NuGet di non sovrascrivere eventuali pacchetti esistenti.Ignore All instructs NuGet to skip overwriting any existing packages.
  • Sovrascrivi tutto indica a NuGet di sovrascrivere eventuali pacchetti esistenti.Overwrite All instructs NuGet to overwrite any existing packages.

Opzioni di disinstallazioneUninstall Options

(Non disponibile per tutti i tipi di progetto.)(Not available for all project types.)

Rimuovi dipendenze: quando si seleziona questa opzione, eventuali pacchetti dipendenti vengono rimossi se non esistono riferimenti altrove nel progetto.Remove dependencies: when selected, removes any dependent packages if they're not referenced elsewhere in the project.

Forza la disinstallazione anche se sono presenti dipendenze: quando si seleziona questa opzione, un pacchetto viene disinstallato anche se sono ancora presenti riferimenti nel progetto.Force uninstall even if there are dependencies on it: when selected, uninstalls a package even if it's still being referenced in the project. Questa opzione viene in genere usata in combinazione con Rimuovi dipendenze per rimuovere un pacchetto e tutte le eventuali dipendenze installate.This is typically used in combination with Remove dependencies to remove a package and whatever dependencies it installed. L'uso di questa opzione può, tuttavia, causare riferimenti interrotti nel progetto.Using this option may, however, lead to broken references in the project. In questi casi, potrebbe essere necessario reinstallare gli altri pacchetti.In such cases, you may need to reinstall those other packages.