10 Jak vydávat verze a changelog?

Pro vydávání verzí používáme nástroj semantic release. Po spuštění příkazu analyzuje commity a jejich typy (viz předchozí kapitola) a na tomto základě vyhodnotí číslo verze, změní ho v package.json, vygeneruje changelog a vše pushne automaticky do gitu, kam zároveň přidá i tag s číslem verze. Pokud v seznamu commitů nebude žádný, co mění verzi, konzole nás upozorní a verzi měnit nebude.

Changelog je strukturovaný seznam úprav, vylepšení a fixů. Obsahuje datum, číslo verze a změny od verze minulé. Obsah changelogu se vygeneruje na základě commit zpráv, jak je popsáno v předchozí kapitole.

Semantic release se spouští manuálně příkazem npm run release. Skutečný release proběhne jen na větvi muni-redesign, v ostatních případech proběhne jen test. Načasování, kdy je vhodné pustit release a kdy je lepší čekat na další chystané změny, je otázkou citu. Většinou, když se nashromáždí více nových featur, nebo když od poslední updatu uplyne určitý časový interval (záleží na projektu). Nejsou stanoveny žádná pevná pravidla.

Potřebujete-li si release zkusit nanečisto a přesvedčit se, že se vygeneruje správně vše co má, můžete použít příkaz npx semantic-release --dry-run.