تعديل البيان

تحويل ملف البيان V2 إلى بيان V3

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

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

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

إصدار Manifest V2
{
  ...
  "manifest_version": 2
  ...
}
ملف البيان - الإصدار 3
{
  ...
  "manifest_version": 3
  ...
}

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

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

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

إصدار Manifest V2
{
  ...
  "permissions": [
    "tabs",
    "bookmarks",
    "https://www.blogger.com/",
  ],
  "optional_permissions": [
    "unlimitedStorage",
    "*://*/*",
  ]
  ...
}
ملف البيان - الإصدار 3
{
  ...
  "permissions": [
    "tabs",
    "bookmarks"
  ],
  "optional_permissions": [
    "unlimitedStorage"
  ],
  "host_permissions": [
    "https://www.blogger.com/",
  ],
  "optional_host_permissions": [
    "*://*/*",
  ]
  ...
}

تحديث الموارد التي يمكن الوصول إليها على الويب

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

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

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

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

إصدار Manifest V2
{
  ...
  "web_accessible_resources": [
    "images/*",
    "style/extension.css",
    "script/extension.js"
  ],
  ...
}
ملف البيان - الإصدار 3
{
  ...
    "web_accessible_resources": [
    {
      "resources": [
        "images/*"
      ],
      "matches": [
        "*://*/*"
      ]
    },
    {
      "resources": [
        "style/extension.css",
        "script/extension.js"
      ],
      "matches": [
        "https://example.com/*"
      ]
    }
  ],
  ...
}