原生移动开发 / 系统课时

发送一条标准系统通知

发送一条标准系统通知

本课解决“代码执行了但通知没有正常出现”的常见问题。你会用 NotificationCompat 创建通知渠道、设置有效的小图标与正文,并通过稳定的通知 ID 让系统正确展示通知。

学习目标

  • 能区分通知渠道、通知内容和通知 ID 的职责。
  • 能使用 NotificationCompat.Builder 构建并发送一条标准通知。
  • 能根据 Android 版本和通知权限检查发送失败的原因。

先准备通知渠道

Android 8.0(API 26)及以上要求通知归属于具体渠道。渠道决定重要性等用户可控行为,而标题、文本和小图标等属于单条通知内容。渠道应该在首次需要通知时创建,也可以在应用启动阶段统一创建。

构建并发送通知

下面示例放在一个可调用的 Activity 中。假设项目已经引入 AndroidX Core,且 res/drawable/ic_stat_notification.xml 是一个可用于通知栏的小图标资源。

kotlin
package com.example.notifications

import android.app.NotificationChannel
import android.app.NotificationManager
import android.os.Build
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import androidx.core.app.NotificationCompat
import androidx.core.app.NotificationManagerCompat

class MainActivity : AppCompatActivity() {

    companion object {
        private const val CHANNEL_ID = "order_updates"
        private const val NOTIFICATION_ID = 1001
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        createNotificationChannel()
    }

    private fun createNotificationChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channel = NotificationChannel(
                CHANNEL_ID,
                "订单更新",
                NotificationManager.IMPORTANCE_DEFAULT
            ).apply {
                description = "订单状态变化通知"
            }

            val manager = getSystemService(NotificationManager::class.java)
            manager.createNotificationChannel(channel)
        }
    }

    fun sendOrderNotification() {
        // 通知栏小图标必须是真实存在的 drawable 资源。
        val notification = NotificationCompat.Builder(this, CHANNEL_ID)
            .setSmallIcon(R.drawable.ic_stat_notification)
            .setContentTitle("订单状态已更新")
            .setContentText("订单 <ID> 已进入配送环节")
            .setPriority(NotificationCompat.PRIORITY_DEFAULT)
            .setAutoCancel(true)
            .build()

        NotificationManagerCompat.from(this).notify(NOTIFICATION_ID, notification)
    }
}

预期结果

text
运行 sendOrderNotification() 后,系统通知栏出现一条“订单状态已更新”通知,正文显示“订单 <ID> 已进入配送环节”。实际订单 ID 应替换为业务运行时值。

这里有三个容易混淆的对象。CHANNEL_ID 标识通知渠道,渠道需要先存在;setSmallIcon() 指定通知栏使用的小图标,不能用不存在的资源;NOTIFICATION_ID 标识当前发送的通知,同一个通知 ID 再次调用 notify() 时,通常会更新对应通知,而不是无限新增通知。

小图标和通知 ID 怎么选

通知栏小图标不是应用启动图标的简单替代品。应该准备专门的通知状态栏图标资源,并确保在不同主题和系统版本下都能正常显示。实际项目中,图标资源缺失或使用不合适的资源,是“通知代码无异常但通知表现异常”的常见原因。

通知 ID 则应该由业务场景决定。需要更新同一条通知时可以复用同一个 ID;例如订单状态从“已付款”变化到“配送中”,可以继续更新订单对应通知。需要让多个订单各自保持独立通知时,应为不同订单分配不同 ID。

发送失败时先检查什么

如果调用成功但用户看不到通知,先按下面顺序排查:

  1. 检查 Android 13 及以上是否已经获得 POST_NOTIFICATIONS 权限。
  2. 检查 CHANNEL_ID 是否与创建渠道时完全一致。
  3. 检查用户是否在系统设置中关闭了该渠道,或降低了渠道的重要性。
  4. 检查 R.drawable.ic_stat_notification 是否存在,并确认通知确实调用了 notify()。

通知渠道一旦创建,部分用户可控属性不能单纯依靠下一次 NotificationChannel 创建来覆盖,开发调试时可能需要进入系统设置调整渠道,或清除应用数据重新观察初始状态。

让通知行为可维护

实际项目里不要把渠道字符串和通知 ID 散落在各个页面。可以把渠道集中定义,把不同业务通知映射到明确的 ID 策略。这样后续加入消息推送、订单提醒或下载进度时,能保持渠道和通知更新规则的一致性。

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

目录与阅读设置

阅读设置

17

记录一个想法

发送一条标准系统通知

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

登录哪都通