اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release
بدلاً من aosp-main
لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
سجلّ الإشعارات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
سجلّ الإشعارات هو شاشة على الجهاز يمكن للمستخدمين من خلالها الاطّلاع على الإشعارات التي تم تأجيلها
وعدد من الإشعارات التي تم تجاهلها مؤخرًا وسجلّ
الإشعارات في اليوم الأخير. وهي ميزة اختيارية يمكن للمصنعين الأصليين للأجهزة تنفيذها.
ولن يؤثّر ذلك في وحدات المعالجة المركزية أو مشغّلي شبكات الجوّال.
يهدف سجلّ الإشعارات إلى معالجة حالات الاستخدام التالية:
- الإغلاق غير المقصود: إذا أغلقت أحد
الإشعارات عن طريق الخطأ وأردت الاطّلاع عليه سريعًا
- الإشعارات المؤجَّلة: إذا تم تأجيل إشعار وأردت
الاطّلاع عليه قبل انتهاء فترة التأجيل
- تحديد المشاكل وحلّها: إذا كنت تعتقد أنّك فاتتك إشعار يمكنك
الاطّلاع على سجلّ الإشعارات لمعرفة ما إذا كان هناك إشعار وما إذا كان قد صدر صوت تنبيه. إذا لم تعثر عليه، تحقَّق مما إذا تم منع الإشعار. يمكنك تغيير إعدادات الإشعارات في سجلّ الإشعارات.
- إدارة الإشعارات: إذا أردت تغيير مستوى تدخُّل الإشعارات، يمكنك استخدام سجلّ الإشعارات لأنّه يقدّم تحليلاً واقعيًا للعدد اليومي للإشعارات، ما يسهّل فهم نطاق التغييرات التي أجريتها على التنبيهات والحظر وما إلى ذلك.
تتوفّر تنفيذات مرجعية لمكوّنات سجلّ الإشعارات التالية:
- الإعدادات:
packages/apps/Settings/src/com/android/settings/notification/history
- خادم النظام:
com.android.server.notification.NotificationHistory.*.java
في ما يلي الخطوات الرئيسية لتنفيذ ميزة "سجلّ الإشعارات":
- كتابة أحداث الإشعارات في السجلّ
- أضِف نقاط دخول إلى السجلّ والإعداد لتفعيله وإيقافه.
- تنفيذ شاشة "سجلّ الإشعارات"
يمكن للمستخدمين إيقاف "سجلّ الإشعارات". وعند إيقافه، يتم
حذف جميع عناصر السجلّ ولا يتم كتابة أي عناصر في السجلّ.
يمكنك ضبط عدد الأيام التي تظهر فيها الإشعارات في "سجلّ الإشعارات" باستخدام الثابت HISTORY_RETENTION_DAYS
في فئة
NotificationHistoryDatabase
. يمكنك أيضًا تعديل الأقسام التي تظهر في شاشة "سجلّ الإشعارات" وطريقة عرض البيانات.
تكون الفترة التلقائية للاحتفاظ بسجلّ الإشعارات هي 24 ساعة.
يتم توفير اختبارات الوحدة هذه لكل مكوّن من مكوّنات الرمز البرمجي:
- اختبارات وحدات خادم النظام:
FrameworksUiServicesTests
- اختبارات وحدات الإعدادات:
make -j64 RunSettingsRoboTests
ROBOTEST_FILTER="com.android.settings.notification"
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Notification history is a device screen where users can see snoozed\nnotifications, a handful of recently dismissed notifications, and a history of\nthe last day of notifications. It is an optional feature for OEMs to implement.\nThere's no impact on SoCs or carriers.\n\nNotification history is meant to address these use cases:\n\n- **Accidental dismissal**: You accidentally dismissed a notification and want to get a quick look at what it was.\n- **Snoozed notifications**: You snoozed a notification but want to see it before the snooze period is over.\n- **Troubleshooting**: You think you missed a notification. You check the notification history to see whether there was a notification and whether it buzzed. If you don't find it, you check whether a notification was blocked. You can change notification settings in notification history.\n- **Notification management**: You want to change how interruptive notifications are, so you use notification history because it offers a realistic slice of daily notification load, which makes it easy to understand the scope of your changes to alerting, blocking. etc.\n\nReference implementations of these components of Notification History are\navailable:\n\n- **Settings** : `packages/apps/Settings/src/com/android/settings/notification/history`\n- **System server** : `com.android.server.notification.NotificationHistory.*.java`\n\nThese are the major steps to implement Notification History:\n\n- Write notification events to the log.\n- Add entry points to the log and the setting to turn it on and off.\n- Implement the Notification History screen.\n\nUsers can turn Notification History off. When it's off, all history items are\ndeleted and no items are written to the log.\n\nYou can set the number of days notifications appear in the Notification\nHistory using the `HISTORY_RETENTION_DAYS` constant in the\n`NotificationHistoryDatabase` class. You can also modify which\nsections appear in the Notification History screen and how the data is\npresented.\n\nThe default notification history retention period is 24 hours.\n\nThese unit tests are provided for each component of the code:\n\n- **System server unit tests** : `FrameworksUiServicesTests`\n- **Settings unit tests** : `make -j64 RunSettingsRoboTests\n ROBOTEST_FILTER=\"com.android.settings.notification\"`"]]