IcoJet아이콘 제작 노트
← 아이콘 제작 노트

PWA 아이콘 잘림과 작은 흰 상자 해결

설치된 웹 앱은 manifest 아이콘을 사용합니다. 런처의 모양 마스크가 표시 결과를 바꿀 수 있습니다.

앱 이미지 준비

192×192, 512×512 PNG에서 시작하고 대상 플랫폼을 확인하세요. 상대 경로는 manifest URL 기준입니다. IcoJet 최대 256px는 512px PNG를 대신하지 못합니다.

maskable 버전 설계

중요한 그림은 폭의 40%를 반지름으로 하는 중앙 원 안에 놓고 배경은 끝까지 확장하세요. 확인된 디자인에만 purpose="maskable"을 지정합니다.

설치 결과 검증

브라우저에서 manifest와 마스크 미리보기를 확인하고 대상 기기에 설치하세요. 일반 및 maskable 버전을 모두 검사합니다. 기존 설치 문제는 새 설치와 비교한 뒤 수정하세요.

{
  "icons": [
    {
      "src": "/icons/app-192.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "/icons/app-512.png",
      "sizes": "512x512",
      "type": "image/png",
      "purpose": "any"
    },
    {
      "src": "/icons/app-maskable-512.png",
      "sizes": "512x512",
      "type": "image/png",
      "purpose": "maskable"
    }
  ]
}
출처와 참고 자료 MDN — Manifest icons ↗web.dev — Web app manifest ↗

변환기로 돌아가기 ↗