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 to, že vytvoření balíčku začíná rozhodováním o jeho identifikátoru, čísle verze, licenci, informace o autorských právech a veškerým dalším nezbytným obsahem. 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.
Tip
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. Než se ho pokusíte nahrát na hostitele, nezapomeňte rozšíření změnit zpátky .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 jednorázové nahrazení tokenů, a upravovat a
app.config
sweb.config
nastavením, která jsou také zálohovaná 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í krokovat se svým kódem při ladění.
- Správa verzí balíčků popisuje, jak identifikovat přesné verze, které umožňují vaše závislosti (jiné balíčky, které využíváte z balíčku).
- 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ů.