إذن الإخطار لإشعارات الاشتراك

تستخدم الإشعارات في Android 13 نموذج الاشتراك، وهو تغيير عن إصدارات Android السابقة، التي تستخدم نموذج إلغاء الاشتراك. في Android 13، يجب أن تطلب جميع التطبيقات الإذن من المستخدمين قبل إرسال مطالبات الإشعارات. يساعد هذا النموذج في تقليل انقطاعات الإشعارات، وتقليل التحميل الزائد للمعلومات، ويساعد المستخدمين على التحكم في الإشعارات التي تظهر بناءً على ما هو مهم بالنسبة لهم. لدعم نموذج الاشتراك، يجب على مصنعي المعدات الأصلية تنفيذ التغييرات في أنظمة أذونات الإعلام ووقت التشغيل.

توضح هذه الصفحة ما يجب على مصنعي المعدات الأصلية (OEM) تنفيذه لدعم هذا التغيير وكيفية التحقق من صحة التنفيذ.

تنفيذ التغييرات لإشعارات الاشتراك

بدءًا من Android 13، يجب أن تعلن التطبيقات عن نيتها إرسال الإشعارات عن طريق طلب إذن التشغيل android.permission.POST_NOTIFICATION من النظام قبل أن تتمكن من إرسال الإشعارات.

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

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

سلوك إشعارات المستخدم في نموذج الاشتراك

يوضح الجدول التالي سلوك الإشعارات لإصدارات التطبيقات المختلفة على جهاز يعمل بنظام التشغيل Android 13:

الجهاز يعمل بنظام أندرويد 13 التطبيقات التي تستهدف Android 13 أو الإصدارات الأحدث تستهدف التطبيقات الإصدارات الأقدم من Android 13
تثبيت جديد يتم حظر الإشعارات حتى يطلبها التطبيق.

تتحكم التطبيقات في وقت طلب الإذن.

يتم حظر الإشعارات حتى يطالبك نظام التشغيل بذلك.

يتم طلب الإذن عند التشغيل الأول للتطبيق.

التطبيق الحالي (الترقية) يُسمح بالإشعارات حتى يطلبها التطبيق.

يتم منح الإذن المؤقت حتى يطلب التطبيق في الجولة التأهيلية الأولى.

يُسمح بالإشعارات حتى يطلبها نظام التشغيل.

يتم منح الإذن المؤقت حتى التشغيل الأول للتطبيق.

المبادئ التوجيهية للتنفيذ

للتنفيذ المرجعي، راجع خدمة الإعلام وخدمة الأذونات وخدمة السياسة . لتنفيذ استثناءات لمعالجات الأذونات الافتراضية، راجع أذونات وقت التشغيل .

أثناء التنفيذ، استخدم الإرشادات التالية بشأن سلوك إشعار المستخدم للتطبيقات التي تستهدف Android 13 أو حزم SDK الأقدم:

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

    • بالنسبة للتطبيقات التي تستهدف SDK للإصدارات Android 13 والإصدارات الأحدث، إذا لم يقم المستخدم مسبقًا بتخصيص إعدادات الإشعارات لهذا التطبيق على مستوى التطبيق أو NotificationChannel ، فقم بإلغاء منح الإذن المؤقت. يجب أن تطلب التطبيقات إذنًا من المستخدم قبل السماح لها بمواصلة إرسال الإشعارات.

      إذا لم يكن لدى التطبيق الذي تمت ترقيته والذي يستهدف Android 13 حاليًا إذن الإشعارات من خلال منحة الترقية المؤقتة، وقام المستخدم بتشغيله مرة واحدة على الأقل، فيجب أن يعرض التطبيق مطالبة إذن الإشعارات قبل السماح له بتشغيل أي خدمات مقدمة أخرى.

    • بالنسبة للتطبيقات التي تحتوي على SDK مستهدف بإصدارات أقل من Android 13، اعترض تشغيل النشاط الأول بعد أن أنشأ التطبيق NotificationChannel واحدة على الأقل لإظهار مطالبة إذن تسأل عما إذا كان المستخدم يريد تلقي إشعارات من التطبيق.

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

  • يجب أن يكون النسخ الاحتياطي والاستعادة متوافقين مع الإصدارات السابقة والأمامية بين جهاز يعمل بنظام التشغيل Android 13 وجهاز من إصدار سابق لنظام التشغيل. يجب استعادة بيانات النسخ الاحتياطي التي تم إنشاؤها من جهاز يعمل بنظام التشغيل Android 13 إلى إصدار سابق من نظام التشغيل، كما يجب استعادة بيانات النسخ الاحتياطي من إصدار سابق من نظام التشغيل إلى جهاز يعمل بنظام التشغيل Android 13.

  • يجب استثناء إشعارات الوسائط المرتبطة بتشغيل الوسائط المستمر من إذن الإشعارات.

التحقق من صحة التغييرات في أنظمة الإشعارات والأذونات

للتحقق من صحة التنفيذ، قم بإجراء الاختبارات التالية:

,

تستخدم الإشعارات في Android 13 نموذج الاشتراك، وهو تغيير عن إصدارات Android السابقة، التي تستخدم نموذج إلغاء الاشتراك. في Android 13، يجب أن تطلب جميع التطبيقات الإذن من المستخدمين قبل إرسال مطالبات الإشعارات. يساعد هذا النموذج في تقليل انقطاعات الإشعارات، وتقليل التحميل الزائد للمعلومات، ويساعد المستخدمين على التحكم في الإشعارات التي تظهر بناءً على ما هو مهم بالنسبة لهم. لدعم نموذج الاشتراك، يجب على مصنعي المعدات الأصلية تنفيذ التغييرات في أنظمة أذونات الإعلام ووقت التشغيل.

توضح هذه الصفحة ما يجب على مصنعي المعدات الأصلية (OEM) تنفيذه لدعم هذا التغيير وكيفية التحقق من صحة التنفيذ.

تنفيذ التغييرات لإشعارات الاشتراك

بدءًا من Android 13، يجب أن تعلن التطبيقات عن نيتها إرسال الإشعارات عن طريق طلب إذن التشغيل android.permission.POST_NOTIFICATION من النظام قبل أن تتمكن من إرسال الإشعارات.

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

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

سلوك إشعارات المستخدم في نموذج الاشتراك

يوضح الجدول التالي سلوك الإشعارات لإصدارات التطبيقات المختلفة على جهاز يعمل بنظام التشغيل Android 13:

الجهاز يعمل بنظام أندرويد 13 التطبيقات التي تستهدف Android 13 أو الإصدارات الأحدث تستهدف التطبيقات الإصدارات الأقدم من Android 13
تثبيت جديد يتم حظر الإشعارات حتى يطلبها التطبيق.

تتحكم التطبيقات في وقت طلب الإذن.

يتم حظر الإشعارات حتى يطالبك نظام التشغيل بذلك.

يتم طلب الإذن عند التشغيل الأول للتطبيق.

التطبيق الحالي (الترقية) يُسمح بالإشعارات حتى يطلبها التطبيق.

يتم منح الإذن المؤقت حتى يطلب التطبيق في الجولة التأهيلية الأولى.

يُسمح بالإشعارات حتى يطلبها نظام التشغيل.

يتم منح الإذن المؤقت حتى التشغيل الأول للتطبيق.

المبادئ التوجيهية للتنفيذ

للتنفيذ المرجعي، راجع خدمة الإعلام وخدمة الأذونات وخدمة السياسة . لتنفيذ استثناءات لمعالجات الأذونات الافتراضية، راجع أذونات وقت التشغيل .

أثناء التنفيذ، استخدم الإرشادات التالية بشأن سلوك إشعار المستخدم للتطبيقات التي تستهدف Android 13 أو حزم SDK الأقدم:

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

    • بالنسبة للتطبيقات التي تستهدف SDK للإصدارات Android 13 والإصدارات الأحدث، إذا لم يقم المستخدم مسبقًا بتخصيص إعدادات الإشعارات لهذا التطبيق على مستوى التطبيق أو NotificationChannel ، فقم بإلغاء منح الإذن المؤقت. يجب أن تطلب التطبيقات إذنًا من المستخدم قبل السماح لها بمواصلة إرسال الإشعارات.

      إذا لم يكن لدى التطبيق الذي تمت ترقيته والذي يستهدف Android 13 حاليًا إذن الإشعارات من خلال منحة الترقية المؤقتة، وقام المستخدم بتشغيله مرة واحدة على الأقل، فيجب أن يعرض التطبيق مطالبة إذن الإشعارات قبل السماح له بتشغيل أي خدمات مقدمة أخرى.

    • بالنسبة للتطبيقات التي تحتوي على SDK مستهدف بإصدارات أقل من Android 13، اعترض تشغيل النشاط الأول بعد أن ينشئ التطبيق NotificationChannel واحدة على الأقل لإظهار مطالبة إذن تسأل عما إذا كان المستخدم يريد تلقي إشعارات من التطبيق.

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

  • يجب أن يكون النسخ الاحتياطي والاستعادة متوافقين مع الإصدارات السابقة والأمامية بين جهاز يعمل بنظام التشغيل Android 13 وجهاز من إصدار سابق لنظام التشغيل. يجب استعادة بيانات النسخ الاحتياطي التي تم إنشاؤها من جهاز يعمل بنظام التشغيل Android 13 إلى إصدار سابق من نظام التشغيل، كما يجب استعادة بيانات النسخ الاحتياطي من إصدار سابق من نظام التشغيل إلى جهاز يعمل بنظام التشغيل Android 13.

  • يجب استثناء إشعارات الوسائط المرتبطة بتشغيل الوسائط المستمر من إذن الإشعارات.

التحقق من صحة التغييرات في أنظمة الإشعارات والأذونات

للتحقق من صحة التنفيذ، قم بإجراء الاختبارات التالية: