二、创建基础通知：NotificationCompat.Builder、渠道ID、小图标、标题、正文、优先级设置

2.1 原理：通知的构成要素与 Builder 模式

Android 通知（Notification）是一种在系统状态栏呈现的消息载体，其核心构成要素包括渠道（Channel）、小图标（Small Icon）、标题（Title）、正文（Body）和优先级（Priority）。这些要素通过 NotificationCompat.Builder 对象以 Builder 模式 逐步装配，最终由 NotificationManager 提交至系统。

2.2 实现流程：三步构建一条基础通知

创建一条基础通知遵循三步法，任何遗漏都可能导致通知无法显示。

1. 注册通知渠道（Android 8.0+ 必须）—— 创建 NotificationChannel 对象并调用 createNotificationChannel()。
2. 构建通知对象—— 使用 NotificationCompat.Builder 设置渠道 ID、小图标、标题、正文和优先级。
3. 发布通知—— 通过 NotificationManager.notify() 提交，需传入唯一 ID 与通知对象。

2.3 核心 API 详解：NotificationCompat.Builder

下表列出构建基础通知时最常用的 API 方法，每个方法都有其版本兼容性要求。

2.4 完整代码示例：发送一条高优先级通知

以下代码演示了从渠道注册到通知发布的完整链路，要求应用已导入 AndroidX 核心库。

// 1. 创建通知渠道（仅在 API 26+ 需要）
NotificationManager manager = (NotificationManager)
    getSystemService(Context.NOTIFICATION_SERVICE);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    NotificationChannel channel = new NotificationChannel(
        "alerts",           // 渠道 ID
        "重要提醒",          // 用户可见的渠道名称
        NotificationManager.IMPORTANCE_HIGH  // 高重要性
    );
    channel.setDescription("用于接收应用的重要提醒通知");
    manager.createNotificationChannel(channel);
}

// 2. 使用 Builder 构建通知
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "alerts")
    .setSmallIcon(R.drawable.ic_notify_alert)       // 必须设置
    .setContentTitle("内存使用超过 85%")
    .setContentText("建议立即清理后台进程，以免系统卡顿。")
    .setPriority(NotificationCompat.PRIORITY_HIGH); // API 26+ 由渠道控制

// 3. 发布唯一通知
int uniqueId = (int) System.currentTimeMillis();
manager.notify(uniqueId, builder.build());

2.5 调试与验证方法

• Logcat 过滤：关键字 NotificationService 或 NotificationChannel，查看渠道注册是否成功。
• adb 命令检查渠道：adb shell dumpsys notification --list-channels com.your.package 可列出已注册渠道及其重要性。
• 系统设置验证：进入 设置 → 通知与状态栏 → 应用通知，查看目标应用的开关及渠道列表。
• 常见失败表现：通知图标为空白方块（小图标不符合规范） / 通知完全不出现（渠道未注册或重要性为 NONE）。

2.6 常见错误与避坑指南

2.7 性能与稳定性优化

• 避免频繁创建渠道：渠道注册应在 Application.onCreate() 或主 Activity 的初始化阶段一次性完成，不要在每次通知发送前重复注册。
• 图标资源缓存：小图标使用 R.drawable 静态资源，不要动态生成 Bitmap 作为小图标，防止内存抖动。
• 控制通知正文长度：正文建议限制在 80 字符以内，长文本使用 setStyle(new NotificationCompat.BigTextStyle()) 展开。
• 通知去重：对于相同内容的通知，应复用通知 ID（如使用固定 ID 更新已有通知），避免通知栏堆积。
• 渠道持久化：渠道创建后系统会自动持久化，升级应用时不要更改已有渠道的 ID，否则会丢失用户对该渠道的偏好设置。