Instalowanie pakietów NuGet i zarządzanie nimi za pomocą interfejsu wiersza polecenia dotnet

Możesz użyć narzędzia interfejsu wiersza polecenia dotnet w Windows, macOS lub Linux, aby łatwo instalować, odinstalować i aktualizować pakiety NuGet w projektach i rozwiązaniach .NET. W tym artykule opisano najbardziej typowe polecenia interfejsu CLI dotnet do zarządzania pakietami NuGet.

Interfejs wiersza polecenia dotnet działa na projektach .NET, .NET Core, .NET Standard w stylu SDK i innych projektach w stylu SDK, na przykład tych, które są przeznaczone dla platformy .NET Framework. Aby uzyskać więcej informacji, zobacz Zestawy SDK projektu .NET.

W przypadku większości poleceń narzędzie interfejsu wiersza polecenia wyszukuje plik projektu w bieżącym katalogu, chyba że w poleceniu określono inny plik projektu jako opcjonalny przełącznik. Aby uzyskać pełną listę poleceń i ich argumentów, zobacz polecenia dotnet CLI.

Wymagania wstępne

Zestaw SDK .NET, który udostępnia dotnet CLI. W programie Visual Studio interfejs wiersza poleceń dotnet jest automatycznie instalowany wraz ze wszystkimi obciążeniami związanymi z .NET.

Instalowanie lub aktualizowanie pakietu

Polecenie dotnet package add dodaje odwołanie do pakietu do pliku projektu, a następnie uruchamia polecenie dotnet restore w celu zainstalowania pakietu.

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

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

    dotnet package add <package-name>

    Aby na przykład zainstalować Newtonsoft.Json pakiet, użyj następującego polecenia:

    dotnet package add Newtonsoft.Json

    Jeśli używasz .NET 9 lub starszego, zamiast tego użyj wersji z czasownikiem na początku polecenia.

    dotnet add package <package-name>

  3. Po zakończeniu polecenia otwórz plik projektu, aby sprawdzić odwołanie do pakietu.

    Na przykład otwórz plik csproj i sprawdź, czy dodano Newtonsoft.Json odwołanie do pakietu:

    <ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.4" />
</ItemGroup>

Instalowanie określonej wersji pakietu

Polecenie dotnet package add instaluje najnowszą wersję pakietu, chyba że określono inną wersję.

Aby zainstalować określoną wersję pakietu NuGet, użyj opcjonalnego -v lub --version przełącznika:

dotnet package add <package-name> -v <version>

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

dotnet package add Newtonsoft.Json --version 13.0.1

Lista odwołań do pakietów

Możesz użyć polecenia dotnet package list, aby wyświetlić listę odwołań i wersji pakietu dla projektu. W katalogu zawierającym plik projektu uruchom następujące polecenie:

dotnet package list

Jeśli używasz .NET 9 lub starszej wersji, zamiast tego używaj formy czasownika jako pierwszej:

dotnet list package

Usuwanie pakietu

Możesz użyć polecenia dotnet package remove , aby usunąć odwołanie do pakietu z pliku projektu. W katalogu zawierającym plik projektu uruchom następujące polecenie:

dotnet package remove <package-name>

Aby na przykład usunąć Newtonsoft.Json pakiet, użyj następującego polecenia:

dotnet package remove Newtonsoft.Json

Jeśli używasz .NET 9 lub starszej wersji, zamiast tego używaj formy czasownika jako pierwszej:

dotnet remove package <package-name>

Przywracanie pakietów

Polecenie dotnet restore przywraca pakiety wymienione w <PackageReference> elementach w pliku projektu. Aby uzyskać więcej informacji, zobacz PackageReference w plikach projektu.

Począwszy od .NET Core 2.0 i kontynuując z .NET, polecenia dotnet build oraz dotnet run automatycznie przywracają pakiety, podobnie jak wiele innych poleceń dotnet CLI. Od NuGet 4.0 dotnet restore uruchamia ten sam kod co polecenie NuGet CLI nuget restore.

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

  1. Otwórz okno wiersza polecenia i przejdź do katalogu zawierającego plik projektu.
  2. Uruchom program dotnet restore.

Treści powiązane

  • Last updated on