Spotřeba zabalit pracovní postupPackage consumption workflow

Mezi nuget.org a privátní balíček galerie, které vaše organizace může vytvořit najdete desítky tisíc balíčků velmi užitečné pro použití ve vašich aplikacích a službách.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 zdroj, spotřebovává balíček následuje stejný obecný pracovní postup.But regardless of the source, consuming a package follows the same general workflow.

Tok přejdete ke zdroji balíčku, vyhledání balíčku, instalace v projektu a přidání pomocí příkazu a volání rozhraní API balíčku

* Visual Studio a dotnet.exe pouze. nuget install Příkaz neprovede žádné změny soubory projektu nebo packages.config soubor; položky se musí spravovat ručně.* Visual Studio and dotnet.exe only. The nuget install command does not modify project files or the packages.config file; entries must be managed manually.

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

NuGet si pamatuje identity a verze počet každý nainstalovaný balíček nahrávání 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. Nuget 4.0 +, PackageReference upřednostňována, i když je to možnost konfigurace 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 souboru příslušné kdykoli chcete zobrazit úplný seznam závislostí 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é vždy zkontrolujte licence 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, můžete najít informace o licenci 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 nejsou zadány licenční podmínky, obraťte se přímo pomocí vlastníka balíčku 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í, od poskytovatelů třetích stran balíček a neodpovídá za informace, které jsou poskytovány třetími stranami.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, jestli tento balíček již k dispozici uloženou v mezipaměti.When installing packages, NuGet typically checks if the package is already available from its cache. Můžete ručně vymazat tuto mezipaměť z příkazového řádku, jak je popsáno na Správa globálních balíčků a složek 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 vaším projektem cílových platforem podporovaných 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í, NuGet zobrazí chybu.If the package does not contain compatible assemblies, NuGet displays an error. Zobrazit řešení chyb nekompatibilní balíček.See Resolving incompatible package errors.

Při přidávání projektu kódu do úložiště zdrojového kódu, obvykle neobsahuje balíčky NuGet.When adding project code to a source repository, you typically don't include NuGet packages. Uživatele, kteří později naklonujte úložiště nebo jinak získají projektu, včetně agentů sestavení na systémech, jako je Visual Studio Team Services, musíte obnovit potřebné balíčky 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:

Obnovují se balíčky NuGet tak, že klonování úložiště a pomocí příkazu restore tok

Obnovení balíčků používá informace v souboru projektu nebo packages.config přeinstalovat 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 existují rozdíly v procesu používané, 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 výše uvedeném diagramu nezobrazí příkaz restore pro konzolu Správce balíčků proto, že jste s konzolou jste již v rámci sady Visual Studio, která obvykle automaticky obnoví balíčky a poskytuje řešení úrovni příkaz, jak je znázorněno .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 potřeba znovu nainstaluje balíčky, které už jsou obsažené v projektu, který může také znovu nainstalovat závislosti.Occasionally it's necessary to reinstall packages that are already included in a project, which may also reinstall dependencies. Je to snadné dosáhnout pomocí nuget reinstall příkaz nebo konzoly 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 aktualizace balíčků.For details, see Reinstalling and Updating Packages.

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

Užijte si produktivní psaní kódu s balíčky NuGet.Enjoy your productive coding with NuGet packages!