Pracovní postup vytvoření balíčkuPackage creation workflow

Vytvoření balíčku začíná zkompilovaný kód (obvykle sestavení .NET), které chcete balíček a sdílet s ostatními, buď prostřednictvím Galerie nuget.org veřejné nebo privátní Galerie ve vaší organizaci.Creating a package starts with the compiled code (typically .NET assemblies) that you want to package and share with others, either through the public nuget.org gallery or a private gallery within your organization. Balíček může zahrnovat také další soubory, jako je například soubor readme, který se zobrazí, když je balíček nainstalován a může obsahovat transformací pro některé soubory projektu.The package can also include additional files such as a readme that is displayed when the package is installed, and can include transformations to certain project files.

Balíček může také sloužit k pouze o přijetí změn v jakémkoli počtu Další závislosti, bez nadřazeného libovolný kód.A package can also serve to only pull in any number of other dependencies, without containing any code of its own. Takový balíček je pohodlný způsob, jak poskytovat sady SDK, která se skládá z více nezávislých balíčků.Such a package is a convenient way to deliver an SDK that's composed of multiple independent packages. V ostatních případech balíček smí obsahovat pouze znak (.pdb) soubory pro usnadnění ladění.In other cases, a package may contain only symbol (.pdb) files to aid debugging.

Poznámka

Při vytváření balíčku pro použití pro jiné vývojáře, je důležité pochopit, že se tak závislosti na svoji práci.When you create a package for use by other developers, it's important to understand that they are taking a dependency on your work. V důsledku toho vytváření a publikování balíčku také znamená závazkem oprava chyb a provádění dalších aktualizací nebo na velmi nejméně provedete k dispozici jako balíček opensourcových ostatní mohli pomoct k její údržbě.As such, creating and publishing a package also implies a commitment to fixing bugs and making other updates, or at the very least making the package available as open source so others can help to maintain it.

Bez ohledu případ, vytvoření balíčku začíná rozhodování o tom, která sestavení a další soubory balíčku.Whatever the case, creating a package begins with deciding which assemblies and other files to package. Vytvořte soubor manifestu, označuje jako .nuspec souboru k popisu obsah balíčku společně s jeho identifikátor, číslo verze, informace o autorských právech, vlastnosti nástroje MSBuild a cíle a spoustu dalších věcí.You then create a manifest file, referred to as a .nuspec file, to describe the package's contents along with its identifier, version number, copyright information, MSBuild props and targets, and much more.

Když jste připravili všechny potřebné soubory do příslušných složek a vytvořili odpovídající .nuspec soubor, pak použijete nuget pack příkazu (nebo cíl nástroje MSBuild pack) sestavit vše, co do .nupkg souboru.When you've prepared all the necessary files in the appropriate folders and have created the appropriate .nuspec file, you then use the nuget pack command (or the MSBuild pack target) to put everything together into a .nupkg file. Pak jste připraveni nasadit balíček do libovolné hostitele zpřístupňuje je s ostatními vývojáři.You're then ready to deploy the package to whatever host makes it available to other developers.

Tip

Balíček NuGet s .nupkg rozšíření je soubor ZIP.A NuGet package with the .nupkg extension is simply a ZIP file. Chcete-li snadněji zkontrolovat všechny balíčky obsahu, změňte příponu na .zip a rozbalte svůj obsah jako obvykle.To easily examine any package's contents, change the extension to .zip and expand its contents as usual. Jenom nezapomeňte změnit rozšíření zpět .nupkg před pokusem o jeho nahrání do hostitele.Just be sure to change the extension back to .nupkg before attempting to upload it to a host.

Další informace a pochopení proces vytváření, začněte s vytvoření balíčku který vás provede klíčové procesy, které jsou společné pro všechny balíčky.To learn and understand the creation process, start with Creating a package which guides you through the core processes common to all packages.

Odtud můžete zvážit řadu dalších možností pro svůj balíček:From there, you can consider a number of other options for your package:

  • Podpora více cílových platforem popisuje, jak vytvořit balíček s více variantami různá rozhraní .NET.Supporting Multiple Target Frameworks describes how to create a package with multiple variants for different .NET Frameworks.
  • Vytvoření lokalizovaných balíčků popisuje strukturu balíček s více prostředků jazyka a použití samostatné lokalizované satelitní balíčků.Creating Localized Packages describes how to structure a package with multiple language resources and how to use separate localized satellite packages.
  • Předběžné verze balíčků ukazuje, jak k uvolnění alpha, beta a rc balíčky pro zákazníky, kteří chtějí.Pre-release Packages demonstrates how to release alpha, beta, and rc packages to those customers who are interested.
  • Zdroj a transformace souboru Config popisuje, jak obě jednosměrné token nahrazení v souborech, které jsou přidány do projektu a upravte web.config a app.config s nastaveními, která se také vztahuje si při odinstalaci balíčku .Source and Config File Transformations describes how you can do both one-way token replacements in files that are added to a project, and modify web.config and app.config with settings that are also backed out when the package is uninstalled.
  • Symbol balíčky nabízí pokyny k zadávání symboly pro knihovny, které umožňují uživatelům Krokovat s vnořením kód během ladění.Symbol Packages offers guidance for supplying symbols for your library that allow consumers to step into your code while debugging.
  • Balíček správy verzí popisuje, jak určit přesné verze, které umožňují závislostí (další balíčky, které využívají ze svého balíčku).Package versioning discusses how to identify the exact versions that you allow for your dependencies (other packages that you consume from your package).
  • Nativní balíčky popisuje proces pro vytvoření balíčku pro spotřebitele C++.Native Packages describes the process for creating a package for C++ consumers.
  • Podepisují se balíčky popisuje proces pro přidávání digitálního podpisu balíčku.Signing Packages describes the process for adding a digital signature to a package.

Pokud pak budete připraveni publikovat balíček na nuget.org, postupujte podle jednoduchých kroků v publikování balíčku.When you're then ready to publish a package to nuget.org, follow the simple process in Publish a package.

Pokud chcete použít privátní kanál namísto nuget.org, přečtěte si článek přehled hostování balíčkůIf you want to use a private feed instead of nuget.org, see the Hosting Packages Overview