استخدام طرق التثبيت البديلة

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

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

في الحالات السابقة، يتيح متصفّح Google Chrome طرق تثبيت الإضافات التالية:

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

تحذير بشأن إضافة خارجية

في نظام التشغيل Linux، يمكن أن يشير ملف الإعدادات المفضّلة إلى إضافة من "سوق Chrome الإلكتروني" أو إضافة مستضافة خارجيًا أو ملف إضافة CRX على جهاز الكمبيوتر الخاص بالمستخدم. ولن يُطلب من مستخدمي Linux تفعيل الإضافة، بل يتم تثبيتها تلقائيًا.

قبل البدء

التثبيت من "سوق Chrome الإلكتروني"

إذا كنت توزّع إضافة مستضافة في "سوق Chrome الإلكتروني"، عليك أولاً نشر الإضافة. بعد ذلك، يُرجى تدوين ما يلي:

  • عنوان URL لتعديل المحتوى: https://clients2.google.com/service/update2/crx. يشير عنوان URL هذا إلى سوق Chrome الإلكتروني.
  • معرِّف الإضافة: يمكن العثور عليه في عنوان URL للإضافة في "سوق Chrome الإلكتروني".

‎item id لعنصر في سوق Chrome الإلكتروني

التثبيت من ملف CRX على الجهاز

إذا كنت توزّع التطبيق على مستخدمي Linux من ملف على الجهاز، عليك تجميع ملف CRX وتدوين المعلومات التالية:

  • رقم تعريف الإضافة: يمكن العثور عليه في صفحة إدارة الإضافات chrome://extensions.

  • إصدار الإضافة: يظهر هذا العنصر في صفحة إدارة الإضافة chrome://extensions أو في ملف البيان بتنسيق JSON.

كيفية العثور على رقم تعريف الإضافة وإصدارها

  • الموقع الجغرافي لملف CRX: يمكن أن يكون دليلاً محليًا أو مشاركة على الشبكة. تأكَّد من توفّر الملف على الجهاز الذي تريد تثبيت الإضافة عليه.

التثبيت من خادم شخصي

إذا كنت توزّع إضافة مستضافة على خادم شخصي لمستخدمي Linux، عليك اتّباع تعليمات تثبيت الإضافات على Linux والاطّلاع على الخطوات التالية:

  • رقم تعريف الإضافة: يمكن العثور عليه في صفحة إدارة الإضافات chrome://extensions.

  • update_url XML file path: يجب أن يتطابق هذا المسار مع مسار حقل update_url المحدَّد في ملف البيان بتنسيق JSON.

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

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

نظام التشغيل Mac

  1. أنشئ ملف JSON يتضمّن اسم معرّف الإضافة. مثلاً: aaabbbcccdddeeefff.json

  2. ضَع الملف في أحد المجلدات التالية:

    لمستخدم محدَّد
    ~USERNAME/Library/Application Support/Google/Chrome/External Extensions/
    لجميع المستخدمين
    /Library/Application Support/Google/Chrome/External Extensions/

  3. حدِّد عنوان URL الخاص بالتحديث باستخدام اسم الحقل "external_update_url". على سبيل المثال: json { "external_update_url": "https://clients2.google.com/service/update2/crx" }

  4. احفظ ملف JSON.

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

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

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

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

Linux

  1. أنشئ ملف JSON يتضمّن اسم معرّف الإضافة. على سبيل المثال: aaabbbcccdddeeefff.json.

  2. ضَع الملف في أحد المجلدات التالية:

    • /opt/google/chrome/extensions/
    • /usr/share/google-chrome/extensions/

  3. توضِّح القائمة التالية كيفية تثبيت الإضافة من "سوق Chrome الإلكتروني" أو من ملف CRX أو من خادم شخصي:

    • لتثبيت إضافة من سوق Chrome الإلكتروني، حدِّد عنوان URL للتحديث باستخدام اسم الحقل "external_update_url". على سبيل المثال: json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
    • لتثبيت الإضافة من ملف CRX، حدِّد الموقع في "external_crx" والإصدار في "external_version". مثلاً: json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
    • لتثبيت الإضافة المُستضافة على خادم شخصي، يجب أن يشير الحقل "external_update_url" إلى ملف XML، كما في المثال التالي: json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }

  4. احفظ ملف JSON.

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

اللغات المتاحة

إذا كنت تريد تثبيت الإضافة لبعض لغات المتصفّح فقط، يمكنك إدراج اللغات المتوافقة في اسم الحقل supported_locales. قد تحدّد "اللغة" اللغة الرئيسية مثل "en"، وفي هذه الحالة سيتم تثبيت الإضافة لجميع اللغات الإنجليزية مثل "en-US" و"en-GB" وما إلى ذلك. وفي حال اختيار لغة متصفّح أخرى غير متوافقة مع الإضافة، سيتم إلغاء تثبيت الإضافات الخارجية. في حال عدم توفّر قائمة "اللغات_المتوافقة"، سيتم تثبيت الإضافة لأي لغة. على سبيل المثال:

{
  "external_update_url": "https://clients2.google.com/service/update2/crx",
  "supported_locales": [ "en", "fr", "de" ]
}

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

  1. ابحث عن المفتاح التالي أو أنشئه في السجل:

    نظام التشغيل Windows بإصدار 32 بت
    HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
    نظام التشغيل Windows 64 بت
    HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions

  2. أنشئ مفتاحًا (مجلدًا) جديدًا ضمن مفتاح الإضافات بالاسم نفسه الذي يحمله رقم تعريف الإضافة. على سبيل المثال: aaabbbcccdddeeefff.

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

  4. افتح متصفّح Chrome.

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

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

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

لتعديل امتداد ملف CRX على الجهاز إلى إصدار جديد، عدِّل الملف، ثم عدِّل الإصدار في ملف json للإعدادات المفضّلة.

لإلغاء تثبيت الإضافة (على سبيل المثال، إذا تم إلغاء تثبيت برنامجك)، عليك إزالة ملف الإعدادات المفضّلة (مثلاً aaabbbcccdddeeefff.json) أو البيانات الوصفية من قاعدة بيانات المسجّلين.

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

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

هل لا يزال خيار "التثبيت المُسبَق" متاحًا في Google Chrome؟

نعم، ولكن فقط كعملية تثبيت من update_url في "سوق Chrome الإلكتروني"، وليس من مسار CRX على الجهاز. لمزيد من المعلومات، يُرجى الاطّلاع على سياسات التطبيقات والإضافات.

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

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

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

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

ماذا يحدث إذا أزال المستخدم الإضافة؟

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

كيف يمكنني إزالة الصفحة من القائمة المحظورة؟

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