Валидатор на манифест за уеб приложение

Прогресивно уеб приложение (PWA) се инсталира безпроблемно само когато неговият manifest.json отговаря на полетата, които браузърите и магазините за приложения реално проверяват. Този валидатор обработва качения от вас манифест и преминава поле по поле през спецификацията W3C Web App Manifest: сигнализира липсващи name и short_name, празен или некоректен масив icons, икони без src, sizes или type, неразпознаваем start_url, неразпозната стойност на display и низове за theme_color или background_color, които не са валидни CSS цветове. Всяка констатация се показва като изречение на разбираем език — а не като суров цитат от спецификацията — така че да знаете точно какво да коригирате и защо това е важно за възможността за инсталиране.

Ключовото предимство е прегледът на безопасната зона за адаптивна икона. Адаптивните икони на Android прилагат избрана от операционната система форма на маска — кръг, заоблен квадрат, капка и други — върху всяка икона, маркирана с "purpose": "maskable". Всичко извън центриран кръг, покриващ 40% от визуалното поле на иконата, може да бъде изрязано в зависимост от маската, която устройството прилага. Качете файловете с изображения на икони, посочени от вашия манифест, заедно с manifest.json и този инструмент ги съпоставя по име на файл, изчертава всяка адаптивна икона върху платно в декларирания ѝ размер и наслагва точно този кръг на безопасната зона, за да видите със собствените си очи дали вашият дизайн оцелява при изрязването.

Индикаторът „преминат/непреминат“ под всеки преглед не е просто козметичен елемент от списък — той идва от реален попикселен анализ на декодираните данни от изображението. Инструментът измерва колко не-фоново съдържание се намира извън кръга на безопасната зона (съдържание, което маската би изрязала) и каква част от иконата е прозрачна (адаптивните икони трябва да имат плътен непрозрачен фон, тъй като прозрачността позволява да прозира цветът на подложката на маската). И двете проверки се изпълняват върху реалното bitmap изображение, което сте качили, така че резултатът отразява действителния ви файл с икона, а не предположение.

Всичко се случва локално във вашия браузър: manifest.json се чете чрез File API, иконите се декодират с createImageBitmap или резервен метод FileReader/Image, а пикселите се анализират върху платно в паметта. Нищо не се качва на сървър, което е от значение, ако вашият манифест съдържа име на приложение, което все още не е публично, вътрешни пътища за start_url или икони в процес на разработка.