Android 10设备读取剪贴板内容返回null适配问题咨询

你的代码本身没有错误，该问题是Android 10（API 级别 29）引入的系统层级剪贴板访问限制导致的。

核心限制规则 #

Android 10开始，只有三类应用有权限访问剪贴板数据：

• 当前正处于窗口焦点状态的前台应用
• 系统当前的默认输入法（IME）应用
• 系统最近使用过的默认输入法应用
  非上述场景下调用getPrimaryClip()都会直接返回null，普通权限申请也无法突破该限制。

常见触发场景 #

你遇到返回null的原因大概率是读取剪贴板的时机不对：

• 在应用退到后台时执行读取操作，比如后台服务、广播接收器中调用读取逻辑
• 应用还没获得窗口焦点时就提前执行读取，比如Activity的onCreate生命周期阶段就调用读取代码

适配方案 #

1. 调整读取时机（普通应用唯一可行方案） #

将剪贴板读取逻辑调整到应用确定获得焦点之后执行，可以重写Activity的onWindowFocusChanged回调：

override fun onWindowFocusChanged(hasFocus: Boolean) {
    super.onWindowFocusChanged(hasFocus)
    if (hasFocus) {
        // 只有拿到焦点后再读取剪贴板
        val clipboard = getSystemService(Context.CLIPBOARD_SERVICE) as? ClipboardManager
        // 先判断剪贴板是否有内容，避免空引用
        if (clipboard?.hasPrimaryClip() == true) {
            val text = clipboard.primaryClip?.getItemAt(0)?.text?.toString()
            // 后续处理text逻辑
        }
    }
}

2. 后台读取特殊说明 #

如果你的应用是输入法类应用，不需要额外适配即可正常读取。如果是其他需要后台读取剪贴板的应用，Android 12（API 31）新增了READ_CLIPBOARD_IN_BACKGROUND权限，但该权限仅对系统预装应用、或用户主动在设置中授予特殊权限的应用开放，普通三方应用无法申请获得。

额外注意事项 #

Android 13（API 33）及以上版本，任意应用读取剪贴板时系统都会弹出全局提示告知用户，用户可主动禁止应用的剪贴板访问权限，建议业务逻辑中做好读取失败的兜底处理。

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