Instalowanie pakietów NuGet i zarządzanie nimi w programie Visual Studio dla komputerów Mac

Dotyczy:yes Visual Studio dla komputerów Mac noVisual Studio

Interfejs użytkownika menedżera pakietów NuGet w programie Visual Studio dla komputerów Mac umożliwia łatwe instalowanie, odinstalowywanie i aktualizowanie pakietów NuGet w projektach i rozwiązaniach. Możesz wyszukiwać i dodawać pakiety do projektów platformy .NET Core, ASP.NET Core i Xamarin.

W tym artykule opisano sposób dołączania pakietu NuGet do projektu i przedstawiono łańcuch narzędzi, który sprawia, że proces jest bezproblemowy.

Aby zapoznać się z wprowadzeniem do korzystania z narzędzia NuGet w programie Visual Studio dla komputerów Mac, zobacz Szybki start: instalowanie i używanie pakietu w programie Visual Studio dla komputerów Mac

Znajdowanie i instalowanie pakietu

  1. Po otwarciu projektu w programie Visual Studio dla komputerów Mac kliknij prawym przyciskiem myszy folder Dependencies (Pakiety , jeśli korzystasz z projektu Xamarin) w oknie rozwiązania , a następnie wybierz polecenie Zarządzaj pakietami NuGet....

    This screenshot is of Add new NuGet package context action.

  2. Zostanie wyświetlone okno dialogowe Zarządzanie pakietami NuGet . Upewnij się, że lista rozwijana Źródło pakietu w lewym dolnym rogu okna dialogowego jest ustawiona na nuget.org, aby przeszukiwać centralne repozytorium pakietów NuGet.

    This screenshot is of Manage NuGet Packages dialog - List NuGet Packages. The Package source option is set to nuget.org.

  3. Użyj pola Wyszukiwania w prawym górnym rogu, aby znaleźć określony pakiet, na przykład EntityFramework. Po znalezieniu pakietu, którego chcesz użyć, wybierz go i wybierz przycisk Dodaj pakiet , aby rozpocząć instalację.

    This screenshot is of add EntityFramework NuGet Package.

  4. Po pobraniu pakietu zostanie on dodany do projektu. Rozwiązanie zmieni się w zależności od typu edytowanego projektu:

    Projekty platformy Xamarin

    • Węzeł Odwołania będzie zawierać listę wszystkich zestawów, które są częścią pakietu NuGet.
    • W węźle Pakiety zostanie wyświetlony każdy pobrany pakiet NuGet. Możesz zaktualizować lub usunąć pakiet z tej listy.

    Projekty platformy .NET Core

    • Węzeł NuGet zależności > wyświetla każdy pobrany pakiet NuGet. Możesz zaktualizować lub usunąć pakiet z tej listy.

Korzystanie z pakietów NuGet

Po dodaniu pakietu NuGet i zaktualizowaniu odwołań do projektu można programować względem interfejsów API tak, jak w przypadku dowolnego odwołania do projektu.

Upewnij się, że dodano wszystkie wymagane using dyrektywy na początku pliku:

using Newtonsoft.Json;

Aktualizowanie pakietów

Aktualizacje pakietów można wykonywać jednocześnie, klikając prawym przyciskiem myszy węzeł Zależności (węzeł Pakiety dla projektów platformy Xamarin) lub indywidualnie w każdym pakiecie. Gdy jest dostępna nowa wersja pakietu NuGet, zostanie wyświetlona This is the update icon for updating a new version of NUGet package - Up arrow with circle.ikona aktualizacji .

Kliknij prawym przyciskiem myszy pozycję Zależności , aby uzyskać dostęp do menu kontekstowego, a następnie wybierz polecenie Aktualizuj , aby zaktualizować wszystkie pakiety:

This screenshot shows the Dependencies context menu with the Update menu highlighted.

  • Zarządzanie pakietami NuGet — otwiera okno, aby dodać więcej pakietów do projektu.
  • Update — sprawdza serwer źródłowy dla każdego pakietu i pobiera wszystkie nowsze wersje.
  • Przywracanie — pobiera wszystkie brakujące pakiety (bez aktualizowania istniejących pakietów do nowszych wersji).

Opcje aktualizacji i przywracania są również dostępne na poziomie rozwiązania i mają wpływ na wszystkie projekty w rozwiązaniu.

Aktualizowanie do wersji wstępnej pakietów

Aby przeprowadzić aktualizację do nowszej wersji wstępnej pakietu, możesz kliknąć prawym przyciskiem myszy pozycję Zależności , aby otworzyć menu kontekstowe i wybrać menu Zarządzaj pakietami NuGet... .

This screenshot shows Dependencies context menu with Manage NuGet Packages... menu highlighted.

Zaznacz pole wyboru Uwzględnij wersje wstępne w dolnej części okna dialogowego.

This screenshot shows Manage NuGet Packages dialog opened with the 'Include prereleases option checked.

Na koniec na karcie Aktualizacje okna dialogowego wybierz pakiet, który chcesz zaktualizować, a następnie wybierz nową wersję wstępną z listy rozwijanej Nowa wersja , a następnie wybierz pozycję Pakiet aktualizacji.

This screenshot shows Manage NuGet Packages dialog opened to the Installed tab, with a package selected and the New Version dropdown list open.

Lokalizowanie nieaktualnych pakietów

W oknie rozwiązania możesz wyświetlić, jaka wersja pakietu jest obecnie zainstalowana. Kliknij prawym przyciskiem myszy pakiet, aby go zaktualizować.

This screenshot shows Packages menu with the options to Update, Remove, Refresh.

Zobaczysz również powiadomienie obok nazwy pakietu, gdy jest dostępna nowa wersja pakietu. Możesz zdecydować, czy chcesz ją zaktualizować.

This screenshot is of Notification shown when a new package version is available.

W wyświetlonym menu dostępne są dwie opcje:

  • Update — sprawdza serwer źródłowy i pobiera nowszą wersję (jeśli istnieje).
  • Remove — usuwa pakiet z tego projektu i usuwa odpowiednie zestawy z odwołań projektu.

Zarządzanie pakietami dla rozwiązania

Zarządzanie pakietami dla rozwiązania to wygodny sposób jednoczesnej pracy z wieloma projektami.

  1. Kliknij rozwiązanie prawym przyciskiem myszy i wybierz polecenie Zarządzaj pakietami NuGet...:

    This screenshot shows Manage NuGet packages for the solution.

  2. Podczas zarządzania pakietami dla rozwiązania interfejs użytkownika umożliwia wybranie projektów, na które mają wpływ operacje:

    This screenshot shows Project selector when managing packages for the solution.

Karta Konsoliduj

Podczas pracy w rozwiązaniu z wieloma projektami upewnij się, że w dowolnym miejscu, w którym używasz tego samego pakietu NuGet w każdym projekcie, używasz również tego samego numeru wersji tego pakietu. Program Visual Studio dla komputerów Mac ułatwia udostępnianie karty Konsoliduj w interfejsie użytkownika Menedżera pakietów podczas wybierania zarządzania pakietami dla rozwiązania. Korzystając z karty Konsolidowanie , można łatwo zobaczyć, gdzie pakiety z różnymi numerami wersji są używane przez różne projekty w rozwiązaniu:

This screenshot shows the Package Manager UI Consolidate tab.

W tym przykładzie projekt NuGetDemo korzysta z elementu Microsoft.EntityFrameworkCore 3.1.23, natomiast element NuGetDemo.Shared korzysta z elementu Microsoft.EntityFrameworkCore 5.0.2. Aby skonsolidować wersje pakietu, wykonaj następujące kroki:

  1. Wybierz projekty do zaktualizowania na liście projektów.
  2. Wybierz wersję do użycia we wszystkich tych projektach na liście Nowa wersja , na przykład Microsoft.EntityFrameworkCore 6.0.3.
  3. Wybierz przycisk Konsoliduj pakiet .

Menedżer pakietów instaluje wybraną wersję pakietu we wszystkich wybranych projektach, po czym pakiet nie jest już wyświetlany na karcie Konsoliduj .

Dodawanie źródeł pakietów

Pakiety dostępne do instalacji są początkowo pobierane z nuget.org. Można jednak dodać inne lokalizacje pakietów do programu Visual Studio dla komputerów Mac. Jest to przydatne do testowania własnych pakietów NuGet w ramach programowania lub używania prywatnego serwera NuGet w firmie lub organizacji.

W programie Visual Studio dla komputerów Mac przejdź do pozycji Źródła NuGet > preferencji > programu Visual Studio>, aby wyświetlić i edytować listę źródeł pakietów. Źródła mogą być serwerem zdalnym (określonym przez adres URL) lub katalogiem lokalnym.

This screenshot shows Package Sources to add other package locations to Visual Studio for Mac.

Wybierz pozycję Dodaj , aby skonfigurować nowe źródło. Wprowadź przyjazną nazwę i lokalizację (adres URL lub ścieżkę pliku) do źródła pakietu. Jeśli źródło jest bezpiecznym serwerem internetowym, wprowadź również pola Nazwa użytkownika i Hasło , w przeciwnym razie pozostaw te wpisy puste:

This screenshot shows Add Package Source dialog with a prompt for Name, location URL, user name, and password.

Podczas wyszukiwania pakietów można wybrać różne źródła:

This screenshot shows Add Package Source dialog showing a drop down with a list of package sources.

Kontrola wersji

W dokumentacji narzędzia NuGet omówiono używanie narzędzia NuGet bez zatwierdzania pakietów do kontroli źródła. Jeśli nie chcesz przechowywać plików binarnych i nieużywanych informacji w kontroli źródła, możesz skonfigurować program Visual Studio dla komputerów Mac tak, aby automatycznie przywracał pakiety z serwera. Gdy deweloper po raz pierwszy pobierze projekt z kontroli źródła, program Visual Studio dla komputerów Mac automatycznie pobierze i zainstaluje wymagane pakiety.

This screenshot shows the Preferences screen to automatically restore packages when opening a solution.

Aby uzyskać szczegółowe informacje na temat wykluczania packages katalogu z śledzenia, zapoznaj się z konkretną dokumentacją kontroli źródła.

Zobacz też