Validateur de manifeste d'application Web

Une application Web progressive ne s'installe proprement que lorsque son fichier manifest.json satisfait aux champs que les navigateurs et les magasins d'applications vérifient réellement. Ce validateur analyse votre manifeste téléchargé et parcourt champ par champ la spécification du manifeste de l'application Web du W3C : il signale un nom et un nom_court manquants, un tableau d'icônes vide ou mal formé, des icônes manquant de src, de tailles ou de type, une URL de démarrage non analysable, une valeur d'affichage non reconnue et des chaînes theme_color ou background_color qui ne sont pas des couleurs CSS valides. Chaque résultat est présenté sous forme de phrase en anglais simple (et non d'une citation brute de spécifications) afin que vous sachiez exactement quoi corriger et pourquoi cela est important pour l'installation.

La fonctionnalité phare est l’aperçu de la zone de sécurité avec icône masquable. Les icônes adaptatives d'Android appliquent une forme de masque choisie par le système d'exploitation (cercle, cercle, larme, etc.) à toute icône marquée « objectif » : « masquable ». Tout ce qui se trouve en dehors d'un cercle centré couvrant 40 % de la fenêtre d'affichage de l'icône peut être coupé en fonction du masque appliqué par l'appareil. Téléchargez les fichiers d'images d'icônes référencés par votre manifeste aux côtés de manifest.json, et cet outil les fait correspondre par nom de fichier, dessine chaque icône masquable sur une toile à sa taille déclarée et superpose exactement ce cercle de zone de sécurité afin que vous puissiez voir de vos propres yeux si votre œuvre survit au recadrage.

Le badge réussite/échec sous chaque aperçu n’est pas un élément de liste de contrôle cosmétique : il provient d’une analyse réelle par pixel des données d’image décodées. L'outil mesure la quantité de contenu hors arrière-plan qui se trouve en dehors du cercle de la zone de sécurité (contenu qu'un masque couperait) et la quantité de transparence de l'icône (les icônes masquables doivent avoir un arrière-plan opaque à fond perdu, car la transparence laisse transparaître la couleur du masque sous-jacent). Les deux vérifications sont exécutées sur le bitmap réel que vous avez téléchargé, de sorte que le résultat reflète votre véritable fichier d'icône, et non une supposition.

Tout se passe localement dans votre navigateur : manifest.json est lu avec l'API File, les icônes sont décodées avec createImageBitmap ou une solution de secours FileReader/Image, et les pixels sont analysés sur un canevas en mémoire. Rien n'est téléchargé sur un serveur, ce qui est important si votre manifeste fait référence à un nom d'application pas encore public, à des chemins d'accès start_url internes ou à des icônes en cours de développement.