Wear OS Complication setTapAction无Broadcast回调问题

问题核心原因 #

你把ComplicationBroadcastListener定义在了onComplicationRequest方法的局部作用域内，系统的PendingIntent机制无法定位到这个局部类来实例化并调用onReceive方法。当PendingIntent触发时，系统需要通过全类名找到对应的BroadcastReceiver，而局部类的作用域仅限于方法内部，无法被系统访问。

修复步骤 #

1. 重构BroadcastReceiver为可访问的类 #

将BroadcastReceiver定义为顶级类或者宿主类的静态嵌套类（Kotlin中直接定义在类外部即可）：

class ComplicationBroadcastReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        // 可获取complication ID区分不同组件的点击
        val complicationId = intent.getIntExtra("COMPLICATION_ID", -1)
        Log.i("ComplicationTag", "Complication $complicationId 被点击，触发onReceive")
    }
}

2. 在AndroidManifest.xml中注册Receiver #

静态注册BroadcastReceiver，确保系统能找到它：

<receiver android:name=".ComplicationBroadcastReceiver" />

3. 修改PendingIntent创建逻辑 #

在onComplicationRequest中创建PendingIntent时，使用重构后的Receiver类，并添加参数区分不同complication：

override fun onComplicationRequest(request: ComplicationRequest, listener: ComplicationRequestListener )  {
    val intent = Intent(this, ComplicationBroadcastReceiver::class.java)
    // 传递complication ID，方便区分点击来源
    intent.putExtra("COMPLICATION_ID", request.complicationInstanceId)
    
    complicationPendingIntent = PendingIntent.getBroadcast(
        this,
        request.complicationInstanceId, // 用唯一ID作为requestCode，避免PendingIntent被覆盖
        intent,
        PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
    )
    
    // 后续创建ComplicationData并绑定tapAction的逻辑保持不变
}

额外排查点 #

• 确认PendingIntent.FLAG_IMMUTABLE已添加（Android 12及以上版本强制要求），避免因flag错误导致PendingIntent无法触发。
• 检查每个complication使用的requestCode（这里用complicationInstanceId）是否唯一，防止多个PendingIntent互相覆盖。
• 验证createComplicationData方法中确实将初始化后的complicationPendingIntent传入了setTapAction，且未出现null值。

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