คำแนะนำในการแปลงส่วนขยายไฟล์ Manifest V2 เป็นส่วนขยายไฟล์ Manifest V3
ส่วนนี้จะช่วยคุณอัปเกรดส่วนขยายจาก Manifest V2 เป็น Manifest V3 ซึ่งเป็นแพลตฟอร์มส่วนขยาย Chrome เวอร์ชันล่าสุด งานการย้ายข้อมูลแบ่งออกเป็นหมวดหมู่ต่อไปนี้ เราได้จัดทำรายการตรวจสอบที่สรุปเนื้อหาของเอกสารเหล่านี้ไว้เพื่อช่วยให้คุณติดตามงานได้ คุณเข้าถึงเนื้อหาได้โดยใช้เช็กลิสต์หรือเจาะลึกเนื้อหา ทั้ง 2 เส้นทางจะสิ้นสุดด้วยส่วนขยายที่อัปเกรดแล้ว
- อัปเดตไฟล์ Manifest -
manifest.jsonต้องเป็นของ V3 โดยเฉพาะ การเปลี่ยนแปลงที่ทำได้ด้วยตัวเองจะอธิบายไว้ในส่วนนี้ การเปลี่ยนแปลงไฟล์ Manifest ที่เกี่ยวข้องกับโค้ดจะอธิบายพร้อมกับการเปลี่ยนแปลงโค้ดที่รองรับ - ย้ายข้อมูลไปยัง Service Worker - Service Worker จะแทนที่หน้าพื้นหลังหรือหน้าเหตุการณ์ของส่วนขยายเพื่อให้แน่ใจว่าโค้ดเบื้องหลังจะไม่อยู่ในเทรดหลักซึ่งอาจส่งผลต่อประสิทธิภาพ การเปลี่ยนแปลงนี้ยังกำหนดให้ย้าย DOM, หน้าต่าง และการเรียก API ของส่วนขยายบางอย่างไปยังเอกสารนอกหน้าจอด้วย
- อัปเดตการเรียก API - การเรียก API บางรายการต้องแทนที่ด้วยการเรียกที่เทียบเท่าที่ทันสมัยกว่า
- แทนที่เครื่องมือฟังคำขอเว็บที่บล็อก - การบล็อกหรือแก้ไขคำขอเครือข่ายใน Manifest V2 อาจทำให้ประสิทธิภาพลดลงอย่างมากและต้องมีการเข้าถึงข้อมูลผู้ใช้ที่ละเอียดอ่อนมากเกินไป Declarative Net Request API ช่วยให้ส่วนขยายบล็อกหรือแก้ไขเนื้อหาเว็บได้โดยใช้สิทธิ์น้อยลงและไม่ทำให้ประสิทธิภาพลดลง
- ปรับปรุงความปลอดภัยของส่วนขยาย - Manifest V3 ปรับปรุงความปลอดภัยของส่วนขยายได้หลายวิธี นอกเหนือจากนโยบายรักษาความปลอดภัยเนื้อหาที่ได้รับการปรับปรุงแล้ว เรายังได้นำการรองรับโค้ดที่โฮสต์จากระยะไกลและการดำเนินการสตริงที่กำหนดเองออกด้วย
- เผยแพร่ส่วนขยาย - ส่วนนี้อธิบายวิธีเปิดตัวส่วนขยาย Manifest V3 เป็นระยะๆ เพื่อให้มั่นใจว่าส่วนขยายทำงานได้ตามที่คาดไว้ โดยการทดสอบกับกลุ่มเป้าหมายแบบจำกัดก่อน
นอกจากนี้ เรายังมีตัวแปลงไฟล์ Manifest ของส่วนขยายด้วย แต่จะช่วยให้คุณเริ่มต้นใช้งานได้ README ของตัวแปลงจะอธิบายสิ่งที่เครื่องมือเปลี่ยนแปลง
ใช้ชุดฟีเจอร์ปัจจุบันต่อไป
เราขอแนะนำว่าอย่าเพิ่มฟังก์ชันใหม่เมื่อย้ายข้อมูลเพื่อลดโอกาสที่จะเกิดปัญหาหรือข้อบกพร่องที่ไม่คาดคิด เช่น การเพิ่มฟีเจอร์ที่ต้องใช้สิทธิ์ใหม่ๆ อาจทําให้เกิดคําเตือนเรื่องสิทธิ์ ซึ่งจะปิดใช้ส่วนขยายจนกว่าผู้ใช้จะยอมรับสิทธิ์ใหม่ ดูแนวทางปฏิบัติแนะนำเกี่ยวกับคำเตือนเรื่องสิทธิ์เพื่อดูวิธีอื่นๆ ในการเพิ่มสิทธิ์โดยไม่ต้องแสดงคำเตือน
โดยทั่วไป Chrome เวอร์ชัน 88 ขึ้นไปจะรองรับ Manifest V3 เมื่ออัปเดตการเรียก API คุณอาจพบว่าฟีเจอร์ทดแทนอาจยังไม่พร้อมใช้งานใน Chrome จนกว่าจะถึงเวอร์ชัน 88 หน้าเอกสารอ้างอิง API มีข้อมูลการสนับสนุนสำหรับสมาชิก API แต่ละราย หากพบว่าคุณต้องการใช้ฟีเจอร์ใดฟีเจอร์หนึ่งเหล่านี้ คุณสามารถระบุเวอร์ชัน Chrome ขั้นต่ำในไฟล์ Manifest ได้
ฟีเจอร์แพลตฟอร์มส่วนขยายใหม่
นับตั้งแต่เปิดตัว Manifest V3 เราได้เพิ่มฟีเจอร์ใหม่ๆ อย่างต่อเนื่อง ซึ่งหลายฟีเจอร์ใช้ได้ทั้งใน Manifest V2 และ Manifest V3 คุณไม่จำเป็นต้องใช้เมื่อแปลง แต่เมื่อแทนที่ฟีเจอร์เก่า คุณควรเลือกใช้ฟีเจอร์ใหม่แทนฟีเจอร์ที่ถูกแทนที่ และคาดการณ์ว่าฟีเจอร์ที่ถูกแทนที่จะเลิกใช้งานและนำออกในที่สุด