خيارات توزيع الإضافات البديلة

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

يثبّت المستخدمون عادةً الإضافات من "سوق Chrome الإلكتروني"، ولكنك قد تريد في بعض الأحيان تثبيت إحدى الإضافات عن طريق وسائل أخرى. وإليك حالتين نموذجيتين:

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

تُعرف الإضافة التي لم يتم تثبيتها من "سوق Chrome الإلكتروني" باسم الإضافة الخارجية. بالنسبة إلى المطورين الذين يريدون توزيع إضافة كجزء من عملية التثبيت لبرامج أخرى، أو لمشرفي الشبكة الذين يريدون توزيع إضافة على مستوى مؤسستهم، يدعم Google Chrome طرق تثبيت الإضافات التالية:

  • استخدام ملف JSON للإعدادات المفضّلة (لنظام التشغيل Mac OS X وLinux فقط)
  • استخدام سجلّ Windows (لنظام التشغيل Windows فقط)

وتتيح كلتا الطريقتين تثبيت إضافة مستضافة على update_URL. على نظامَي التشغيل Windows وMac، يجب أن تشير العلامة update_URL إلى "سوق Chrome الإلكتروني" حيث يجب استضافة الإضافة.

يمكن أن يشير ملف الإعدادات المفضّلة على نظام التشغيل Linux إلى خادمك الخاص الذي تستضيف الإضافة عليه. يتيح ملف JSON للإعدادات المفضّلة أيضًا تثبيت امتداد من ملف الامتداد .crx على كمبيوتر المستخدم الذي يعمل بنظام التشغيل Linux.

قبل البدء

أولاً، publish الإضافة في "سوق Chrome الإلكتروني"، أو أنشئ ملفًا .crx واحرص على تثبيتها بنجاح.

في حال التثبيت من عنوان URL للتحديث، تأكَّد من استضافة الإضافة بشكل صحيح.

قبل تعديل ملف الإعدادات المفضّلة أو السجلّ، يُرجى تدوين ما يلي:

  • الموقع الجغرافي المقصود لملف الإضافة .crx أو عنوان URL للتحديث الذي يتم عرضه من خلاله
  • إصدار الإضافة (من ملف البيان أو صفحة chrome://extensions)
  • رقم تعريف الإضافة (من صفحة chrome://extensions عند تحميل الإضافة المجمّعة)

تفترض الأمثلة التالية أنّ الإصدار هو 1.0 ورقم التعريف هو aaaaaaaaaabbbbbbbbbbcccccccccc.

استخدام ملف إعدادات مفضّلة

  1. إذا كنت تجري التثبيت من ملف على نظام التشغيل Linux، فاجعل ملف الامتداد .crx متاحًا للجهاز الذي تريد تثبيت الإضافة عليه. (انسخه إلى دليل محلي أو إلى مشاركة في الشبكة، على سبيل المثال، \\server\share\extension.crx أو /home/share/extension.crx).

  2. أنشئ ملفًا بالاسم التالي في أحد المجلدات المدرَجة أدناه: aaaaaaaaaabbbbbbbbbbcccccccccc.json حيث يتوافق اسم الملف (بدون امتداد) مع معرِّف إضافتك. ويعتمد الموقع على نظام التشغيل.

    نظام التشغيل Mac OS X:

    بالنسبة إلى مستخدم محدّد: ~USERNAME/Library/Application Support/Google/Chrome/External Extensions/ بالنسبة إلى جميع المستخدمين: /Library/Application Support/Google/Chrome/External Extensions/

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

    أجهزة Linux:

    /opt/google/chrome/extensions/

    /usr/share/google-chrome/extensions/

    ملاحظة: استخدِم chmod إذا لزم الأمر للتأكد من أنّ ملفات aaaaaaaaaabbbbbbbbbbcccccccccc.json قابلة للقراءة عالميًا.

  3. Linux فقط: في حال التثبيت من ملف، حدد موقع الإضافة وإصدارها باستخدام الحقلين باسم "external_crx" و"external_version" في الملف الذي تم إنشاؤه أعلاه.

    • مثال:
    • json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
    • ملاحظة: عليك تخطي كل \` character in the location. For example,\server\share\extension.crxwould be"\\server\share\extension.crx"`.
    • في حال التثبيت من عنوان URL للتحديث، حدِّد عنوان URL لتحديث الإضافة باستخدام اسم الحقل external_update_url.
    • مثال على التثبيت من ملف .crx المحلي (نظام التشغيل Linux فقط):
    • json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }
    • مثال على التثبيت من سوق Chrome الإلكتروني (نظاما التشغيل Mac وLinux):
    • json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
    • إذا كنت ترغب في تثبيت إضافة لبعض لغات المتصفح فقط، فيمكنك إدراج اللغات المدعومة في اسم الحقل "supported_locale". قد تحدد اللغة المحلية لغة رئيسية مثل en، وفي هذه الحالة سيتم تثبيت الإضافة لجميع اللغات الإنجليزية مثل en-US وen-GB وما إلى ذلك. وإذا تم تحديد لغة متصفح أخرى غير متوافقة مع الإضافة، فسيتم إلغاء تثبيت الإضافات الخارجية. إذا كانت القائمة "supported_locales" مفقودة، سيتم تثبيت الإضافة لأي لغة.
    • مثال:
    • json { "external_update_url": "https://clients2.google.com/service/update2/crx", "supported_locales": [ "en", "fr", "de" ] }

  4. احفظ ملف JSON.

  5. شغِّل متصفّح Google Chrome وانتقِل إلى chrome://extensions، من المفترض أن تظهر لك الإضافة المُدرَجة.

تحديد مشاكل أذونات نظام التشغيل Mac وحلّها

في نظام التشغيل Mac، لا تتم قراءة ملفات الإضافات الخارجية لجميع المستخدمين إلا إذا كانت أذونات نظام الملفات تمنع المستخدمين غير المميّزين من تغييرها. إذا لم تظهر لك إضافات خارجية تم تثبيتها عند إطلاق Chrome، قد تكون هناك مشكلة في الأذونات متعلّقة بملفات الإعدادات المفضّلة للإضافات الخارجية. لمعرفة ما إذا كانت هذه هي المشكلة، اتّبِع الخطوات التالية:

  1. تشغيل برنامج Console يمكنك العثور عليها ضمن /Applications/Uutilities/ Console (التطبيقات/الأدوات المساعدة/وحدة التحكم).
  2. إذا كان الرمز الموجود في أقصى اليمين في وحدة التحكم يعرض عبارة "عرض قائمة السجلّات"، انقر على ذلك الرمز. يظهر عمود ثانٍ على اليسار.
  3. انقر فوق "رسائل وحدة التحكم" في اللوحة اليمنى.
  4. ابحث عن السلسلة لا يمكن قراءة الإضافات الخارجية. إذا كانت هناك مشكلة في قراءة ملفات الإضافات الخارجية، فستظهر لك رسالة خطأ. ابحث عن رسالة خطأ أخرى فوقها مباشرةً، والتي من المفترض أن تفسر المشكلة. على سبيل المثال، إذا ظهرت لك رسالة الخطأ التالية: "Path /Library/Application Support/Google/Chrome مملوك من خلال مجموعة غير صحيحة"، عليك استخدام chgrp أو مربّع حوار "الحصول على معلومات" في "الباحث" لتغيير مالك مجموعة الدليل إلى مجموعة المشرفين.
  5. بعد حلّ المشكلة، أعِد تشغيل Chrome. نفِّذ اختبارًا للتأكّد من أنّ الإضافة الخارجية قد تم تثبيتها الآن. فمن الممكن أن يؤدي خطأ في الأذونات إلى منع Chrome من اكتشاف خطأ ثانٍ. في حال عدم تثبيت الإضافة الخارجية، كرِّر هذه الخطوات حتى لا يظهر لك خطأ في تطبيق Console.

استخدام قاعدة بيانات المسجّلين على Windows

  1. ابحث عن المفتاح التالي أو أنشئه في السجلّ:
    • Windows 32 بت: HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
    • Windows 64 بت: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions
  2. أنشئ مفتاحًا جديدًا (مجلدًا) ضمن مفتاح الإضافات بالاسم نفسه كرقم تعريف الإضافة (على سبيل المثال، aaaaaaaaaabbbbbbbbbbcccccccccc).

  3. في مفتاح الإضافة، أنشئ الموقع "update_url" واضبطه على القيمة: "https://clients2.google.com/service/update2/crx" (يشير هذا إلى crx للإضافة في سوق Chrome الإلكتروني):

    {
  "update_url": "https://clients2.google.com/service/update2/crx"
}

  4. افتح المتصفّح وانتقِل إلى chrome://extensions، من المفترض أن تظهر لك الإضافة المُدرَجة.

التحديث والإلغاء

يفحص Google Chrome إدخالات البيانات الوصفية في التفضيلات والسجل في كل مرة يبدأ فيها المتصفح، ويجري أي تغييرات ضرورية على الإضافات الخارجية المثبتة.

لتحديث إضافتك إلى إصدار جديد، عليك تحديث الملف ثم تحديث الإصدار في الإعدادات المفضّلة أو قاعدة بيانات المسجّلين.

لإلغاء تثبيت الإضافة (على سبيل المثال، في حال إلغاء تثبيت البرنامج)، أزِل الملف المفضّل (aaaaaaaaaabbbbbbbbcccccccccc.json) أو البيانات الوصفية من السجلّ.

الأسئلة الشائعة

يجيب هذا القسم عن الأسئلة الشائعة حول الإضافات الخارجية.

هل ستظل منهجية السماح "بالتثبيت المسبق" متاحة في Google Chrome بدءًا من الإصدار M33 وصاعدًا؟

نعم، ولكن فقط كتثبيت من update_URL من "سوق Chrome الإلكتروني"، وليس من مسار ملف محلي.

هل يمكنني تحديد عنوان URL كمسار للإضافة الخارجية؟

نعم، استخدم ملف preferences JSON لنظامي التشغيل Mac OS X وLinux، وregistry لنظام التشغيل Windows. يجب أن تكون الإضافة مستضافة كما هو موضّح في الاستضافة. في ملف الإعدادات المفضّلة، استخدِم السمة "external_update_url" للإشارة إلى بيان التحديث الذي يحتوي على عنوان URL الخاص بالإضافة. في سجلّ Windows، استخدِم السمة "update_url".

ما هي بعض الأخطاء الشائعة التي تظهر عند التثبيت باستخدام ملف الإعدادات المفضّلة؟

  • عدم تحديد رقم التعريف/الإصدار نفسه كما هو الحال في .crx
  • تم وضع ملف .json (aaaaaaaaaabbbbbbbbbbcccccccccc.json) في مكان غير صحيح أو أنّ المعرّف المحدّد لا يتطابق مع رقم تعريف الإضافة.
  • خطأ في البنية في ملف JSON (نسيان فصل الإدخالات بفاصلة أو ترك فاصلة لاحقة في أي مكان)
  • يشير إدخال ملف JSON إلى المسار الخطأ إلى .crx (أو المسار المحدَّد ولكن بدون اسم ملف)
  • لم يتم تجاوز الشرطة المائلة للخلف في مسار UNC (على سبيل المثال، خطأ "\\server\share\file"، يجب أن يكون "\\\\server\\share\\extension").
  • مشاكل الأذونات في مشاركة شبكة

ما هي بعض الأخطاء الشائعة عند التثبيت باستخدام قاعدة بيانات المسجّلين؟

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

كيف يمكنني تحديث البرامج الثنائية الأصلية والإضافات خطوة بخطوة؟

في السابق، عندما كانت الإضافات من خارج المتجر متاحة، كان من الممكن تحديث البرامج الثنائية الأصلية والإضافة في خطوة القفل. ومع ذلك، يتم تحديث الإضافات المستضافة على "سوق Chrome الإلكتروني" من خلال آلية تحديث Chrome التي لا يتحكم فيها المطوّرون. وعلى مطوّري الإضافات الانتباه بشأن تحديث الإضافات التي تعتمد على البرنامج الثنائي الأصلي (على سبيل المثال، الإضافات القديمة التي تستخدم NPAPI).

ماذا لو ألغى المستخدم تثبيت الإضافة؟

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

كيف يمكنني الخروج من القائمة المحظورة؟

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