Sdílet prostřednictvím

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

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 projektech v ne-SDK stylu, například projekty cílící na knihovny .NET Standard. Příkazy rozhraní příkazového řádku NuGet můžou použít soubor projektu packages.config, který obsahuje odkazy na balíčky. U projektů, které nejsou ve stylu SDK a používají místo packages.config pro odkazy na balíčky, místo toho použijte dotnet CLI.

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 packages.config soubor. Příkazy install a restore přidávají balíčky pouze na disk, ale nepřidávají do projektů závislosti. Pokud chcete přidat závislosti projektu, přidejte balíčky prostřednictvím uživatelského rozhraní Správce balíčků sady Visual Studio 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í packages.config soubor v aktuálním nebo jiném adresáři. Příkaz install nainstaluje všechny balíčky uvedené v souborupackages.config .

nuget install packages.config

Následující příkaz například nainstaluje všechny balíčky uvedené v 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 packages projektu 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 projektu packages.config soubor na nejnovější dostupné verze. Je nejlepší spustit restore před spuštěním update.

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 projekt, packages.configani soubory NuGet.Config . Nejlepší způsob, jak odebrat balíčky, je prostřednictvím uživatelského rozhraní správce balíčků sady Visual Studio 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 na projektech, které používají PackageReference nebo packages.config pro odkazy na balíčky.

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

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

  • Last updated on