Pracovní postup spotřeby balíčků

  • Článek

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

Flow of going to a package source, finding a package, installing it in a project, then adding a using statement and calls to the package API

* Visual Studio a dotnet.exe pouze. 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 volba 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 NuGet. U NuGet 4.0 nebo novější se preferuje PackageReference, i když je to možné konfigurovat v Visual Studio prostřednictvím uživatelského rozhraní Správce balíčků. V každém případě se můžete kdykoli podívat do příslušného souboru a zobrazit úplný seznam závislostí pro váš projekt.

Tip

Je rozumné 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 s informacemi o licenci na pravé straně stránky popisu každého balíčku. Pokud balíček nezadá 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 neodpovídá za informace poskytované 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í chyb nekompatibilního balíčku.

Při přidávání kódu projektu do zdrojového úložiště obvykle nezahrnuje NuGet balíčky. 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:

Flow of restoring NuGet packages by cloning a repository and using either a restore command

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 tématu Řešení závislostí. Výše uvedený diagram také nezobrazuje příkaz pro obnovení konzoly Správce balíčků, protože pokud jste s konzolou, kterou už používáte v kontextu Visual Studio, který obvykle automaticky obnovuje balíčky a poskytuje příkaz na úrovni řešení, jak je znázorněno.

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

Nakonec NuGet chování řídí 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

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

Nástroj Platformy Popis
dotnet CLI Vše 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 na soubor projektu. Načte a nainstaluje také závislosti.
Visual Studio Windows a Mac Poskytuje uživatelské rozhraní, prostřednictvím 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á odkazy na nainstalované balíčky do souboru projektu.
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. Načte a nainstaluje také závislosti.
nuget.exe CLI Vše Nástroj rozhraní příkazového řádku pro knihovny .NET Framework a projekty bez 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.