إرشادات التحذير بشأن الأذونات

تعمل إضافات Chrome على تحسين تجربة المستخدم في المتصفِّح. لتنفيذ هذه الإضافات، يمكنك استخدام واجهات برمجة تطبيقات Chrome التي تتطلب أذونات معيّنة. تُعد بعض الأذونات أقل تدخُّلاً ولا تعرض أي تحذير. تؤدي الأذونات الأخرى إلى ظهور تحذير يجب أن يسمح به المستخدمون. توفر هذه الصفحة إرشادات للتعامل مع التحذيرات المتعلقة بالأذونات. تتم الإشارة إلى تحذيرات محدّدة في الأذونات بموجب الإذن الذي تسري عليه هذه الأذونات.

يتم عرض مثال على تحذيرات بشأن الأذونات عندما يُضيف المستخدم إضافة جديدة.
الشكل 1: يظهر مربّع حوار تحذيرات بشأن الأذونات أثناء التثبيت.

عندما يتم إدراج إذن جديد يؤدي إلى ظهور تحذير، سيتم إيقاف الإضافة إلى أن يقبل المستخدم الإذن الجديد. راجع تعديل الأذونات للتعرّف على كيفية اختبار هذا السلوك.

مثال على إضافة تم إيقافها إلى أن يقبل المستخدم الإذن الجديد
الشكل 2: إضافة يتم إيقافها إلى أن يقبل المستخدم الإذن الجديد.

قد لا تعرض بعض الأذونات تحذيرات عند إقرانها بأذونات أخرى. على سبيل المثال، لن يظهر التحذير "tabs" إذا كانت الإضافة تطلب "<all_urls>" أيضًا.

أفضل الممارسات

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

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

عرض التحذيرات

لعرض التحذيرات المتعلّقة بأذونات الإضافات، تتوفّر لك الخيارات التالية:

استخدام أداة اختبار تحديث الإضافات

قبل البدء

  1. ثبِّت Node.js وNPM.
  2. ثبِّت Chromium.
  3. استنسِخ المستودع extension-update-testing-tool.
  4. تشغيل npm install في جذر المستودع.

استخدام الأداة

  1. قم بتشغيل npm start.
  2. افتح الخادم المحلي على http://localhost:8080 في Chromium.
  3. اسحب إضافة تم فك حزمتها (مجلد أو ملف بتنسيق .zip) إلى الصفحة.
  4. اتّبِع التعليمات الواردة ضمن "التثبيت يدويًّا" لتنزيل الإضافة وتثبيتها.

من خلال تعبئة الإضافة يدويًا

  1. الانتقال إلى chrome://extensions
  2. تفعيل وضع مطوّر البرامج
  3. انقر على إضافة حزمة.
    إنشاء حزمة للإضافة
    الشكل 3: تم تفعيل وضع مطوّر البرامج في صفحة إدارة الإضافات
  4. حدِّد المسار إلى مجلد الإضافة في حقل الدليل الجذر للإضافة. يُرجى تجاهل حقل المفتاح الخاص لحزمة الفترة الأولى.

  5. انقر على الزر إضافة حزمة.

    حدِّد مسار الإضافة ثم انقر على &quot;حزمة الإضافة&quot;.
    الشكل 4: تحديد مسار الإضافة

  6. سينشئ متصفِّح Chrome ملفَين، ملف .crx وملف .pem. يحتوي ملف .pem على المفتاح الخاص الذي تم استخدامه لتوقيع الإضافة. احرص على تذكّر الدليل الذي تم حفظ هذه الملفات فيه.

    ملفات الإضافات المجمَّعة
    الشكل 5: ملفات الإضافات المجمَّعة

  7. احتفِظ بملف .pem في مكان سرّي وآمن، لأنّه سيكون مطلوبًا تحديث الإضافة.

  8. ثبِّت ملف .crx من خلال إفلاته في صفحة "إدارة الإضافة".

    أفلِت الملف لتثبيته.
    الشكل 6: إفلات الملف لتثبيته

  9. بعد إسقاط ملف .crx، سيسأل المتصفِّح عما إذا كان من الممكن إضافة الإضافة وسيعرض تحذيرات.

    تحذير بشأن إضافة علامة تبويب جديدة
    الشكل 7: تحذير بشأن إضافة علامة تبويب جديدة

تحديث الأذونات

عندما تُدرج الإضافة إذنًا جديدًا يؤدي إلى عرض تحذير، قد يتم إيقافها مؤقتًا. لن تتم إعادة تفعيل الإضافة إلا بعد موافقة المستخدم على قبول الإذن الجديد.

لمعرفة ما إذا كان سيتم إيقاف الإضافة عند إضافة إذن جديد، يمكنك اتّباع الخيارات التالية:

التحديث باستخدام "أداة اختبار تحديث الإضافات"

تفترض هذه الخطوات أنّك اتّبعت تعليمات استخدام "أداة اختبار تحديث الإضافات" لبدء تشغيل الخادم.

استخدام الأداة

  1. أضِف إذنًا جديدًا مع تحذير.
  2. عليك زيادة رقم إصدار الإضافة.
  3. اسحب الإضافة التي تم فك ضغطها (مجلد أو ملف بتنسيق .zip) إلى الصفحة.
  4. الانتقال إلى chrome://extensions.
  5. انقر على الزر تعديل.

تحديث الإضافة يدويًا

  1. ابحث عن ملف .crx الذي أنشأته للتو في عرض التحذيرات.
  2. يمكنك إعادة تسميته أو حذفه.
  3. افتح manifest.json وأضِف أي إذن يؤدي إلى ظهور تحذير.
  4. الانتقال إلى chrome://extensions. لا تزِل الحزمة المثبتة مسبقًا.
  5. يُرجى تعبئة الإضافة مرة أخرى، ولكن هذه المرة أضِف ملف pem في الإدخال الثاني.
    تمت إضافة ملف Pem عند إضافة حزمة.
    الشكل 8: جارٍ تعبئة مربع حوار الإضافة مع تضمين ملف pem.
  6. اسحب الإضافة المجمّعة الجديدة إلى صفحة "إدارة الإضافات".

  7. سيظهر لك مربّع حوار يطلب من المستخدم قبول الأذونات الجديدة.

    تم إيقاف الإضافة.

    الشكل 9: تحذير بشأن الإضافة غير المفعّلة

    الموافقة على الأذونات
    الشكل 10: مربّع حوار طلب إذن جديد