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

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

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

قد لا تعرض بعض الأذونات تحذيرات عند إقرانها بأذونات أخرى. على سبيل المثال، لن يظهر التحذير "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. انقر على إضافة حزمة.

   

4. حدِّد المسار إلى مجلد الإضافة في حقل الدليل الجذر للإضافة. يُرجى تجاهل حقل المفتاح الخاص لحزمة الفترة الأولى.

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

   

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

   

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

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

   

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

   

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

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

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

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

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

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

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

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

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

   

6. اسحب الإضافة المجمّعة الجديدة إلى صفحة "إدارة الإضافات".

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