دليل لتحويل إضافات Manifest V2 إلى إضافات Manifest V3
يساعدك هذا القسم في ترقية إضافة من الإصدار Manifest V2 إلى الإصدار Manifest V3، وهو أحدث إصدار من منصة "إضافات Chrome". يتم تقسيم عملية نقل البيانات بشكل عام إلى الفئات التالية. لمساعدتك في تتبُّع عملك، قدّمنا قائمة تحقّق تلخّص محتوى هذه المستندات. يمكنك الوصول إلى المحتوى باستخدام قائمة التحقّق أو الانتقال مباشرةً إلى المحتوى. ينتهي كلا المسارين بإضافة تمت ترقيتها.
- تعديل ملف البيان: يجب أن يكون
manifest.jsonخاصًا بالإصدار 3. يوضّح هذا القسم التغييرات التي يمكن إجراؤها بشكل مستقل. يتم وصف التغييرات في ملف البيان المرتبطة بالرمز باستخدام تغييرات الرمز التي تتيحها. - الانتقال إلى مشغّل خدمات: يحلّ مشغّل الخدمات محلّ صفحة الخلفية أو صفحة الأحداث في الإضافة لضمان عدم تشغيل الرمز البرمجي في الخلفية على سلسلة التعليمات الرئيسية حيث يمكن أن يؤثر سلبًا في الأداء. يتطلّب هذا التغيير أيضًا نقل DOM وwindow وبعض طلبات واجهة برمجة التطبيقات الخاصة بالإضافات إلى المستندات خارج الشاشة.
- تعديل طلبات البيانات من واجهة برمجة التطبيقات: يجب استبدال بعض طلبات البيانات من واجهة برمجة التطبيقات ببدائل أحدث.
- استبدال أدوات معالجة طلبات الويب التي تحظر: يمكن أن يؤدي حظر طلبات الشبكة أو تعديلها في الإصدار Manifest V2 إلى خفض الأداء بشكل كبير ويتطلب الوصول بشكل مفرط إلى بيانات المستخدمين الحسّاسة. تتيح واجهة برمجة التطبيقات Declarative Net Request للإضافات حظر محتوى الويب أو تعديله بأذونات أقل وبدون التأثير في الأداء.
- تحسين أمان الإضافة: يحسّن الإصدار Manifest V3 أمان الإضافة بعدة طرق. بالإضافة إلى سياسة أمان المحتوى المحسّنة، تمت إزالة إمكانية استضافة الرمز عن بُعد وتنفيذ السلاسل العشوائية.
- نشر الإضافة: يوضّح هذا القسم كيفية إصدار إضافة Manifest V3 على مراحل لضمان عملها على النحو المتوقّع من خلال اختبارها مع مجموعة محدودة من الجمهور أولاً.
لدينا أيضًا أداة تحويل لبيان الإضافة. لا ينفّذ كل الإجراءات نيابةً عنك، ولكنّه سيساعدك في البدء. يوضّح ملف README الخاص بالمحوّل التغييرات التي تجريها الأداة.
الاحتفاظ بالمجموعة الحالية من الميزات
للحدّ من فرص حدوث مشاكل أو أخطاء غير متوقّعة، ننصحك بعدم إضافة وظائف جديدة أثناء نقل البيانات. على سبيل المثال، قد يؤدي إضافة ميزة تتطلّب أذونات جديدة إلى ظهور تحذير بشأن الأذونات، ما سيؤدي إلى إيقاف الإضافة إلى أن يوافق المستخدم على الأذونات الجديدة. يمكنك الاطّلاع على أفضل الممارسات المتعلّقة بتحذير الأذونات للتعرّف على طرق أخرى لإضافة الأذونات بدون عرض تحذير.
يتوفّر الإصدار Manifest V3 بشكل عام في الإصدار 88 من Chrome أو الإصدارات الأحدث. عند تعديل طلبات البيانات من واجهة برمجة التطبيقات، قد تجد أنّ ميزات الاستبدال لم يتم طرحها في Chrome إلا بعد الإصدار 88. تحتوي صفحات مرجع واجهة برمجة التطبيقات على معلومات الدعم لأفراد واجهة برمجة التطبيقات. إذا تبيّن لك أنّك بحاجة إلى إحدى هذه الميزات، يمكنك تحديد الحد الأدنى لإصدار Chrome في ملف البيان.
ميزات جديدة في منصة الإضافات
منذ إصدار Manifest V3، واصلنا إضافة ميزات جديدة، والعديد منها قابل للاستخدام في كل من Manifest V2 وManifest V3. لست ملزمًا باستخدامها عند إجراء عملية التحويل، ولكن عندما تحلّ محلّ ميزات قديمة، عليك تفضيلها على الميزات التي تحلّ محلّها وتوقّع إيقاف الميزات التي تم استبدالها نهائيًا وإزالتها.