Instalowanie pakietów i zarządzanie nimi w programie Visual Studio przy użyciu Menedżera pakietów NuGet

Interfejs użytkownika Menedżera pakietów NuGet w programie Microsoft Visual Studio dla systemu Windows umożliwia łatwe instalowanie, odinstalowywanie i aktualizowanie pakietów NuGet w projektach i rozwiązaniach.

Artykuł dotyczy tylko użytkowników systemu Windows. Jeśli używasz programu Visual Studio dla komputerów Mac, zobacz Dołączanie pakietu NuGet w projekcie.

Wymagania wstępne

• Zainstaluj program Visual Studio 2022 dla systemu Windows z dowolnym obciążeniem związanym z platformą .NET.

  Możesz zainstalować wersję Community Edition 2022 bezpłatnie z visualstudio.microsoft.com lub użyć wersji Professional lub Enterprise.

  Visual Studio 2017 i nowszy automatycznie zawiera Menedżera pakietów NuGet, gdy obciążenie związane z platformą .NET jest zainstalowane. Aby zainstalować ją indywidualnie w Instalatorze programu Visual Studio, wybierz kartę Poszczególne składniki , a następnie wybierz pozycję Menedżer pakietów NuGet w obszarze Narzędzia kodu .

  Jeśli w programie Visual Studio 2015 brakuje Menedżera pakietów NuGet, sprawdź narzędzia>Rozszerzenia i aktualizacje i wyszukaj rozszerzenie Menedżera pakietów NuGet . Jeśli nie możesz użyć instalatora rozszerzeń w programie Visual Studio, pobierz rozszerzenie bezpośrednio z witryny https://dist.nuget.org/index.html.

• Zarejestruj się w celu uzyskania bezpłatnego konta na nuget.org , jeśli jeszcze go nie masz. Należy zarejestrować i potwierdzić konto, zanim będzie można przesłać pakiet NuGet.

Znajdowanie i instalowanie pakietu

Aby znaleźć i zainstalować pakiet NuGet w programie Visual Studio, wykonaj następujące kroki:

1. Załaduj projekt w Eksploratorze rozwiązań, a następnie wybierz pozycję Projekt>Zarządzaj pakietami NuGet.

   Zostanie otwarte okno Menedżer pakietów NuGet .

2. Wybierz kartę Przeglądaj , aby wyświetlić pakiety według popularności z aktualnie wybranego źródła (zobacz Źródła pakietów).

   • Aby wyszukać określony pakiet, użyj pola wyszukiwania w lewym górnym rogu.
   • Skrócone informacje mogą być wyświetlane obok każdego identyfikatora pakietu, aby ułatwić identyfikację poprawnego pakietu i różnią się w zależności od wybranych źródeł pakietów. Przykłady obejmują liczbę pobrań pakietów, odnośniki do profilu autora lub właściciela.

   Uwaga / Notatka

   W programie Visual Studio 17.11 i nowszych, właściciele pakietów wyświetlani są jako hiperłącza do profili, jeśli jest to obsługiwane przez wybrane źródło pakietu. Własność pakietu jest definiowana przez źródło pakietu. Na przykład zobacz Zarządzanie właścicielami pakietów w nuget.org.

   W programie Visual Studio 17.10 i starszych metadane autora pakietu są wyświetlane jako zwykły tekst. Aby uzyskać więcej informacji, zobacz Metadane pakietu autorów.

   • Wybierz pakiet, aby wyświetlić szczegółowe informacje o pakiecie. Zostanie wyświetlone okienko szczegółów po prawej stronie i umożliwi wybranie wersji do zainstalowania. Metadane pakietu, informacje o właścicielach, autorach, licencjach itp. można zobaczyć na karcie Szczegóły pakietu i pliku README pakietu (jeśli jest on dostarczony przez autora pakietu) oraz na karcie README.

3. W okienku po prawej stronie wybierz pozycję Wersja z listy rozwijanej. Jeśli chcesz uwzględnić wersje wstępne na liście Wersja , wybierz pozycję Uwzględnij wersję wstępną.

4. Aby zainstalować pakiet NuGet, wybierz pozycję Zainstaluj. Może zostać wyświetlony monit o zaakceptowanie postanowień licencyjnych lub wyświetlenie monitu o zweryfikowanie instalacji.

   Program Visual Studio instaluje pakiet i jego zależności w projekcie. Po zakończeniu instalacji dodane pakiety są wyświetlane na karcie Zainstalowane. Pakiety można również znaleźć w węźlePakiety> projektu w Eksploratorze rozwiązań. Po zainstalowaniu pakietu można odwoływać się do niego w projekcie za pomocą instrukcji using .

5. (Opcjonalnie) NuGet ma dwa formaty, w których projekt może używać pakietów: PackageReference i packages.config. Aby ustawić format domyślny, wybierz pozycję Narzędzia>Opcje, rozwiń węzeł Menedżer pakietów NuGet, wybierz pozycję Ogólne, a następnie wybierz domyślny format zarządzania pakietami. Aby uzyskać więcej informacji, zobacz Wybieranie domyślnego formatu zarządzania pakietami.

Odinstalowywanie pakietu

Aby odinstalować pakiet NuGet, wykonaj następujące kroki:

1. Załaduj projekt w Eksploratorze rozwiązań, wybierz pozycję Projekt>Zarządzaj pakietami NuGet, a następnie wybierz kartę Zainstalowane .

2. Wybierz pakiet do odinstalowania w okienku po lewej stronie (użyj pola Wyszukaj , aby go znaleźć, jeśli to konieczne), a następnie wybierz pozycję Odinstaluj w okienku po prawej stronie.

   

Aktualizowanie pakietu

Aby zaktualizować pakiet NuGet, wykonaj następujące kroki:

1. Załaduj projekt w Eksploratorze rozwiązań, a następnie wybierz pozycję Projekt>Zarządzaj pakietami NuGet. W przypadku projektów witryn internetowych wybierz najpierw folder Bin .

2. Wybierz kartę Aktualizacje , aby wyświetlić pakiety, które mają dostępne aktualizacje z wybranego źródła pakietu. Wybierz pozycję Uwzględnij wersję wstępną , aby uwzględnić pakiety wersji wstępnej na liście aktualizacji.

3. Wybierz pakiet do zaktualizowania. W okienku po prawej stronie wybierz odpowiednią wersję z listy rozwijanej, a następnie wybierz pozycję Aktualizuj.

   

4. W przypadku niektórych pakietów przycisk Aktualizuj jest wyłączony, a wyświetlany jest następujący komunikat: Niejawnie przywołyny przez zestaw SDK. Aby zaktualizować pakiet, zaktualizuj zestaw SDK, do którego należy. Ten komunikat wskazuje, że pakiet jest częścią większej struktury lub zestawu SDK i nie można go aktualizować niezależnie. Takie pakiety są wewnętrznie oznaczone znakiem <IsImplicitlyDefined>True</IsImplicitlyDefined>. Na przykład Microsoft.NETCore.App jest częścią zestawu .NET Core SDK, a wersja pakietu różni się od wersji platformy uruchomieniowej używanej przez aplikację. Aby pobrać nową wersję platformy .NET Core, zaktualizuj instalację platformy .NET Core. Aby uzyskać więcej informacji, zobacz Metapakiety i wersjonowanie platformy .NET Core. Ten scenariusz dotyczy następujących często używanych pakietów:

   • Microsoft.AspNetCore.All
   • Microsoft.AspNetCore.App
   • Microsoft.NETCore.App
   • NETStandard.Library

   

5. Aby zaktualizować wiele pakietów do najnowszych wersji, wybierz je na liście pakietów NuGet, a następnie wybierz pozycję Aktualizuj.

6. Możesz również zaktualizować pojedynczy pakiet na karcie Zainstalowane . W tym przypadku możesz również wybrać opcję Wersja i Uwzględnij wersję wstępną .

Zarządzanie pakietami dla rozwiązania

Zarządzanie pakietami dla rozwiązania jest wygodnym sposobem pracy z wieloma projektami jednocześnie:

1. Wybierz rozwiązanie w Menedżerze rozwiązań, a następnie wybierz pozycję Narzędzia>Menedżer> pakietówNuGet Zarządzaj pakietami NuGet dla rozwiązania.

2. W oknie Zarządzanie pakietami NuGet dla rozwiązania wybierz projekty, na które mają wpływ operacje.

   

Karta Konsolidacja

Programiści zazwyczaj uważają, że złą praktyką jest używanie różnych wersji tego samego pakietu NuGet w różnych projektach w ramach tego samego rozwiązania. Program Visual Studio umożliwia używanie wspólnej wersji pakietów NuGet. W tym celu użyj karty Konsolidowanie okna Menedżer pakietów NuGet , aby dowiedzieć się, gdzie pakiety z unikatowymi numerami wersji są używane przez różne projekty w rozwiązaniu.

W tym przykładzie projekt ClassLibrary1 używa elementu EntityFramework 6.2.0, natomiast aplikacja ConsoleApp1 używa elementu EntityFramework 6.1.0. Aby skonsolidować wersje pakietów, wykonaj następujące kroki:

1. Na karcie Konsolidowanie wybierz projekty do zaktualizowania na liście projektów.

2. Wybierz wersję, która ma być używana dla wszystkich tych projektów na liście Wersja .

3. Wybierz Zainstaluj.

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

Źródła pakietów

Program Visual Studio ignoruje kolejność źródeł pakietów i używa pakietu z tego źródła, które jako pierwsze odpowiada na żądanie. Aby uzyskać więcej informacji, zobacz Przywracanie pakietów. Aby uzyskać informacje na temat ładowania pakietu z określonego źródła, zobacz Mapowanie źródła pakietów.

1. Aby zmienić źródło, z którego program Visual Studio ładuje metadane pakietu, wybierz źródło z selektora źródła pakietu .

   

2. Aby zarządzać źródłami pakietów, wybierz ikonę Ustawienia lub wybierz pozycję Opcje narzędzi>.

   

3. Aby zarządzać źródłami pakietów NuGet, zobacz Opcje narzędzia NuGet w programie Visual Studio.

Opcje menedżera pakietów NuGet

Po wybraniu pakietu Menedżer pakietów NuGet wyświetla rozwijaną kontrolkę Opcje poniżej selektora wersji . W przypadku większości typów projektów jest dostępna tylko opcja Pokaż okno podglądu .

W poniższych sekcjach opisano dostępne opcje.

Opcje instalacji i aktualizacji

Te opcje są dostępne tylko dla niektórych typów projektów:

• Zachowanie zależności: ta opcja umożliwia skonfigurowanie sposobu, w jaki program NuGet decyduje o tym, które wersje pakietów zależnych mają być instalowane. Ma następujące ustawienia:

  • Ignoruj zależności pomija instalację zależności, co zwykle przerywa instalowanie pakietu.
  • Najniższa [Domyślna] instaluje zależność z minimalnym numerem wersji spełniającym wymagania wybranego pakietu podstawowego.
  • Najwyższa poprawka instaluje wersję z tymi samymi numerami wersji głównych i pomocniczych, ale najwyższym numerem poprawki. Jeśli na przykład zostanie określona wersja 1.2.2, zostanie zainstalowana najwyższa wersja rozpoczynająca się od wersji 1.2
  • Najwyższa wersja pomocnicza instaluje wersję z tym samym numerem wersji głównej, ale największą liczbą pomocniczą i numerem poprawki. Jeśli zostanie określona wersja 1.2.2, zostanie zainstalowana najwyższa wersja rozpoczynająca się od 1
  • Najwyższa instaluje najwyższą dostępną wersję pakietu.

• Akcja powodująca konflikt plików: ta opcja określa, jak pakiet NuGet powinien obsługiwać pakiety, które już istnieją na komputerze lokalnym lub projekcie. Ma następujące ustawienia:

  • Monit instruuje NuGet, aby zapytał, czy zachować czy nadpisać istniejące pakiety.
  • Ignoruj wszystkie instruuje NuGet, aby pominąć zastępowanie jakichkolwiek istniejących pakietów.
  • Zastąp wszystkie powoduje, że pakiet NuGet zastąpi wszystkie istniejące pakiety.

Opcje odinstalowywania

Te opcje są dostępne tylko dla niektórych typów projektów:

• Usuń zależności: po wybraniu opcji usuwa wszystkie pakiety zależne, jeśli nie odwołują się do nich w innym miejscu projektu.

• Wymuś odinstalowanie, nawet jeśli istnieją zależności: po wybraniu powoduje odinstalowanie pakietu, nawet jeśli nadal jest używany w projekcie. Ta opcja jest zwykle używana w połączeniu z usuwaniem zależności w celu usunięcia pakietu i zależności, które zostały zainstalowane. Użycie tej opcji może jednak prowadzić do uszkodzenia odwołań w projekcie. W takim przypadku może być konieczne ponowne zainstalowanie tych innych pakietów.

Powiązany film wideo

• Znajdź filmy NuGet w kanałach Channel 9 i YouTube.

Zobacz także

Aby uzyskać więcej informacji na temat narzędzia NuGet, zobacz następujące artykuły:

• Co to jest NuGet?
• Przepływ pracy użycia pakietu
• Znajdowanie i wybieranie pakietów
• Odwołania do pakietów w plikach projektu
• Zainstaluj pakiet i użyj go przy użyciu interfejsu wiersza polecenia platformy .NET.