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 '测试')

参考