如何让Jetpack Compose组件响应剪贴板内容变化？

Jetpack Compose的ClipboardManager本身不提供可观察状态，要让Composable感知剪贴板内容变化，需要结合State和系统剪贴监听机制实现。

核心思路 #

用mutableStateOf持有剪贴板内容（触发Composable自动重组），通过系统监听手段（ContentObserver或广播）在内容变化时更新这个State。

方案1：API 33+ 推荐（ContentObserver） #

从Android 13（API 33）开始，系统提供了剪贴板URI的监听能力，通过ContentObserver可以精准监听变化：

@Composable
fun ClipboardContents() {
    val clipboardManager = LocalClipboardManager.current
    val context = LocalContext.current
    // 用State保存剪贴板内容，值变化时自动触发UI重组
    val clipboardText = remember { mutableStateOf(clipboardManager.getText()) }

    LaunchedEffect(Unit) {
        val contentObserver = object : ContentObserver(Handler(Looper.getMainLooper())) {
            override fun onChange(selfChange: Boolean) {
                super.onChange(selfChange)
                // 更新State，触发UI刷新
                clipboardText.value = clipboardManager.getText()
            }
        }
        // 注册剪贴板观察者
        context.contentResolver.registerContentObserver(
            ClipboardManager.getPrimaryClipboardUri(),
            true,
            contentObserver
        )
        // Composable销毁时取消注册，避免内存泄漏
        onDispose {
            context.contentResolver.unregisterContentObserver(contentObserver)
        }
    }

    Text(text = clipboardText.value ?: "剪贴板为空")
}

方案2：兼容低版本（广播，Android 10以下可用） #

针对Android 10及以下系统，可以通过监听ACTION_CLIPBOARD_CHANGED广播实现，但注意Android 10+系统限制第三方应用接收此广播：

@Composable
fun ClipboardContents() {
    val clipboardManager = LocalClipboardManager.current
    val context = LocalContext.current
    val clipboardText = remember { mutableStateOf(clipboardManager.getText()) }

    LaunchedEffect(Unit) {
        val clipboardReceiver = object : BroadcastReceiver() {
            override fun onReceive(context: Context?, intent: Intent?) {
                if (intent?.action == Intent.ACTION_CLIPBOARD_CHANGED) {
                    clipboardText.value = clipboardManager.getText()
                }
            }
        }
        // 注册广播接收器
        context.registerReceiver(
            clipboardReceiver,
            IntentFilter(Intent.ACTION_CLIPBOARD_CHANGED)
        )
        // 销毁时取消注册
        onDispose {
            context.unregisterReceiver(clipboardReceiver)
        }
    }

    Text(text = clipboardText.value ?: "剪贴板为空")
}

关键注意事项 #

• 必须用mutableStateOf（或其他State类型）持有内容，否则Composable无法感知变化
• 务必在onDispose中取消注册监听器/接收器，防止内存泄漏
• Android 10+优先使用ContentObserver方案，广播方式在高版本系统中会失效

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