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

  • Artykuł

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

Interfejs wiersza polecenia dotnet działa w projektach w stylu zestawu .NET Core, .NET Core, .NET Standard SDK i innych projektach w stylu zestawu 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 dotnet CLI commands (Polecenia interfejsu wiersza polecenia dotnet).

Wymagania wstępne

  • Zestaw .NET Core SDK, który udostępnia dotnet narzędzie wiersza polecenia. Począwszy od programu Visual Studio 2017, interfejs wiersza polecenia dotnet jest automatycznie instalowany ze wszystkimi obciążeniami powiązanymi z platformą .NET i platformą .NET Core.

Instalowanie lub aktualizowanie pakietu

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

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

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

    dotnet add package <PACKAGE_NAME>

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

    dotnet add package Newtonsoft.Json

  3. Po zakończeniu wykonywania polecenia możesz otworzyć plik projektu, aby wyświetlić odwołanie do pakietu.

    Na przykład otwórz plik csproj , aby wyświetlić dodane Newtonsoft.Json odwołanie do pakietu:

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

Instalowanie określonej wersji pakietu

Polecenie dotnet add package 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 add package <PACKAGE_NAME> -v <VERSION>

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

dotnet add package Newtonsoft.Json --version 12.0.1

Lista odwołań do pakietów

Wyświetl listę odwołań i wersji pakietu dla projektu przy użyciu polecenia dotnet list package :

dotnet list package

Usuwanie pakietu

Użyj polecenia dotnet remove package, aby usunąć odwołanie do pakietu z pliku projektu.

dotnet remove package <PACKAGE_NAME>

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

dotnet remove package Newtonsoft.Json

Przywracanie pakietów

Polecenie dotnet restore przywraca pakiety zawierające listę plików projektu za pomocą <PackageReference>polecenia . Aby uzyskać więcej informacji, zobacz PackageReference w plikach projektu.

Program .NET Core 2.0 lub nowszy dotnet build oraz dotnet run polecenia automatycznie przywracają pakiety. Od wersji NuGet 4.0 dotnet restore program uruchamia ten sam kod co nuget restore.

Aby przywrócić pakiet za pomocą polecenia dotnet restore:

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

Następne kroki