原生移动开发 / 系统课时

接收闹钟与系统广播

接收闹钟与系统广播

AlarmManager 触发后,本质上是系统向目标 BroadcastReceiver 发送广播;开机完成等系统事件也遵循广播机制。掌握静态注册和动态注册的边界,才能让闹钟、开机恢复和前台页面监听分别走正确的接收路径。

学习目标

  • 能用 BroadcastReceiver 接收 AlarmManager 触发事件
  • 能判断哪些广播适合清单静态注册、哪些适合动态注册
  • 能处理开机后重新安排闹钟的基本流程

AlarmManager 到 BroadcastReceiver

使用基于 PendingIntent 的 AlarmManager API 时,系统会在触发时间发送对应 Intent;如果目标组件当时没有运行,系统也可以启动目标应用进程来处理广播。设备关机重启后,原有闹钟会被清除,因此需要在合适的系统事件中恢复调度。([Android Developers][4])

闹钟触发与系统广播接收关系

最直接的实现方式,是把闹钟事件交给一个专门的 receiver,而不是在 Activity 中等待时间到达。这样页面关闭后,闹钟仍有明确的系统接收入口。

静态注册适合系统生命周期事件

对于需要在应用进程未运行时接收、并且系统允许通过清单发现的广播,可以使用 manifest 声明。ACTION_BOOT_COMPLETED 是典型场景:设备完成启动后,应用可以接收事件并重新安排自己需要的闹钟。现代 Android 对清单接收器限制了大量隐式广播,但也保留了一些系统广播的可用场景;实际使用时应以目标 API 级别和具体广播文档为准。([Android Developers][5])

下面示例只展示一个完整的开机恢复接收器和清单配置,恢复函数应读取应用自己持久化的提醒数据,而不是硬编码业务状态。

xml
<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>

预期结果:

text
设备完成启动后,系统向符合条件的 BootReceiver 发送 ACTION_BOOT_COMPLETED,应用获得机会重新安排需要恢复的闹钟。

对应的 Kotlin 接收器可以只负责很轻的入口判断,把真正工作交给后续调度逻辑。广播接收器的 onReceive() 不适合执行长时间任务;需要更长处理时间时,应转交合适的后台任务机制。([Android Developers][5])

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

预期输出:

text
boot completed; restore alarms

动态注册适合跟随页面生命周期的监听

动态注册使用 registerReceiver() 创建接收关系,它的有效期跟注册所使用的上下文生命周期相关。比如 Activity 注册的 receiver 通常只在 Activity 处于有效生命周期期间接收广播;页面销毁后应及时 unregisterReceiver()。([Android Developers][5])

因此,动态注册很适合“用户打开页面时监听状态变化”的场景,例如临时监听某个应用内部事件;它不适合拿来保证一个页面关闭后仍能可靠接收的闹钟任务。

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

预期结果:

text
页面进入 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])

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

目录与阅读设置

阅读设置

17

记录一个想法

接收闹钟与系统广播

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

登录哪都通