Android 12下监听日历变更触发AppWidget更新失效问题

现有代码在Android 12一加设备上失效是同时踩了两个适配坑：

• 静态注册ACTION_PROVIDER_CHANGED广播的方式在Android 12及以上版本已被系统拦截，无法正常接收事件。Android 10及更早版本没有该限制，因此诺基亚设备可正常触发。
• 硬编码日历Provider的host为com.android.calendar，仅匹配AOSP原生日历的authority。一加搭载的ColorOS/HydrogenOS日历authority为厂商自定义值，intent-filter的data规则匹配失败，广播直接被过滤。

• 对隐式广播的限制进一步收紧：ACTION_PROVIDER_CHANGED这类由ContentProvider数据变更触发的广播，不再投递到Manifest中静态注册的接收器，仅允许运行时动态注册的接收器接收，从系统层面减少应用后台滥听广播造成的资源占用。
• 强化intent-filter的匹配校验：携带data字段的隐式广播，必须完全匹配filter中配置的scheme、host、path等规则才会投递，厂商自定义ContentProvider authority的场景下，硬编码host值的写法会直接失效。
• 新增广播注册的导出规则要求：Android 13（API 33）及以上版本，动态注册接收器必须明确指定RECEIVER_EXPORTED或RECEIVER_NOT_EXPORTED标志，未指定的注册调用会直接抛出异常。

1. 调整Manifest配置 #

删除receiver下针对ACTION_PROVIDER_CHANGED的intent-filter配置，仅保留AppWidget必需的系统Action即可，静态注册受限制广播无意义：

<receiver android:name="my.package.name.WidgetProvider"
    android:exported="true">
    <intent-filter>
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
    </intent-filter>
    <meta-data
        android:name="android.appwidget.provider"
        android:resource="@xml/widget_info" />
</receiver>

2. 动态注册广播+动态获取日历Authority #

不要硬编码任何厂商相关的配置，通过Android官方SDK提供的CalendarContract常量获取当前设备真实的日历authority，在组件启用时动态注册广播接收器，代码如下：

class WidgetProvider : AppWidgetProvider() {
    private var calendarObserver: BroadcastReceiver? = null

    override fun onEnabled(context: Context) {
        super.onEnabled(context)
        // 初始化广播接收器
        calendarObserver = object : BroadcastReceiver() {
            override fun onReceive(ctx: Context, intent: Intent) {
                if (intent.action != Intent.ACTION_PROVIDER_CHANGED) return
                val changedUri = intent.data ?: return
                // 校验变更来源确实是日历Provider
                if (changedUri.authority == getCalendarAuth(ctx)) {
                    refreshAllWidgets(ctx)
                }
            }
        }
        // 配置过滤器，动态传入真实的日历authority
        val filter = IntentFilter(Intent.ACTION_PROVIDER_CHANGED).apply {
            addDataScheme("content")
            addDataAuthority(getCalendarAuth(context), null)
        }
        // 分版本适配广播注册标志
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            context.registerReceiver(
                calendarObserver, 
                filter, 
                Context.RECEIVER_NOT_EXPORTED
            )
        } else {
            context.registerReceiver(calendarObserver, filter)
        }
    }

    override fun onDisabled(context: Context) {
        super.onDisabled(context)
        // 最后一个 widget 移除时注销接收器，避免内存泄漏
        calendarObserver?.let {
            context.unregisterReceiver(it)
            calendarObserver = null
        }
    }

    // 从系统SDK获取当前设备真实的日历Provider authority，兼容所有厂商ROM
    private fun getCalendarAuth(context: Context): String {
        return CalendarContract.Calendars.CONTENT_URI.authority 
            ?: "com.android.calendar"
    }

    // 统一触发所有实例更新
    private fun refreshAllWidgets(context: Context) {
        val widgetComponent = ComponentName(context, javaClass.name)
        val manager = AppWidgetManager.getInstance(context)
        val widgetIds = manager.getAppWidgetIds(widgetComponent)
        widgetIds.forEach { id ->
            updateWidget(context, manager, id) // 复用原有更新逻辑
        }
    }

    override fun onReceive(context: Context, intent: Intent) {
        super.onReceive(context, intent)
        // 保留原有其他业务逻辑
    }
}

3. 极端场景兜底适配 #

针对部分深度定制ROM完全不发送原生ACTION_PROVIDER_CHANGED的情况，可以搭配WorkManager配置间隔15-30分钟的短周期兜底刷新任务，既符合Android后台任务限制不会造成过高耗电，也能保证日历变更后组件最长半小时内完成更新，覆盖所有异常场景。

内容的提问来源于stack exchange，提问作者bic55