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