Správa balíčků pomocí rozhraní příkazového řádku NuGet. exeManage packages using the nuget.exe CLI

Nástroj rozhraní příkazového řádku umožňuje snadno aktualizovat a obnovovat balíčky NuGet v projektech a řešeních.The CLI tool allows you to easily update and restore NuGet packages in projects and solutions. Tento nástroj poskytuje všechny funkce NuGet ve Windows a poskytuje i většinu funkcí v systémech Mac a Linux, když běží v mono.This tool provides all NuGet capabilities on Windows, and also provides most features on Mac and Linux when running under Mono.

Rozhraní nuget.exe příkazového řádku je pro vaše .NET Framework projektů a projektů, které nejsou ve stylu sady SDK (například projekt bez sady SDK, který cílí na .NET Standard knihovny).The nuget.exe CLI is for your .NET Framework project and non-SDK-style projects (for example, a non-SDK style project that targets .NET Standard libraries). Pokud používáte projekt, který není ve stylu sady SDK, který byl migrován do PackageReference, dotnet použijte místo toho příkaz CLI.If you are using a non-SDK-style project that has been migrated to PackageReference, use the dotnet CLI instead. Rozhraní nuget.exe příkazového řádku vyžaduje soubor Packages. config pro odkazy na balíčky.The nuget.exe CLI requires a packages.config file for package references.

Poznámka

Ve většině scénářů doporučujeme migrovat projekty, které nejsou ve stylu sady SDK , packages.config které používají PackageReference, a pak můžete použít rozhraní dotnet příkazového řádku namísto nuget.exe rozhraní příkazového řádku.In most scenarios, we recommend migrating non-SDK-style projects that use packages.config to PackageReference, and then you can use the dotnet CLI instead of the nuget.exe CLI. Migrace není aktuálně k dispozici C++ pro projekty a ASP.NET.Migration is not currently available for C++ and ASP.NET projects.

Tento článek popisuje základní použití pro několik nejběžnějších příkazů rozhraní nuget.exe příkazového řádku.This article shows you basic usage for a few of the most common nuget.exe CLI commands. Pro většinu těchto příkazů nástroj CLI vyhledá soubor projektu v aktuálním adresáři, pokud není v příkazu zadaný soubor projektu.For most of these commands, the CLI tool looks for a project file in the current directory, unless a project file is specified in the command. Úplný seznam příkazů a argumenty, které můžete použít, najdete v referenčních informacích k NuGet. exe CLI.For a complete list of commands and the arguments you may use, see the nuget.exe CLI reference.

PožadavkyPrerequisites

  • Nainstalujte rozhraní nuget.exe příkazového řádku stažením z NuGet.org, uložte tento .exe soubor do vhodné složky a přidejte tuto složku do proměnné prostředí PATH.Install the nuget.exe CLI by downloading it from nuget.org, saving that .exe file to a suitable folder, and adding that folder to your PATH environment variable.

Instalace balíčkuInstall a package

Příkaz install stáhne a nainstaluje balíček do projektu, přičemž použije výchozí nastavení pro aktuální složku pomocí zadaných zdrojů balíčků.The install command downloads and installs a package into a project, defaulting to the current folder, using specified package sources. Nainstalujte nové balíčky do složky Packages v kořenovém adresáři projektu.Install new packages into the packages folder in your project root directory.

Důležité

Příkaz neupraví soubor projektu nebo Packages . config; tímto způsobem je podobný restore jako v tom, že přidává pouze balíčky na disk, ale nemění závislosti projektu. installThe installcommand does not modify a project file or packages.config; in this way it's similar to restore in that it only adds packages to disk but does not change a project's dependencies. Chcete-li přidat závislost, buď přidejte balíček prostřednictvím uživatelského rozhraní nebo konzoly Správce balíčků v aplikaci Visual Studio, nebo upravte soubor Packages. config a install potom restorespusťte nebo.To add a dependency, either add a package through the Package Manager UI or Console in Visual Studio, or modify packages.config and then run either install or restore.

  1. Otevřete příkazový řádek a přejděte do adresáře, který obsahuje soubor projektu.Open a command line and switch to the directory that contains your project file.

  2. K instalaci balíčku NuGet do složky Packages použijte následující příkaz .Use the following command to install a NuGet package to the packages folder.

    nuget install <packageID> -OutputDirectory packages
    

    Chcete-li Newtonsoft.json balíček nainstalovat do složky Packages, použijte následující příkaz:To install the Newtonsoft.json package to the packages folder, use the following command:

    nuget install Newtonsoft.Json -OutputDirectory packages
    

Případně můžete použít následující příkaz k instalaci balíčku NuGet pomocí existujícího packages.config souboru do složky Packages .Alternatively, you can use the following command to install a NuGet package using an existing packages.config file to the packages folder. Tím se balíček nepřidá do závislostí projektu, ale nainstaluje se místně.This does not add the package to your project dependencies, but installs it locally.

nuget install packages.config -OutputDirectory packages

Instalace konkrétní verze balíčkuInstall a specific version of a package

Pokud při použití příkazu install není zadána verze, NuGet nainstaluje nejnovější verzi balíčku.If the version is not specified when you use the install command, NuGet installs the latest version of the package. Můžete také nainstalovat specifickou verzi balíčku NuGet:You can also install a specific version of a Nuget package:

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

Pokud například chcete přidat 12.0.1 Newtonsoft.json verze balíčku, použijte tento příkaz:For example, to add version 12.0.1 of the Newtonsoft.json package, use this command:

nuget install Newtonsoft.Json -Version 12.0.1

Další informace o omezeních a chování installnástroje najdete v tématu instalace balíčku.For more information on the limitations and behavior of install, see Install a package.

Odebrat balíčekRemove a package

Chcete-li odstranit jeden nebo více balíčků, odstraňte balíčky, které chcete odebrat ze složky Packages.To delete one or more packages, delete the packages you want to remove from the packages folder.

Pokud chcete balíčky znovu nainstalovat, použijte restore příkaz nebo. installIf you want to reinstall packages, use the restore or install command.

Výpis balíčkůList packages

Seznam balíčků z daného zdroje můžete zobrazit pomocí příkazu list .You can display a list of packages from a given source using the list command. K omezení vyhledávání použijte možnost.-SourceUse the -Source option to restrict the search.

nuget list -Source <source>

Například vypíšete balíčky ve složce Packages .For example, list packages in the packages folder.

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

Pokud používáte hledaný termín, hledání zahrnuje názvy balíčků, značek a popisů balíčků.If you use a search term, the search includes names of packages, tags, and package descriptions.

nuget list <search term>

Aktualizace jednotlivého balíčkuUpdate an individual package

NuGet nainstaluje nejnovější verzi balíčku, když použijete install příkaz, pokud nezadáte verzi balíčku.NuGet installs the latest version of the package when you use the install command unless you specify the package version.

Aktualizovat všechny balíčkyUpdate all packages

Pomocí příkazu Update aktualizujte všechny balíčky.Use the update command to update all packages. Aktualizuje všechny balíčky v projektu (pomocí packages.config) na nejnovější dostupné verze.Updates all packages in a project (using packages.config) to their latest available versions. Doporučuje se spustit restore před spuštěním update.It is recommended to run restore before running update.

nuget update

Obnovit balíčkyRestore packages

Použijte příkaz Restore , který stáhne a nainstaluje ze složky Packages chybějící balíčky.Use the restore command, which downloads and installs any packages missing from the packages folder.

Pro projekty migrované do PackageReference použijte místo toho nástroj MSBuild-t:Restore k obnovení balíčků.For projects migrated to PackageReference, use msbuild -t:restore to restore packages instead.

restorepřidá pouze balíčky na disk, ale nemění závislosti projektu.restore only adds packages to disk but does not change a project's dependencies. Chcete-li obnovit závislosti projektu packages.config, upravte a pak restore použijte příkaz.To restore project dependencies, modify packages.config, then use the restore command.

Stejně jako u ostatních nuget.exe příkazů CLI otevřete příkazový řádek a přejděte do adresáře, který obsahuje soubor projektu.As with the other nuget.exe CLI commands, first open a command line and switch to the directory that contains your project file.

Postup obnovení balíčku pomocí restore:To restore a package using restore:

nuget restore MySolution.sln

Získat verzi rozhraní příkazového řádkuGet the CLI version

Použijte tento příkaz:Use this command:

nuget help

První řádek ve výstupu pro Help zobrazuje verzi.The first line in the help output shows the version. Chcete-li se vyhnout posunu nahoru, použijte nuget help | more místo toho.To avoid scrolling up, use nuget help | more instead.