매니페스트에 마스크 가능한 아이콘이 없음

마스킹 가능한 아이콘은 모든 Android 기기에서 PWA 아이콘이 멋지게 표시되도록 하는 새로운 아이콘 형식입니다. 최신 Android 기기에서는 마스크 가능한 아이콘 형식을 따르지 않는 PWA 아이콘에 흰색 배경이 적용됩니다. 마스크 가능한 아이콘을 사용하면 아이콘이 Android에서 제공하는 모든 공간을 차지하게 됩니다.

Lighthouse 마스크 가능 아이콘 감사 실패 방식

Lighthouse는 마스크 가능한 아이콘을 지원하지 않는 페이지를 신고합니다.

Lighthouse 보고서 UI의 마스크 가능한 아이콘 감사

감사를 통과하려면 다음 단계를 따르세요.

  • 웹 앱 매니페스트가 있어야 합니다.
  • 웹 앱 매니페스트에는 icons 배열이 있어야 합니다.
  • icons 배열에는 purpose 속성이 있는 객체가 하나 포함되어야 하며, 이 purpose 속성의 값에는 maskable가 포함되어야 합니다.

PWA에 마스크 가능한 아이콘 지원을 추가하는 방법

  1. Maskable.app 편집기를 사용하여 기존 아이콘을 마스크 가능 아이콘으로 변환합니다.

  2. purpose 속성을 웹 앱 매니페스트의 icons 객체 중 하나에 추가합니다. purpose 값을 maskable로 설정합니다. 값을 참고하세요.

    {
  …
  "icons": [
    …
    {
      "src": "path/to/maskable_icon.png",
      "sizes": "196x196",
      "type": "image/png",
      "purpose": "maskable"
    }
  ]
  …
}

  3. Chrome DevTools를 사용하여 마스크 가능한 아이콘이 올바르게 표시되는지 확인합니다. 현재 아이콘이 준비되었나요?를 참고하세요.

리소스