原生移动开发 / 系统课时

更新取消与分组通知

更新取消与分组通知

当应用不断产生同类消息时,直接创建新通知会造成列表堆积。本文通过稳定通知 ID、取消接口和通知分组,让同一业务消息可以被更新、撤回,并在系统通知栏中按类别整理展示。

学习目标

  • 理解稳定通知 ID 与“更新同一条通知”的关系
  • 掌握 notify()、cancel() 和通知分组的基本用法
  • 能根据业务场景选择独立通知、分组通知和汇总通知

用稳定 ID 更新同一条通知

通知是否“新增”还是“更新”,关键不在通知内容,而在你传给 NotificationManager.notify() 的通知 ID。对同一个通知 ID 重复调用 notify(),系统会替换原来的通知内容;换成新的 ID 才会形成另一条通知。

例如订单状态从“待支付”变成“已支付”,应该继续使用同一个订单通知 ID,而不是每次状态变化都生成新的 ID。这样既避免重复展示,也便于后续取消。

kotlin
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)
    }
}

预期结果

text
首次调用 show("待支付") 时出现一条订单通知;再次调用 show("已支付") 后,原通知内容变为“已支付”,不会额外增加第二条同 ID 通知;调用 cancel() 后该通知从通知栏移除。

通知 ID 最好与业务实体建立稳定映射,例如订单 ID、任务 ID 或消息 ID。不要直接使用时间戳作为 ID,否则每次推送都会变成新通知,后续也很难准确取消某一条。

用分组整理同类通知

当应用同时存在多个订单、聊天或下载任务时,可以给通知设置相同的 groupKey。系统会据此把相关通知组织到同一组中。分组解决的是“展示关系”,通知 ID 解决的是“具体对象”,两者不要混为一谈。

一个常见做法是:每条子通知使用自己的稳定 ID,同时设置相同的组键;再创建一条使用固定 ID 的汇总通知,并调用 setGroupSummary(true)。这样用户可以看到组标题和汇总信息,展开后仍能查看各条具体消息。

通知更新、分组与汇总关系

kotlin
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)
}

预期结果

text
通知栏中存在一个以 message_group 组织的消息组,包含“消息 A”和“消息 B”,并由固定 ID 3000 的汇总通知代表该组。3001、3002 分别对应两个独立子通知,可单独更新或取消。

取消通知时要注意什么

cancel(id) 只能根据具体通知 ID 删除通知,因此应用必须保留创建通知时使用的 ID。对于一组通知,取消某个子通知不会自动等价于取消整组业务;汇总通知也应在组内没有子通知时按业务需要更新或撤销。

另外,取消通知并不等于删除通知渠道。渠道属于用户可配置的长期设置,而通知属于某次具体展示。业务结束时通常取消具体通知即可,除非确实不再需要某类通知渠道。

什么时候使用哪种方式

独立任务适合每个任务一个稳定 ID;同类消息较多时适合统一 groupKey;需要让用户快速看到“还有多少条同类消息”时再增加 group summary。核心原则是让通知 ID 对应明确的业务实体,而不是对应一次发送动作。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

更新取消与分组通知

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通