Android Widget接收自定义显式广播的正确注册方式咨询

首先明确：不能在AppWidgetProvider的onUpdate方法中重复注册广播接收器。因为AppWidgetProvider本身是BroadcastReceiver的子类，生命周期仅存在于回调方法执行的短短几秒，执行完成后实例就会被系统回收，在其中注册的接收器要么跟随实例泄漏，要么直接失效，重复注册还会抛出异常。

以下是适配多Widget场景、符合系统规范的动态注册实现方案：

核心实现步骤 #

1. 全局统一管理广播接收器实例 #

维护单例广播接收器，同时管理所有激活的Widget ID，实现多Widget按需更新：

object WidgetUpdateReceiver : BroadcastReceiver() {
    // 存储所有需要监听更新的Widget ID
    private val watchWidgetIds = mutableSetOf<Int>()

    // 新增需要监听的Widget
    fun addWatchWidgetId(widgetId: Int) {
        watchWidgetIds.add(widgetId)
    }

    // 移除被删除的Widget监听
    fun removeWatchWidgetId(widgetId: Int) {
        watchWidgetIds.remove(widgetId)
    }

    // 所有监听的Widget都被删除时判断是否为空
    fun isEmpty(): Boolean = watchWidgetIds.isEmpty()

    override fun onReceive(context: Context?, intent: Intent?) {
        if (intent?.action != "com.example.UPDATE") return
        val appWidgetManager = AppWidgetManager.getInstance(context!!)
        // 遍历所有监听的Widget执行更新
        watchWidgetIds.forEach { widgetId ->
            val remoteViews = RemoteViews(context.packageName, R.layout.your_widget_layout)
            // 此处执行你的Widget视图更新逻辑
            appWidgetManager.updateAppWidget(widgetId, remoteViews)
        }
    }
}

2. 选择正确的注册/注销时机 #

使用Application上下文注册接收器，避免内存泄漏，和Widget生命周期绑定：

class MyAppWidgetProvider : AppWidgetProvider() {
    override fun onEnabled(context: Context?) {
        super.onEnabled(context)
        // 第一个Widget被添加到桌面时，注册全局广播接收器
        val filter = IntentFilter("com.example.UPDATE")
        // Android13及以上必须显式指定flag，仅接收本应用广播用RECEIVER_NOT_EXPORTED更安全
        context!!.applicationContext.registerReceiver(
            WidgetUpdateReceiver,
            filter,
            Context.RECEIVER_NOT_EXPORTED
        )
    }

    override fun onUpdate(
        context: Context?,
        appWidgetManager: AppWidgetManager?,
        appWidgetIds: IntArray?
    ) {
        super.onUpdate(context, appWidgetManager, appWidgetIds)
        appWidgetIds?.forEach { widgetId ->
            // 新增的Widget加入监听列表
            WidgetUpdateReceiver.addWatchWidgetId(widgetId)
            // 此处执行Widget初始渲染逻辑
        }
    }

    override fun onDeleted(context: Context?, appWidgetIds: IntArray?) {
        super.onDeleted(context, appWidgetIds)
        appWidgetIds?.forEach { widgetId ->
            // 被用户删除的Widget移出监听列表
            WidgetUpdateReceiver.removeWatchWidgetId(widgetId)
        }
    }

    override fun onDisabled(context: Context?) {
        super.onDisabled(context)
        // 最后一个Widget被删除时，注销广播接收器避免泄漏
        try {
            context!!.applicationContext.unregisterReceiver(WidgetUpdateReceiver)
        } catch (e: IllegalArgumentException) {
            // 捕获重复注销异常，无需额外处理
        }
    }
}

3. 应用内触发广播的代码 #

在你需要触发Widget更新的业务位置发送广播即可：

val updateIntent = Intent("com.example.UPDATE")
// Android8+指定包名提升广播传递效率
updateIntent.setPackage(context.packageName)
context.sendBroadcast(updateIntent)

方案优势 #

• 全程使用Application上下文注册，不存在Context内存泄漏风险
• 自动适配多Widget场景，新增/删除Widget无需修改广播逻辑
• 仅在有激活Widget时保留广播接收器，没有Widget时自动注销，资源占用更低

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