تتبُّع تقدُّم عملية نقل البيانات
تم إعداد قوائم التحقُّق أدناه لمساعدتك على تتبُّع عمليات نقل البيانات. تحدد المهام التي يجب إكمالها بروابط إلى التعليمات. تنقسم عمل عملية نقل البيانات بشكل كبير إلى خمس فئات كما هو موضّح في ملخّص نقل البيانات.
تعديل البيان
يتطلّب ملف manifest.json
استخدام تنسيق Manifest V3 مختلف قليلاً عن تنسيق Manifest V2. تصف هذه الصفحة التغييرات التي تؤثر فقط في ملف manifest.json
. إنّ العديد من التغييرات على النصوص البرمجية والصفحات تتطلّب أيضًا إجراء تغييرات على البيان. وتشمل هذه التغييرات مهام نقل البيانات التي تتطلّبها.
النقل إلى عامل خدمات
يستبدل مشغّل الخدمات خلفية الإضافة أو صفحة الحدث لضمان بقاء رمز الخلفية خارج سلسلة التعليمات الرئيسية. يؤدي ذلك إلى تفعيل الإضافات عند الحاجة فقط، ما يؤدي إلى توفير الموارد.
قبل البدء، يمكنك الاطّلاع على الاختلافات بين النصوص البرمجية للخلفية والعاملين في خدمات الإضافات.
- تعديل حقل "الخلفية" في البيان
- نقل استدعاءات DOM والنوافذ إلى مستند خارج الشاشة
- تحويل LocalStorage إلى chrome.storage.local
- تسجيل أدوات الاستماع بشكل متزامن
- استبدال المكالمات إلى
XMLHttpRequest()
بـfetch()
عمومية. - الحالات المستمرة
- تحويل الموقّتات إلى منبّهات
- الحفاظ على استمرارية عامل الخدمة (في حالات استثنائية)
تعديل طلبات البيانات من واجهة برمجة التطبيقات
يجب استبدال بعض الميزات بإصدارات Manifest V3 المكافئة لها. ويجب إزالة الإعلانات الأخرى تمامًا.
- استبدال
tabs.executeScript()
بـscripting.executeScript()
- استبدال
tabs.insertCSS()
وtabs.removeCSS()
بـscripting.insertCSS()
وscripting.removeCSS()
. - استبدال إجراءات المتصفّح وإجراءات الصفحة بالإجراءات
- استبدال الدوال التي تتوقّع سياق خلفية Manifest V2:
- استبدال عمليات معاودة الاتصال بالوعود
- استبدال واجهات برمجة التطبيقات غير المتوافقة
استبدال أدوات معالجة طلبات الويب المحظورة
بدلاً من قراءة طلبات الشبكة آليًا وتغييرها (كما فعلت في إصدار Manifest V2)، تحدِّد الإضافة القواعد التي تصف الإجراءات التي يجب تنفيذها عند استيفاء مجموعة معيّنة من الشروط.
بعد إكمال العناصر المذكورة أعلاه، يمكنك مراجعة بعض حالات الاستخدام الشائعة:
تحسين أمان الإضافات
يجب إجراء تغييرات لتحسين مستوى أمان الإضافات. ويتضمن ذلك إزالة الرمز الذي تتم استضافته عن بُعد، والذي لم يعد متاحًا.
- إزالة تنفيذ السلاسل العشوائية:
- إزالة الرمز المستضاف عن بُعد
- تعديل سياسة أمان المحتوى
- إزالة قيم سياسة أمان المحتوى غير المتوافقة
نشر الإصدار 3 من بيان الإضافة
بعد التحويل إلى إصدار Manifest 3، يحين وقت إصدار إضافتك على "سوق Chrome الإلكتروني". استنادًا إلى التغييرات التي تم إجراؤها، ننصحك بإجراء عملية طرح تدريجية. ويسمح لك هذا الأسلوب بالتأكد من أنّ إضافتك تعمل كما هو متوقع مع جمهور محدود أولاً، قبل نشرها لقاعدة المستخدمين بأكملها.