Walidator Web App Manifest

Progressive Web App instaluje się bezproblemowo tylko wtedy, gdy manifest.json spełnia pola, które faktycznie sprawdzają przeglądarki i sklepy z aplikacjami. Ten walidator odczytuje Twój manifest i przechodzi przez specyfikację W3C Web App Manifest pole po polu: zgłasza brak name i short_name, pustą lub nieprawidłową tablicę icons, ikony bez src, sizes lub type, niemożliwy do sparsowania start_url, nierozpoznaną wartość display oraz theme_color lub background_color, które nie są poprawnymi kolorami CSS. Każdy wynik wyświetlany jest jako zdanie w zrozumiałym języku – a nie surowy cytat ze specyfikacji – więc wiesz dokładnie, co poprawić i dlaczego ma to znaczenie dla instalacji.

Kluczową funkcją jest podgląd bezpiecznej strefy maskowalnych ikon. Adaptacyjne ikony Androida nakładają wybraną przez system maskę – okrąg, kwadrat z zaokrąglonymi rogami, łzę i inne – na każdą ikonę oznaczoną jako "purpose": "maskable". Wszystko poza wyśrodkowanym okręgiem zajmującym 40% viewportu ikony może zostać obcięte w zależności od zastosowanej przez urządzenie maski. Prześlij pliki ikon, do których odwołuje się manifest, razem z manifest.json, a to narzędzie dopasuje je po nazwie pliku, narysuje każdą maskowalną ikonę na canvas w jej zadeklarowanym rozmiarze i nałoży dokładnie ten okrąg bezpiecznej strefy, abyś mógł na własne oczy zobaczyć, czy Twoja grafika przetrwa przycięcie.

Odznaka Zaliczone/Niezaliczone pod każdym podglądem nie jest kosmetycznym elementem listy kontrolnej – wynika z rzeczywistej analizy pikseli zdekodowanego obrazu. Narzędzie mierzy, ile treści innej niż tło znajduje się poza okręgiem bezpiecznej strefy (treść, która zostałaby obcięta przez maskę) i jaka część ikony jest przezroczysta (maskowalne ikony powinny mieć jednolite kryjące tło, ponieważ przezroczystość przepuszcza kolor maski). Oba testy wykonywane są na rzeczywistej bitmapie, którą przesłałeś, więc wynik odzwierciedla Twój prawdziwy plik ikony, a nie przypuszczenie.

Wszystko odbywa się lokalnie w Twojej przeglądarce: manifest.json odczytywany jest przez File API, ikony dekodowane są za pomocą createImageBitmap lub z użyciem FileReader/Image, a piksele analizowane są na canvas w pamięci. Nic nie jest wysyłane na serwer, co ma znaczenie, jeśli manifest zawiera niepubliczną jeszcze nazwę aplikacji, wewnętrzne ścieżki start_url lub ikony będące w fazie rozwoju.