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