تعديل البيان

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

يتطلب ملف manifest.json تنسيقًا مختلفًا قليلاً لملف البيان بتنسيق V3 مقارنةً بملف البيان بتنسيق 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/*"
      ]
    }
  ],
  ...
}