ไฟล์ 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 เพื่อยืนยันว่าไอคอนที่ปิดบังได้แสดงอย่างถูกต้อง ดูหัวข้อไอคอนปัจจุบันของฉันพร้อมใช้งานไหม

แหล่งข้อมูล