Správa balíčků NuGet pomocí rozhraní příkazového řádku NuGet

  • Článek

Pomocí nuget.exe nástroje CLI můžete spravovat balíčky NuGet v projektech a řešeních sady Visual Studio. Tento článek popisuje nejběžnější příkazy rozhraní příkazového řádku NuGet pro správu balíčků NuGet. Všechny tyto příkazy fungují ve Windows a většina funguje na Macu a Linuxu s Mono.

Rozhraní příkazového řádku NuGet běží na projektech .NET Framework a jiných než SDK, například projekty, které nejsou stylem sady SDK, které cílí na knihovny .NET Standard. Příkazy rozhraní příkazového řádku NuGet můžou používat soubor packages.config projektu, který obsahuje odkazy na balíčky. V případě projektů jiných než SDK, které místo packages.config používají PackageReferenceodkazy na balíčky, použijte místo toho rozhraní příkazového řádku dotnet.

Poznámka:

U většiny projektů bez sady SDK, které používají packages.config, je nejlepší migrovat packages.config do PackageReference a pak ke správě balíčků použít rozhraní příkazového řádku dotnet místo rozhraní příkazového řádku NuGet. Nemůžete ale migrovat projekty C++ ani ASP.NET.

U většiny příkazů nástroj Rozhraní příkazového řádku NuGet používá aktuální adresář, pokud v příkazu nezadáte jiné umístění. Pokud chcete spustit příkazy Rozhraní příkazového řádku NuGet, otevřete příkazový řádek a přepněte do adresáře, který obsahuje váš soubor projektu.

Úplný seznam příkazů a jejich argumentů najdete v referenčních informacích k rozhraní příkazového řádku NuGet.

Požadavky

Stáhněte si rozhraní příkazového řádku NuGet z nuget.org. Uložte soubor nuget.exe do vhodného adresáře a ujistěte se, že je adresář v proměnné prostředí PATH.

Poznámka:

Můžete také použít nástroj winget pro Windows nebo Homebrew pro macOS.

Pokud chcete zjistit verzi rozhraní příkazového řádku NuGet, otevřete příkazový řádek a spusťte nuget help, nebo se vyhnete posouvání nahoru, použijte nuget help | more. První řádek ve výstupu nápovědy zobrazuje verzi.

Instalace balíčku

Příkaz pro instalaci rozhraní příkazového řádku NuGet stáhne a nainstaluje zadané balíčky NuGet.

Důležité

Příkaz install neupravuje soubor projektu ani soubor packages.config . Příkazy install a restore příkazy přidávají balíčky pouze na disk, ale nepřidávejte do projektů závislosti. Pokud chcete přidat závislosti projektu, přidejte balíčky prostřednictvím uživatelského rozhraní sady Visual Studio Správce balíčků nebo konzoly Správce balíčků a pak spusťte install nebo restore.

-OutputDirectory Tuto možnost použijte k instalaci balíčků do konkrétního adresáře. Pokud nezadáte výstupní adresář, install použije se aktuální adresář.

nuget install <packageID | configFilePath> -OutputDirectory <outputDirectory>

Pokud například chcete balíček nainstalovat Newtonsoft.json do podadresáře balíčků, použijte následující příkaz:

nuget install Newtonsoft.Json -OutputDirectory packages

Místo zadání balíčku, který se má nainstalovat, můžete zadat existující soubor packages.config v aktuálním nebo jiném adresáři. Příkaz install nainstaluje všechny balíčky uvedené v souboru packages.config .

nuget install packages.config

Následující příkaz například nainstaluje všechny balíčky uvedené v souboru packages.config v podadresáři konfigurace do podadresáře balíčků :

nuget install config\packages.config -OutputDirectory packages

Instalace konkrétní verze balíčku

Příkaz install nainstaluje nejnovější verzi balíčku, pokud nezadáte jinou verzi. Pokud chcete nainstalovat konkrétní verzi balíčku, použijte tuto -Version možnost:

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

Pokud chcete například nainstalovat balíček verze 12.0.1 Newtonsoft.json , použijte:

nuget install Newtonsoft.Json -Version 12.0.1

Výpis balíčků

Pomocí příkazu list zobrazte seznam balíčků nainstalovaných ve složkách balíčků. -Source Pomocí možnosti seznam omezte.

nuget list -Source <source>

Chcete-li například vypsat balíčky v podadresáři balíčků MyProject, použijte:

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

Hledaný termín můžete použít také k vyhledání názvů balíčků, značek nebo popisů:

nuget list <"search term"> -Source <source>

Aktualizace všech balíčků

Pomocí příkazu update aktualizujte všechny balíčky v souboru project packages.config na nejnovější dostupné verze. Před spuštěním updateje nejlepší spustit restore .

nuget update

Odebrání balíčku

Pokud chcete balíček odebrat, odstraňte ho ze složky projektu. K přeinstalaci balíčků použijte restore příkazy nebo install příkazy.

Odstranění balíčků z disku neaktualizuje soubory projektu, packages.config ani NuGet.Config . Nejlepší způsob, jak balíčky odebrat, je prostřednictvím uživatelského rozhraní sady Visual Studio Správce balíčků nebo konzoly Správce balíčků.

Obnovení balíčků

Příkaz pro obnovení rozhraní příkazového řádku NuGet stáhne a nainstaluje všechny chybějící balíčky. Příkaz funguje u projektů, které pro odkazy na balíčky používají PackageReference nebo packages.config.

Podobně jako installpříkaz přidává balíčky pouze na disk, ale neupravuje soubor projektu ani packages.config.restore Pokud chcete přidat závislosti projektu, použijte uživatelské rozhraní nebo konzolu sady Visual Studio Správce balíčků.

Pokud chcete obnovit balíčky, spusťte následující příkaz:

nuget restore <projectPath>

Příkaz restore používá soubor řešení nebo soubor package.config v zadané cestě projektu.

Pokud chcete například obnovit všechny balíčky pro MySolution.sln v aktuálním adresáři, spusťte:

nuget restore MySolution.sln

Poznámka:

Pro projekty, které nepoužívají PackageReferencesadu SDK, použijte k obnovení balíčků příkaz msbuild -t:restore .

Další informace naleznete v tématu Obnovení balíčků.

Další kroky