Guida introduttiva: Installare e usare un pacchetto in Visual Studio per Mac

Articolo
08/10/2023

I pacchetti NuGet contengono codice riutilizzabile che altri sviluppatori rendono disponibile per l'uso nei progetti. Vedere Che cos'è NuGet? per le informazioni di base. I pacchetti vengono installati in un progetto di Visual Studio per Mac usando il NuGet Gestione pacchetti. Questo articolo illustra il processo usando il popolare pacchetto Newtonsoft.Json e un progetto console .NET Core. Lo stesso processo si applica a qualsiasi altro progetto Xamarin o .NET Core.

Al termine dell'installazione, fare riferimento al pacchetto nel codice con using <namespace>, dove <spazio dei nomi> è specifico per il pacchetto in uso. Dopo avere creato il riferimento, è possibile chiamare il pacchetto tramite la relativa API.

Suggerimento

Iniziare con nuget.org: l'esplorazione di nuget.org è il modo in cui gli sviluppatori .NET trovano in genere componenti che possono riutilizzare nelle proprie applicazioni. È possibile eseguire una ricerca direttamente in nuget.org o trovare e installare pacchetti all'interno di Visual Studio, come illustrato in questo articolo. Per informazioni generali, vedere Trovare e valutare i pacchetti NuGet.

Prerequisiti

Visual Studio 2019 per Mac.

È possibile installare l'edizione 2019 Community gratuitamente da visualstudio.com o usare le edizioni Professional o Enterprise.

Se si usa Visual Studio in Windows, vedere Installare e usare un pacchetto in Visual Studio (solo Windows).

Creare un progetto

I pacchetti NuGet possono essere installati in qualsiasi progetto .NET, a condizione che il pacchetto supporti lo stesso framework di destinazione del progetto.

Per questa procedura dettagliata, usare una semplice app console .NET Core. Creare un progetto in Visual Studio per Mac usando File > Nuova soluzione... selezionare il modello Applicazione console app .NET Core >>. Fare clic su Avanti. Accettare i valori predefiniti per Framework di destinazione quando richiesto.

Visual Studio crea il progetto, che viene aperto in Esplora soluzioni.

Aggiungere il pacchetto NuGet Newtonsoft.Json

Per installare il pacchetto, usare il NuGet Gestione pacchetti. Quando si installa un pacchetto, NuGet registra la dipendenza nel file di progetto o in un file packages.config, a seconda del formato del progetto. Per altre informazioni, vedere Flusso di lavoro dell'utilizzo di pacchetti.

Gestione pacchetti NuGet

In Esplora soluzioni fare clic con il pulsante destro del mouse su Dipendenze e scegliere Aggiungi pacchetti....
Scegliere "nuget.org" come origine pacchetto nell'angolo superiore sinistro della finestra di dialogo e cercare Newtonsoft.Json, selezionare il pacchetto nell'elenco e selezionare Aggiungi pacchetti...:

Per altre informazioni sulla NuGet Gestione pacchetti, vedere Installare e gestire i pacchetti tramite Visual Studio per Mac.

Usare l'API Newtonsoft.Json nell'app

Con il pacchetto Newtonsoft.Json nel progetto, è possibile chiamare il relativo metodo JsonConvert.SerializeObject per convertire un oggetto in una stringa leggibile.

Aprire il Program.cs file (che si trova nel riquadro della soluzione) e sostituire il contenuto del file con il codice seguente:

using System;
using Newtonsoft.Json;

namespace NuGetDemo
{
    public class Account
    {
        public string Name { get; set; }
        public string Email { get; set; }
        public DateTime DOB { get; set; }
    }

    class Program
    {
        static void Main(string[] args)
        {
            Account account = new Account()
            {
                Name = "Joe Doe",
                Email = "joe@test.com",
                DOB = new DateTime(1976, 3, 24)
            };
            string json = JsonConvert.SerializeObject(account);
            Console.WriteLine(json);
        }
    }
}

Compilare ed eseguire l'app selezionando Esegui > avvia debug:
Una volta eseguita l'app, l'output JSON serializzato verrà visualizzato nella console:

Output of the Console app

Passaggi successivi

È stato installato e usato il primo pacchetto NuGet.

Installare e gestire pacchetti tramite Visual Studio per Mac

Per esplorare in modo più approfondito ciò che NuGet può offrire, selezionare i collegamenti seguenti.