Pracovní postup využití balíčků

Mezi galeriemi nuget.org a privátních balíčků, které by vaše organizace mohla navázat, najdete desítky tisíc vysoce užitečných balíčků, které můžete používat ve svých aplikacích a službách. Bez ohledu na zdroj se ale použití balíčku řídí stejným obecným pracovním postupem.

* Visual Studio a dotnet.exe jenom. Příkaz nuget install neupravuje soubory projektu ani packages.config soubor. Položky musí být spravovány ručně.

Další podrobnosti najdete v tématu Hledání a výběr balíčků a co se stane, když je balíček nainstalován?.

NuGet si pamatuje identitu a číslo verze každého nainstalovaného balíčku, zaznamenává ho buď v souboru projektu (pomocí PackageReference), nebo packages.configv závislosti na typu projektu a vaší verzi NuGetu. U NuGetu 4.0+ je upřednostňovaná funkce PackageReference, i když je tato možnost v sadě Visual Studio konfigurovatelná prostřednictvím uživatelského rozhraní Správce balíčků. V každém případě můžete v příslušném souboru kdykoli zobrazit úplný seznam závislostí pro váš projekt.

Návod

Je vhodné vždy zkontrolovat licenci pro každý balíček, který máte v úmyslu používat ve svém softwaru. Na nuget.org najdete odkaz Informace o licenci na pravé straně stránky popisu každého balíčku. Pokud balíček nezadává licenční podmínky, obraťte se přímo na vlastníka balíčku pomocí odkazu Kontaktovat vlastníky na stránce balíčku. Společnost Microsoft vám nelicencuje žádné duševní vlastnictví od poskytovatelů balíčků třetích stran a nenese odpovědnost za informace poskytnuté třetími stranami.

Při instalaci balíčků NuGet obvykle kontroluje, jestli je balíček již dostupný z mezipaměti. Tuto mezipaměť můžete ručně vymazat z příkazového řádku, jak je popsáno v tématu Správa globálních balíčků a složek mezipaměti.

NuGet také zajišťuje, aby cílové architektury podporované balíčkem byly kompatibilní s vaším projektem. Pokud balíček neobsahuje kompatibilní sestavení, nuGet zobrazí chybu. Viz Řešení nekompatibilních chyb balíčku.

Při přidávání kódu projektu do zdrojového úložiště obvykle nezahrnujete balíčky NuGet. Ti, kteří později naklonují úložiště nebo jinak získávají projekt, včetně agentů sestavení v systémech, jako je Visual Studio Team Services, musí před spuštěním sestavení obnovit potřebné balíčky:

Obnovení balíčku používá informace v souboru projektu nebo packages.config k přeinstalaci všech závislostí. Všimněte si, že v průběhu procesu existují rozdíly, jak je popsáno v řešení závislostí. Výše uvedený diagram také nezobrazuje příkaz pro obnovení konzoly Správce balíčků, protože pokud už používáte konzolu, kterou už máte v kontextu sady Visual Studio, která obvykle obnovuje balíčky automaticky a poskytuje příkaz na úrovni řešení, jak je znázorněno.

Někdy je nutné přeinstalovat balíčky, které jsou již součástí projektu, což může také přeinstalovat závislosti. To se dá snadno udělat pomocí nuget reinstall příkazu nebo konzoly Správce balíčků NuGet. Podrobnosti najdete v tématu Přeinstalace a aktualizace balíčků.

Chování NuGetu je nakonec řízeno NuGet.Config soubory. K centralizaci určitých nastavení na různých úrovních je možné použít více souborů, jak je vysvětleno v tématu Konfigurace chování NuGet.

Způsoby instalace balíčku NuGet

Balíčky NuGet se stáhnou a nainstalují pomocí některé z metod v následující tabulce.

Tool	Platforms	Description
rozhraní příkazového řádku dotnet	Všechno	Nástroj CLI pro knihovny .NET Core a .NET Standard a projekty ve stylu sady SDK, které cílí na rozhraní .NET Framework (viz atribut sady SDK). Načte balíček identifikovaný <package_name> a přidá odkaz do souboru projektu. Také načte a nainstaluje závislosti.
Visual Studio	Windows a Mac	Poskytuje uživatelské rozhraní, pomocí kterého můžete procházet, vybírat a instalovat balíčky a jejich závislosti do projektu ze zadaného zdroje balíčku. Přidá do souboru projektu odkazy na nainstalované balíčky. Instalace a správa balíčků pomocí sady Visual Studio Zahrnutí balíčku NuGet do projektu (Mac)
Konzola Správce balíčků (Visual Studio)	Jen ve Windows	Načte a nainstaluje balíček identifikovaný <package_name> z vybraného zdroje do zadaného projektu v řešení a pak přidá odkaz na soubor projektu. Také načte a nainstaluje závislosti.
rozhraní příkazového řádkunuget.exe	Všechno	Nástroj rozhraní příkazového řádku pro knihovny rozhraní .NET Framework a projekty, které nejsou stylem sady SDK, které cílí na knihovny .NET Standard. Načte balíček identifikovaný <package_name> a rozbalí jeho obsah do složky v aktuálním adresáři; může také načíst všechny balíčky uvedené v packages.config souboru. Také načte a nainstaluje závislosti, ale neprovádí žádné změny souborů projektu nebo packages.config.