الوحدات المشتركة

الوحدات المشتركة هي مجموعات من الموارد التي لا يُسمح لها بالحصول على إذن ويمكن مشاركتها مع مستخدمين آخرين. الإضافات والتطبيقات. الاستخدامات الشائعة للوحدات المشتركة هي:

  • كواجهة برمجة تطبيقات. يمكنك توزيع "وحدة مشتركة" يمكنها توفير HTML وJS وغيرها من المصادر إلى توفير واجهة برمجة تطبيقات يمكن تحديثها بشكل مستقل عن الإضافات التي تعتمد عليها. يمكن أن تظهر فائدة هذا بوضوح أكبر مفيدة لبيئات التشغيل ومحركات الألعاب، حيث تكون التطبيقات غالبًا حمولات بيانات أصغر تعمل على رمز الوحدة المشتركة.
  • كتحسين للتنزيل. تحتوي الوحدة المشتركة على موارد شائعة تستخدمها العديد من الإضافات. ويتم تنزيله مرة واحدة، عند تثبيت إضافة تابعة لأول مرة.

البيان

يتم استخدام "الوحدات المشتركة" من خلال حقلَي بيان: التصدير والاستيراد.

يشير حقل التصدير إلى أنّ الإضافة هي وحدة مشتركة تصدِّر مواردها:

{
  "version": "1.0",
  "name": "My Shared Module",
  "export": {
    // Optional list of extension IDs explicitly allowed to
    // import this Shared Module's resources.  If no allowlist
    // is given, all extensions are allowed to import it.
    "allowlist": [
      "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
    ]
  }
  // Note: no permissions are allowed in Shared Modules
}

تستخدم الإضافات والتطبيقات حقل استيراد للتصريح بأنها تعتمد على موارد من وحدات مشتركة معينة:

{
  "version": "1.0",
  "name": "My Importing Extension",
  ...
  "import": [
    {"id": "cccccccccccccccccccccccccccccccc"},
    {"id": "dddddddddddddddddddddddddddddddd"
     "minimum_version": "0.5" // optional
    },
  ]
}

الوصول إلى الموارد

يمكن الوصول إلى موارد الوحدات المشتركة من خلال مسار محجوز _modules/SHARED_MODULE_ID في الجذر. لإضافة الاستيراد. على سبيل المثال، لتضمين النص البرمجي "foo.js" من وحدة مشتركة مع المعرّف "cccccccccccccccccccc"، استخدم هذا المسار من جذر الإضافة:

<script src="_modules/cccccccccccccccccccccccccccccccc/foo.js">

إذا كانت إضافة الاستيراد تتضمّن رقم التعريف "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa"، في هذه الحالة، عنوان URL الكامل للموارد في الوحدة المشتركة هي:

chrome-extension://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/_modules/cccccccccccccccccccccccccccccccc/

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

التثبيت / إلغاء التثبيت

يتم تثبيت الوحدة المشتركة تلقائيًا من سوق Chrome الإلكتروني عند الحاجة من خلال دليل بالإضافة إلى إلغاء تثبيته تلقائيًا عند إلغاء تثبيت الإضافة الأخيرة التي ترجع إليها. لتحميل إضافة تستخدم "وحدة مشتركة"، يجب نشر "الوحدة المشتركة" في يجب ألا يتم حظر "سوق Chrome الإلكتروني" والإضافة من استخدام "الوحدة المشتركة" من خلال القائمة المسموح بها.

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