a.内容描述
- 核心功能定位：该项目是一个Android虚拟键盘（IME），旨在通过ADB命令接收系统广播意图，从而实现对Android设备的远程文本输入。它主要解决了标准ADB
input命令无法输入Unicode字符（如中文、表情符号）的局限性。 - 关键应用场景：
- 设备自动化与测试：特别适用于需要自动化输入非ASCII字符（如多语言文本、特殊符号）的测试场景。
- 远程输入控制：允许开发者或测试人员通过命令行直接向连接的设备或模拟器发送文本，无需手动在设备键盘上操作。
b.功能特性
- 基础文本输入：支持通过ADB广播发送普通文本。对于高版本Android系统（如Oreo/P）中文本传输的问题，提供了Base64编码的替代方案。
- 编码文本输入：提供
ADB_INPUT_B64动作，允许发送经过Base64编码的字符串，以兼容更多字符集和系统环境。 - 键位代码输入：通过
ADB_INPUT_CODE动作发送Android标准的KeyEvent键值（如删除键KEYCODE_DEL），模拟物理按键。 - 编辑器动作输入：通过
ADB_EDITOR_CODE动作发送编辑器动作代码（如IME_ACTION_GO），模拟输入法编辑器上的操作。 - Unicode字符输入：通过
ADB_INPUT_CHARS动作，直接发送Unicode字符的十进制码点数组，完美支持表情符号等复杂字符。 - 元键（组合键）输入：支持通过
ADB_INPUT_TEXT动作的mcode参数发送元状态（如Ctrl、Alt）与普通键的组合，模拟如Ctrl+A等操作。 - 文本清除功能：提供
ADB_CLEAR_TEXT动作，用于清除当前输入框中的所有文本。 - ADB键盘管理：提供完整的ADB命令集，用于启用、切换、重置虚拟键盘，方便在脚本中动态控制输入法。
d.使用说明
- 安装与启用：
- 通过ADB安装APK文件。
- 在设备的“语言与输入”设置中启用该键盘，或直接使用ADB命令
ime enable和ime set来启用并设置为当前输入法。
- 基本使用流程：
- 确保该键盘被设置为默认键盘或当前聚焦输入框的输入法。
- 通过
adb shell am broadcast命令发送特定的Intent（如ADB_INPUT_TEXT）并附带相应的参数（如--es msg ‘文本内容’），即可将文本输入到当前焦点所在的位置。
- 高级与兼容性用法：
- 对于Unicode字符输入问题，优先使用
ADB_INPUT_CHARS（发送码点）或ADB_INPUT_B64（发送Base64编码字符串）。 - 提供了从ADB切换回其他第三方输入法（如某知名输入法）以及列出、重置所有可用输入法的命令示例。
- 针对Windows、Mac/Linux及Python环境，给出了发送Base64编码文本的具体脚本示例。
- 对于Unicode字符输入问题，优先使用
e.潜在新需求
（1）需求1：用户希望实现候选文本输入功能，以支持在输入中文、日文等语言时，能够像本地输入法一样显示并选择带下划线的候选词条。
（2）需求2：用户希望增加直接清除当前已聚焦输入框中所有文本的功能，而无需通过模拟多次删除键操作来实现。
（3）需求3：用户希望工具能默认禁用或提供选项以忽略系统级的“全屏键盘”显示模式，改善输入体验。
（4）需求4：用户希望改善在F-Droid等第三方应用商店的发布信息，提供应用截图、更新日志和多语言描述，以提升应用的可发现性和用户体验。
（5）需求5：用户希望在Windows系统命令行的复杂环境下，能够更稳定、无乱码地输入包含单引号、双引号等特殊符号的文本。
article id：3a697434c3a31c6986b36c4301185ffa
更多精彩内容 请关注我的个人公众号 公众号（办公AI智能小助手）
对网络安全、黑客技术感兴趣的朋友可以关注我的安全公众号（网络安全技术点滴分享）
公众号二维码
公众号二维码
