Android - Notifications教程

封面图 • 2025-11-26 • Android开发

当然！下面是一个关于 **Android 通知（Notifications）** 的详细教程，适合初学者和中级开发者。我们将涵盖：

1. **什么是 Android 通知？**
2. **通知的基本结构**
3. **创建通知的步骤**
4. **使用 `NotificationCompat` 创建兼容性通知**
5. **通知的高级功能（如点击、声音、振动等）**
6. **通知渠道（Android 8.0+）**

---

## 📱 一、什么是 Android 通知？

Android 通知是应用程序向用户发送消息的一种方式，通常出现在状态栏中（顶部通知栏），用户可以点击它来打开应用或执行某些操作。

通知可用于：

- 提醒用户有新消息
- 通知下载完成
- 显示来电或短信
- 提示任务完成

---

## 🧩 二、通知的基本结构

一个通知由以下部分组成：

| 组件 | 说明 |
|------|------|
| **标题** | 显示在通知中的短文本 |
| **内容** | 更详细的描述信息 |
| **图标** | 显示在通知左侧的小图标 |
| **时间戳** | 显示通知的时间 |
| **动作按钮** | 可以点击的按钮（如“查看详情”、“忽略”） |

---

## 🛠 三、创建通知的步骤（Android 8.0+）

### 1. 添加依赖（如果使用 Support Library）

如果你使用的是 `androidx.core.app.NotificationCompat`，请确保添加以下依赖：

```gradle
implementation 'androidx.core:core-ktx:1.9.0'
```

### 2. 创建通知通道（Android 8.0+ 必须）

从 Android 8.0 开始，所有通知都必须属于一个 **通知渠道（Notification Channel）**，否则不会显示。

```kotlin
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    val channel = NotificationChannel(
        "my_channel_id",
        "My Channel",
        NotificationManager.IMPORTANCE_DEFAULT
    ).apply {
        description = "My Channel Description"
    }

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

> 🔍 注意：`"my_channel_id"` 是你自定义的唯一标识符。

---

### 3. 构建通知

使用 `NotificationCompat.Builder` 来构建通知：

```kotlin
val channelId = "my_channel_id"

val intent = Intent(this, MainActivity::class.java).apply {
    flags = Intent.FLAG_ACTIVITY_CLEAR_TOP
}

val pendingIntent = PendingIntent.getActivity(
    this,
    0,
    intent,
    PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
)

val notification = NotificationCompat.Builder(this, channelId)
    .setSmallIcon(R.drawable.ic_notification)
    .setContentTitle("New Message")
    .setContentText("You have a new message from John.")
    .setPriority(NotificationCompat.PRIORITY_DEFAULT)
    .setContentIntent(pendingIntent)
    .setAutoCancel(true)
    .build()

val notificationManager = getSystemService(NotificationManager::class.java)
notificationManager.notify(1, notification)
```

---

## 🎯 四、通知的高级功能

### 1. 设置声音和震动

```kotlin
.notification.defaults = Notification.DEFAULT_SOUND or Notification.DEFAULT_VIBRATE
```

### 2. 添加操作按钮（Action）

```kotlin
val actionIntent = Intent(this, ActionReceiver::class.java).apply {
    putExtra("action", "mark_as_read")
}

val actionPendingIntent = PendingIntent.getBroadcast(
    this,
    0,
    actionIntent,
    PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
)

notification = NotificationCompat.Builder(this, channelId)
    .setSmallIcon(R.drawable.ic_notification)
    .setContentTitle("New Message")
    .setContentText("You have a new message from John.")
    .setPriority(NotificationCompat.PRIORITY_DEFAULT)
    .setAutoCancel(true)
    .addAction(R.drawable.ic_check, "Mark as Read", actionPendingIntent)
    .build()
```

> ⚠️ 需要注册 `BroadcastReceiver` 来处理点击事件。

---

### 3. 使用大视图（BigTextStyle）

```kotlin
val bigTextStyle = NotificationCompat.BigTextStyle()
    .bigText("This is a very long message that will be shown in the expanded view.")

---

## 🧾 五、通知的取消与更新

### 1. 取消通知

```kotlin
notificationManager.cancel(1)
```

### 2. 更新通知

你可以通过 `notify(id, updatedNotification)` 来更新已存在的通知。

---

## 📌 六、注意事项

- 从 Android 8.0 开始，必须使用 **通知渠道**。
- 如果你的应用目标 API 级别 < 26（即 Android 7.1），则不需要创建通知渠道。
- 在 Android 12 及更高版本中，`FLAG_IMMUTABLE` 是推荐的标志。

---

## ✅ 总结

| 功能 | 方法/类 |
|------|---------|
| 创建通知 | `NotificationCompat.Builder` |
| 通知渠道 | `NotificationChannel` |
| 发送通知 | `NotificationManager.notify()` |
| 取消通知 | `NotificationManager.cancel()` |
| 大视图样式 | `NotificationCompat.BigTextStyle` |
| 操作按钮 | `.addAction()` |

---

如果你需要更具体的示例，比如使用 `WorkManager` 或 `Firebase Cloud Messaging` 发送通知，我也可以为你提供详细教程。

是否需要我帮你写一个完整的 Kotlin 示例项目？