通过 ADB 和 Shell 在 Android 10+ 访问剪贴板

原创已于 2025-07-04 10:06:20 修改 · 2.3k 阅读

本内容遵循CC 4.0 BY-SA版权协议

于 2025-07-04 10:05:53 首次发布

简介

从 Android 10 开始，谷歌引入了剪贴板访问的隐私限制：只有当前获得焦点的应用或输入法（IME）可以读取剪贴板，即使有 root 权限，应用也无法在后台读取剪贴板。此更改极大限制了开发者通过 ADB 或自动化工具监控或控制剪贴板的能力。

为了解决这一限制，本项目提供了一种新方案：自定义软件输入法。作为输入法应用，该 App 可以不受限制地访问剪贴板，并且可以在后台控制剪贴板，同时通过 ADB 或 Shell 与用户通信。

使用方法

下载和安装
- 从 GitHub Releases 页面下载发布版 APK 并安装到你的设备上。

启用输入法

adb shell ime enable com.example.input/.MyInputMethodService

示例

以下是通过 ADB 使用的一些示例命令。在部分设备上，你必须显式设置目标应用，否则广播将无法被接收。

读取剪贴板内容

adb shell am broadcast -a com.example.input.ACTION_READ_CLIPBOARD
或
adb shell am broadcast -a com.example.input.ACTION_READ_CLIPBOARD -n com.example.input/.ClipboardReceiver

设置剪贴板内容（无空格）

adb shell am broadcast -a com.example.input.ACTION_SET_CLIPBOARD --es com.example.input.EXTRA_CLIPBOARD_TEXT "YourNewClipboardTestWithoutAnySpace"
或
adb shell am broadcast -a com.example.input.ACTION_SET_CLIPBOARD --es com.example.input.EXTRA_CLIPBOARD_TEXT "YourNewClipboardTestWithoutAnySpace"  -n com.example.input/.ClipboardReceiver

设置剪贴板内容（含空格）

adb shell am broadcast -a com.example.input.ACTION_SET_CLIPBOARD --es com.example.input.EXTRA_CLIPBOARD_TEXT "\"Your new clipboard text, and you can have space here\""
或
adb shell am broadcast -a com.example.input.ACTION_SET_CLIPBOARD --es com.example.input.EXTRA_CLIPBOARD_TEXT "\"Your new clipboard text, and you can have space here\""  -n com.example.input/.ClipboardReceiver

清空剪贴板

adb shell am broadcast -a com.example.input.ACTION_CLEAR_CLIPBOARD
或
adb shell am broadcast -a com.example.input.ACTION_CLEAR_CLIPBOARD  -n com.example.input/.ClipboardReceiver

复现

建议使用 Android Studio Narwhal | 2025.1.1 2025年6月24日发布 来复现和测试此项目的功能。
你可以从本仓库下载代码，并直接用 Android Studio Narwhal 打开。旧版本的 Android Studio 可能也能运行，但不保证。

注意事项

要使剪贴板命令生效，必须启用并选中本输入法。
使用完本应用后，记得切回你原来的输入法。

个人说明

谷歌开发者总是喜欢做一些让人费解的功能。我理解安全性很重要，但至少应该留个按钮（可以带警告），让用户主动授权他们希望的应用访问剪贴板。确实有些用户可能会无视警告，但最终，选择权应该在用户手里。就像小米、OPPO 等厂商允许用户在点击“我已阅读并理解风险”后安装未知来源应用一样，剪贴板也应该如此。谷歌甚至阻止了 root 权限读取剪贴板。而且，尽管如此，仍然安全漏洞，因为恶意应用可以伪装成输入法（就像本项目一样，当然本项目不是恶意的）。所以最安全的办法大概就是直接移除剪贴板，这样谁都读不了了，哈哈。

标签