原生移动开发 / 系统课时
接收闹钟与系统广播
接收闹钟与系统广播
AlarmManager 触发后,本质上是系统向目标 BroadcastReceiver 发送广播;开机完成等系统事件也遵循广播机制。掌握静态注册和动态注册的边界,才能让闹钟、开机恢复和前台页面监听分别走正确的接收路径。
学习目标
- 能用 BroadcastReceiver 接收 AlarmManager 触发事件
- 能判断哪些广播适合清单静态注册、哪些适合动态注册
- 能处理开机后重新安排闹钟的基本流程
AlarmManager 到 BroadcastReceiver
使用基于 PendingIntent 的 AlarmManager API 时,系统会在触发时间发送对应 Intent;如果目标组件当时没有运行,系统也可以启动目标应用进程来处理广播。设备关机重启后,原有闹钟会被清除,因此需要在合适的系统事件中恢复调度。([Android Developers][4])

最直接的实现方式,是把闹钟事件交给一个专门的 receiver,而不是在 Activity 中等待时间到达。这样页面关闭后,闹钟仍有明确的系统接收入口。
静态注册适合系统生命周期事件
对于需要在应用进程未运行时接收、并且系统允许通过清单发现的广播,可以使用 manifest 声明。ACTION_BOOT_COMPLETED 是典型场景:设备完成启动后,应用可以接收事件并重新安排自己需要的闹钟。现代 Android 对清单接收器限制了大量隐式广播,但也保留了一些系统广播的可用场景;实际使用时应以目标 API 级别和具体广播文档为准。([Android Developers][5])
下面示例只展示一个完整的开机恢复接收器和清单配置,恢复函数应读取应用自己持久化的提醒数据,而不是硬编码业务状态。
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<application
android:theme="@style/Theme.App">
<receiver
android:name=".BootReceiver"
android:enabled="true"
android:exported="false">
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED" />
</intent-filter>
</receiver>
</application>
</manifest>预期结果:
设备完成启动后,系统向符合条件的 BootReceiver 发送 ACTION_BOOT_COMPLETED,应用获得机会重新安排需要恢复的闹钟。对应的 Kotlin 接收器可以只负责很轻的入口判断,把真正工作交给后续调度逻辑。广播接收器的 onReceive() 不适合执行长时间任务;需要更长处理时间时,应转交合适的后台任务机制。([Android Developers][5])
package com.example.alarmdemo
import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import android.util.Log
class BootReceiver : BroadcastReceiver() {
override fun onReceive(context: Context, intent: Intent) {
if (intent.action != Intent.ACTION_BOOT_COMPLETED) return
// 真实项目中应从持久化数据恢复尚未完成的提醒。
Log.i("AlarmDemo", "boot completed; restore alarms")
}
}预期输出:
boot completed; restore alarms动态注册适合跟随页面生命周期的监听
动态注册使用 registerReceiver() 创建接收关系,它的有效期跟注册所使用的上下文生命周期相关。比如 Activity 注册的 receiver 通常只在 Activity 处于有效生命周期期间接收广播;页面销毁后应及时 unregisterReceiver()。([Android Developers][5])
因此,动态注册很适合“用户打开页面时监听状态变化”的场景,例如临时监听某个应用内部事件;它不适合拿来保证一个页面关闭后仍能可靠接收的闹钟任务。
private val receiver = object : BroadcastReceiver() {
override fun onReceive(context: Context, intent: Intent) {
if (intent.action == "com.example.alarmdemo.ACTION_REFRESH") {
android.util.Log.i("AlarmDemo", "refresh broadcast received")
}
}
}
override fun onStart() {
super.onStart()
val filter = android.content.IntentFilter("com.example.alarmdemo.ACTION_REFRESH")
registerReceiver(receiver, filter)
}
override fun onStop() {
unregisterReceiver(receiver)
super.onStop()
}预期结果:
页面进入 STARTED 状态后,收到 ACTION_REFRESH 时输出 refresh broadcast received;页面停止后不再由该 Activity receiver 接收。这是一个依赖 Activity 生命周期的片段示例,必须位于 Activity 类内部使用。动态注册最重要的不是“能收到广播”,而是明确广播应该跟谁的生命周期绑定。
闹钟广播与开机广播不要混成一个入口
一个更容易维护的设计,是让 AlarmReceiver 只处理“某个提醒到点”,让 BootReceiver 只处理“设备刚完成启动”。两者最终都可以调用共享的调度服务,但职责不同:闹钟接收器消费一次提醒事件,开机接收器负责根据持久化状态恢复未来任务。
Android 8.0(API 26)开始,面向多数隐式广播的 manifest 静态注册受到限制;动态注册也受上下文生命周期约束。因此,决定注册方式时应先回答“这个广播是谁发的、什么时候需要收到、应用未运行时是否仍必须收到”,再选择静态或动态注册,而不是默认全部写进 Manifest。([Android Developers][5])
实际项目中还要注意两个边界:第一,onReceive() 应尽快返回;第二,设备重启后闹钟不会自动恢复,应用必须依据自己的持久化数据主动重建调度。把“事件接收”和“业务执行”分开,才能同时满足 Android 的广播限制与可靠的定时任务需求。([Android Developers][4])