مراحل دورة حياة تحديث إضافة Chrome

يوضّح هذا الدليل عملية تحديث الإضافة بالكامل، ويشمل عملية التحديث العادية وعمليات الإلغاء اليدوية وواجهات برمجة التطبيقات الخاصة بالمطوّرين والتأثير الكبير لسياسات المؤسسات.

دورة التحديث العادية

تم تصميم Chrome لتحديث الإضافات المثبَّتة تلقائيًا إلى أحدث إصداراتها، ما يضمن حصول المستخدمين على الميزات الجديدة وإصلاحات الأمان. يتحقّق Chrome تلقائيًا من توفّر تحديثات للإضافات عند بدء التشغيل وكل بضع ساعات.

من الجوانب المهمة في عملية التحديث أنّه لا يتم تثبيت التحديث إلا عندما تكون الإضافة في حالة عدم النشاط. لكي تكون الإضافة في وضع الخمول، يجب ألا تكون مكوّناتها قيد الاستخدام النشط. في سياق Manifest V3، يعني ذلك في المقام الأول أنّ مشغّل الخدمات الخاص بالإضافة لا يعمل. تم تصميم عامل الخدمة ليكون مستندًا إلى الأحداث ويتوقف بعد فترة من عدم النشاط. بالإضافة إلى ذلك، تمنع أي صفحات إضافات مفتوحة، مثل اللوحة الجانبية أو النافذة المنبثقة أو صفحة الخيارات، اعتبار الإضافة غير نشطة. لا يؤثّر النص البرمجي النشط الخاص بالمحتوى في ما إذا كانت الإضافة تُعتبر غير نشطة أم لا.

يمكن أن يؤدي شرط عدم النشاط هذا إلى حدوث تأخيرات في تحديثات الإضافات النشطة بشكل متكرّر. إذا كان عامل الخدمة لإحدى الإضافات يتم تشغيله باستمرار من خلال الأحداث، قد لا يصل أبدًا إلى حالة الخمول، وسيتم تأجيل التحديث إلى حين إعادة تشغيل المتصفّح.

مراقبة توزيع تحديثات الإضافات

لمعرفة عدد المستخدمين الذين يستخدمون أحدث إصدار من إضافتك، استخدِم لوحة بيانات إحصاءات "سوق Chrome الإلكتروني". انتقِل إلى لوحة بيانات المطوّر في "سوق Chrome الإلكتروني" واختَر إحدى الإضافات المنشورة. في شريط التنقّل الجانبي، انتقِل إلى: إحصاءات Google -> المستخدِمون وانتقِل للأسفل إلى مخطّط المستخدِمين اليوميين حسب العنصر. يمكنك هنا الاطّلاع على عدد المستخدمين الذين يستخدمون أحدث إصدار من تطبيقك.

تعديل الإضافات يدويًا

إذا أراد المستخدمون تلقّي آخر التحديثات على الفور، يوفّر Chrome آلية تحديث يدوي. وهذه أيضًا أداة مفيدة عند اختبار التحديثات.

يمكن للمستخدمين الفرديين فرض إجراء تحديث لجميع الإضافات المثبَّتة من خلال اتّباع الخطوات التالية:

1. انتقِل إلى chrome://extensions.
2. فعِّل وضع مطور البرامج باستخدام زر التبديل في أعلى يسار الشاشة.
3. انقر على زر تعديل الذي يظهر.

يؤدي هذا الإجراء إلى أن يجلب Chrome على الفور أحدث إصدارات جميع الإضافات المثبَّتة من "سوق Chrome الإلكتروني".

التحقّق من توفّر تحديثات من إضافة

توفّر واجهة برمجة التطبيقات browser.runtime أدوات تتيح للإضافات التفاعل مع آلية التحديث.

البحث عن تحديثات عند الطلب

تتيح الدالة browser.runtime.requestUpdateCheck() لإحدى الإضافات بدء عملية البحث عن التحديثات آليًا. ويكون ذلك مفيدًا بشكل خاص للإضافات التي تعتمد بشكل كبير على خدمة خلفية وتحتاج إلى التأكّد من أنّها تستخدم أحدث إصدار متوافق.

عند استدعاء هذه الدالة، يطلب Chrome من "سوق Chrome الإلكتروني" إصدارًا جديدًا ويتم تنزيل الإصدار الجديد إذا كان متاحًا. تتلقّى دالة ردّ الاتصال حالة تشير إلى نتيجة عملية التحقّق.

الاستماع إلى التحديثات المتوفّرة

يتم تشغيل الحدث browser.runtime.onUpdateAvailable عند تنزيل تحديث ويكون جاهزًا للتثبيت. يوفّر هذا الحدث رقم الإصدار الجديد في تفاصيله. من خلال الاستماع إلى هذا الحدث، يمكن للإضافة تحديد ما إذا كان يتوفّر تحديث، ويمكنها اختيار عدم تنفيذ أي إجراء أو إعادة التحميل باستخدام browser.runtime.reload() عند الاقتضاء.

يوضّح الرمز التالي نمطًا أساسيًا للتنفيذ:

في حالات استثنائية، يمكن فرض التحقّق من توفّر تحديث للإضافة باستخدام browser.runtime.requestUpdateCheck():

يُرجى العِلم أنّ المتصفّح سيحدّ من عدد المرات التي يمكن فيها استدعاء الدالة requestUpdateCheck() بشكل متكرّر. استخدِم هذه الدالة فقط عندما تعرف أنّ هناك تحديثًا متاحًا. على سبيل المثال، عندما تتطلّب الخلفية المُعدَّلة إصدارًا أحدث من الإضافة.

التحكّم في التحديثات من خلال سياسة المؤسسة

في بيئات المؤسسات المُدارة، يخضع مسار تحديث الإضافات العادي للسياسات التي يضبطها مشرفو النظام. يمكن أن تتجاوز هذه السياسات السلوك التلقائي لفرض الأمان والثبات.

فرض التثبيت

تسمح سياسة ExtensionInstallForcelist للمشرفين بتثبيت إضافات معيّنة تلقائيًا للمستخدمين. لا يمكن للمستخدمين إيقاف الإضافات المثبَّتة باستخدام هذه السياسة أو إلغاء تثبيتها.

تثبيت إصدار الإضافة

ومع ذلك، تحتاج المؤسسات غالبًا إلى التحكّم في الإصدار الدقيق للإضافة المستخدَمة لضمان التوافق مع البرامج الأخرى. لتحقيق ذلك، يمكن للمشرفين "تثبيت" إضافة على إصدار معيّن. يتم ذلك من خلال "وحدة تحكّم المشرف في Google"، حيث يمكن للمشرف اختيار الإصدار المطلوب لوحدة تنظيمية. عند تثبيت إصدار معيّن من إضافة، لن يحدّث Chrome هذه الإضافة إلى إصدار أحدث من الإصدار المحدّد.

تجاوز مصدر التحديث

يمكن للمؤسسات استضافة إصدارات معدَّلة من الإضافات لأسباب تتعلّق بالأمان أو التخصيص. لإجراء ذلك، استخدِم سياسة ExtensionSettings مع ضبط الخاصية override_update_url على "صحيح". يؤدي ذلك إلى إجبار Chrome على جلب الإضافة وتحديثاتها من عنوان URL محدّد، بدلاً من "سوق Chrome الإلكتروني".

ضبط الحدّ الأدنى لإصدار Chrome

يمكنك تحديد minimum_chrome_version في ملف بيان الإضافة. يضمن ذلك عدم تثبيت الإضافة إلا على إصدارات Chrome التي تتوافق مع واجهات برمجة التطبيقات التي تستخدمها.

بالنسبة إلى عمليات التثبيت الجديدة، سيمنع "سوق Chrome الإلكتروني" المستخدمين الذين يستخدمون إصدارات قديمة من Chrome من تثبيت الإضافة، وسيتم عرض الرسالة "غير متوافق". بالنسبة إلى المستخدمين الحاليين، إذا أدّى تحديث إحدى الإضافات إلى زيادة minimum_chrome_version إلى إصدار أعلى من إصدار Chrome المثبَّت لدى المستخدم، سيتوقف المستخدم عن تلقّي تحديثات هذه الإضافة بدون إشعاره بذلك. على المطوّرين الانتباه إلى ذلك وإبلاغ المستخدمين إذا كان من المحتمل أن يتأثر جزء كبير من قاعدة المستخدمين.