Appium安卓自动化如何通过键盘操作触发输入法绿色对勾按钮

问题场景 #

编写Appium Android自动化脚本时，需要先输入若干数字，再点击输入法界面的绿色对勾按钮：

点击该按钮的预期效果为：收起输入法键盘，页面展示校验错误提示信息：

原有实现代码如下，数字输入可以正常执行，但传入AndroidKey.ENTER触发动作时会出现不符合预期的异常表现，手动按压实体回车键也会复现同样问题：

((AndroidDriver) driver).pressKey(new KeyEvent(AndroidKey.DIGIT_2));
((AndroidDriver) driver).pressKey(new KeyEvent(AndroidKey.DIGIT_3));
((AndroidDriver) driver).pressKey(new KeyEvent(AndroidKey.DIGIT_4));
// 该参数无法正确触发绿色对勾逻辑
((AndroidDriver) driver).pressKey(new KeyEvent(AndroidKey.ENTER));

核心原因 #

输入法面板上的绿色对勾是输入框imeOptions配置对应的输入法编辑器动作，不属于系统级物理按键映射范畴。AndroidKey.ENTER对应的是实体回车键的系统事件，和输入法面板上的确认按钮走的是完全独立的事件分发逻辑，所以无法触发对勾按钮绑定的业务逻辑，手动按实体回车出现同样异常也是这个原因。

正确实现方案 #

方案1：直接触发输入法Done动作（适配绝大多数默认场景） #

不要用普通按键按压逻辑，改用Appium提供的编辑器动作触发接口，传入对应Done动作常量即可完全模拟绿色对勾的点击效果：

((AndroidDriver) driver).pressKey(new KeyEvent(AndroidKey.DIGIT_2));
((AndroidDriver) driver).pressKey(new KeyEvent(AndroidKey.DIGIT_3));
((AndroidDriver) driver).pressKey(new KeyEvent(AndroidKey.DIGIT_4));
// 触发输入法确认动作，等价于点击绿色对勾，6对应Android原生IME_ACTION_DONE常量值
((AndroidDriver) driver).performEditorAction(6);

如果当前使用的Java Client版本支持IME常量直接引用，也可以写为：

((AndroidDriver) driver).performEditorAction(AndroidKey.IME_ACTION_DONE);

方案2：第三方定制输入法适配方案 #

如果使用的是厂商定制/第三方输入法，IME动作映射存在差异，可以直接定位输入法面板上的对勾按钮元素点击，不需要模拟按键事件。不同输入法的元素属性存在差异，以原生Android输入法为例，定位逻辑参考：

// 定位输入法面板区域内的确认按钮点击
driver.findElement(By.id("android:id/input_method"))
  .findElement(By.className("android.widget.ImageView"))
  .click();

内容的提问来源于stack exchange，提问作者Ramkumar