ไฟล์ Manifest ของเว็บแอปไม่ตรงตามข้อกำหนดด้านความสามารถในการติดตั้ง

ความสามารถในการติดตั้งเป็นข้อกำหนดหลักของ Progressive Web App (PWA) การแจ้งให้ผู้ใช้ติดตั้ง PWA เป็นการอนุญาตให้ผู้ใช้เพิ่ม PWA ลงในหน้าจอหลัก ผู้ใช้ที่เพิ่มแอปลงในหน้าจอหลักจะมีส่วนร่วมกับแอปเหล่านั้นบ่อยขึ้น

ไฟล์ Manifest ของเว็บแอปประกอบด้วยข้อมูลสำคัญที่จำเป็นต่อการทำให้แอปติดตั้งได้

วิธีที่การตรวจสอบไฟล์ Manifest ของเว็บแอป Lighthouse ไม่สำเร็จ

Lighthouse จะแสดงหน้าเว็บที่ไม่มีไฟล์ Manifest ของเว็บแอปที่เป็นไปตามข้อกำหนดขั้นต่ำสำหรับความสามารถในการติดตั้ง ดังนี้

การตรวจสอบ Lighthouse แสดงให้เห็นว่าผู้ใช้ติดตั้งเว็บแอปจากหน้าจอหลักไม่ได้

หากไฟล์ Manifest ของหน้าเว็บไม่มีพร็อพเพอร์ตี้ต่อไปนี้ จะทำให้การตรวจสอบไม่ผ่าน

  • พร็อพเพอร์ตี้ short_name หรือ name
  • พร็อพเพอร์ตี้ icons ที่มีไอคอนขนาด 192x192 พิกเซล และไอคอน 512x512 พิกเซล
  • พร็อพเพอร์ตี้ start_url
  • พร็อพเพอร์ตี้ display ที่ตั้งค่าเป็น fullscreen, standalone หรือ minimal-ui
  • พร็อพเพอร์ตี้ prefer_related_applications ที่ตั้งค่าเป็นค่าอื่นที่ไม่ใช่ true

วิธีทำให้ PWA ติดตั้งได้

ตรวจสอบว่าแอปมีไฟล์ Manifest ที่ตรงกับเกณฑ์ข้างต้น ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้าง PWA ได้ที่ทำให้ติดตั้งได้

วิธีตรวจสอบว่า PWA ติดตั้งได้

ใน Chrome

เมื่อแอปเป็นไปตามข้อกำหนดขั้นต่ำด้านความสามารถในการติดตั้งแล้ว Chrome จะเริ่มใช้เหตุการณ์ beforeinstallprompt ซึ่งคุณใช้เพื่อแจ้งให้ผู้ใช้ติดตั้ง PWA ได้

ในเบราว์เซอร์อื่นๆ

เบราว์เซอร์อื่นมีเกณฑ์การติดตั้งและทริกเกอร์เหตุการณ์ beforeinstallprompt ที่แตกต่างกัน โปรดดูรายละเอียดทั้งหมดในเว็บไซต์ของผู้ให้บริการรายนั้นๆ ดังนี้

แหล่งข้อมูล