إصدار البيان

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

الإصدار الحالي

على المطوّرين تحديد 'manifest_version': 2 حاليًا:

{
  ...,
  "manifest_version": 2,
  ...
}

تم إيقاف إصدار البيان 1 نهائيًا في الإصدار 18 من Chrome، وسيتم إيقاف التوافق التدريجي وفقًا لـ الجدول الزمني التالي.

الجدول الزمني للدعم لإصدار البيان 1

‏‫آب (أغسطس)‬ 2012

  • سيحظر "السوق الإلكتروني" إنشاء الإضافات الجديدة للإصدار 1 من البيان.
  • سيسمح "السوق الإلكتروني" بتحديثات الإصدار 1 الحالية من البيان.

آذار (مارس) 2013

  • سيحظر السوق الإلكتروني تحديثات إضافات الإصدار 1 في 4 آذار (مارس) 2013.

نيسان (أبريل) 2013

  • سيتوقف الإصدار التجريبي من Chrome 27 عن تجميع إضافات الإصدار 1 من ملف البيان (أو تحميلها لـ والتطوير).

حزيران (يونيو) 2013

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

سبتمبر 2013

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

كانون الثاني (يناير) 2014

  • سيتوقف Chrome عن تحميل أو تشغيل إضافات الإصدار 1 من البيان.

التغييرات بين الإصدار 1 و2

  • يتم ضبط سياسة أمان المحتوى على `script-src 'self'; object-src 'self'; تلقائيًا. هذا النمط له مجموعة متنوعة من التأثيرات على المطوّرين، كما هو موضَّح بالتفصيل في content_security_policy التوثيق.
  • لم تعد موارد الحزمة متاحة بشكل تلقائي للمواقع الإلكترونية الخارجية (مثل src أو صورة أو علامة script). إذا أردت أن يتمكن موقع ويب من تحميل مورد موجود في عليك إضافتها إلى القائمة المسموح بها بشكل صريح من خلال بيان web_accessible_resources. . وينطبق ذلك بشكل خاص على الإضافات التي تنشئ واجهة على موقع إلكتروني. عبر النصوص البرمجية للمحتوى الذي تم إدخاله.
  • تم استبدال السمة background_page بالسمة background التي تحتوي على إما أحد المواقع على scripts أو page. يمكنك الاطّلاع على التفاصيل في صفحات الفعاليات. التوثيق.

  • تغييرات إجراءات المتصفّح:

    • تمت إزالة المفتاح browser_actions في البيان وواجهة برمجة التطبيقات chrome.browserActions. يمكنك استخدام المفرد browser_action وchrome.browserAction بدلاً من ذلك.
    • تمت إزالة السمة icons الخاصة بـ browser_action. استخدام السمة default_icon أو browserAction.setIcon بدلاً من ذلك.
    • تمت إزالة السمة name الخاصة بـ browser_action. استخدام السمة default_title أو browserAction.setTitle بدلاً من ذلك.
    • تمت إزالة السمة popup الخاصة بـ browser_action. استخدام default_popup أو browserAction.setPopup بدلاً منه.
    • لم يعُد من الممكن تحديد السمة default_popup لـ browser_action ككائن. أُنشأها جون هنتر، الذي كان متخصصًا أن تكون سلسلة.

  • تغييرات إجراءات الصفحة:

    • تمت إزالة المفتاح page_actions في البيان وواجهة برمجة التطبيقات chrome.pageActions. يمكنك استخدام المفرد page_action وchrome.pageAction بدلاً من ذلك.
    • تمت إزالة السمة icons الخاصة بـ page_action. استخدام السمة default_icon يمكنك استخدام pageAction.setIcon بدلاً من ذلك.
    • تمت إزالة السمة name الخاصة بـ page_action. استخدام السمة default_title يمكنك استخدام pageAction.setTitle بدلاً من ذلك.
    • تمت إزالة السمة popup الخاصة بـ page_action. استخدام السمة default_popup أو pageAction.setPopup بدلاً من ذلك.
    • لم يعُد من الممكن تحديد السمة default_popup لـ page_action ككائن. يجب عبارة عن سلسلة.

  • تمت إزالة واجهة برمجة التطبيقات chrome.self. يمكنك استخدام chrome.extension بدلاً من ذلك.

  • اختفى chrome.extension.getTabContentses (!!!) وchrome.extension.getExtensionTabs. استخدام extension.getViews بدلاً من ذلك.

  • اختفى Port.tab. استخدِم runtime.Port بدلاً منه.