คู่มือการแปลงส่วนขยาย 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 คุณไม่จำเป็นต้องใช้เมื่อแปลง แต่เมื่อมาแทนที่ฟีเจอร์เก่า คุณควรเลือกใช้ฟีเจอร์ที่มาแทน และคาดว่าฟีเจอร์ที่มาแทนจะถูกเลิกใช้งานและนำออกไปในที่สุด