วิธีที่ Chrome จัดการการอัปเดตไฟล์ Manifest ของเว็บแอป

สิ่งที่ต้องใช้เพื่อเปลี่ยนไอคอน ทางลัด สี และข้อมูลเมตาอื่นๆ สำหรับ PWA

Adriana Jara
François Beaufort
François Beaufort
GitHub
Pete LePage

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

ในกรณีส่วนใหญ่ การเปลี่ยนแปลงควรมีผลภายใน 1-2 วัน เปิดตัว PWA หลังจากอัปเดตไฟล์ Manifest แล้ว

การอัปเดตใน Chrome บนเดสก์ท็อป

เมื่อมีการเปิดตัวหรือเปิด PWA ในแท็บเบราว์เซอร์ Chrome จะระบุ ครั้งล่าสุดที่มีการตรวจหาการเปลี่ยนแปลงไฟล์ Manifest ในเครื่อง หากไฟล์ Manifest ไม่ ถูกตรวจสอบตั้งแต่เริ่มเบราว์เซอร์ครั้งล่าสุด หรือไม่ได้ตรวจสอบใน 24 ชั่วโมงที่ผ่านมา Chrome จะส่งคำขอเครือข่ายสำหรับไฟล์ Manifest จากนั้น ให้เปรียบเทียบกับสำเนาในเครื่อง

หากพร็อพเพอร์ตี้บางรายการในไฟล์ Manifest มีการเปลี่ยนแปลง (ดูรายการด้านล่าง) Chrome จัดคิวไฟล์ Manifest ใหม่ และหลังจากปิดหน้าต่างทั้งหมดแล้ว ให้ติดตั้ง เมื่อติดตั้งแล้ว ช่องทั้งหมดจากไฟล์ Manifest ใหม่ (ยกเว้น name, short_name, และ icons) แล้ว

พร็อพเพอร์ตี้ใดจะทริกเกอร์การอัปเดต

  • display (ดูด้านล่าง)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

จะเกิดอะไรขึ้นเมื่อมีการอัปเดตช่อง display

หากคุณอัปเดตโหมดการแสดงผลของแอปจาก browser เป็น standalone ผู้ใช้ปัจจุบันจะไม่เปิดแอปของตนในหน้าต่างหลังจากการอัปเดต มี คือการตั้งค่าการแสดงผล 2 แบบสำหรับเว็บแอป คือ การตั้งค่าจากไฟล์ Manifest (ที่คุณ ) และการตั้งค่าหน้าต่าง/แท็บเบราว์เซอร์ที่ผู้ใช้ควบคุม ผู้ใช้ การตั้งค่าจะได้รับการดำเนินการตามเสมอ

การทดสอบการอัปเดตไฟล์ Manifest

หน้า chrome://web-app-internals (ใช้ได้ใน Chrome 85 ขึ้นไป) มีข้อมูลโดยละเอียดเกี่ยวกับ PWA ทั้งหมดที่ติดตั้งในอุปกรณ์ และจะช่วยให้คุณเข้าใจว่าไฟล์ Manifest อัปเดตครั้งล่าสุดเมื่อใด บ่อยแค่ไหน มีการอัปเดตและอื่นๆ

หากต้องการบังคับให้ Chrome ตรวจหาไฟล์ Manifest ที่อัปเดตด้วยตนเอง ให้เลือกเปิด Chrome ที่มีค่าสถานะบรรทัดคำสั่ง --disable-manifest-update-throttle หรือรีสตาร์ท Chrome (ใช้ about://restart) ซึ่งจะเป็นการรีเซ็ตตัวจับเวลาเพื่อให้ Chrome จะตรวจหาไฟล์ Manifest ที่อัปเดตเมื่อมีการเปิดตัว PWA ครั้งถัดไป จากนั้นเปิดตัว PWA หลังจากปิด PWA แล้ว คุณควรอัปเดตไฟล์ด้วย Manifest ใหม่ พร็อพเพอร์ตี้

ข้อมูลอ้างอิง

ข้อมูลอัปเดตเกี่ยวกับ Chrome สำหรับ Android

เมื่อมีการเปิดตัว PWA แล้ว Chrome จะกำหนดเวลาล่าสุดของไฟล์ Manifest ในเครื่อง เพื่อตรวจสอบการเปลี่ยนแปลงแล้ว หากไม่มีการตรวจสอบไฟล์ Manifest ในช่วง 24 วันที่ผ่านมา Chrome จะตั้งเวลาคำขอเครือข่ายสำหรับไฟล์ Manifest จากนั้นทำการเปรียบเทียบ เทียบกับสำเนาในเครื่อง

หากพร็อพเพอร์ตี้บางรายการในไฟล์ Manifest มีการเปลี่ยนแปลง (ดูรายการด้านล่าง) Chrome จัดคิวไฟล์ Manifest ใหม่ และหลังจากปิดหน้าต่างทั้งหมดของ PWA อุปกรณ์เสียบปลั๊กอยู่และเชื่อมต่อกับ Wi-Fi อยู่ Chrome จะขอให้อัปเดต WebAPK จากเซิร์ฟเวอร์ เมื่ออัปเดตแล้ว ช่องทั้งหมดจากไฟล์ Manifest ใหม่จะ

พร็อพเพอร์ตี้ใดจะทริกเกอร์การอัปเดต

  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

หาก Chrome รับไฟล์ Manifest ที่อัปเดตไม่ได้จากเซิร์ฟเวอร์ อาจ เพิ่มระยะเวลาระหว่างการตรวจสอบเป็น 30 วัน

การทดสอบการอัปเดตไฟล์ Manifest

หน้า about://webapks มีข้อมูลโดยละเอียดเกี่ยวกับ PWA ที่ติดตั้งในอุปกรณ์ และจะบอกให้คุณทราบว่าไฟล์ Manifest ล่าสุดเมื่อใด อัปเดต ความถี่ในการอัปเดต และอื่นๆ

หากต้องการกำหนดเวลาการอัปเดตไฟล์ Manifest ด้วยตนเอง การลบล้างตัวจับเวลาและ ไฟล์ Manifest ในเครื่อง ให้ทำดังนี้

  1. เสียบปลั๊กอุปกรณ์และเชื่อมต่อ Wi-Fi
  2. ใช้ตัวจัดการงานของ Android เพื่อปิด PWA แล้วใช้แผงแอป ในการตั้งค่า Android เพื่อบังคับให้ PWA หยุด
  3. ใน Chrome ให้เปิด about://webapks แล้วคลิก "อัปเดต" สำหรับส่วน PWA "สถานะการอัปเดต" ควรเปลี่ยนเป็น "รอดำเนินการ"
  4. เปิด PWA และยืนยันว่าโหลดอย่างถูกต้อง
  5. ใช้ตัวจัดการงานของ Android เพื่อปิด PWA แล้วใช้แผงแอป ในการตั้งค่า Android เพื่อบังคับให้ PWA หยุด

โดยปกติแล้ว PWA จะอัปเดตภายในไม่กี่นาทีเมื่อการอัปเดตเสร็จสมบูรณ์ "สถานะการอัปเดต" ควรเปลี่ยนเป็น "สำเร็จ"

ข้อมูลอ้างอิง