原生移动开发 / 系统课时
发送一条标准系统通知
发送一条标准系统通知
本课解决“代码执行了但通知没有正常出现”的常见问题。你会用 NotificationCompat 创建通知渠道、设置有效的小图标与正文,并通过稳定的通知 ID 让系统正确展示通知。
学习目标
- 能区分通知渠道、通知内容和通知 ID 的职责。
- 能使用
NotificationCompat.Builder构建并发送一条标准通知。 - 能根据 Android 版本和通知权限检查发送失败的原因。
先准备通知渠道
Android 8.0(API 26)及以上要求通知归属于具体渠道。渠道决定重要性等用户可控行为,而标题、文本和小图标等属于单条通知内容。渠道应该在首次需要通知时创建,也可以在应用启动阶段统一创建。
构建并发送通知
下面示例放在一个可调用的 Activity 中。假设项目已经引入 AndroidX Core,且 res/drawable/ic_stat_notification.xml 是一个可用于通知栏的小图标资源。
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)
}
}预期结果
运行 sendOrderNotification() 后,系统通知栏出现一条“订单状态已更新”通知,正文显示“订单 <ID> 已进入配送环节”。实际订单 ID 应替换为业务运行时值。这里有三个容易混淆的对象。CHANNEL_ID 标识通知渠道,渠道需要先存在;setSmallIcon() 指定通知栏使用的小图标,不能用不存在的资源;NOTIFICATION_ID 标识当前发送的通知,同一个通知 ID 再次调用 notify() 时,通常会更新对应通知,而不是无限新增通知。
小图标和通知 ID 怎么选
通知栏小图标不是应用启动图标的简单替代品。应该准备专门的通知状态栏图标资源,并确保在不同主题和系统版本下都能正常显示。实际项目中,图标资源缺失或使用不合适的资源,是“通知代码无异常但通知表现异常”的常见原因。
通知 ID 则应该由业务场景决定。需要更新同一条通知时可以复用同一个 ID;例如订单状态从“已付款”变化到“配送中”,可以继续更新订单对应通知。需要让多个订单各自保持独立通知时,应为不同订单分配不同 ID。
发送失败时先检查什么
如果调用成功但用户看不到通知,先按下面顺序排查:
- 检查 Android 13 及以上是否已经获得
POST_NOTIFICATIONS权限。 - 检查
CHANNEL_ID是否与创建渠道时完全一致。 - 检查用户是否在系统设置中关闭了该渠道,或降低了渠道的重要性。
- 检查
R.drawable.ic_stat_notification是否存在,并确认通知确实调用了notify()。
通知渠道一旦创建,部分用户可控属性不能单纯依靠下一次 NotificationChannel 创建来覆盖,开发调试时可能需要进入系统设置调整渠道,或清除应用数据重新观察初始状态。
让通知行为可维护
实际项目里不要把渠道字符串和通知 ID 散落在各个页面。可以把渠道集中定义,把不同业务通知映射到明确的 ID 策略。这样后续加入消息推送、订单提醒或下载进度时,能保持渠道和通知更新规则的一致性。