Szybki start: instalowanie i używanie pakietu w programie Visual Studio dla komputerów Mac

NuGet zawierają kod wielokrotnego użytku, który inni deweloperzy udostępnią Ci do użycia w Twoich projektach. Zobacz Co to jest NuGet? w tle. Pakiety są instalowane w projekcie Visual Studio dla komputerów Mac przy użyciu NuGet Menedżer pakietów. W tym artykule pokazano proces korzystający z popularnego pakietu Newtonsoft.Json i projektu konsoli .NET Core. Ten sam proces dotyczy każdego innego projektu platformy Xamarin lub .NET Core.

Po zainstalowaniu odwołaj się do pakietu w kodzie, gdzie przestrzeń nazw jest specyficzna dla using <namespace><> pakietu, którego używasz. Po wywołyniu odwołania możesz wywołać pakiet za pośrednictwem jego interfejsu API.

Porada

Zacznij od nuget.org:przeglądanie nuget.org to sposób, w jaki deweloperzy .NET zwykle znajdują składniki, których mogą używać ponownie we własnych aplikacjach. Możesz wyszukiwać nuget.org lub wyszukiwać i instalować pakiety w Visual Studio jak pokazano w tym artykule. Aby uzyskać ogólne informacje, zobacz Znajdowanie i ocenianie NuGet pakietów.

Wymagania wstępne

  • Visual Studio 2019 dla komputerów Mac.

Wersję 2019 Community można zainstalować bezpłatnie z visualstudio.com lub użyć wersji Professional lub Enterprise.

Jeśli używasz usługi Visual Studio na platformie Windows, zobacz Instalowanie i używanie pakietu w Visual Studio (tylko Windows).

Tworzenie projektu

NuGet można zainstalować w dowolnym projekcie .NET, pod warunkiem, że pakiet obsługuje tę samą platformę docelową co projekt.

W tym przewodniku użyj prostej aplikacji konsolowej .NET Core. Utwórz projekt w programie Visual Studio dla komputerów Mac przy użyciu nowego rozwiązania..., wybierz szablon Aplikacja > konsolowa aplikacji .NET Core. Kliknij przycisk Dalej. Po wyświetleniu monitu zaakceptuj wartości domyślne dla struktury docelowej.

Visual Studio projekt, który zostanie otwarty w Eksplorator rozwiązań.

Dodawanie pakietu NuGet Newtonsoft.Json

Aby zainstalować pakiet, należy użyć NuGet Menedżer pakietów. Podczas instalowania pakietu program NuGet zależność w pliku projektu lub pliku (w zależności packages.config od formatu projektu). Aby uzyskać więcej informacji, zobacz Omówienie użycia pakietów i przepływ pracy.

Menedżer pakietów NuGet

  1. W Eksplorator rozwiązań prawym przyciskiem myszy pozycję Zależności i wybierz polecenie Dodaj pakiety.

    Polecenie Manage NuGet Packages for project References (Zarządzanie pakietami NuGet pakietów dla odwołań do projektu)

  2. Wybierz pozycję "nuget.org" jako źródło pakietu w lewym górnym rogu okna dialogowego, a następnie wyszukaj pozycję Newtonsoft.Json,wybierz ten pakiet na liście i wybierz pozycję Dodaj pakiety...:

    Lokalizowanie pakietu Newtonsoft.Json

    Aby uzyskać więcej informacji na temat usługi NuGet Menedżer pakietów, zobacz Instalowanie pakietów i zarządzanie nimi przy użyciu Visual Studio dla komputerów Mac.

Korzystanie z interfejsu API Newtonsoft.Json w aplikacji

Pakiet Newtonsoft.Json w projekcie umożliwia wywołanie jego metody w celu przekonwertowania obiektu na ciąg JsonConvert.SerializeObject czytelny dla człowieka.

  1. Otwórz plik (znajdujący się w okienko rozwiązania) i zastąp Program.cs zawartość pliku następującym kodem:

    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);
            }
        }
    }
    
  2. Skompilować i uruchomić aplikację, wybierając pozycję Uruchom rozpocznij debugowanie:

  3. Po zakończeniu aplikacji w konsoli zostaną wyświetlone serializowane dane wyjściowe JSON:

Dane wyjściowe aplikacji konsoli

Następne kroki

Gratulujemy zainstalowania i użycia pierwszego NuGet pakietu!

Aby dowiedzieć się więcej NuGet, wybierz poniższe linki.