تعديل البيان

تحويل ملف بيان بالإصدار 2 إلى ملف بيان بالإصدار 3

يتطلب ملف manifest.json تنسيقًا مختلفًا قليلاً في الإصدار Manifest V3 عن تنسيق Manifest V2. توضّح هذه الصفحة التغييرات التي تؤثر في ملف manifest.json فقط. ولكن تتطلّب العديد من التغييرات على النصوص البرمجية والصفحات أيضًا إجراء تغييرات على البيان. وتتم تغطية هذه التغييرات من خلال مهام نقل البيانات التي تتطلبها.

تغيير رقم إصدار البيان

غيِّر قيمة الحقل "manifest_version" من 2 إلى 3.

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

{
  ...
  "manifest_version": 3
  ...
}

تعديل أذونات المضيف

إنّ أذونات المضيف في الإصدار 3 من ملف البيان هي حقل منفصل، ولا يتم تحديدها في "permissions" أو "optional_permissions".

تظل النصوص البرمجية للمحتوى ضمن "content_scripts.matches". اطّلِع على الإدراج باستخدام التعريفات الثابتة للحصول على معلومات عن "content_scripts.matches".

{
  ...
  "permissions": [
    "tabs",
    "bookmarks",
    "https://www.blogger.com/",
  ],
  "optional_permissions": [
    "unlimitedStorage",
    "*://*/*",
  ]
  ...
}

{
  ...
  "permissions": [
    "tabs",
    "bookmarks"
  ],
  "optional_permissions": [
    "unlimitedStorage"
  ],
  "host_permissions": [
    "https://www.blogger.com/",
  ],
  "optional_host_permissions": [
    "*://*/*",
  ]
  ...
}

تعديل الموارد المتاحة على الويب

الموارد التي يمكن الوصول إليها من الويب هي ملفات داخل إضافة يمكن الوصول إليها من صفحات الويب أو إضافات أخرى. وفقًا للتنفيذ في الإصدار 2 من بيان الإضافة، سمح حقل "web_accessible_resources" للمواقع الإلكترونية والمهاجمين برصد الإضافات إذا اختارت الكشف عن الموارد. وقد أدّى ذلك إلى ظهور فرص لتحديد الهوية أو الوصول غير المقصود إلى الموارد.

يحدّ الإصدار 3 من بيان الإضافة من مستوى الظهور من خلال حظر المواقع الإلكترونية والإضافات التي يمكنها الوصول إلى الموارد في إضافتك. بدلاً من تقديم قائمة بالملفات كما في السابق، يمكنك الآن تقديم صفيف من العناصر، يربط كلّ منها مجموعة من الموارد بمجموعة من عناوين URL أو أرقام تعريف الإضافات.

يقارن المثال أدناه بين المراجع التي يمكن الوصول إليها على الويب في الإصدار 2 من بيان التطبيق والإصدار 3 منه. في الإصدار 2 من Manifest، كان بإمكان جميع المواقع الإلكترونية الوصول تلقائيًا إلى الموارد المحدّدة. في رمز Manifest V3 المعروض أدناه، لا تتوفّر هذه الموارد إلا https://example.com، في حين تتوفّر صور معيّنة فقط لجميع المواقع الإلكترونية.

لمزيد من المعلومات، يُرجى الاطّلاع على الموارد التي يمكن الوصول إليها من الويب وأنماط المطابقة.

{
  ...
  "web_accessible_resources": [
    "images/*",
    "style/extension.css",
    "script/extension.js"
  ],
  ...
}

{
  ...
    "web_accessible_resources": [
    {
      "resources": [
        "images/*"
      ],
      "matches": [
        "*://*/*"
      ]
    },
    {
      "resources": [
        "style/extension.css",
        "script/extension.js"
      ],
      "matches": [
        "https://example.com/*"
      ]
    }
  ],
  ...
}