Pracovní postup spotřeba balíčkuPackage consumption workflow

Mezi nuget.org a privátní balíček galerie, které vaše organizace může vytvořit můžete najít desetitisíce velmi užitečné balíčků pro použití v aplikace a služby.Between nuget.org and private package galleries that your organization might establish, you can find tens of thousands of highly useful packages to use in your apps and services. Ale bez ohledu na zdroje, využívání balíček následuje stejné obecný postup.But regardless of the source, consuming a package follows the same general workflow.

Tok přejdete ke zdroji balíčku, hledání balíček, nainstalujte ho v projektu a pak přidání pomocí příkazu a volání rozhraní API balíčku

* Visual Studio a dotnet.ex' pouze. Příkaz instalace nuget neupravuje soubory projektu a packages.config; položky musí být spravovaný ručně.* Visual Studio and dotnet.ex` only. The nuget install command does not modify project files or packages.config; entries must be managed manually.

Další podrobnosti najdete v tématu vyhledání a výběr balíčky a různé způsoby, jak nainstalovat balíček NuGet.For further details, see Finding and Choosing Packages and Different ways to install a NuGet package.

NuGet pamatuje číslo identity a verze jednotlivých balíčků nainstalovaných záznam buď packages.config nebo soubor projektu (pomocí PackageReference), v závislosti na typu projektu a verze balíčku NuGet.NuGet remembers the identity and version number of each installed package, recording it in either packages.config or the project file (using PackageReference), depending on project type and your version of NuGet. U balíčku NuGet 4.0 +, je preferovaná, PackageReference, i když to lze nakonfigurovat v sadě Visual Studio prostřednictvím možnosti uživatelského rozhraní Správce balíčků.With NuGet 4.0+, PackageReference is preferred, although this is configurable in Visual Studio through the Package Manager UI options. V každém případě můžete prohlédnout v příslušné souboru vždy, když chcete zobrazit úplný seznam závislosti pro váš projekt.In any case, you can look in the appropriate file at any time to see the full list of dependencies for your project.

Tip

Je vhodné si vždycky prohlédněte licenci pro každý balíček, který chcete používat váš software.It's prudent to always check the license for each package you intend to use in your software. Na nuget.org, Najít licenční informace odkaz na pravé straně stránky popis každého balíčku.On nuget.org, you find a License Info link on the right side of each package's description page. Pokud balíček neurčuje licenční podmínky, obraťte se na vlastníka balíčku přímo pomocí obraťte se na vlastníky odkaz na stránce balíček.If a package does not specify license terms, contact the package owner directly using the Contact owners link on the package page. Společnost Microsoft není licence duševního vlastnictví vám ze zprostředkovatelů balíček třetích stran a není zodpovědná za informace třetích stran.Microsoft does not license any intellectual property to you from third party package providers and is not responsible for information provided by third parties.

Při instalaci balíčků, NuGet obvykle zkontroluje, zda balíček je již k dispozici, ze své mezipaměti.When installing packages, NuGet typically checks if the package is already available from its cache. Tato mezipaměť z příkazového řádku, můžete ručně vymazat, jak je popsáno na správy globální balíčky a složky mezipaměti.You can manually clear this cache from the command line, as described on Managing the global packages and cache folders.

NuGet také zajišťuje, že jsou kompatibilní s projektu cílové rozhraní nepodporuje balíček.NuGet also makes sure that the target frameworks supported by the package are compatible with your project. Pokud balíček neobsahuje kompatibilní sestavení, zobrazí se NuGet k chybě.If the package does not contain compatible assemblies, NuGet displays an error. V tématu řešení chyb při nekompatibilní balíček.See Resolving incompatible package errors.

Při přidávání kód projektu do zdrojové úložiště, obvykle nejsou zahrnuty balíčky NuGet.When adding project code to a source repository, you typically don't include NuGet packages. Uživatelům, kteří později klonovat úložiště nebo jinak získat projektu, včetně agenty sestavení v systémech například Visual Studio Team Services, musíte obnovit nezbytných balíčků před spuštěním sestavení:Those who later clone the repository or otherwise acquire the project, including build agents on systems like Visual Studio Team Services, must restore the necessary packages prior to running a build:

Tok klonování úložiště a pomocí příkazu restore Probíhá obnovení balíčků NuGet

Obnovení balíčků používá informace v souboru projektu nebo packages.config znovu nainstalovat všechny závislosti.Package Restore uses the information in the project file or packages.config to reinstall all dependencies. Všimněte si, že jsou rozdíly v procesu související se situací, jak je popsáno v řešení závislostí.Note that there are differences in the process involved, as described in Dependency Resolution. Navíc diagramu výše nezobrazuje příkazu restore pro konzolu Správce balíčků proto, že jste s konzolou jste již v kontextu sady Visual Studio, která obvykle automaticky obnoví balíčky a obsahuje příkaz úrovni řešení, jak je vidět .Also, the diagram above does not show a restore command for the Package Manager Console because you're with the Console you're already in the context of Visual Studio, which typically restores packages automatically and provides the solution-level command as shown.

Někdy je nutné znovu nainstalovat balíčky, které jsou již zahrnuty v projektu, který může přeinstalovat také závislosti.Occasionally it's necessary to reinstall packages that are already included in a project, which may also reinstall dependencies. Toto je snadné provést pomocí nuget reinstall příkaz nebo konzole Správce balíčků NuGet.This is easy to do using the nuget reinstall command or the NuGet Package Manager Console. Podrobnosti najdete v tématu Reinstalling a balíčky, aktualizace.For details, see Reinstalling and Updating Packages.

Nakonec se řídí chování NuGet Nuget.Config soubory.Finally, NuGet's behavior is driven by Nuget.Config files. Více souborů umožňují centralizovat určitých nastavení na různých úrovních, jak je popsáno v konfigurace chování NuGet.Multiple files can be used to centralize certain settings at different levels, as explained in Configuring NuGet Behavior.

Užijte si ji produktivní kódování se balíčky NuGet!Enjoy your productive coding with NuGet packages!