Appium中文输入问题的一些探索

Appium输入中文的问题

在使用Appium做手机端的自动化测试时，你可以会遇到输入中文的问题。但是由于Appium是三个自动化测试工具的集合，所以遇到的中文问题也可能会比较难说清楚。Appium支持iOS、Android和FireFoxOS三种操作系统。但是FireFoxOS一般人都不用，所以，文章中它是最后一次露面了。

Appium在iOS端自动化测试底层使用的是官方的UI Autoamtion。在Android端，4.2以上使用的官方的Uiautomator，4.1以下使用的时eBay的selendroid。所以在输入中文的问题上，三个平台理论上都有可能遇到问题。本文之后将重点调研Uiautomator的输入中文的问题。

关于中文输入的的结论：

• Appium iOS 完全支持
• Appium Android selendroid 应该支持（需要实践确认，目前没有试过，只是猜测）
• Appium Android Uiautomator 不支持，应该是硬伤，目前无解

selendroid的调研之后补充。

Appium iOS中文输入调研

首先先来说一下UI Automation。苹果官方的UI Automation在输入时有两种方法：

• （1）直接使用Element的setValue方法。
• （2）UI Automation中的 UIAKeyboard对象有一个typeString方法。

以上两个方法在模拟器上都是完美支持中文的。所以不管在iOS上面怎么玩，都是支持中文的。当然两个方式是有区别的。方法（1）简单直接，基本上就是一个简单的set方法。输入时不会触发什么类似textChanged事件。方法（2）需要很多支持，方法二是完全模拟人手工输入过程。苹果对英文以外的输入都做了很好地兼容。

Appium iOS版本的 sendkeys方法，直接对应 UIAKeyboard的typeString方法。由于typeString方法完美支持中文。所以Appium iOS版本也就支持中文了。当然，typeString方法也有缺点。当一个输入框内有内容的时候，typeString的输入方法是添加，所以，如果之前的内容不需要的时候，还需要先清除掉，在进行typeString。在没有特殊要求的情况下，我比较喜欢setValue这个方法，但是遗憾的时Appium不支持直接setValue。

Appium Android Uiautomator中文输入调研

之所以能有这篇文章，主要是因为最近想使用Appium做一些App之间相互跳转的自动化确认测试。一个中文的App，如果不能输入中文基本上就是歇菜。在使用学习工具的时候发现了很多坑，不能输入中文的这个坑最大，最郁闷。所以，把自己的调研方法写出来，供大家参考。

首先 在一切未知的情况下，使用了这个方法进行输入：

input.sendKeys("舌尖上的中国"); 

发现结果不对，然后尝试了不输入中文：

input.sendKeys("ssssssss"); 

结果也不对，发现手机上使用的输入法是Google中文输入法。把输入法切换到英文输入法，以后，英文的正确的了，中文的还是有问题。于是Google了一下，找到了一个帖子。上面信息量很大，看起来比较靠谱的是有一个方法，利用JS运行器来直接输入方法，翻译为Java版本以后，代码如下：

1 2 3 

    inputDir.put("element",((RemoteWebElement)input).getId());    inputDir.put("text","舌尖上的中国");    driver.executeScript("element:setText", inputDir);

这个方法会出现一个没有实现的异常。

好吧，看源码。

在使用Appium 的sendkeys方法是，Client会发送一个http请求到Appium的server。在AppiumServer端的源码中 有一个 rounting 的文件，输入方法会发送这样的路由： rest.post(‘/wd/hub/session/:sessionId?/element/:elementId?/value’, controller.setValue); 然后树藤摸瓜，找到controller的setValue方法。然后一步一步的查找，最终会找到bootstrap项目中的AndroidElement.java文件，其中有setText方法。代码如下：

1 2 3 4 5 6 7 8 9 10 

 public boolean setText(final String text) throws UiObjectNotFoundException {    if (UnicodeEncoder.needsEncoding(text)) {      Logger.info("Sending Unicode text to element: " + text);      String encodedText = UnicodeEncoder.encode(text);      return el.setText(encodedText);    } else {      Logger.info("Sending plain text to element: " + text);      return el.setText(text);    }  }

在Appium Android Uiautomator中，输入方法就是这一段代码。从这一段代码中会发现Appium基本没有做什么事情，最终调用了Uiautomator本身的setText方法。所以，接下来需要确认原生的Uiautomator是否可以支持中文输入。 经过简单的测试发现，Uiautomator不支持中文输入，然后继续Google解决方案。发现了一个uiautomator-unicode-input-helper开源项目。直接拿来尝试了中文，也发现不对。按照作者的说法是可以支持日语，但是貌似想支持中文的话，还要进行一定量的开发。

继续看看Uiautomator为什么不支持中文。然后继续找Android的源码，发现Uiautomator的所有的功能都是通过UiAutomatorBridge来完成的。在UiAutomatorBridge类中有一个成员变量类型是InteractionController。输入是通过InteractionController来实现的。具体的setText方法代码如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 

   public boolean More ...sendText(String text) {        if (DEBUG) {                    Log.d(LOG_TAG, "sendText (" + text + ")");        }        mUiAutomatorBridge.setOperationTime();        KeyEvent[] events = mKeyCharacterMap.getEvents(text.toCharArray());        if (events != null) {            for (KeyEvent event2 : events) {                // We have to change the time of an event before injecting it because                // all KeyEvents returned by KeyCharacterMap.getEvents() have the same                // time stamp and the system rejects too old events. Hence, it is                // possible for an event to become stale before it is injected if it                // takes too long to inject the preceding ones.                KeyEvent event = KeyEvent.changeTimeRepeat(event2,                        SystemClock.uptimeMillis(), 0);                if (!injectEventSync(event)) {                    return false;                }            }        }        return true;    }

通过这段代码，基本上就明白了，Android的Uiautomator完全没有兼容英文以外的输入法的意思。并且也没有提供直接设置属性的方法。

Appium Android Uiautomator 要支持输入中文还有很长的一段路需要走。伤心了。