تحقيق التوافق بين Firefox وGoogle Chrome: حلول لتجنب تحذير ‘Unrecognized manifest key’

عند مواجهتك لتحذير في Google Chrome بسبب مفتاح ‘applications’ غير المعترف به في ملف التكوين (manifest.json)، يتعين عليك النظر في الاختلافات بين متطلبات تطبيقات الويب (Web Extensions) في Firefox وGoogle Chrome.

أولاً وقبل كل شيء، يجب عليك أن تدرك أن هناك بعض الاختلافات بين المتصفحين، حتى وإن كنت تستخدم واجهة برمجة التطبيقات (API) الخاصة بـ Google Chrome في تطبيق الويب الخاص بك. في هذا السياق، يعتبر مفتاح ‘applications’ غير معترف به في Google Chrome، ولكنه متوافق مع Firefox.

لحل هذه المشكلة وضمان أن تعمل الإضافة على كل من Firefox وGoogle Chrome دون تحذيرات، يمكنك اتباع الخطوات التالية:

1. استخدام شرط مشروط:

   • قم بإضافة مفتاح ‘applications’ في ملف manifest.json واجعله ضمن شرط يستبين أنه يجب تضمينه فقط عند التثبيت على Firefox.

   jsonCopy code
   "applications": {
       "gecko": {
           "id": "your-firefox-addon-id"
       }
   }
   

   ضمن ملف manifest.json.

2. استخدام مفتاح ‘chrome_url_overrides’:

   • قم بفصل الأكواد التي تختلف بين Firefox وGoogle Chrome في ملفات مختلفة، ثم استخدم مفتاح ‘chrome_url_overrides’ في manifest.json لتحديد الملفات التي تختلف بين المتصفحين.

   jsonCopy code
   "chrome_url_overrides": {
       "newtab": ["newtab.html"]
   }
   

3. استخدام مفتاح ‘browser_action’:

   • قم بتحديد أي خصائص تختلف بين المتصفحين ضمن مفتاح ‘browser_action’ أو أي مفتاح آخر يكون مشترك بينهما.

   jsonCopy code
   "browser_action": {
       "default_icon": {
           "16": "images/icon16.png",
           "48": "images/icon48.png",
           "128": "images/icon128.png"
       },
       "default_popup": "popup.html",
       "default_title": "My Extension"
   }
   

   تأكد من الالتزام بجميع المتطلبات الخاصة بـ Google Chrome وFirefox لتضمن أن تعمل الإضافة بشكل صحيح على كل منهما دون تحذيرات.

تشير الرسالة “Unrecognized manifest key ‘applications'” التي تظهر عند محاولة تثبيت الامتداد على Google Chrome إلى أن هناك مشكلة في ملف التعريف (manifest.json) الخاص بامتدادك. هذه المشكلة تنبع من استخدام مفتاح (‘applications’) الذي لا يتم التعرف عليه من قِبل Google Chrome. تظهر هذه المشكلة بسبب اختلاف في متطلبات تعريف الامتداد بين Google Chrome وFirefox.

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

من ثم، يُفضل استخدام مفاتيح مختلفة في ملف التعريف لتحقيق التوافق بين الامتدادين. يمكنك استخدام الشرطية (conditionals) في ملف التعريف لتحديد أي مفتاح يتم استخدامه بناءً على نوع المتصفح. على سبيل المثال، يمكنك استخدام الشرطية كالتالي:

jsonCopy code
"browser_specific_settings": {
  "gecko": {
    "id": "your-firefox-extension-id",
    "strict_min_version": "firefox-version"
  },
  "chrome": {
    "id": "your-chrome-extension-id"
  }
},

هنا، يتم تعيين الخصائص المحددة لكل متصفح باستخدام الشرطية “gecko” لـFirefox و “chrome” لـGoogle Chrome. يجب استبدال “your-firefox-extension-id” و “your-chrome-extension-id” بمعرفات الامتداد الخاصة بك، وكذلك “firefox-version” بالإصدار الأدنى المطلوب من Firefox.

بهذه الطريقة، يمكنك تحقيق التوافق بين الامتدادين وتجنب ظهور التحذيرات عند تثبيت الامتداد على Google Chrome.