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

แหล่งข้อมูล