Validator manifesta spletne aplikacije

Progresivna spletna aplikacija se čisto namesti le, če njen manifest.json izpolnjuje polja, ki jih brskalniki in trgovine z aplikacijami dejansko preverjajo. Ta validator razčleni vaš naloženi manifest in ga polje za poljem pregleda glede na specifikacijo W3C Web App Manifest: označi manjkajoča name in short_name, prazno ali nepravilno oblikovano polje icons, ikone brez src, sizes ali type, nerazčlenljiv start_url, neprepoznano vrednost display ter nize theme_color ali background_color, ki niso veljavne barve CSS. Vsaka ugotovitev je prikazana kot preprosto razumljiv stavek – ne le surov sklic na specifikacijo – tako da natančno veste, kaj popraviti in zakaj je to pomembno za možnost namestitve.

Ključna funkcija je predogled varnostnega območja prilagodljivih ikon. Androidove prilagodljive ikone uporabijo obliko maske, ki jo izbere OS – krog, zaobljen kvadrat, solzo in druge – za vsako ikono, označeno s "purpose": "maskable". Vse, kar je zunaj središčnega kroga, ki pokriva 40 % vidnega polja ikone, je lahko obrezano, odvisno od maske, ki jo uporabi naprava. Poleg datoteke manifest.json naložite še slikovne datoteke ikon, na katere se manifest sklicuje, in to orodje jih poveže po imenu datoteke, vsako prilagodljivo ikono izriše na platnu v njeni deklarirani velikosti ter prekrije s tistim natančnim varnostnim krogom, tako da lahko na lastne oči vidite, ali bo vaša umetnina preživela obrezovanje.

Značka uspešno/neuspešno pod vsakim predogledom ni le kozmetična postavka s seznama – izhaja iz dejanske analize vsake slikovne pike dekodiranih podatkov slike. Orodje izmeri, koliko vsebine, ki ni ozadje, se nahaja zunaj kroga varnega območja (vsebina, ki bi jo maska obrezala) in kolikšen del ikone je prosojen (prilagodljive ikone morajo imeti popolnoma prekrivno neprosojno ozadje, saj prosojnost omogoča, da se skozi vidi barva maske). Obe preverjanji se izvedeta na dejanski bitni sliki, ki ste jo naložili, tako da rezultat odraža vašo resnično datoteko ikone, ne pa ugibanja.

Vse poteka lokalno v vašem brskalniku: manifest.json se prebere z API-jem File, ikone se dekodirajo s createImageBitmap ali nadomestnim postopkom FileReader/Image, slikovne pike pa se analizirajo na platnu v pomnilniku. Nič se ne naloži na strežnik, kar je pomembno, če vaš manifest vsebuje še ne javno ime aplikacije, notranje poti start_url ali ikone v razvoju.