Android 10+如何从后台服务获取剪贴板内容？

问题核心 #

Android 10（API 29）及以上对剪贴板访问做了严格限制：仅当应用处于前台焦点状态，或作为系统服务时，才能读取剪贴板内容。你当前的代码报错是因为启动的Activity未完全获取焦点就尝试访问剪贴板，且弹窗式Activity会打扰用户。Clipt这类应用的核心思路是用无UI的透明Activity，既满足"应用处于焦点"的要求，又不会对用户造成视觉干扰。

可行实现方案 #

1. 创建透明主题的Activity，处理通知按钮点击事件，读取剪贴板后立即销毁
2. 通知栏按钮的PendingIntent指向该透明Activity，确保点击后应用临时获得焦点
3. 读取操作完成后立即finish() Activity，全程无视觉弹窗

代码修改示例 #

1. 添加透明Activity主题 #

在res/values/styles.xml中添加完全透明的主题：

<style name="TransparentActivityTheme" parent="Theme.Material3.DayNight.NoActionBar">
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:windowIsTranslucent">true</item>
    <item name="android:windowAnimationStyle">@android:style/Animation.Translucent</item>
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowContentOverlay">@null</item>
</style>

2. 配置Manifest中的透明Activity #

修改AndroidManifest.xml，给SendHandler设置透明主题并优化启动属性：

<activity
    android:name=".ui.gui.SendHandler"
    android:theme="@style/TransparentActivityTheme"
    android:excludeFromRecents="true"
    android:taskAffinity=""
    android:launchMode="singleInstance"/>

3. 修改透明Activity逻辑 #

更新SendHandler代码，在获取焦点后读取剪贴板，完成后立即销毁：

class SendHandler : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 不设置布局，保持完全透明
    }

    override fun onResume() {
        super.onResume()
        // 此时Activity已获取焦点，可安全访问剪贴板
        val clipboard = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager
        clipboard.primaryClip?.let { clip ->
            val item = clip.getItemAt(0)
            val text = item.text
            Log.d("SendHandler", "剪贴板内容: $text")
            // 在此添加你的业务逻辑（如同步、存储等）
        }
        // 立即销毁Activity，无视觉残留
        finish()
    }
}

4. 适配API 30+的PendingIntent Flag #

修改MyService中的getHelloPendingIntent方法，适配高版本系统的Flag要求：

private fun getHelloPendingIntent(context: Context): PendingIntent {
    val helloIntent = Intent(context, SendHandler::class.java)
    val flags = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
    } else {
        PendingIntent.FLAG_UPDATE_CURRENT
    }
    return PendingIntent.getActivity(context, 100, helloIntent, flags)
}

关键注意事项 #

• 透明Activity必须配置正确的主题，确保完全无UI显示，避免打扰用户
• 读取剪贴板后务必立即调用finish()，防止应用占用前台资源
• API 30及以上必须使用FLAG_IMMUTABLE或FLAG_MUTABLE（根据是否需要修改Intent），否则会抛出异常
• 该方案符合Android隐私规范：操作由用户主动点击通知按钮触发，属于用户交互场景，不会触发系统的剪贴板访问限制

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