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

Vytvář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 soukromé Galerie v rámci vaší organizace.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 určité 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 taky sloužit pouze stáhnout libovolný počet dalších závislosti bez obsahující všechny vlastní 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 dodat sadu 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 může obsahovat pouze symbol (.pdb) souborů a usnadňuje ladění.In other cases, a package may contain only symbol (.pdb) files to aid debugging.

Poznámka

Když vytvoříte balíček pro použití jinými vývojáři, je důležité si uvědomit, že jejich trvá závislost na vaši 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. Jako takový vytváření a publikování balíčku také znamená závazek oprava chyby a provedení jiné aktualizace, nebo na velmi alespoň využívajícího otevřít balíčku k dispozici jako zdroj, ostatní může pomoci 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.

Ať tak, vytváření balíčku začíná při rozhodování o tom, které sestavení a dalších souborů do balíčku.Whatever the case, creating a package begins with deciding which assemblies and other files to package. Pak vytvořte soubor manifestu, označuje jako .nuspec souboru k popisu obsah balíčku společně s jeho identifikátoru, číslo verze, informace o autorských právech, MSBuild props a cílů a mnoho dalšího.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 v příslušné složky a vytvořili odpovídající .nuspec soubor, pak použijete nuget pack příkaz (nebo MSBuild pack cíl) všechno dávat dohromady 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 budete připraveni k nasazení balíčku na jakémkoli hostitele je k dispozici jiný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 se .nupkg rozšíření je jednoduše soubor ZIP.A NuGet package with the .nupkg extension is simply a ZIP file. Snadno zjistit jakékoli balíčku obsahu, změňte příponu na .zip a rozbalte 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 na .nupkg před pokusem o nahrajte ho do hostitele.Just be sure to change the extension back to .nupkg before attempting to upload it to a host.

Další informace a pochopit procesu vytváření, začínat vytvář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 několik 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é rozhraní popisuje, jak vytvořit balíček s více variant pro různé rozhraní .NET Framework.Supporting Multiple Target Frameworks describes how to create a package with multiple variants for different .NET Frameworks.
  • Vytvoření lokalizovaných balíčků popisuje postup struktury balíček s více prostředky jazyk a jak používat samostatné lokalizované satelitní balíčky.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ří se chtějí.Pre-release Packages demonstrates how to release alpha, beta, and rc packages to those customers who are interested.
  • Zdroj a konfiguračním souboru transformace popisuje, jak můžete provést i jednosměrný tokenu nahrazení v souborech, které jsou přidány do projektu a upravit web.config a app.config s nastavením, které jsou také vyřadit 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 své knihovny, které umožňují příjemcům kroku do kódu při ladění.Symbol Packages offers guidance for supplying symbols for your library that allow consumers to step into your code while debugging.
  • Správa verzí balíčku popisuje, jak určit přesné verze, které umožňují pro svoje závislosti (další balíčky, které spotřebujete 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 vytváření balíčku pro spotřebitele C++.Native Packages describes the process for creating a package for C++ consumers.
  • Podepisování balíčků popisuje postup pro přidání digitální podpis balíčku.Signing Packages describes the process for adding a digital signature to a package.

Pokud pak budete připraveni k publikování balíčku do nuget.org, postupujte podle jednoduchý proces 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žívat privátní informačního kanálu místo nuget.org, najdete v článku hostování Přehled balíčkůIf you want to use a private feed instead of nuget.org, see the Hosting Packages Overview