Instalace a správa balíčků NuGet pomocí rozhraní příkazového řádku dotnet

  • Článek

Pomocí nástroje rozhraní příkazového řádku dotnet ve Windows, macOS nebo Linuxu můžete snadno instalovat, odinstalovat a aktualizovat balíčky NuGet v projektech a řešeních .NET. Tento článek popisuje nejběžnější příkazy rozhraní příkazového řádku dotnet pro správu balíčků NuGet.

Rozhraní příkazového řádku dotnet běží na projektech .NET, .NET Core, .NET Standard SDK a všech dalších projektech ve stylu sady SDK, například těch, které cílí na rozhraní .NET Framework. Další informace najdete v tématu Sady SDK projektu .NET.

U většiny příkazů nástroj rozhraní příkazového řádku hledá soubor projektu v aktuálním adresáři, pokud není v příkazu zadán jiný soubor projektu jako volitelný přepínač. Úplný seznam příkazů a jejich argumentů najdete v tématu příkazy rozhraní příkazového řádku dotnet.

Požadavky

  • Sada .NET Core SDK, která poskytuje nástroj příkazového dotnet řádku. Počínaje sadou Visual Studio 2017 se rozhraní příkazového řádku dotnet automaticky nainstaluje se všemi úlohami souvisejícími s .NET a .NET Core.

Instalace nebo aktualizace balíčku

Příkaz dotnet add package přidá odkaz na balíček do souboru projektu a pak se spustí dotnet restore pro instalaci balíčku.

  1. Otevřete příkazový řádek a přepněte do adresáře, který obsahuje váš soubor projektu.

  2. Pomocí následujícího příkazu nainstalujte balíček NuGet:

    dotnet add package <PACKAGE_NAME>

    Například k instalaci Newtonsoft.Json balíčku použijte následující příkaz.

    dotnet add package Newtonsoft.Json

  3. Po dokončení příkazu můžete otevřít soubor projektu a zobrazit odkaz na balíček.

    Otevřete například soubor .csproj a zobrazte přidaný Newtonsoft.Json odkaz na balíček:

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

Instalace konkrétní verze balíčku

Příkaz dotnet add package nainstaluje nejnovější verzi balíčku, pokud nezadáte jinou verzi.

Pokud chcete nainstalovat konkrétní verzi balíčku NuGet, použijte volitelný -v nebo --version přepínač:

dotnet add package <PACKAGE_NAME> -v <VERSION>

Pokud chcete například přidat balíček verze 12.0.1 Newtonsoft.Json , použijte tento příkaz:

dotnet add package Newtonsoft.Json --version 12.0.1

Výpis odkazů na balíčky

Pomocí příkazu balíčku dotnet list vypíšete odkazy na balíčky a verze pro váš projekt:

dotnet list package

Odebrání balíčku

Pomocí příkazu dotnet remove package odeberte odkaz na balíček ze souboru projektu.

dotnet remove package <PACKAGE_NAME>

Pokud například chcete balíček odebrat Newtonsoft.Json , použijte následující příkaz:

dotnet remove package Newtonsoft.Json

Obnovení balíčků

Příkaz dotnet restore obnoví balíčky, které soubor projektu obsahuje <PackageReference>. Další informace naleznete v tématu PackageReference v souborech projektu.

Balíčky pro obnovení .NET Core 2.0 a novějších a novějších dotnet build a dotnet run příkazy se automaticky obnovují. Od NuGetu 4.0 dotnet restore spustí stejný kód jako nuget restore.

Obnovení balíčku pomocí dotnet restore:

  1. Otevřete příkazový řádek a přepněte do adresáře, který obsahuje váš soubor projektu.
  2. Spusťte dotnet restore.

Další kroky