Zarządzanie pakietami przy użyciu interfejsu wiersza polecenia nuget.exe

Narzędzie interfejsu wiersza polecenia umożliwia łatwe aktualizowanie i przywracanie pakietów NuGet w projektach i rozwiązaniach. To narzędzie zapewnia wszystkie NuGet możliwości na Windows, a także udostępnia większość funkcji na komputerach Mac i Linux podczas uruchamiania w środowisku Mono.

Interfejs nuget.exe wiersza polecenia jest przeznaczony dla projektów .NET Framework i projektów innych niż zestaw SDK (na przykład projekt w stylu bez zestawu SDK przeznaczony dla bibliotek platformy .NET Standard). Jeśli używasz projektu innego niż zestaw SDK, który został zmigrowany do PackageReferenceprogramu , zamiast tego użyj interfejsu dotnet wiersza polecenia. Interfejs nuget.exe wiersza polecenia wymaga pliku packages.config dla odwołań do pakietu.

Uwaga

W większości scenariuszy zalecamy migrowanie projektów innych niż zestaw SDK , które są używane packages.config do funkcji PackageReference, a następnie można użyć interfejsu dotnet wiersza polecenia zamiast interfejsu nuget.exe wiersza polecenia. Migracja nie jest obecnie dostępna dla projektów C++ i ASP.NET.

W tym artykule przedstawiono podstawowe użycie kilku najczęściej używanych nuget.exe poleceń interfejsu wiersza polecenia. W przypadku większości tych poleceń narzędzie interfejsu wiersza polecenia wyszukuje plik projektu w bieżącym katalogu, chyba że w poleceniu określono plik projektu. Aby uzyskać pełną listę poleceń i argumentów, których można użyć, zobacz dokumentację interfejsu wiersza polecenianuget.exe.

Wymagania wstępne

  • nuget.exe Zainstaluj interfejs wiersza polecenia, pobierając go z nuget.org, zapisując ten .exe plik w odpowiednim folderze i dodając ten folder do zmiennej środowiskowej PATH.

Instalowanie pakietu

Polecenie instalacji pobiera i instaluje pakiet w projekcie, domyślnie do bieżącego folderu przy użyciu określonych źródeł pakietów. Zainstaluj nowe pakiety w folderze packages w katalogu głównym projektu.

Ważne

Polecenie installnie modyfikuje pliku projektu ani packages.config; w ten sposób jest podobny do restore tego, że dodaje tylko pakiety na dysku, ale nie zmienia zależności projektu. Aby dodać zależność, dodaj pakiet za pomocą interfejsu użytkownika Menedżer pakietów lub konsoli w Visual Studio albo zmodyfikuj packages.config, a następnie uruchom install polecenie lub restore.

  1. Otwórz wiersz polecenia i przejdź do katalogu zawierającego plik projektu.

  2. Użyj następującego polecenia, aby zainstalować pakiet NuGet w folderze packages.

    nuget install <packageID> -OutputDirectory packages
    

    Aby zainstalować pakiet w Newtonsoft.json folderze packages , użyj następującego polecenia:

    nuget install Newtonsoft.Json -OutputDirectory packages
    

Alternatywnie możesz użyć następującego polecenia, aby zainstalować pakiet NuGet przy użyciu istniejącego packages.config pliku w folderze packages. Nie powoduje to dodania pakietu do zależności projektu, ale instaluje go lokalnie.

nuget install packages.config -OutputDirectory packages

Instalowanie określonej wersji pakietu

Jeśli wersja nie zostanie określona podczas korzystania z polecenia instalacji, NuGet zainstaluje najnowszą wersję pakietu. Można również zainstalować określoną wersję pakietu Nuget:

nuget install <packageID | configFilePath> -Version <version>

Aby na przykład dodać wersję 12.0.1 pakietu, użyj następującego Newtonsoft.json polecenia:

nuget install Newtonsoft.Json -Version 12.0.1

Aby uzyskać więcej informacji na temat ograniczeń i zachowania programu install, zobacz Instalowanie pakietu.

Usuwanie pakietu

Aby usunąć co najmniej jeden pakiet, usuń pakiety, które chcesz usunąć z folderu packages .

Jeśli chcesz ponownie zainstalować pakiety, użyj restore polecenia lub install .

Wyświetlanie listy pakietów

Listę pakietów z danego źródła można wyświetlić za pomocą polecenia listy . -Source Użyj opcji , aby ograniczyć wyszukiwanie.

nuget list -Source <source>

Na przykład wyświetl listę pakietów w folderze packages .

nuget list -Source C:\Users\username\source\repos\MyProject\packages

Jeśli używasz terminu wyszukiwania, wyszukiwanie zawiera nazwy pakietów, tagów i opisów pakietów.

nuget list <search term>

Aktualizowanie pojedynczego pakietu

NuGet instaluje najnowszą wersję pakietu podczas korzystania z install polecenia , chyba że zostanie określona wersja pakietu.

Aktualizowanie wszystkich pakietów

Użyj polecenia update , aby zaktualizować wszystkie pakiety. Aktualizuje wszystkie pakiety w projekcie (przy użyciu polecenia packages.config) do najnowszych dostępnych wersji. Zaleca się uruchomienie restore polecenia przed uruchomieniem polecenia update.

nuget update

Przywracanie pakietów

Użyj polecenia restore , które pobiera i instaluje wszystkie brakujące pakiety z folderu packages .

W przypadku projektów migrowanych do elementu PackageReference zamiast tego użyj polecenia msbuild -t:restore , aby przywrócić pakiety.

restore dodaje tylko pakiety do dysku, ale nie zmienia zależności projektu. Aby przywrócić zależności projektu, zmodyfikuj packages.configrestore polecenie , a następnie użyj polecenia .

Podobnie jak w przypadku innych nuget.exe poleceń interfejsu wiersza polecenia, najpierw otwórz wiersz polecenia i przejdź do katalogu zawierającego plik projektu.

Aby przywrócić pakiet przy użyciu polecenia restore:

nuget restore MySolution.sln

Uzyskiwanie wersji interfejsu wiersza polecenia

Użyj następującego polecenia:

nuget help

Pierwszy wiersz w danych wyjściowych pomocy zawiera wersję. Aby uniknąć przewijania w górę, zamiast tego użyj polecenia nuget help | more .