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

يجب توزيع جميع إضافات 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 الخاص بالمستخدم.

قبل البدء

أولاً، انشر الإضافة في "سوق 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 OS وإصلاحها

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

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

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

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

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

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