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