Installare e gestire i pacchetti NuGet in Visual Studio per MacInstall and manage NuGet packages in Visual Studio for Mac

L'interfaccia utente di gestione pacchetti NuGet in Visual Studio per Mac consente di installare, disinstallare e aggiornare facilmente i pacchetti NuGet in progetti e soluzioni.The NuGet Package Manager UI in Visual Studio for Mac allows you to easily install, uninstall, and update NuGet packages in projects and solutions. È possibile cercare e aggiungere pacchetti ai progetti .NET Core, ASP.NET Core e Novell.You can search for and add packages to your .NET Core, ASP.NET Core, and Xamarin projects.

Questo articolo descrive come includere un pacchetto NuGet in un progetto e illustra la catena di strumenti che rende facile il processo.This article describes how to include a NuGet package in a project and demonstrates the tool chain that makes the process seamless.

Per un'introduzione all'uso di NuGet in Visual Studio per Mac, vedere Guida introduttiva: Installare e usare un pacchetto in Visual Studio per MacFor an intro to using NuGet in Visual Studio for Mac, see Quickstart: Install and use a package in Visual Studio for Mac

Trovare e installare un pacchettoFind and Install a Package

  1. Con un progetto aperto in Visual Studio per Mac, fare clic con il pulsante destro del mouse sulla cartella dipendenze (cartellapacchetti se si usa un progetto Novell) nel riquadro della soluzione e selezionare Gestisci pacchetti NuGet... .With a project open in Visual Studio for Mac, right-click on the Dependencies folder (Packages folder if using a Xamarin project) in the Solution Pad and select Manage NuGet Packages....

    Azione di contesto di aggiunta di un nuovo pacchetto NuGet

  2. Verrà avviata la finestra Gestisci pacchetti NuGet .This launches the Manage NuGet Packages window. Verificare che l'elenco a discesa di origine nell'angolo superiore sinistro della finestra di dialogo sia impostato nuget.orgsu.Ensure that the Source drop-down in the top left corner of the dialog is set to nuget.org.

    Elenco di pacchetti NuGet

  3. Usare la casella di ricerca nell'angolo superiore destro per trovare un pacchetto specifico, ad esempio EntityFramework.Use the search box in the top-right corner to find a specific package, for example EntityFramework. Dopo aver trovato un pacchetto da usare, selezionarlo e fare clic sul pulsante Aggiungi pacchetto per avviare l'installazione.When you have found a package that you wish to use, select it and click the Add Package button to begin installation.

    Aggiungere il pacchetto NuGet EntityFramework

  4. Dopo essere stato scaricato, il pacchetto verrà aggiunto al progetto.Once the package has been downloaded, it will be added to your project. La soluzione cambierà a seconda del tipo di progetto che si sta modificando:The solution will change depending on the type of project you're editing:

    Progetti NovellXamarin Projects

    • Il nodo Riferimenti conterrà un elenco di tutti gli assembly che fanno parte di un pacchetto NuGet.The References node will contain a list of all the assemblies that are part of a NuGet package.
    • Il nodo Pacchetti mostra ogni pacchetto NuGet scaricato.The Packages node displays each NuGet package that you have downloaded. È possibile aggiornare o rimuovere un pacchetto dall'elenco.You can update or remove a package from this list.

    Progetti .NET Core.NET Core Projects

    • Il nodo dipendenze > NuGet Visualizza ogni pacchetto NuGet scaricato.The Dependencies > NuGet node displays each NuGet package that you have downloaded. È possibile aggiornare o rimuovere un pacchetto dall'elenco.You can update or remove a package from this list.

Uso di pacchetti NuGetUsing NuGet Packages

Dopo che il pacchetto NuGet è stato aggiunto e i riferimenti del progetto sono stati aggiornati, è possibile programmare usando le API come si farebbe con qualsiasi riferimento del progetto.Once the NuGet package has been added and the project references updated, you can program against the APIs as you would with any project reference.

Assicurarsi di aggiungere le direttive using necessarie all'inizio del file:Ensure that you add any required using directives to the top of your file:

using Newtonsoft.Json;

Aggiornamento di pacchettiUpdating Packages

Gli aggiornamenti dei pacchetti possono essere eseguiti contemporaneamente, facendo clic con il pulsante destro del mouse sul nodo dipendenze (nodopacchetti per progetti Novell) o singolarmente in ogni pacchetto.Package updates can be done either all at once, by right-clicking on the Dependencies node (Packages node for Xamarin projects), or individually on each package. Quando è disponibile una nuova versione di un pacchetto NuGet, viene visualizzata un'icona di aggiornamento con il cerchio.When a new version of a NuGet package is available, an update icon appears Up arrow with circle.

Fare clic con il pulsante destro del mouse su dipendenze per accedere al menu di scelta rapida e scegliere Aggiorna per aggiornare tutti i pacchetti:Right-click on Dependencies to access the context menu and choose Update to update all packages:

Menu Pacchetti

  • Gestisci pacchetti NuGet : apre la finestra per aggiungere altri pacchetti al progetto.Manage NuGet Packages - Opens the window to add more packages to the project.
  • Aggiorna - Controlla il server di origine per ogni pacchetto e scarica le eventuali versioni più recenti.Update - Checks the source server for each package and downloads any newer versions.
  • Ripristina - Scarica tutti i pacchetti mancanti (senza aggiornare i pacchetti esistenti alle versioni più recenti).Restore - Downloads any missing packages (without updating existing packages to newer versions).

Le opzioni Aggiorna e Ripristina sono disponibili anche a livello di soluzione e influiscono su tutti i progetti nella soluzione.Update and Restore options are also available at the Solution level, and affect all the projects in the solution.

Dal riquadro della soluzione è possibile visualizzare la versione di un pacchetto attualmente installata e fare clic con il pulsante destro del mouse sul pacchetto da aggiornare.From the solution pad, you can view what version of a package is currently installed and right-click on the package to update.

Menu pacchetti con le opzioni per aggiornare, rimuovere, aggiornare

Verrà visualizzata anche una notifica accanto al nome del pacchetto quando sarà disponibile una nuova versione di un pacchetto, quindi è possibile decidere se è necessario aggiornarla.You will also see a notification next to the package name when a new version of a package is available, so you can decide if you may want to update it.

Notifica visualizzata quando è disponibile una nuova versione del pacchetto

Nel menu visualizzato sono disponibili due opzioni:In the menu shown, you have two options:

  • Aggiorna - Controlla il server di origine e scarica una versione più recente, se disponibile.Update - Checks the source server and downloads a newer version (if it exists).
  • Rimuovi - Rimuove il pacchetto dal progetto e gli assembly correlati dai riferimenti del progetto.Remove - Removes the package from this project and removes the relevant assemblies from the project's References.

Aggiunta di origini dei pacchettiAdding Package Sources

I pacchetti disponibili per l'installazione vengono recuperati inizialmente da nuget.org. È tuttavia possibile aggiungere in Visual Studio per Mac altri percorsi dei pacchetti.Packages available for installation are initially retrieved from nuget.org. However, you can add other package locations to Visual Studio for Mac. Ciò può essere utile per testare i pacchetti NuGet in fase di sviluppo oppure per usare un server NuGet privato all'interno dell'azienda o dell'organizzazione.This can be useful for testing your own NuGet packages under development, or to use a private NuGet server inside your company or organization.

In Visual Studio per Mac passare a Visual Studio > Preferenze > NuGet > Origini per visualizzare e modificare l'elenco di origini dei pacchetti.In Visual Studio for Mac, navigate to Visual Studio > Preferences > NuGet > Sources to view and edit the list of package sources. Si noti che le origini possono essere un server remoto (specificato da un URL) o una directory locale.Note that sources can be a remote server (specified by a URL) or a local directory.

Origini dei pacchetti

Fare clic su Aggiungi per configurare una nuova origine.Click Add to set-up a new source. Immettere un nome descrittivo e l'URL (o il percorso file) dell'origine del pacchetto.Enter a friendly name and the URL (or file path) to the package source. Se l'origine è un server Web sicuro, immettere nome utente e password, in caso contrario lasciare vuote queste voci:If the source is a secure web server, enter the username and password as well, otherwise leave these entries blank:

Aggiungere origini dei pacchetti

Quando si cercano i pacchetti è quindi possibile selezionare origini diverse:Different sources can then be selected when searching for packages:

Aggiungere origini dei pacchetti

Controllo della versioneVersion Control

La documentazione di NuGet illustra come usare NuGet senza eseguire il commit di pacchetti nel controllo del codice sorgente.The NuGet documentation discusses using NuGet without committing packages to source control. Se si preferisce non archiviare i file binari e le informazioni non usate nel controllo del codice sorgente, è possibile configurare Visual Studio per Mac per il ripristino automatico dei pacchetti dal server.If you prefer not to store binaries and unused information in source control, you can configure Visual Studio for Mac to automatically restore packages from the server. Ciò significa che quando uno sviluppatore recupera il progetto dal controllo del codice sorgente per la prima volta, Visual Studio per Mac scarica e installa automaticamente i pacchetti richiesti.This means that when a developer retrieves the project from source control for the first time, Visual Studio for Mac will automatically download and install the required packages.

Ripristino automatico dei pacchetti

Vedere la documentazione relativa al controllo del codice sorgente specifico per informazioni dettagliate su come escludere la directory packages dal controllo.Refer to your particular source control documentation for details on how to exclude the packages directory from being tracked.

Vedere ancheSee also