原生移动开发 / 系统课时
用 AlarmManager 设置闹钟
用 AlarmManager 设置闹钟
实现一次 Android 闹钟,需要把“什么时候触发”和“触发后执行什么”分开:AlarmManager 负责时间调度,PendingIntent 负责把触发动作交给系统,通常再由 BroadcastReceiver 接住事件。理解这条链路后,才能正确选择唤醒、非唤醒、精确与非精确闹钟。([Android Developers][1])
学习目标
- 能使用
AlarmManager配置一次非精确闹钟。 - 能正确创建显式
PendingIntent并理解其作用。 - 能区分
set()、setAndAllowWhileIdle()与setExactAndAllowWhileIdle()的使用场景。
AlarmManager、PendingIntent 与 Receiver 的关系
调用 AlarmManager 时,并不是把 Kotlin 方法直接交给系统保存。应用需要先准备一个 PendingIntent,其中封装要发送的显式 Intent;闹钟到期后,系统触发这个 PendingIntent,再由接收方执行对应逻辑。Android 官方也建议在 PendingIntent 中使用显式 Intent,并优先使用 FLAG_IMMUTABLE,除非业务确实需要让系统或其他组件填充内容。([Android Developers][3])

创建一次非精确闹钟
先从最常见的场景开始:用户要求“在未来某个时间之后提醒”,但不要求秒级精确。setAndAllowWhileIdle() 属于非精确闹钟,它不会早于给定触发时间,并允许在设备处于空闲状态时触发;与 exact alarm 相比,它更符合普通后台提醒对资源消耗的要求。([Android Developers][1])
下面给出一个可落地的最小 Kotlin 示例。这里让 BroadcastReceiver 只负责接收事件,实际业务可再转交给其他后台机制。
class AlarmReceiver : BroadcastReceiver() {
override fun onReceive(context: Context, intent: Intent) {
Log.d("AlarmDemo", "alarm fired")
}
}
fun scheduleAlarm(context: Context) {
val alarmManager = context.getSystemService(AlarmManager::class.java)
val intent = Intent(context, AlarmReceiver::class.java)
val pendingIntent = PendingIntent.getBroadcast(
context,
1001,
intent,
PendingIntent.FLAG_IMMUTABLE
)
val triggerAtMillis = System.currentTimeMillis() + 60_000L
alarmManager.setAndAllowWhileIdle(
AlarmManager.RTC_WAKEUP,
triggerAtMillis,
pendingIntent
)
}预期结果
约 60 秒后,Logcat 出现:
alarm fired示例使用 RTC_WAKEUP,表示以墙上时钟时间计算触发,并在需要时唤醒设备;如果业务不要求唤醒设备,可以考虑不带 WAKEUP 的对应闹钟类型,以降低不必要的资源影响。具体选择应与“设备睡眠时是否仍需及时触发”一致。([Android Developers][1])
精确与非精确怎么选
几个常见 API 可以按时间要求理解,而不是死记方法名:
| API | 时间语义 | 典型用途 |
|---|---|---|
set() |
不早于指定时间,系统可调整 | 普通定时事件 |
setAndAllowWhileIdle() |
非精确,但空闲状态下也允许触发 | 用户指定的后台提醒 |
setExact() |
接近指定时间精确触发 | 确实需要准点的功能 |
setExactAndAllowWhileIdle() |
接近指定时间,并尽量穿过省电空闲限制 | 对时间和空闲状态都敏感的功能 |
Android 官方建议大多数场景优先使用非精确闹钟;只有应用的核心功能依赖精确时间时,才使用 exact alarm。([Android Developers][1])
对于以 Android 12(API 31)及以上为目标版本的应用,使用 exact alarm 还涉及“Alarms & reminders”特殊权限;Android 官方文档列出了 SCHEDULE_EXACT_ALARM,对符合受限场景的应用也提供 USE_EXACT_ALARM 方案。因此,不要为了让普通提醒“看起来更准”就默认采用 exact alarm。([Android Developers][1])
PendingIntent 的两个关键点
第一,requestCode 和 Intent 标识共同影响 PendingIntent 的匹配。如果应用要同时保存多个不同闹钟,需要设计稳定且不冲突的标识,否则后创建的闹钟可能与已有 PendingIntent 被视为同一项。
第二,默认优先使用不可变 PendingIntent。只有确实需要由系统或其他组件向 PendingIntent 注入额外数据时,才考虑可变版本;同时应尽量使用显式 Intent,避免把触发入口暴露给不必要的组件。([Android Developers][3])
什么时候不该用 AlarmManager
如果任务本质上是“后台处理尽快完成”“满足网络条件后上传”“周期同步但不要求准点”,AlarmManager 往往不是第一选择。WorkManager 原生提供约束、重试、退避与持久化后台工作能力,更适合这类任务。([Android Developers][2])
闹钟回调本身也不应该承担长时间工作。更合理的做法是让 Receiver 快速完成事件接收,再把耗时处理交给后台执行机制,这样既符合系统资源管理方式,也更容易处理进程被回收后的场景。([Android Developers][1])