Verze aplikace (App version)

Příklady z praxe

1. 01

   Nucená aktualizace mobilního klienta

   Backend změní tvar odpovědi u plateb a starší klienti by na ní spadli. Server proto podle hlavičky s verzí klienta rozhodne, zda pustí požadavek dál, nebo vrátí odpověď, po které aplikace zobrazí obrazovku s výzvou k aktualizaci. Hranice se drží v konfiguraci, aby se dala měnit bez nasazení nové verze serveru.

   // Express middleware: minimální podporovaná verze klienta
   const MIN = [2, 4, 0];
   
   app.use((req, res, next) => {
     const v = (req.get('X-App-Version') || '0.0.0')
       .split('.').map(Number);
     const tooOld = v[0] < MIN[0]
       || (v[0] === MIN[0] && v[1] < MIN[1]);
     if (tooOld) {
       return res.status(426).json({ code: 'UPGRADE_REQUIRED' });
     }
     next();
   });

2. 02

   Odvození verze pro Android z jednoho zdroje

   Tým drží verzi jen v package.json a build ji dopočítá. versionName se převezme beze změny, versionCode se složí z čísla běhu pipeline, takže při každém nahrání do Google Play roste. Odpadá tím situace, kdy vývojář zapomene číslo zvýšit a obchod build odmítne až po dvaceti minutách nahrávání.

   def appVersion = new groovy.json.JsonSlurper()
       .parse(file("../package.json")).version
   
   android {
       defaultConfig {
           versionName appVersion
           versionCode (System.getenv("BUILD_NUMBER") ?: "1").toInteger()
       }
   }

Časté omyly

MýtusVerze 1.0 znamená, že produkt je hotový a stabilní.

Ve skutečnostiČíslo 1.0 říká jen to, že vydavatel začal považovat rozhraní za veřejné a bude u něj sledovat zpětnou kompatibilitu. O kvalitě, počtu chyb ani vyzrálosti produktu nevypovídá nic.

MýtusKdyž se změní jen pár řádků, stačí zvýšit poslední číslo.

Ve skutečnostiRozhoduje dopad změny, ne její velikost. Jednořádková úprava, která přejmenuje pole v odpovědi API, je rozbíjející změna a patří do hlavní složky verze, zatímco tisíc řádků refaktoringu bez změny chování může být klidně patch.

MýtusUživatelská verze v obchodě a interní číslo buildu jsou totéž.

Ve skutečnostiGoogle Play i App Store pracují se dvěma údaji: čitelný název verze a interní číslo, které musí monotónně růst. Stejný uživatelský název verze lze nahrát vícekrát, ale jen s novým interním číslem.

Časté dotazy

Jak často by se měla verze aplikace zvyšovat?

Verze aplikace se mění při každém vydání, které se dostane mimo vývojový tým. U mobilních aplikací to bývá jednou za jeden až čtyři týdny, u webových služeb s průběžným nasazováním klidně několikrát denně. Rozumné pravidlo zní, že každý build nahraný do obchodu nebo na produkci má vlastní jednoznačné označení. Frekvence sama o sobě není cíl: důležité je, aby se každé vydání dalo zpětně identifikovat, dohledat v repozitáři a v případě problému vrátit zpět na předchozí známé funkční vydání.

Kdo v týmu rozhoduje o zvýšení hlavního čísla verze?

Rozhodnutí o zvýšení hlavního čísla verze má typicky technický vlastník daného rozhraní, tedy tech lead nebo architekt, ve spolupráci s produktem. Kritérium je technické: existuje změna, po které přestane fungovat dosavadní použití API, formát dat nebo integrace partnera? Marketing občas tlačí na verzi 2.0 kvůli komunikaci velkého redesignu, což je legitimní u aplikace pro koncové uživatele, ale u knihovny nebo veřejného API to mate závislé týmy. U veřejných rozhraní by měl mít poslední slovo technický posudek dopadu.

Co dělat, když už je verze aplikace nahraná v obchodě a obsahuje chybu?

Nahranou verzi aplikace v obchodě obvykle nelze opravit na místě. Postup je zastavit rozšiřování postupného vydávání, pokud běží, a připravit opravné vydání se zvýšenou poslední složkou verze. U Google Play lze u postupného vydávání zastavit distribuci a znovu propagovat předchozí vydání, u App Store se používá odstranění verze z prodeje a rychlé schválení opravy. Serverovou část problému lze často zmírnit okamžitě, například vypnutím dotčené funkce přes feature flag, než se oprava dostane k uživatelům.

Musí mít verze aplikace tři čísla?

Verze aplikace nemusí mít tři čísla, tři složky vyžaduje jen sémantické verzování. V praxi se používá i kalendářní verzování ve tvaru rok.měsíc nebo rok.číslo vydání, jednoduché pořadové číslo buildu, případně kombinace obojího. Volba schématu závisí na tom, co má číslo sdělovat: u knihovny, na kterou navazují jiné týmy, nese hlavní hodnotu informace o zpětné kompatibilitě, u aplikace pro koncové uživatele spíš informace o stáří vydání. Podstatné je držet zvolené schéma konzistentně a zdokumentovat ho.

Zdroje

1. Software versioning(otevře se v novém okně)Wikipedia
2. Git - Tagging(otevře se v novém okně)Git

Související pojmy

• CI/CDCI/CD je sada postupů a automatizací, které průběžně integrují změny kódu, ověřují je testy a připravují nebo provádějí nasazení aplikace. Cílem je zkrátit cestu od commitu k bezpečnému vydání, snížit ruční práci a rychle odhalit chyby v build procesu, konfiguraci nebo samotném kódu.
• RollbackRollback je návrat systému do posledního známého konzistentního stavu poté, co změna selhala nebo způsobila problém. V databázi ruší všechny zápisy rozpracované transakce, v nasazení vrací aplikaci na předchozí verzi. Cílem je odstranit následky neúspěšné operace bez ručního dohledávání toho, co se stihlo změnit.
• ACIDACID je sada čtyř vlastností databázové transakce: atomicity, consistency, isolation a durability. Zaručuje, že skupina zápisů proběhne jako jeden celek, neporuší definovaná pravidla databáze, nebude se nebezpečně míchat s jinými transakcemi a po potvrzení přežije pád systému, například při převodu peněz.
• Adaptive IconAdaptivní ikona je formát ikony aplikace na Androidu, který se místo jedné hotové bitmapy skládá z oddělených vrstev: pozadí a popředí. Systém výsledný tvar sám ořízne podle masky výrobce zařízení a může vrstvy animovat nebo přebarvit. Vývojář tak dodá jeden zdroj a launcher z něj vytvoří kruh, čtverec i squircle.
• Adresa v pamětiAdresa v paměti je číslo, kterým procesor jednoznačně označuje konkrétní buňku operační paměti, obvykle jeden bajt. Program pomocí adresy říká, odkud má data načíst nebo kam je zapsat. Adresy tvoří souvislý číselný rozsah, jehož velikost určuje šířka adresní sběrnice a architektura, typicky 32 nebo 64 bitů.
• AI agentAI agent je softwarový systém, který pomocí modelu umělé inteligence vnímá zadaný kontext, plánuje další kroky a samostatně volá nástroje nebo služby k dosažení cíle. Na rozdíl od jednorázového promptu udržuje stav úlohy, vyhodnocuje výsledky akcí a může opakovat postup, dokud nesplní zadání nebo nenarazí na limit.
• AndroidAndroid je operační systém postavený nad linuxovým jádrem, který vyvíjí Google a otevřeně uvolňuje jako projekt AOSP. Android pohání převážnou většinu chytrých telefonů, dále tablety, televize, hodinky i palubní systémy aut. Aplikace se pro něj píší hlavně v Kotlinu nebo Javě a distribuují přes Google Play i alternativní obchody.
• APIAPI je smluvené rozhraní, přes které spolu dva programy komunikují, aniž by jeden musel znát vnitřní fungování druhého. Definuje, jaké operace lze volat, jaká data se posílají a co se vrátí zpět.