如何基于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
相关产品推荐
相关产品推荐

