A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Histórico de notificações
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O histórico de notificações é uma tela do dispositivo em que os usuários podem ver notificações
adiadas, algumas notificações dispensadas recentemente e um histórico do
último dia de notificações. É um recurso opcional para OEMs implementarem.
Não há impacto em SoCs ou operadoras.
O histórico de notificações foi criado para abordar estes casos de uso:
- Remoção acidental: você removeu acidentalmente uma
notificação e quer conferir rapidamente o que era.
- Notificações adiadas: você adicionou uma notificação à lista de espera, mas quer
verificar antes do fim do período de adiamento.
- Solução de problemas: você acha que perdeu uma notificação. Você
confere o histórico de notificações para saber se houve uma notificação e
se ela fez um som. Se você não encontrar, verifique se uma notificação foi
bloqueada. Você pode mudar as configurações de notificação no histórico de notificações.
- Gerenciamento de notificações: você quer mudar a forma
como as notificações interruptivas são exibidas, então usa o histórico de notificações, que
oferece uma amostra realista da carga diária de notificações, o que facilita
entender o escopo das suas mudanças para alertas, bloqueios etc.
As implementações de referência desses componentes do histórico de notificações estão
disponíveis:
- Configurações:
packages/apps/Settings/src/com/android/settings/notification/history
- Servidor do sistema:
com.android.server.notification.NotificationHistory.*.java
Estas são as principais etapas para implementar o histórico de notificações:
- Grave eventos de notificação no registro.
- Adicione pontos de entrada ao registro e a configuração para ativá-lo e desativá-lo.
- Implemente a tela "Histórico de notificações".
Os usuários podem desativar o histórico de notificações. Quando ele está desativado, todos os itens do histórico são
excluídos e nenhum item é gravado no registro.
É possível definir o número de dias em que as notificações aparecem no histórico
de notificações usando a constante HISTORY_RETENTION_DAYS na
classe NotificationHistoryDatabase. Você também pode modificar quais
seções aparecem na tela "Histórico de notificações" e como os dados são
apresentados.
O período de retenção padrão do histórico de notificações é de 24 horas.
Esses testes de unidade são fornecidos para cada componente do código:
- Testes de unidade do servidor do sistema:
FrameworksUiServicesTests
- Testes de unidade de configurações:
make -j64 RunSettingsRoboTests
ROBOTEST_FILTER="com.android.settings.notification"
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],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\"`"]]
