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

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

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

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

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