原生移动开发 / 系统课时

用 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])

AlarmManager 触发链路

创建一次非精确闹钟

先从最常见的场景开始:用户要求“在未来某个时间之后提醒”,但不要求秒级精确。setAndAllowWhileIdle() 属于非精确闹钟,它不会早于给定触发时间,并允许在设备处于空闲状态时触发;与 exact alarm 相比,它更符合普通后台提醒对资源消耗的要求。([Android Developers][1])

下面给出一个可落地的最小 Kotlin 示例。这里让 BroadcastReceiver 只负责接收事件,实际业务可再转交给其他后台机制。

kotlin
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
    )
}

预期结果

text
约 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])

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 AlarmManager 设置闹钟

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通