웹 앱 매니페스트 검사기

사용 방법

1. 1

   매니페스트 불러오기

   JSON을 편집기에 붙여 넣거나 .json·.webmanifest 파일(5 MiB까지)을 끌어다 놓거나 예제로 시작합니다.

2. 2

   판정 확인

   입력하는 즉시 JSON을 파싱합니다. 배너에 설치 가능 또는 아직 설치할 수 없음이 표시되고, 설치 조건 7가지가 통과·미통과로 나열됩니다.

3. 3

   개수 확인

   타일에 매니페스트가 선언한 멤버 수와 아이콘 수, 오류·경고 수가 나옵니다.

4. 4

   지적 사항 처리

   항목마다 멤버(예: icons[1].src), 심각도(오류·경고·팁), 고치는 방법을 담은 메시지가 나옵니다. 오류가 먼저 나오며, startUrl처럼 철자가 틀린 멤버에는 "start_url을 말씀하신 건가요?" 힌트가 붙습니다.

5. 5

   정리된 JSON 복사·내려받기

   들여쓰기가 정리된 매니페스트를 복사하거나 manifest.webmanifest로 내려받습니다.

작동 원리

실제 예시

{"name":"Example shop","short_name":"Shop","start_url":"/","display":"standalone","icons":[{"src":"/icon-192.png","sizes":"192x192","type":"image/png"},{"src":"/icon-512.png","sizes":"512x512","type":"image/png"}]}

설치 가능. 멤버 5, 아이콘 2, 오류 0, 경고 0
팁: id, theme_color, background_color, maskable 아이콘, screenshots 추가

{"short_name":"Shop","display":"app","icons":[{"src":"/a.png"},"x",{"sizes":"1x1"}]}

아직 설치할 수 없음. 오류 4, 경고 2
경고 name: name이 없음, short_name이 대신하지만 name을 권장
오류 start_url: start_url이 없음
오류 display: "app"은 표시 모드가 아님
경고 icons[0].sizes: sizes를 선언하세요
오류 icons[1]: 각 아이콘은 객체여야 함
오류 icons[2].src: 각 아이콘에 src가 필요함
미통과 조건: start_url, display, 192 아이콘, 512 아이콘

{"name":"A"}

아직 설치할 수 없음. 멤버 1, 아이콘 0, 오류 2, 경고 2
경고 short_name: short_name 추가 권장
오류 start_url: start_url이 없음
경고 display: 없어서 일반 탭으로 열림
오류 icons: icons 배열을 추가하세요

[1]

매니페스트의 최상위는 JSON 객체 { … }여야 합니다.

자주 하는 실수

• "오류 없음"을 모든 곳에서 설치 가능으로 착각

  판정은 크로미움의 매니페스트 기준을 따르며 HTTPS, <link rel="manifest"> 태그, 서비스 워커는 볼 수 없습니다. 사파리와 파이어폭스는 다른 규칙을 쓰므로 대상 브라우저에서 직접 테스트하세요.

• 아이콘 상대 경로는 매니페스트 URL 기준

  실제 브라우저에서 src와 start_url은 페이지가 아니라 매니페스트 파일 기준으로 해석됩니다. /app/manifest.json에서 src: icon.png는 /app/icon.png를 가리킵니다. 이 도구는 경로를 해석하거나 요청하지 않습니다.

• 512픽셀 아이콘 누락

  작은 아이콘만 선언하는 것이 설치 안내가 뜨지 않는 가장 흔한 이유입니다. 도구는 선언된 sizes를 읽어 192·512 항목이 없으면 지적하지만, 파일이 실제로 그 크기인지는 알 수 없습니다.

• 서버의 잘못된 MIME 타입

  파일은 application/manifest+json(최소한 JSON 타입)으로 제공해야 합니다. 대체 라우트가 HTML을 돌려주면 여기서 JSON이 유효해도 브라우저에서는 불러오지 못합니다.

• 주석과 마지막 쉼표

  매니페스트는 순수 JSON입니다. 주석, 마지막 쉼표, 작은따옴표는 문법 오류가 되며, 메시지는 브라우저 엔진마다 다릅니다.

자주 묻는 질문

더 깊이 읽기

• 7분 읽기파비콘 사이즈와 설정 체크리스트: 모든 사이트에 필요한 최소 아이콘 세트아이콘 파일이 스무 개나 필요하지는 않습니다. 여섯 개면 충분하고, 각각이 서로 다른 클라이언트를 맡습니다. 여기에 매니페스트 하나, 그리고 옛 아이콘이 안 바뀌는 이유에 대한 대처가 필요합니다.