原生移动开发 / 系统课时
更新取消与分组通知
更新取消与分组通知
当应用不断产生同类消息时,直接创建新通知会造成列表堆积。本文通过稳定通知 ID、取消接口和通知分组,让同一业务消息可以被更新、撤回,并在系统通知栏中按类别整理展示。
学习目标
- 理解稳定通知 ID 与“更新同一条通知”的关系
- 掌握
notify()、cancel()和通知分组的基本用法 - 能根据业务场景选择独立通知、分组通知和汇总通知
用稳定 ID 更新同一条通知
通知是否“新增”还是“更新”,关键不在通知内容,而在你传给 NotificationManager.notify() 的通知 ID。对同一个通知 ID 重复调用 notify(),系统会替换原来的通知内容;换成新的 ID 才会形成另一条通知。
例如订单状态从“待支付”变成“已支付”,应该继续使用同一个订单通知 ID,而不是每次状态变化都生成新的 ID。这样既避免重复展示,也便于后续取消。
import android.app.NotificationChannel
import android.app.NotificationManager
import android.content.Context
import android.os.Build
class OrderNotification(private val context: Context) {
private val channelId = "orders"
private val notificationId = 2001
fun show(status: String) {
val manager = context.getSystemService(NotificationManager::class.java)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
val channel = NotificationChannel(
channelId,
"订单通知",
NotificationManager.IMPORTANCE_DEFAULT
)
manager.createNotificationChannel(channel)
}
val notification = android.app.Notification.Builder(context, channelId)
.setSmallIcon(android.R.drawable.ic_dialog_info)
.setContentTitle("订单状态")
.setContentText(status)
.setAutoCancel(true)
.build()
// 同一个订单始终复用同一个 ID,因此状态变化会更新原通知。
manager.notify(notificationId, notification)
}
fun cancel() {
val manager = context.getSystemService(NotificationManager::class.java)
manager.cancel(notificationId)
}
}预期结果
首次调用 show("待支付") 时出现一条订单通知;再次调用 show("已支付") 后,原通知内容变为“已支付”,不会额外增加第二条同 ID 通知;调用 cancel() 后该通知从通知栏移除。通知 ID 最好与业务实体建立稳定映射,例如订单 ID、任务 ID 或消息 ID。不要直接使用时间戳作为 ID,否则每次推送都会变成新通知,后续也很难准确取消某一条。
用分组整理同类通知
当应用同时存在多个订单、聊天或下载任务时,可以给通知设置相同的 groupKey。系统会据此把相关通知组织到同一组中。分组解决的是“展示关系”,通知 ID 解决的是“具体对象”,两者不要混为一谈。
一个常见做法是:每条子通知使用自己的稳定 ID,同时设置相同的组键;再创建一条使用固定 ID 的汇总通知,并调用 setGroupSummary(true)。这样用户可以看到组标题和汇总信息,展开后仍能查看各条具体消息。

import android.app.Notification
import android.app.NotificationManager
import android.app.NotificationChannel
import android.content.Context
import android.os.Build
fun showGroupedNotifications(context: Context) {
val channelId = "messages"
val groupKey = "message_group"
val manager = context.getSystemService(NotificationManager::class.java)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
manager.createNotificationChannel(
NotificationChannel(channelId, "消息通知", NotificationManager.IMPORTANCE_DEFAULT)
)
}
val first = Notification.Builder(context, channelId)
.setSmallIcon(android.R.drawable.ic_dialog_info)
.setContentTitle("消息 A")
.setContentText("来自联系人 A 的新消息")
.setGroup(groupKey)
.build()
val second = Notification.Builder(context, channelId)
.setSmallIcon(android.R.drawable.ic_dialog_info)
.setContentTitle("消息 B")
.setContentText("来自联系人 B 的新消息")
.setGroup(groupKey)
.build()
val summary = Notification.Builder(context, channelId)
.setSmallIcon(android.R.drawable.ic_dialog_info)
.setContentTitle("消息汇总")
.setContentText("有 2 条新消息")
.setGroup(groupKey)
.setGroupSummary(true)
.build()
manager.notify(3001, first)
manager.notify(3002, second)
manager.notify(3000, summary)
}预期结果
通知栏中存在一个以 message_group 组织的消息组,包含“消息 A”和“消息 B”,并由固定 ID 3000 的汇总通知代表该组。3001、3002 分别对应两个独立子通知,可单独更新或取消。取消通知时要注意什么
cancel(id) 只能根据具体通知 ID 删除通知,因此应用必须保留创建通知时使用的 ID。对于一组通知,取消某个子通知不会自动等价于取消整组业务;汇总通知也应在组内没有子通知时按业务需要更新或撤销。
另外,取消通知并不等于删除通知渠道。渠道属于用户可配置的长期设置,而通知属于某次具体展示。业务结束时通常取消具体通知即可,除非确实不再需要某类通知渠道。
什么时候使用哪种方式
独立任务适合每个任务一个稳定 ID;同类消息较多时适合统一 groupKey;需要让用户快速看到“还有多少条同类消息”时再增加 group summary。核心原则是让通知 ID 对应明确的业务实体,而不是对应一次发送动作。