# ADBKeyboard 安装与使用指南 ## 为什么需要 ADBKeyboard **问题**: Android 16 的 `input text` 和 `mcp_android_phone_input_text` 不支持中文输入。默认输入法(微信键盘)也无法通过 ADB 输入中文。 **解决方案**: 安装 ADBKeyboard,通过广播 Intent 输入中文。 ## 安装步骤 ### 1. 下载 APK ```bash curl -fL -o /data/local/tmp/ADBKeyboard.apk https://github.com/senzhk/ADBKeyBoard/raw/master/ADBKeyboard.apk ``` ### 2. 安装 ```bash su -c "pm install /data/local/tmp/ADBKeyboard.apk" ``` **输出**: `Success` ### 3. 验证安装 ```bash su -c "pm list packages | grep -i adb" ``` **应输出**: `package:com.android.adbkeyboard` ## 切换输入法 ### 检查当前输入法 ```bash su -c "settings get secure default_input_method" ``` **常见输出**: - `com.tencent.wetype/.plugin.hld.WxHldService` — 微信键盘(无法输入中文) - `com.android.adbkeyboard/.AdbIME` — ADBKeyboard(可以输入中文) ### 切换到 ADBKeyboard ```bash su -c "ime set com.android.adbkeyboard/.AdbIME" ``` **验证**: ```bash su -c "settings get secure default_input_method" # 应输出: com.android.adbkeyboard/.AdbIME ``` ## 输入中文 ### 方法 1: 广播 Intent(推荐) ```bash su -c "am broadcast -a ADB_INPUT_TEXT --es msg '要输入的中文'" ``` **示例**: ```bash su -c "am broadcast -a ADB_INPUT_TEXT --es msg '火星人'" ``` ### 方法 2: 直接输入(仅支持 ASCII) ```bash su -c "input text 'hello'" ``` **注意**: 不支持中文! ## 常见问题 ### 问题 1: 切换输入法失败 **错误**: `Unknown input method com.android.adbkeyboard/.AdbIME cannot be selected for user #0` **原因**: ADBKeyboard 未安装或包名错误。 **解决**: ```bash # 检查所有输入法 su -c "ime list -a" # 找到正确的 ADBKeyboard 包名(通常是 com.android.adbkeyboard/.AdbIME) ``` ### 问题 2: 输入中文无反应 **原因**: 当前输入法不是 ADBKeyboard。 **解决**: ```bash # 检查当前输入法 su -c "settings get secure default_input_method" # 如果不是 ADBKeyboard,切换 su -c "ime set com.android.adbkeyboard/.AdbIME" ``` ### 问题 3: 广播发送后界面无变化 **原因**: 搜索框没有焦点。 **解决**: 先点击搜索框,再发送广播。 ## 在自动化流程中的使用 ```python def ensure_adbkeyboard(): """确保 ADBKeyboard 已启用""" result = subprocess.run( ['su', '-c', 'settings get secure default_input_method'], capture_output=True, text=True ) current_ime = result.stdout.strip() if 'adbkeyboard' not in current_ime: subprocess.run(['su', '-c', 'ime set com.android.adbkeyboard/.AdbIME']) print("已切换 ADBKeyboard") else: print("ADBKeyboard 已启用") def input_chinese(text): """输入中文""" ensure_adbkeyboard() subprocess.run(['su', '-c', f"am broadcast -a ADB_INPUT_TEXT --es msg '{text}'"]) ``` ## 验证清单 - [ ] ADBKeyboard 已安装 (`pm list packages | grep adb`) - [ ] 当前输入法是 ADBKeyboard (`settings get secure default_input_method`) - [ ] 可以输入中文 (`am broadcast -a ADB_INPUT_TEXT --es msg '测试'`) ## 参考 - GitHub: https://github.com/senzhk/ADBKeyBoard - 安装包: https://github.com/senzhk/ADBKeyBoard/raw/master/ADBKeyboard.apk