Validering av Web App Manifest

En progressiv web-app lar seg bare installere rent når manifest.json oppfyller feltene som nettlesere og appbutikker faktisk sjekker. Denne validatoren leser den opplastede manifesten din og går gjennom W3C-standarden for Web App Manifest felt for felt: den flagger manglende name og short_name, en tom eller ugyldig icons-array, ikoner som mangler src, sizes eller type, en start_url som ikke lar seg tolke, en ukjent visningsmodus, samt theme_color- eller background_color-verdier som ikke er gyldige CSS-farger. Hvert funn vises som en setning på vanlig norsk – ikke en rå spesifikasjonshenvisning – så du vet nøyaktig hva du må rette og hvorfor det er viktig for installeringsdyktigheten.

Hovedfunksjonen er forhåndsvisningen av den sikre sonen for maskable-ikoner. Androids adaptive-ikoner legger en maskefasong over alle ikoner som har «purpose»: «maskable» – sirkel, avrundet firkant, dråpeform og flere. Alt som befinner seg utenfor en sentrert sirkel som dekker 40 % av ikonets visningsområde, kan bli beskåret avhengig av masken enheten bruker. Last opp ikonfilene manifesten din refererer til sammen med manifest.json, så matcher verktøyet dem etter filnavn, tegner hvert maskable-ikon på et lerret i den deklarerte størrelsen og legger akkurat den sikre sonen over, slik at du med egne øyne kan se om grafikken din overlever beskjæringen.

Bestått/ikke-bestått-merket under hver forhåndsvisning er ikke bare en kosmetisk sjekklisteprikk – det stammer fra ekte pikselanalyse av de avkodede bildedataene. Verktøyet måler hvor mye ikke-bakgrunnsinnhold som befinner seg utenfor den sikre sirkelen (innhold en maske ville klippet bort), og hvor mye av ikonet som er gjennomsiktig (maskable-ikoner bør ha en heldekkende utfyllende bakgrunn, siden gjennomsiktighet slipper maskefargen gjennom). Begge sjekkene kjøres mot det faktiske punktbildet du lastet opp, slik at resultatet gjenspeiler den ekte ikonfilen, ikke en gjetning.

Alt skjer lokalt i nettleseren din: manifest.json leses med File API-et, ikoner avkodes med createImageBitmap eller en FileReader/Image-reserveløsning, og piksler analyseres på et lerret i minnet. Ingenting lastes opp til en server, noe som er viktig hvis manifesten din refererer til et appnavn som ennå ikke er offentlig, interne start_url-stier eller ikoner under utvikling.