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

NuGet pakiety zawierają kod wielokrotnego użytku, który inni deweloperzy udostępniają do użytku w 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 przedstawiono proces korzystający z popularnego pakietu Newtonsoft.Json i projektu konsoli platformy .NET Core. Ten sam proces dotyczy dowolnego innego projektu platformy Xamarin lub platformy .NET Core.

Po zainstalowaniu zapoznaj się z pakietem w kodzie, using <namespace> w którym <przestrzeń nazw> jest specyficzna dla używanego pakietu. Po utworzeniu odwołania można wywołać pakiet za pośrednictwem interfejsu API.

Porada

Zacznij od nuget.org: przeglądanie nuget.org polega na tym, jak deweloperzy platformy .NET zazwyczaj znajdują składniki, których mogą używać ponownie we własnych aplikacjach. Możesz wyszukać nuget.org bezpośrednio lub znaleźć i zainstalować pakiety w Visual Studio, jak pokazano w tym artykule. Aby uzyskać ogólne informacje, zobacz Znajdowanie i ocenianie pakietów NuGet.

Wymagania wstępne

  • Visual Studio 2019 dla komputerów Mac.

Możesz bezpłatnie zainstalować wersję Community 2019 visualstudio.com lub korzystać z wersji Professional lub Enterprise.

Jeśli używasz Visual Studio w Windows, zobacz Instalowanie i używanie pakietu w programie Visual Studio (tylko Windows).

Tworzenie projektu

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

W tym przewodniku użyj prostej aplikacji konsolowej platformy .NET Core. Utwórz projekt w Visual Studio dla komputerów Mac przy użyciu polecenia Plik > nowe rozwiązanie..., wybierz szablon Aplikacji konsoli aplikacji > .NET Core>. Kliknij przycisk Dalej. Po wyświetleniu monitu zaakceptuj wartości domyślne dla platformy Target Framework .

Visual Studio tworzy 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 NuGet rejestruje zależność w pliku projektu lub packages.config pliku (w zależności 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ń kliknij prawym przyciskiem myszy pozycję Zależności i wybierz polecenie Dodaj pakiety....

    Manage NuGet Packages command for project References

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

    Locating Newtonsoft.Json package

    Aby uzyskać więcej informacji na temat 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 metody JsonConvert.SerializeObject w celu przekonwertowania obiektu na ciąg czytelny dla człowieka.

  1. Program.cs Otwórz plik (znajdujący się w okienko rozwiązania) i zastąp 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. Skompiluj i uruchom aplikację, wybierając pozycję Uruchom > debugowanie:

  3. Po uruchomieniu aplikacji zobaczysz serializowane dane wyjściowe JSON w konsoli:

Output of the Console app

Następne kroki

Gratulujemy instalowania i używania pierwszego pakietu NuGet!

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