Pracovní postup vytvoření balíčku

Vytvoření balíčku začíná kompilovaným kódem (obvykle sestavení .NET), která chcete zabalit a sdílet s ostatními, a to buď prostřednictvím veřejné galerie nuget.org, nebo privátní galerie ve vaší organizaci. Balíček může také obsahovat další soubory, například soubor readme, který se zobrazí při instalaci balíčku, a může obsahovat transformace na určité soubory projektu.

Balíček může sloužit také k načtení libovolného počtu dalších závislostí, aniž by obsahoval vlastní kód. Takový balíček představuje pohodlný způsob, jak doručovat sadu SDK, která se skládá z několika nezávislých balíčků. V jiných případech může balíček obsahovat pouze soubory se symboly (.pdb) pro účely ladění.

Poznámka:

Když vytvoříte balíček pro použití jinými vývojáři, je důležité si uvědomit, že jsou závislí na vaší práci. Vytvoření a publikování balíčku také znamená závazek opravit chyby a provádět další aktualizace nebo přinejmenším zpřístupnit balíček jako open source, aby ho ostatní mohli udržovat.

Bez ohledu na případ, vytvoření balíčku začíná zkontrolováním jeho identifikátoru, čísla verze, licence, údajů o autorských právech a veškerého dalšího nezbytného obsahu. Po dokončení můžete pomocí příkazu "pack" všechno spojit do .nupkg souboru. Tento soubor lze publikovat do informačního kanálu NuGet, jako je nuget.org.

Návod

Balíček NuGet s příponou .nupkg je jednoduše soubor ZIP. Pokud chcete snadno prozkoumat obsah libovolného balíčku, změňte rozšíření .zip na jeho obsah a rozbalte ho obvyklým způsobem. Ujistěte se, že před pokusem o nahrání na hostitele změníte příponu zpět na .nupkg.

Pokud se chcete naučit a porozumět procesu vytváření, začněte vytvořením balíčku , který vás provede základními procesy běžnými pro všechny balíčky.

Tady můžete zvážit řadu dalších možností balíčku:

• Podpora více cílových architektur popisuje, jak vytvořit balíček s více variantami pro různé rozhraní .NET Framework.
• Vytváření lokalizovaných balíčků popisuje, jak strukturovat balíček s více jazykovými prostředky a jak používat samostatné lokalizované satelitní balíčky.
• Předběžné verze balíčků ukazuje, jak vydávat alfa, beta a rc balíčky pro ty zákazníky, kteří mají zájem.
• Transformace zdrojového a konfiguračního souboru popisují, jak můžete v souborech, které jsou přidány do projektu, provádět jednosměrné nahrazení tokenů, a upravit web.config a app.config s nastavením, která jsou také vrácená při odinstalaci balíčku.
• Balíčky symbolů nabízejí pokyny k poskytování symbolů pro vaši knihovnu, které uživatelům umožňují vstupovat do vaší knihovny při ladění.
• Správa verzí balíčků popisuje, jak identifikovat přesné verze, které dovolujete pro své závislosti (jiné balíčky, které váš balíček využívá).
• Nativní balíčky popisují proces vytvoření balíčku pro uživatele jazyka C++.
• Podpisové balíčky popisují proces přidání digitálního podpisu do balíčku.

Až budete připraveni publikovat balíček do nuget.org, postupujte podle jednoduchého postupu v části Publikovat balíček.

Pokud chcete místo nuget.org použít privátní informační kanál, podívejte se na přehled hostitelských balíčků.