原生移动开发 / 系统课时

处理重启后的闹钟恢复

处理重启后的闹钟恢复

设备重启会让已注册的 AlarmManager 闹钟失效,因此不能把“闹钟已经注册”当成永久状态。本篇用“业务数据作为真相源”的方式,在系统启动完成后重新计算并建立仍然有效的定时任务。([Android Developers][1])

学习目标

  • 理解设备重启后 AlarmManager 闹钟为什么需要重新注册
  • 能使用 BOOT_COMPLETED 接收器触发闹钟恢复
  • 能避免恢复重复闹钟,并根据业务状态决定是否重新调度

重启后到底发生了什么

AlarmManager 的闹钟默认不会跨设备关机或重启永久保存。系统重新启动后,应用之前通过 AlarmManager 建立的调度需要重新建立;Android 提供 ACTION_BOOT_COMPLETED 广播作为应用初始化时机,但接收它需要声明 RECEIVE_BOOT_COMPLETED 权限,而且应用至少被用户启动过一次。([Android Developers][1])

真正应该持久化的不是 AlarmManager 对象,而是业务规则,例如“每天 08:00 提醒用户”和“任务 ID 为 <ID>、状态仍为待执行”。重启后从本地数据库、DataStore 或其他持久化存储读取这些规则,再调用 AlarmManager 重建调度。

设备重启后的闹钟恢复流程

用业务数据重新建立闹钟

恢复流程的关键是让恢复操作幂等:同一个任务重复执行恢复逻辑,也不能产生多个重复提醒。常见做法是固定使用任务 ID 构造 PendingIntent,并在注册时保持相同的 requestCode 与 Intent 标识。

下面是一个可移植的片段示例,假设应用已有 AlarmScheduler.schedule() 方法,负责真正调用 AlarmManager;启动接收器只负责读取业务记录并决定是否恢复。

kotlin
class BootCompletedReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        if (intent.action != Intent.ACTION_BOOT_COMPLETED) return

        // 重启后只恢复数据库中仍然有效的任务,而不是恢复所有历史任务。
        val tasks = ReminderRepository(context).loadActiveTasks()
        val scheduler = AlarmScheduler(context)

        for (task in tasks) {
            scheduler.schedule(task.id, task.triggerAtMillis)
        }
    }
}

上面是片段示例,依赖项目自己的 ReminderRepository 和 AlarmScheduler;核心职责是让接收器只做“发现启动事件 → 读取业务状态 → 恢复有效任务”,避免把业务规则直接写进广播入口。

Manifest 至少需要声明启动完成广播权限并注册接收器:

xml
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

<application ...>
    <receiver
        android:name=".BootCompletedReceiver"
        android:exported="false">
        <intent-filter>
            <action android:name="android.intent.action.BOOT_COMPLETED" />
        </intent-filter>
    </receiver>
</application>

预期结果

text
设备完成启动后,系统向应用发送 ACTION_BOOT_COMPLETED;接收器读取仍处于有效状态的提醒任务,并重新注册这些任务。已完成或已删除的业务任务不会被重新调度。

防止恢复逻辑产生重复任务

恢复代码最容易出现的问题,是“每次启动都新增一个闹钟”。判断重复的依据不应该是接收器有没有运行,而应该是任务身份是否稳定。对于同一个业务任务,恢复和用户手动修改计划应使用同一套任务 ID 到 PendingIntent 的映射规则。

还要区分“一次性任务”和“重复任务”。一次性任务恢复前应检查触发时间:如果目标时间已经过去,应根据业务规则选择立即执行、顺延到下一次时间点或直接废弃,而不是机械地注册一个已经过期的时间。

验证恢复结果

验证时不要只看“广播有没有收到”,而要检查业务任务是否真的重新进入调度状态。可以使用一个明确的测试任务:先创建未来时间的提醒,再重启模拟器或测试设备,启动完成后检查应用日志和实际提醒结果。

bash
adb shell am force-stop <PACKAGE>
adb reboot
adb shell logcat -d -s BootCompletedReceiver AlarmScheduler

预期输出

text
BootCompletedReceiver: ACTION_BOOT_COMPLETED received
AlarmScheduler: restored task=<ID> triggerAt=<TIME>

实际日志文本会因项目实现而不同;验证重点是启动广播到达后,应用确实从持久化状态恢复了仍有效的任务,并且没有为同一任务创建重复调度。这样设计后,设备重启只是一次“重新计算调度状态”的事件,而不是要求用户重新配置提醒。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理重启后的闹钟恢复

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

登录哪都通