웹 앱 매니페스트 (Web App Manifest)
별칭: web app manifest · web application manifest · manifest.webmanifest · 매니페스트 · 웹 앱 매니페스트
PWA의 이름, 아이콘, 시작 URL, 표시 방식을 브라우저에 알려주는 JSON 파일.
웹 앱 매니페스트는 PWA가 홈 화면에 추가될 때 어떤 이름과 아이콘으로 보일지, 어떤 주소에서 시작할지, 브라우저 UI를 어떻게 표시할지 알려주는 JSON 파일이다. 보통 manifest.webmanifest라는 이름으로 둔다.
정의
웹 앱 매니페스트는 웹앱에 대한 정보를 담은 JSON 파일이다. 앱 이름, 짧은 이름, 아이콘, 시작 URL, 화면 표시 방식, 배경색, 테마색 같은 정보를 브라우저에 제공한다. PWA 설치 경험에서 핵심 파일 중 하나다.
왜 중요한가
홈 화면에 추가된 웹앱이 어떤 이름과 아이콘으로 표시되는지, 실행했을 때 어느 URL에서 시작하는지, 브라우저 주소창을 얼마나 보일지는 manifest 설정의 영향을 받는다. 초보자에게는 PWA를 "앱처럼 보이게 만드는 명함"으로 설명할 수 있다.
Semiclass에서의 의미
모바일 망토 단계에서는 manifest.webmanifest와 아이콘 세트를 추가한다. 생활정보 보드를 홈 화면에 추가했을 때 알아보기 쉬운 이름과 아이콘이 보이고, 다시 열었을 때 앱처럼 시작되도록 만드는 것이 목표다.
주의할 점
manifest만 있다고 완성된 PWA가 되는 것은 아니다. 브라우저별 설치 조건, HTTPS, 아이콘 크기, service worker 필요 여부를 함께 확인해야 한다. 아이콘은 다양한 크기와 maskable 형태를 준비해야 기기별로 잘려 보이는 문제를 줄일 수 있다.