Validador de Web App Manifest

Una Progressive Web App solo se instala limpiamente cuando su manifest.json cumple los campos que los navegadores y las tiendas de aplicaciones realmente verifican. Este validador analiza el manifest que subas y recorre campo por campo la especificación W3C de Web App Manifest: señala la falta de name y short_name, un array icons vacío o mal formado, iconos sin src, sizes o type, un start_url que no se puede interpretar, un valor de display no reconocido y cadenas de theme_color o background_color que no son colores CSS válidos. Cada hallazgo se muestra como una frase en lenguaje claro — no una cita textual de la especificación — para que sepas exactamente qué corregir y por qué es importante para que la app se pueda instalar.

La función estrella es la vista previa de la zona segura para iconos adaptables. Los iconos adaptativos de Android aplican una forma de máscara elegida por el sistema —círculo, círculo cuadrado, lágrima y más— a cualquier icono marcado con "purpose": "maskable". Cualquier contenido fuera de un círculo centrado que cubra el 40 % del área visible del icono puede recortarse según la máscara que aplique el dispositivo. Sube los archivos de imagen de icono referenciados por tu manifest junto con el manifest.json, y esta herramienta los empareja por nombre de archivo, dibuja cada icono adaptable en un lienzo a su tamaño declarado y superpone ese círculo exacto de zona segura para que puedas ver con tus propios ojos si tu diseño sobrevive al recorte.

La insignia de aprobado/rechazado bajo cada vista previa no es un elemento decorativo de lista de comprobación: proviene de un análisis real píxel por píxel de los datos de imagen decodificados. La herramienta mide cuánto contenido no perteneciente al fondo queda fuera del círculo de zona segura (contenido que una máscara recortaría) y qué parte del icono es transparente (los iconos adaptables deben tener un fondo opaco a sangre completa, ya que la transparencia deja ver el color de la máscara subyacente). Ambas comprobaciones se ejecutan sobre el mapa de bits real que subiste, por lo que el resultado refleja tu archivo de icono real, no una suposición.

Todo ocurre localmente en tu navegador: el manifest.json se lee con la API File, los iconos se decodifican con createImageBitmap o una alternativa FileReader/Image, y los píxeles se analizan en un lienzo en memoria. No se sube nada a un servidor, algo importante si tu manifest referencia un nombre de app aún no público, rutas internas de start_url o iconos en desarrollo.