Validatore Web App Manifest

Una Progressive Web App si installa correttamente solo quando il suo manifest.json soddisfa i campi che browser e store di app effettivamente controllano. Questo validatore analizza il manifest caricato e lo esamina campo per campo secondo la specifica W3C Web App Manifest: segnala la mancanza di nome e nome_breve, un array icone vuoto o malformato, icone prive di src, dimensioni o tipo, un URL_iniziale non interpretabile, un valore di visualizzazione non riconosciuto e stringhe tema_colore o colore_sfondo che non sono colori CSS validi. Ogni riscontro viene mostrato come frase in linguaggio semplice — non un semplice riferimento alla specifica — così sai esattamente cosa correggere e perché è importante per l'installabilità.

La funzionalità distintiva è l'anteprima della zona sicura per icone adattabili. Le icone adattive di Android applicano una forma di maschera scelta dal sistema operativo — cerchio, squircle, goccia e altre — a qualsiasi icona contrassegnata con "purpose": "maskable". Tutto ciò che si trova al di fuori di un cerchio centrato che copre il 40% dell'area visibile dell'icona può essere ritagliato a seconda della maschera applicata dal dispositivo. Carica i file immagine delle icone a cui fa riferimento il tuo manifest insieme al manifest.json e questo strumento li associa per nome file, disegna ogni icona adattabile su un'area di disegno alla sua dimensione dichiarata e sovrappone esattamente quel cerchio di zona sicura, così puoi vedere con i tuoi occhi se la tua grafica sopravvive al ritaglio.

L'indicatore superato/non superato sotto ogni anteprima non è un elemento estetico di una checklist — deriva da un'analisi reale pixel per pixel dei dati decodificati dell'immagine. Lo strumento misura quanto contenuto non di sfondo si trova al di fuori del cerchio della zona sicura (contenuto che una maschera ritaglierebbe) e quanta parte dell'icona è trasparente (le icone adattabili dovrebbero avere uno sfondo opaco a tutto campo, poiché la trasparenza lascia trasparire il colore della maschera sottostante). Entrambe le verifiche vengono eseguite sulla bitmap effettiva che hai caricato, quindi il risultato riflette il tuo file icona reale, non un'ipotesi.

Tutto avviene localmente nel tuo browser: il manifest.json viene letto con l'API File, le icone sono decodificate con createImageBitmap o un fallback FileReader/Image e i pixel sono analizzati su un'area di disegno in memoria. Nulla viene caricato su un server, il che è importante se il tuo manifest fa riferimento a un nome app non ancora pubblico, percorsi URL_iniziale interni o icone in fase di sviluppo.