11 Jak upgradovat/porovnávat verze a zjistit změny

Porovnávání změn

Nejspolehlivější způsob, jak si zobrazit změny mezi dvěma verzemi je přímo v GitLab repozitáři. V boční navigaci je položka Repository a v ní Compare. Zde je možné ve dvou select boxech vybrat verze k porovnání. GitLab poté zobrazí seznam commitů i přehled souborů se zvýrazněnými změnami.

V poli Source zvolte novou verzi, na kterou se chystáte provést upgrate. Pole Target vyplňte podle toho, jakou máte dosavadní verzi:

  • používáte-li už SEMVER, tak tag korespondující s vaší aktuální verzí. Číslo verze je v package.json ve zdrojových souborech pod klíčem version (většinou bývá na jednom z prvních řádků),
  • vychází-li váš kod z doby před zavedením SEMVERu (package.json obsahuje č verze 0.1.0), zadejte číslo posledního commitu, který je implementovaný do vašeho kódu, např. 41780915
    • Poté klepněte na zelené tlačítko Compare. Vygenerování stránky může trvat, pokud jsou verze vzdálené a obsahují hodně změn. Výsledek bude vypadat zhruba takto. Po vykreslení uvidíte seznam všech rozdílů, které nastaly. Ty, které se týkají markupu je potřeba zaimplementovat i do vašich redakčních systémů.

Implementace změn

Dalším způsobem, jak si zobrazit změny je pomocí changelogu. Ten je však dostupný jen pro novější verze, které využívají SEMVER. Changelog obsahuje seznam těch změn, které je potřeba převést (např. změny markupu) nebo se projeví u koncového uživatele (CSS). Ostatní změny týkající se zejména devstacku (úpravy buildu šablon, dokumentace, formátování kódu atp.) zahrnuty nejsou. Existuje však riziko, že commit bude špatně zařazen, pokud vývojář zvolí nevhodný příznak v commit message.