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

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

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

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

  • استخدام ملف preferences JSON (لنظام التشغيل macOS X وLinux فقط)
  • استخدام سجلّ Windows (لنظام التشغيل Windows فقط)

وتتيح كلتا الطريقتين تثبيت إضافة تتم استضافتها على 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 الإلكتروني".

معرّف عنصر في سوق Chrome الإلكتروني

التثبيت من ملف CRX المحلي

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

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

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

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

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

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

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

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

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

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

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

macOS

  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/Uutilities/Console.
  2. إذا كان الرمز الموجود في أقصى اليمين في وحدة التحكم ينص على "عرض قائمة السجلّات"، انقر على ذلك الرمز. يظهر عمود ثانٍ على اليسار.
  3. انقر على "رسائل وحدة التحكّم" في اللوحة اليمنى.
  4. ابحث عن السلسلة لا يمكن قراءة الإضافات الخارجية. إذا كانت هناك مشكلة في قراءة ملفات الإضافات الخارجية، ستظهر رسالة خطأ. ابحث عن رسالة خطأ أخرى قبلها مباشرةً، والتي من المفترض أن تفسر المشكلة. على سبيل المثال، إذا ظهر لك الخطأ التالي: "المسار /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" وما إلى ذلك. وإذا تم اختيار لغة متصفح أخرى غير متوافقة مع الإضافة، سيتم إلغاء تثبيت الإضافات الخارجية. في حال عدم توفّر القائمة "supported_locales"، سيتم تثبيت الإضافة لأي لغة. مثال:

{
  "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 محلي. لمزيد من المعلومات، يُرجى الاطّلاع على سياسات التطبيقات والإضافات.

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

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

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

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

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

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

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

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