You need to enable JavaScript to run this app. 如何基于Appium与Python通过安卓键盘逐字符输入文本
优惠活动
大模型
产品
解决方案
定价
更多

如何基于Appium与Python通过安卓键盘逐字符输入文本

安卓自动化真实系统键盘输入实现(Python3.7+Appium)

先搞懂Appium自带send_keys的底层逻辑

  • 基于UIAutomator2引擎的元素级send_keys(如el.send_keys("xxx")),底层直接调用安卓EditText控件的setText()方法注入文本,完全绕开系统键盘的按键事件流程。
  • 核心特性:
    • 无需唤起系统键盘即可生效(只要目标输入框可编辑,哪怕未聚焦、键盘未弹出,也能直接塞值)
    • 并非真实用户的键盘操作,极易被应用的反自动化机制检测

真实系统键盘输入的实现前提

关键前置配置:必须在Desired Capabilities中关闭Appium的键盘替换逻辑,否则会强制使用Appium自带的万能键盘,而非设备真实系统键盘

  • unicodeKeyboard: False(不启用Appium的Unicode替换键盘)
  • resetKeyboard: False(不重置/修改设备默认键盘)
  • automationName: "UiAutomator2"(必须用UIAutomator2引擎,支持系统级按键事件发送)

逐字符真实输入的实现步骤(含代码)

步骤1:定义安卓KEYCODE映射表

将输入字符转换为安卓系统对应的KEYCODE(按键编码),以下是常用字符的映射(可按需扩展):

# 安卓KEYCODE映射表(仅常用字符)
KEYCODE_MAP = {
    # 小写字母
    'a': 29, 'b': 30, 'c': 31, 'd': 32, 'e': 33, 'f': 34, 'g': 35,
    'h': 36, 'i': 37, 'j': 38, 'k': 39, 'l': 40, 'm': 41, 'n': 42,
    'o': 43, 'p': 44, 'q': 45, 'r': 46, 's': 47, 't': 48, 'u': 49,
    'v': 50, 'w': 51, 'x': 52, 'y': 53, 'z': 54,
    # 数字(主键盘区,无修饰键)
    '0': 7, '1': 8, '2': 9, '3': 10, '4': 11, '5': 12, '6': 13,
    '7': 14, '8': 15, '9': 16,
    # 符号(需SHIFT修饰,格式为(KEYCODE, 修饰键状态))
    '!': (8, 1),   # SHIFT+1
    '@': (9, 1),   # SHIFT+2
    '#': (10, 1),  # SHIFT+3
    '$': (11, 1),  # SHIFT+4
    '%': (12, 1),  # SHIFT+5
    '^': (13, 1),  # SHIFT+6
    '&': (14, 1),  # SHIFT+7
    '*': (15, 1),  # SHIFT+8
    '(': (16, 1),  # SHIFT+9
    ')': (7, 1),   # SHIFT+0
    # 控制类字符
    ' ': 62,       # 空格
    '\b': 67,      # 退格
    '\n': 66       # 回车
}
# 修饰键常量
META_NONE = 0
META_SHIFT = 1

步骤2:编写逐字符输入函数

通过driver.press_keycode()发送系统级按键事件,逐字符处理大小写、修饰键,加微小延迟模拟真实用户输入速度:

import time
def real_keyboard_input(driver, input_text):
    for char in input_text:
        # 处理大写字母:自动叠加SHIFT修饰键
        if char.isupper():
            lower_char = char.lower()
            keycode = KEYCODE_MAP.get(lower_char)
            if keycode:
                driver.press_keycode(keycode, metastate=META_SHIFT)
        # 处理需修饰键的符号
        elif isinstance(KEYCODE_MAP.get(char), tuple):
            keycode, metastate = KEYCODE_MAP[char]
            driver.press_keycode(keycode, metastate=metastate)
        # 处理小写字母/数字/无修饰符号
        else:
            keycode = KEYCODE_MAP.get(char)
            if keycode:
                driver.press_keycode(keycode, metastate=META_NONE)
        # 模拟真实输入间隔
        time.sleep(0.1)

步骤3:完整使用流程

from appium import webdriver

# 配置Desired Capabilities
DESIRED_CAPS = {
    "platformName": "Android",
    "deviceName": "你的设备ID",
    "appPackage": "你的应用包名",
    "appActivity": "你的应用启动Activity",
    "automationName": "UiAutomator2",
    "unicodeKeyboard": False,
    "resetKeyboard": False,
    "noReset": True
}

# 启动Appium Driver
driver = webdriver.Remote('http://localhost:4723/wd/hub', DESIRED_CAPS)

# 定位目标输入框(示例用ID定位)
input_box = driver.find_element_by_id("com.example.app:id/et_input")
# 点击输入框,唤起真实系统键盘
input_box.click()

# 通过真实键盘逐字符输入文本
real_keyboard_input(driver, "Hello!123")

注意事项

  • 安卓KEYCODE无中文对应单字符编码,若需输入中文,需额外模拟系统输入法候选栏的元素点击实现,与上述英文/数字/符号逻辑不同
  • 强制开启unicodeKeyboard/resetKeyboard会替换为Appium自带键盘,无法使用设备真实系统键盘
  • 可按需调整time.sleep(0.1)的延迟时长,模拟不同用户的输入速度,避免输入过快被反自动化机制识别

内容的提问来源于stack exchange,提问作者khushboo saxena

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 12:15:04