Web App Manifest 검증기
PWA manifest.json을 Web App Manifest 스펙에 따라 검증하고 maskable 아이콘을 Android 적응형 아이콘 세이프 존 기준으로 미리보기합니다.
🔒 전적으로 귀하의 브라우저에서 처리됩니다. 여기에 입력하는 어떤 것도 업로드되지 않습니다.
결과
프로그레시브 웹 앱은 브라우저와 앱 스토어가 실제로 확인하는 필드를 manifest.json이 충족할 때만 깔끔하게 설치됩니다. 이 검증기는 업로드된 manifest를 파싱하여 W3C Web App Manifest 스펙을 필드별로 점검합니다. 누락된 name 및 short_name, 비어 있거나 잘못된 icons 배열, src, sizes, type이 빠진 아이콘, 파싱할 수 없는 start_url, 인식할 수 없는 display 값, 유효한 CSS 색상이 아닌 theme_color나 background_color 문자열을 알려줍니다. 발견된 사항은 단순한 스펙 인용이 아니라 평이한 한국어 문장으로 보여주므로 무엇을 고쳐야 하고 설치 적합성에 왜 중요한지 정확히 알 수 있습니다.
가장 큰 특징은 maskable 아이콘 세이프 존 미리보기입니다. Android 적응형 아이콘은 "purpose": "maskable"로 표시된 모든 아이콘에 OS가 정한 마스크 모양(원형, 스퀘어, 물방울형 등)을 적용합니다. 아이콘 뷰포트 중앙의 40% 원 바깥에 있는 모든 요소는 기기에 적용되는 마스크에 따라 잘려 나갈 수 있습니다. manifest 옆에 manifest.json에서 참조하는 아이콘 이미지 파일을 업로드하면 이 도구가 파일 이름으로 매칭하고 선언된 크기로 각 maskable 아이콘을 캔버스에 그린 다음 정확한 세이프 존 원을 겹쳐 보여주므로 아트워크가 잘림을 통과하는지 여러분의 눈으로 확인할 수 있습니다.
각 미리보기 아래의 통과/실패 배지는 단순한 체크리스트 항목이 아닙니다. 디코딩된 이미지 데이터를 픽셀 단위로 분석한 실제 결과입니다. 이 도구는 세이프 존 원 밖에 마스크로 잘릴 비배경 콘텐츠가 얼마나 있는지, 그리고 아이콘이 얼마나 투명한지 측정합니다(maskable 아이콘은 전체 캔버스를 덮는 불투명한 배경을 가져야 합니다. 투명하면 마스크 색상이 비칩니다). 두 검사 모두 업로드된 실제 비트맵을 기준으로 실행되므로 결과는 추측이 아니라 실제 아이콘 파일을 반영합니다.
모든 작업은 브라우저 안에서 로컬로 이루어집니다. manifest.json은 File API로 읽고, 아이콘은 createImageBitmap이나 FileReader/Image 폴백으로 디코딩하며, 픽셀은 메모리 내 캔버스에서 분석합니다. 아직 공개되지 않은 앱 이름, 내부 start_url 경로, 개발 중인 아이콘을 manifest가 참조할 때 중요한 점인 서버 업로드가 전혀 없습니다.