Instalowanie narzędzi klienta NuGet

Chcesz zainstalować pakiet? Zobacz Sposoby instalowania pakietu NuGet.

Aby pracować z pakietem NuGet jako użytkownik lub twórca pakietu, możesz użyć narzędzi interfejsu wiersza polecenia i funkcji NuGet w Visual Studio. W tym artykule krótko opisano możliwości różnych narzędzi. Wyjaśniono również, jak je zainstalować i porównać dostępność funkcji w narzędziach.

Szybkie starty z NuGet

Aby rozpocząć korzystanie z pakietów NuGet, zapoznaj się z następującymi artykułami:

Aby rozpocząć tworzenie pakietów NuGet, zobacz następujące artykuły:

Omówienie narzędzi

Narzędzie Opis Pobierz
dotnet SDK Narzędzie interfejsu wiersza polecenia dla bibliotek .NET i .NET Standard oraz dla dowolnego projektu w stylu SDK takiego jak projekt w .NET Framework. To narzędzie interfejsu wiersza polecenia jest dołączone do zestawu SDK .NET i udostępnia podstawowe funkcje NuGet na wszystkich platformach. W Visual Studio 2017 i nowszych, to narzędzie dotnet CLI jest automatycznie instalowane z dowolnymi obciążeniami związanymi z .NET. .NET SDK
nuget.exe Narzędzie interfejsu wiersza polecenia dla bibliotek platformy .NET Framework oraz dowolnego projektu bez stylu SDK, takiego jak projekt przeznaczony dla bibliotek .NET Standard. To narzędzie CLI udostępnia wszystkie możliwości NuGet na Windows oraz większość funkcji na macOS i Linux podczas działania w Mono. nuget.exe
Visual Studio Pełne zintegrowane środowisko projektowe (IDE), które obejmuje Package Manager NuGet. Visual Studio udostępnia interfejs użytkownika Package Manager oraz konsolę Package Manager (program PowerShell w Windows). Za pomocą tych narzędzi można uruchamiać większość operacji NuGet. Visual Studio
Visual Studio Code Uproszczony edytor kodu typu open source dla Windows, macOS i Linux, który oferuje funkcje NuGet za pośrednictwem rozszerzeń witryny Marketplace. Możesz również użyć zestawu SDK dotnet lub narzędzi wiersza poleceń nuget.exe w Visual Studio Code. Visual Studio Code

Możesz również użyć interfejsu wiersza polecenia Microsoft Build Engine (MSBuild), do przywracania i tworzenia pakietów. Jednak program MSBuild nie jest narzędziem ogólnego przeznaczenia do pracy z pakietem NuGet. To narzędzie interfejsu wiersza polecenia jest przydatne przede wszystkim na serwerach kompilacji.

Polecenia konsoli Menedżera Pakietów działają tylko w Visual Studio na systemie Windows i nie działają w innych środowiskach programu PowerShell.

Polityka wsparcia

Aby uzyskać zasady pomocy technicznej Visual Studio dla Windows, zobacz Visual Studio cykl życia produktu i obsługa.

Najnowsza wersja programu nuget.exe jest w pełni obsługiwana i można na niej polegać w zakresie poprawek usterek, aktualizacji i ulepszeń. Aby uzyskać więcej informacji na temat nuget.exe zasad pomocy technicznej, zobacz Nowoczesna polityka cyklu życia.

Aby uzyskać zasady obsługi zestawu .NET SDK, zobacz .NET i .NET Core Support Policy.

Aktualizacje poprawek

Poprawkowe wersje nuget.exe są wydawane wyłącznie wtedy, gdy krytyczne poprawki zabezpieczeń są wymagane dla długoterminowej wersji Visual Studio lub zestawu .NET SDK.

Wszystkie usterki zabezpieczeń powinny być zgłaszane do Microsoft Security Response Center (MSRC) na stronie raportu MSRC. Aby uzyskać szczegółowe informacje na temat raportowania problemów z zabezpieczeniami, zobacz zasady zabezpieczeń w repozytorium NuGet.Client.

NuGet.exe wyrejesowywanie listy

Nieobsługiwane, przestarzałe lub podatne na zagrożenia wersje nuget.exe są usuwane z punktu końcowegotools.json.

Visual Studio

W Visual Studio 2017 i nowszych, instalator Visual Studio zawiera Menadżer pakietów NuGet z dowolnym obciążeniem korzystającym z .NET.

Możesz również zainstalować Package Manager oddzielnie lub zweryfikować instalację. Uruchom instalator Visual Studio i sprawdź ustawienie opcji w obszarze Individual components>Code tools>NuGet package manager. Aby uzyskać więcej informacji, zobacz Install and manage packages in Visual Studio using the NuGet Package Manager (Instalowanie pakietów i zarządzanie nimi przy użyciu narzędzia NuGet Package Manager

Narzędzia interfejsu wiersza polecenia

Możesz użyć dotnet CLI lub nuget.exe CLI do obsługi funkcji NuGet w Visual Studio IDE. Interfejs wiersza polecenia dotnet jest instalowany z niektórymi zestawami funkcji Visual Studio, takimi jak .NET. CLI nuget.exe należy zainstalować oddzielnie, jak to opisano wcześniej. Aby zapoznać się z porównaniem funkcji narzędzi, zobacz sekcję Dostępność funkcji .

  • Aby celować w .NET lub .NET Standard, użyj narzędzia wiersza polecenia SDK dotnet. Ten CLI jest wymagany dla formatu projektu w stylu SDK, który korzysta z atrybutuSDK.

  • Aby obsługiwać .NET Framework w projektach, które nie są w stylu SDK, użyj narzędzia CLI nuget.exe. Jeśli projekt jest migrowany z packages.config formatu do PackageReference, zamiast tego użyj narzędzia interfejsu wiersza polecenia zestawu SDK dotnet.

dotnet SDK

SDK dotnet to narzędzie CLI dla .NET. Działa na wszystkich platformach (Windows, macOS i Linux) i udostępnia podstawowe funkcje NuGet, takie jak instalowanie, przywracanie i publikowanie pakietów. Interfejs wiersza polecenia dotnet zapewnia bezpośrednią integrację z plikami projektu .NET, takimi jak pliki .csproj, co jest przydatne w większości scenariuszy. Ten interfejs CLI jest również kompilowany bezpośrednio dla każdej platformy i nie wymaga instalacji Mono.

Instalowanie zestawu dotnet SDK

  • Na komputerach deweloperskich zainstaluj zestaw SDK .NET. W Visual Studio 2017 i nowszych, to narzędzie dotnet CLI jest automatycznie instalowane z dowolnymi obciążeniami związanymi z .NET.

  • W przypadku serwerów kompilacji postępuj zgodnie z instrukcjami, aby użyć zestaw .NET SDK w środowiskach ciągłej integracji.

Aby dowiedzieć się, jak używać podstawowych poleceń za pomocą narzędzia interfejsu wiersza polecenia zestawu SDK dotnet, zobacz Instalowanie pakietów NuGet i zarządzanie nimi za pomocą interfejsu wiersza polecenia dotnet.

interfejs wiersza polecenia nuget.exe

Interfejs wiersza polecenia NuGet, nuget.exe, jest narzędziem wiersza polecenia dla Windows, które zapewnia wszystkie możliwości NuGet. Ten interfejs wiersza polecenia może być również uruchamiany w systemach macOS i Linux przy użyciu platformy Mono z pewnymi ograniczeniami.

Aby dowiedzieć się, jak używać podstawowych poleceń za pomocą narzędzia wiersza poleceń nuget.exe, zobacz Zarządzanie pakietami NuGet przy użyciu interfejsu wiersza poleceń nuget.exe.

Instalowanie nuget.exe

Zawsze zainstaluj najnowszą wersję narzędzia obsługującego konfigurację.

Jeśli narzędzie CLI nuget.exe jest już zainstalowane, możesz je zaktualizować do najnowszej wersji, używając polecenia nuget update -self.

  1. Pobierz nuget.exeplik :

  2. Po wyświetleniu monitu zapisz plik w wybranym folderze. Plik nuget.exe jest pobierany bezpośrednio. Pobrany plik nie jest instalatorem, więc nie ma potrzeby uruchamiania pliku bezpośrednio z przeglądarki.

  3. Aby użyć narzędzia interfejsu wiersza polecenia z dowolnego folderu, dodaj folder zawierający plik nuget.exe do PATH zmiennej środowiskowej.

Dostępność funkcji

W poniższej tabeli porównuje się dostępne funkcjonalności dla dotnet CLI, nuget.exe CLI oraz narzędzi Visual Studio na obsługiwanych platformach.

Funkcja dotnet CLI interfejs wiersza polecenia narzędzia nuget (Windows) NuGet CLI (Mono) Visual Studio
Wyszukaj pakiety
Instalowanie lub odinstalowywanie pakietów ✔ (1)
Aktualizowanie pakietów
Przywracanie pakietów ✔ (2)
Zarządzanie źródłami pakietów
Zarządzanie pakietami w kanale informacyjnym
Ustaw klucze API dla kanałów
Tworzenie pakietów (3) ✔ (4)
Publikowanie pakietów
Replikowanie pakietów
Zarządzanie pakietami globalnymi i folderami pamięci podręcznej
Zarządzanie konfiguracją narzędzia NuGet

Uwagi dotyczące funkcji:

  • (1) Użycie tej funkcji nie ma wpływu na pliki projektu. Zamiast tego użyj narzędzia CLI dotnet SDK.
  • (2) Ta funkcja działa tylko z plikami packages.config, a nie z plikami rozwiązania (.sln lub .slnx).
  • (3) Różne zaawansowane funkcje pakietu są dostępne tylko za pośrednictwem interfejsu wiersza polecenia, ponieważ nie są reprezentowane w narzędziach interfejsu użytkownika Visual Studio.
  • (4) Ta funkcja działa z plikami nuspec , ale nie z plikami projektu.

Nadchodzące funkcje

Jeśli chcesz zobaczyć zapowiedź nadchodzących funkcji NuGet, zainstaluj wersję Insiders Channel programu Visual Studio, która działa z wszystkimi stabilnymi wersjami Visual Studio. Aby zgłosić problemy lub podzielić się pomysłami na wersje zapoznawcze, otwórz problem w repozytorium NuGet GitHub.

Deweloperzy, którzy pracują nad Windows, mogą również eksplorować NuGet Package Explorer. Ta aplikacja jest autonomicznym narzędziem typu open source, którego można użyć do wizualnego eksplorowania, tworzenia i edytowania pakietów NuGet. Jest to przydatne w wielu scenariuszach, takich jak wprowadzanie eksperymentalnych zmian w strukturze pakietu bez ponownego kompilowania pakietu.