Notification 通知:从基础到渠道适配

简介: 本文详解Android通知从基础到渠道适配的完整实践:涵盖NotificationChannel创建规范、NotificationCompat.Builder兼容构建、PendingIntent跳转、大文本/进度条/分组等常用样式,并总结SmallIcon要求、ID管理、FLAG_IMMUTABLE适配等关键避坑点,助你打造用户友好、系统兼容的通知体验

Notification 通知:从基础到渠道适配

背景

通知是 Android 系统最核心的交互入口之一。一条好的通知能在不打断用户当前操作的前提下传递关键信息——新消息来了、下载完成了、后台任务执行完毕了。反过来,滥用通知是用户卸载应用的头号理由。

从 Android 8.0(API 26)开始引入通知渠道(Notification Channel)的概念后,通知的管理权真正交到了用户手里:用户可以在系统设置里按渠道开关通知、调静默、改振动,而不需要开发者参与。这意味着如果适配不好,你的通知可能根本不会被展示。

本文从 NotificationCompat 出发,带你理解通知渠道体系,掌握常见的通知构建模式,并解决实际开发中的适配坑。

核心概念

NotificationChannel:通知的分类容器

Android 8.0 之后,所有通知必须关联到一个 NotificationChannel。渠道一旦创建,其重要性级别、声音、振动等属性就由用户接管,应用无法再修改。因此渠道的初始配置必须在首次创建时就设好。

渠道 ID 一旦确定,就不要随意更改,否则老用户的设置会丢失。

NotificationCompat.Builder:兼容构建器

始终使用 NotificationCompat.Builder(来自 androidx.core:core)构建通知,不要直接使用平台 API 的 Notification.Builder。Compat 层自动处理了从 API 16 到最新版本的各种兼容细节。

PendingIntent:延迟意图

点击通知后跳转到哪个 Activity、哪个 Service,都由 PendingIntent 决定。常见用法是 PendingIntent.getActivity() 配合 TaskStackBuilder 构建返回栈。

代码实战(Kotlin)

1. 创建通知渠道(必须在发通知前完成)

import android.app.NotificationChannel
import android.app.NotificationManager
import android.content.Context
import android.os.Build

object NotificationHelper {

    const val CHANNEL_ID_MESSAGE = "channel_message"
    const val CHANNEL_ID_TASK = "channel_task"

    fun createChannels(context: Context) {
        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return

        val manager = context.getSystemService(NotificationManager::class.java)

        // 消息渠道:高重要性,有声音和振动
        val messageChannel = NotificationChannel(
            CHANNEL_ID_MESSAGE,
            "新消息",
            NotificationManager.IMPORTANCE_HIGH
        ).apply {
            description = "新消息通知,包括私信和评论回复"
            enableVibration(true)
        }
        manager.createNotificationChannel(messageChannel)

        // 后台任务渠道:低重要性,默认静默
        val taskChannel = NotificationChannel(
            CHANNEL_ID_TASK,
            "任务进度",
            NotificationManager.IMPORTANCE_LOW
        ).apply {
            description = "下载、同步等后台任务进度"
            enableVibration(false)
        }
        manager.createNotificationChannel(taskChannel)
    }
}

在 Application.onCreate() 中调用 NotificationHelper.createChannels(this)。

2. 发一条基础通知

import android.app.PendingIntent
import android.content.Intent
import androidx.core.app.NotificationCompat
import androidx.core.app.NotificationManagerCompat

fun showBasicNotification(context: Context) {
    val channelId = NotificationHelper.CHANNEL_ID_MESSAGE

    // 点击后跳转
    val intent = Intent(context, MainActivity::class.java).apply {
        flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK
    }
    val pendingIntent = PendingIntent.getActivity(
        context, 0, intent,
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
    )

    val notification = NotificationCompat.Builder(context, channelId)
        .setSmallIcon(android.R.drawable.ic_dialog_info) // 必须设置
        .setContentTitle("新消息")
        .setContentText("你收到了一条新私信")
        .setPriority(NotificationCompat.PRIORITY_HIGH)
        .setContentIntent(pendingIntent)
        .setAutoCancel(true) // 点击后自动消失
        .build()

    // notify id 不要用 0,用固定值保证同类通知可覆盖
    NotificationManagerCompat.from(context).notify(1001, notification)
}

3. 大图/大文字样式

// 大文字样式
val style = NotificationCompat.BigTextStyle()
    .bigText("这是一段很长的消息正文,单行显示不下时,展开后可以看到完整内容。")
    .setBigContentTitle("新消息(展开标题)")
    .setSummaryText("来自张三")

// 或者大图样式
// val style = NotificationCompat.BigPictureStyle()
//     .bigPicture(BitmapFactory.decodeResource(context.resources, R.drawable.demo))
//     .setSummaryText("分享了一张图片")

val notification = NotificationCompat.Builder(context, channelId)
    .setSmallIcon(android.R.drawable.ic_dialog_info)
    .setContentTitle("新消息")
    .setContentText("你收到了一条新私信")
    .setStyle(style)
    .build()

4. 带进度条的通知(下载/上传场景)

fun showProgressNotification(context: Context, progress: Int, max: Int) {
    val notification = NotificationCompat.Builder(context, NotificationHelper.CHANNEL_ID_TASK)
        .setSmallIcon(android.R.drawable.ic_dialog_info)
        .setContentTitle("文件下载中")
        .setContentText("已完成 ${progress * 100 / max}%")
        .setProgress(max, progress, false) // false = 确定进度条
        .setOngoing(true) // 不可滑动删除
        .build()

    NotificationManagerCompat.from(context).notify(2001, notification)
}

下载完成后更新通知:

val doneNotification = NotificationCompat.Builder(context, channelId)
    .setSmallIcon(android.R.drawable.ic_dialog_info)
    .setContentTitle("下载完成")
    .setContentText("文件已保存到本地")
    .setProgress(0, 0, false) // 清除进度条
    .setOngoing(false)
    .setAutoCancel(true)
    .build()

NotificationManagerCompat.from(context).notify(2001, doneNotification)

5. 通知分组

Android 7.0 起支持通知分组,同一组的通知会折叠成一束,展开后能看到全部。

val groupKey = "group_chat_room_42"

// 每条通知都加 setGroup(groupKey)
val notification = NotificationCompat.Builder(context, channelId)
    .setSmallIcon(android.R.drawable.ic_dialog_info)
    .setContentTitle("张三")
    .setContentText("你好!")
    .setGroup(groupKey)
    .build()

// 再发一条摘要通知作为组的头部
val summaryNotification = NotificationCompat.Builder(context, channelId)
    .setSmallIcon(android.R.drawable.ic_dialog_info)
    .setContentTitle("会议室群")
    .setContentText("3 条新消息")
    .setGroup(groupKey)
    .setGroupSummary(true)
    .build()

避坑指南

SmallIcon 必须纯 alpha 通道。 系统通知栏的 SmallIcon 只取 Alpha 层忽略颜色。如果放一张彩色图,会显示成一个纯色方块,在各类 ROM 上效果千奇百怪。建议用矢量绘制纯白/纯透明图案。

Android 8.0 以下不创建渠道也能发通知。 这就是 Compat 的功劳——NotificationCompat.Builder(context, channelId) 在低版本上会忽略 channelId。但 Android 8.0+ 上如果没创建对应渠道,通知静默不会显示,连错误日志都没有,排查起来非常痛苦。

notify id 的管理。 调用 notify(id, notification) 时,相同 id 的通知会覆盖旧通知。这个特性很有用:进度条场景用相同 id 更新进度;不同消息用不同 id 让它们独立显示。但如果 id 管理混乱,会导致重要通知被意外覆盖。

PendingIntent 的 FLAG_IMMUTABLE。 从 Android 12 开始,创建 PendingIntent 必须显式指定 FLAG_IMMUTABLE 或 FLAG_MUTABLE,否则会直接崩溃。最佳实践是:能用 FLAG_IMMUTABLE 就用它,只有需要内部修改的场景才用 FLAG_MUTABLE。

前台服务通知不可关闭。 当通知关联到前台 Service 时(startForeground(id, notification)),用户无法滑动删除,这是系统级别保护。需要确保前台服务通知的渠道重要性不低于 IMPORTANCE_LOW,否则在 Android 8.0+ 上前台服务会直接崩溃。

不要滥用高重要性渠道。 IMPORTANCE_HIGH 的通知会响铃、振动、在屏幕上弹出 Heads-up。每天推十条以上的高优先级通知大概率会被用户关掉整个渠道,甚至卸载。后台任务进度、数据同步等场景一律用 IMPORTANCE_LOW。

总结

Notification 看似只是一条小横幅,背后却涉及渠道管理、版本兼容、生命周期绑定、用户意图跳转等一系列工程问题。核心原则就三条:

  1. 用 NotificationCompat 代替原生 API,省掉大部分兼容性问题
  2. 提前规划渠道体系,初始化时一次性建好,之后不要再改
  3. 尊重用户注意力,用什么级别、什么频率发通知,都要克制

掌握这些,你的应用通知就不会再被用户一刀切地关掉了。

相关文章
|
5月前
|
定位技术 Android开发 Kotlin
Service 与前台服务:让任务在后台持续运行
Android Service 是无UI后台组件,专用于长期任务。自8.0起,需用前台服务(带常驻通知)保障运行;核心要点:5秒内调`startForeground`、耗时操作移出主线程、任务完成及时`stopSelf`。
587 0
BOSHIDA 选择可靠的DC电源模块:减少系统故障的风险
BOSHIDA 选择可靠的DC电源模块:减少系统故障的风险 选择可靠的DC电源模块是保障系统稳定运行的重要步骤。以下是选择可靠的DC电源模块时需要考虑的几个关键因素:
BOSHIDA  选择可靠的DC电源模块:减少系统故障的风险
|
5月前
|
人工智能 自然语言处理 数据可视化
短剧 / 广告量产神器!万镜一刻 yikeai 搭载 HappyHorse1.1,故事板 + 无限画布打通全链路 AI 视频生产
阿里云推出「万镜一刻(yikeai)」一站式AI视频创作平台,集成自研HappyHorse1.1大模型,首创“AI故事板+无限画布”双引擎,实现剧本→分镜→视频全自动流转;支持角色统一、动作连贯、音画同步、团队协作与资产管控,助力短剧、电商种草、品牌广告高效量产。
|
5月前
|
人工智能 弹性计算 Cloud Native
2026企业级 AI 编程助手研发治理与选型指南
本文立足于云原生微服务架构与大模型基础设施的深度融合,横向评测在阿里云生态(涉及云服务器 ECS、容器服务 ACK 及云原生数据库等)主流 AI 编程品牌。通过工程化落地的多维量化数据,为部署在云端的研发团队提供清晰的技术选型指南。
1106 1
|
5月前
|
运维 关系型数据库 MySQL
分布式数据库高可用首选:阿里云 PolarDB-X Paxos 多副本架构详解
阿里云PolarDB-X通过自研X-Paxos共识协议、同城三AZ部署和秒级主备切换,实现RPO=0、RTO&lt;8秒、SLA 99.99%的金融级高可用,兼顾强一致与高性能,已通过双十一万亿级流量验证。
318 1
|
5月前
|
NoSQL PHP 开发工具
ThinkPHP即时通讯源码跨平台聊天im源码搭建带iOS+安卓附SDK
这是一套基于ThinkPHP 6.1 + Workerman 4.x的跨平台IM解决方案,支持iOS/安卓/H5/小程序四端(uni-app Vue3实现),采用MySQL+MongoDB混合存储与Redis实时状态管理,并提供完整JS-SDK和PHP-SDK。源码开源,含鉴权、群聊、红包、离线消息等全功能,中小项目千级并发稳如磐石。
1493 1
|
5月前
|
人工智能 自然语言处理 监控
阿里云百炼大模型平台全指南:定位、模型、场景与计费详解
2026年,阿里云百炼(Model Studio)已从单一模型服务平台,升级为集模型调用、微调、智能体开发、知识库构建、应用部署于一体的全链路MaaS(Model as a Service)平台。它聚合了150+款优质大模型,提供零代码/低代码与高代码双模式开发能力,搭配灵活的计费体系,成为个人开发者、中小企业与大型企业落地AI应用的首选平台。本文将从平台定位、模型矩阵、核心能力、落地场景、计费方案与选型建议等维度,全面解读2026年阿里云百炼大模型平台。
2166 0
|
5月前
|
存储 人工智能 NoSQL
AI应用提效存储首选_阿里云Tair高性能内存数据库实践
阿里云Tair(企业级Redis)是AI应用提效首选内存数据库:性能达原生Redis的3倍,亚毫秒响应,单实例支持百万级QPS;内置HNSW向量索引(召回率99%+),统一支撑KV缓存、向量检索、上下文管理与特征服务,免多系统拼接,全面适配RAG、Agent、推荐等场景(239字)
337 0
|
5月前
|
Java API 调度
WorkManager:可靠的后台任务调度
WorkManager 是 Jetpack 提供的可靠后台任务调度方案,自动适配不同 Android 版本(JobScheduler/AlarmManager),支持约束条件、重试、持久化与设备重启恢复。适用于日志上传、数据同步等“必须完成但无需实时”的任务,兼顾简洁性与健壮性
315 0
|
5月前
|
安全 编译器 Android开发
[Android 从零到一] Navigation Component:让页面跳转更清晰
Navigation Component 是 Jetpack 提供的导航管理方案,通过集中定义导航图(NavGraph),统一由 NavController 执行跳转,自动处理返回栈、参数传递、深链接、Toolbar/BottomNav 集成等。告别散落各处的 Intent 和 FragmentTransaction,让页面流转更清晰、安全、易维护。
346 0