ไฟล์ Manifest ไม่มีไอคอนที่มาสก์ได้

ไอคอนที่ปิดบังได้เป็นรูปแบบไอคอนใหม่ที่จะทำให้ไอคอน PWA ของคุณดูดีในอุปกรณ์ Android ทุกรุ่น ในอุปกรณ์ Android รุ่นใหม่ ไอคอน PWA ที่ไม่เป็นไปตามรูปแบบไอคอนที่ปิดบังได้จะมีพื้นหลังสีขาว เมื่อคุณใช้ไอคอนที่มาสก์ได้ ไอคอนดังกล่าวจะใช้พื้นที่ทั้งหมดที่ Android มีให้

สาเหตุที่การตรวจสอบไอคอนที่ปิดบังได้ของ Lighthouse ไม่สําเร็จ

Lighthouse จะแจ้งว่าหน้าเว็บไม่รองรับไอคอนที่มาสก์ได้ในกรณีต่อไปนี้

การตรวจสอบไอคอนที่ปิดบังได้ใน UI ของรายงาน Lighthouse

วิธีผ่านการตรวจสอบ

  • ต้องมีไฟล์ Manifest ของเว็บแอป
  • ไฟล์ Manifest ของเว็บแอปต้องมีอาร์เรย์ icons
  • อาร์เรย์ icons ต้องมีออบเจ็กต์ 1 รายการที่มีพร็อพเพอร์ตี้ purpose และค่าของพร็อพเพอร์ตี้ purpose นั้นต้องมี maskable

วิธีเพิ่มการรองรับไอคอนที่ปิดบังได้ใน PWA

  1. ใช้ Maskable.app Editor เพื่อแปลงไอคอนที่มีอยู่เป็นไอคอนที่มาสค์ได้

  2. เพิ่มพร็อพเพอร์ตี้ purpose ลงในออบเจ็กต์ icons รายการใดรายการหนึ่งในไฟล์ Manifest ของเว็บแอป ตั้งค่า purpose เป็น maskable ดูค่า

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

  3. ใช้เครื่องมือสำหรับนักพัฒนาเว็บใน Chrome เพื่อยืนยันว่าไอคอนที่ปิดบังได้แสดงอย่างถูกต้อง ดูหัวข้อไอคอนปัจจุบันของฉันพร้อมใช้งานไหม

แหล่งข้อมูล