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

Interfejs NuGet Menedżer pakietów użytkownika w 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 .NET Core, ASP.NET Core i Xamarin.

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

Aby uzyskać wprowadzenie do korzystania z NuGet w Visual Studio dla komputerów Mac, zobacz Szybki start: instalowanie i używanie pakietu w Visual Studio dla komputerów Mac

Znajdowanie i instalowanie pakietu

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

    Dodawanie nowej NuGet kontekstu pakietu

  2. Zostanie otwarte okno Zarządzanie NuGet pakietów. Upewnij się, że na liście rozwijanej Źródło w lewym górnym rogu okna dialogowego jest ustawiona wartość , dzięki czemu wyszukiwane jest nuget.org centralne repozytorium NuGet pakietów.

    Lista NuGet pakietów

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

    Dodawanie pakietu NuGet EntityFramework

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

    Projekty platformy Xamarin

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

    Projekty .NET Core

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

Korzystanie z NuGet pakietów

Po dodaniu NuGet odwołania do projektu można programowanie względem interfejsów API tak samo jak w przypadku dowolnego odwołania do projektu.

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

using Newtonsoft.Json;

Aktualizowanie pakietów

Aktualizacje pakietów można wykonać jednocześnie, klikając prawym przyciskiem myszy węzeł Zależności (węzeł Pakiety dla projektów Xamarin) lub pojedynczo w każdym pakiecie. Gdy dostępna jest nowa wersja pakietu NuGet, zostanie wyświetlona ikona aktualizacji Strzałka w  górę z okręgiem .

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:

Menu kontekstowe zależności z wyróżnione menu Aktualizacji

  • Zarządzanie NuGet pakietów — otwiera okno, aby dodać więcej pakietów do projektu.
  • Aktualizacja — 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 nowszej 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 pakietów do wersji wstępnych

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

Menu kontekstowe zależności z zarządzaniem NuGet pakietów... wyróżnione menu

Zaznacz pole wyboru Pokaż pakiety wersji wstępnej w dolnej części okna dialogowego.

Otwarte okno dialogowe NuGet zarządzanie pakietami wersji wstępnej z zaznaczoną opcją "Pokaż pakiety wersji wstępnej"

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 kliknij pozycję Aktualizuj pakiet.

Zarządzaj NuGet pakietów otwieranych na karcie Zainstalowane z wybranym pakietem i otwartą listą rozwijaną Nowa wersja.

Lokalizowanie nieaktualnych pakietów

W oknie rozwiązania możesz wyświetlić wersję pakietu, która jest obecnie zainstalowana, i kliknąć prawym przyciskiem myszy pakiet, aby go zaktualizować.

Menu Pakiety z opcjami aktualizowania, usuwania i odświeżania

Zobaczysz również powiadomienie obok nazwy pakietu, gdy będzie dostępna nowa wersja pakietu, dzięki czemu możesz zdecydować, czy chcesz go zaktualizować.

Powiadomienie wyświetlane, gdy jest dostępna nowa wersja pakietu

W pokazanym menu dostępne są dwie opcje:

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

Zarządzanie pakietami dla rozwiązania

Zarządzanie pakietami rozwiązania jest wygodnym sposobem jednoczesnej pracy z wieloma projektami.

  1. Kliknij rozwiązanie prawym przyciskiem myszy i wybierz pozycję Zarządzaj NuGet pakietów...:

    Zarządzanie NuGet pakietów dla rozwiązania

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

    Project selektora podczas zarządzania pakietami rozwiązania

Karta Konsolidowanie

Podczas pracy w rozwiązaniu z wieloma projektami najlepszym rozwiązaniem jest upewninie się, że w każdym projekcie używasz tego samego pakietu NuGet, używasz również tego samego numeru wersji tego pakietu. Visual Studio dla komputerów Mac to ułatwić, udostępniając kartę Konsolidowanie w interfejsie Menedżer pakietów użytkownika podczas zarządzania pakietami dla rozwiązania. Korzystając z tej karty, można łatwo sprawdzić, gdzie pakiety o różnych numerach wersji są używane przez różne projekty w rozwiązaniu:

Menedżer pakietów Karta Konsolidowanie interfejsu użytkownika

W tym przykładzie projekt NuGetDemo używa elementu Microsoft.EntityFrameworkCore 2.20, natomiast nuGetDemo.Shared używa rozwiązania Microsoft.EntityFrameworkCore 2.2.6. Aby skonsolidować wersje pakietów, wykonaj następujące czynności:

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

Pakiet Menedżer pakietów wersję wybranego pakietu we wszystkich wybranych projektach, po czym pakiet nie będzie już wyświetlany na karcie Konsolidowanie.

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 Visual Studio dla komputerów Mac. Może to być przydatne do testowania własnych pakietów NuGet w trakcie opracowywania lub używania prywatnego serwera NuGet w firmie lub organizacji.

W Visual Studio dla komputerów Mac przejdź do Visual Studio > Preferencje > NuGet >, aby wyświetlić i edytować listę źródeł pakietów. Należy pamiętać, że źródła mogą być serwerem zdalnym (określonym przez adres URL) lub katalogiem lokalnym.

Źródła pakietów

Kliknij przycisk Dodaj, aby skonfigurować nowe źródło. Wprowadź przyjazną nazwę i adres URL (lub ścieżkę pliku) do źródła pakietu. Jeśli źródłem jest bezpieczny serwer internetowy, wprowadź również nazwę użytkownika i hasło. W przeciwnym razie pozostaw te wpisy puste:

Okno dialogowe Dodawanie źródła pakietu z monitem o nazwę, adres URL lokalizacji, nazwę użytkownika i hasło.

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

Okno dialogowe Dodawanie źródła pakietu z listą rozwijaną z listą źródeł pakietów.

Kontrola wersji

W NuGet omówiono używanie NuGet bez zatwierdzania pakietów do kontroli źródła. Jeśli wolisz nie przechowywać plików binarnych i nieużywanych informacji w kontroli źródła, możesz skonfigurować Visual Studio dla komputerów Mac automatycznego przywracania pakietów z serwera. Oznacza to, że 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.

Automatyczne przywracanie pakietów

Szczegółowe informacje na temat wykluczania katalogu ze śledzenia można znaleźć w dokumentacji packages dotyczącej kontroli źródła.

Zobacz też