Manifest webovej aplikácie sa často predáva ako magický súbor, ktorý z obyčajnej stránky spraví aplikáciu. Realita je triezvejšia. Manifest je JSON dokument, ktorý prehliadaču povie, ako má vašu progresívnu webovú aplikáciu zobraziť na ploche, akú ikonu použiť a aký splash screen ukázať pri spustení. Nič viac, nič menej. Ak čakáte, že samotný manifest nahradí natívny softvér, budete sklamaní. Ak ale chcete, aby sa vaša PWA správala ako aplikácia pri inštalácii z prehliadača, manifest je presne to miesto, kde sa to rozhoduje.

Čo manifest reálne robí a čo od neho nečakajte

Manifest je jediný súbor, ktorý definuje názov aplikácie, jej krátky názov pod ikonou, farbu pozadia, farbu témy a spôsob zobrazenia okna. Keď ho prehliadač prečíta, vie, že pri pridaní na plochu nemá vytvoriť obyčajný odkaz na web, ale aplikáciu so samostatným oknom bez adresného riadka. Bez manifestu sa PWA nainštaluje ako záložka. S manifestom sa zobrazí s vlastnou ikonou a splash screenom. To je celý rozdiel a je to rozdiel, ktorý používateľ pocíti okamžite.

Rozšírený mýtus tvrdí, že manifest je potrebný na to, aby aplikácia fungovala offline. Nie je. Offline režim zabezpečuje service worker, teda skript, ktorý beží na pozadí a cachuje zdroje. Manifest s offline fungovaním nemá nič spoločné. Ďalší mýtus hovorí, že manifest nahrádza natívny softvér. Tiež nie. PWA zostáva webovou aplikáciou, ktorá beží v prehliadačovom jadre, len sa inak zobrazuje. Ak potrebujete prístup k hardvérovým funkciám, ktoré web neponúka, manifest vám nepomôže.

Praktický príklad: Goldbet aplikácia je progresívna webová aplikácia a neinštaluje sa cez Google Play ani App Store. Preto manifest nie je formalita, ale podmienka, aby sa vôbec dala pridať na plochu so správnym menom a ikonou. Bez neho by sa používateľovi na ploche objavil len odkaz s predvoleným názvom stránky.

Ako manifest ovplyvňuje inštaláciu na Androide a iOS

Na Androide prehliadač Chrome prečíta manifest a ponúkne inštaláciu vtedy, keď sú splnené podmienky: manifest obsahuje povinné polia, aplikácia má service worker a beží cez HTTPS. Po inštalácii sa na ploche objaví ikona definovaná v manifeste a pri spustení sa zobrazí splash screen s farbou pozadia z manifestu. Toto je jediný spôsob, ako dostať PWA na plochu bez toho, aby ste prešli obchodom s aplikáciami.

Na iOS je situácia odlišná a tu sa láme veľa očakávaní. Safari manifest čiastočne ignoruje a používa vlastné meta značky, napríklad apple-touch-icon a apple-mobile-web-app-capable. Inštalácia prebieha cez tlačidlo Zdieľať a voľbu Pridať na plochu. Výsledok je podobný, ale splash screen a správanie okna sa riadia inými pravidlami. Ak niekto tvrdí, že jeden manifest zaistí identické správanie na oboch platformách, nemá pravdu.

Povinné polia, bez ktorých manifest nefunguje

Manifest musí obsahovať aspoň názov (name), krátky názov (short_name), cestu k ikonám (icons) a počiatočnú adresu (start_url). Prehliadač bez týchto polí inštaláciu neponúkne alebo ju ponúkne v obmedzenej podobe. Pole display určuje, či sa aplikácia otvorí na celú obrazovku (standalone) alebo v okne prehliadača. Farba theme_color ovplyvní lištu stavu, background_color zase splash screen. Ikony musia mať aspoň dve veľkosti, zvyčajne 192 a 512 pixelov, inak Android inštaláciu odmietne.

Pri projektoch ako goldbet-play.sk, ktorý je informačný sprievodca pre slovenských čitateľov, sa manifest často zamieňa s inštalačným súborom APK. To je ďalší mýtus. Goldbet apk neexistuje, pretože ide o PWA a tá sa inštaluje priamo z prehliadača, nie z balíčka na stiahnutie. Žiadny súbor .apk nepotrebujete a žiadne zrkadlo stránky sťahovať nemusíte. Rovnako to neplatí pre kasíno aplikáciu, ktorá beží v prehliadači.

Bezpečnosť, licencie a čo manifest nerieši

Manifest nemá žiadny vplyv na bezpečnosť. Bezpečnosť SSL zabezpečuje HTTPS na strane servera, nie JSON súbor. Podobne manifest nerieši licenciu hazardu ani to, či je prevádzkovateľ zapísaný v registri Úradu pre reguláciu hazardných hier. To sú otázky úplne inej kategórie. Goldbet prevádzkuje Goldkey Technologies Limitada, ktorá je registrovaná v Kostarike a funguje na základe licencie z Anjouanu. Manifest o tom nepovie ani slovo, pretože to nie je jeho úloha.

Pri overovaní dôveryhodnosti si overte doménu, nie manifest. Goldbet.it patrí talianskej firme Intralot a goldbet.com.au je samostatná austrálska stávková kancelária. Sú to iné entity, hoci majú podobné meno. Ak niekto spája goldbet.io s inou prevádzkou, overte si, kto za doménou stojí. Hranie je povolené osobám starším ako 18 rokov a toto pravidlo platí bez ohľadu na to, aký pekný manifest má aplikácia.

Manifest teda nie je nástroj na budovanie dôveryhodnosti ani na obchádzanie obchodov s aplikáciami. Je to technický dokument, ktorý definuje vzhľad a správanie inštalovanej webovej aplikácie. Ak ho nastavíte správne, používateľ uvidí ikonu, splash screen a samostatné okno. Ak ho nenastavíte, dostane obyčajný odkaz. Rozdiel je v detaile, nie v mágii.

Pre začiatočníka je praktický postup jednoduchý. Vytvorte súbor manifest.json v koreňovom adresári, doplňte name, short_name, icons, start_url, display a farby, prepojte ho v HTML cez odkaz rel=“manifest“ a otestujte v prehliadači cez panel Application v DevTools. Ak sa ikona nezobrazí, skontrolujte veľkosti a formát PNG. Ak sa splash screen nezobrazí, skontrolujte background_color a theme_color. A ak niekto tvrdí, že manifest nahradí natívnu aplikáciu, overte si, o akej platforme hovorí. Zvyčajne to bude Android, kde PWA funguje najpredvídateľnejšie.