Appium Android Bootstrap源码分析之命令解析执行-低调大师

Appium Android Bootstrap源码分析之命令解析执行

2017-07-02 632

通过上一篇文章《 Appium Android Bootstrap源码分析之控件AndroidElement》我们知道了Appium从pc端发送过来的命令如果是控件相关的话，最终目标控件在bootstrap中是以AndroidElement对象的方式呈现出来的，并且该控件对象会在AndroidElementHash维护的控件哈希表中保存起来。但是appium触发一个命令除了需要提供是否与控件相关这个信息外，还需要其他的一些信息，比如，这个是什么命令？这个就是我们这篇文章需要讨论的话题了。

　　下面我们还是先看一下从pc端发过来的json的格式是怎么样的：

　　可以看到里面除了params指定的是哪一个控件之外，还指定了另外两个信息：

　　cmd: 这是一个action还是一个shutdown

　　action：如果是一个action的话，那么是什么action

　　开始前我们先简要描述下我们需要涉及到几个关键类：

1. Appium命令解析器AndroidCommand

　　AndroidCommand这个类真实的作用其实就是去把Appium从pc端发送过来的那串json命令解析出来，它拥有两个成员变量：

　　JSONObject json;

　　AndroidCommandType cmdType;

　　json就是pc过来的json格式的那串命令，cmdType就是action或者shutdown，其实就是用来把这个类伪装成更像个命令类而已，我认为如果不提供这个成员变量而直接修改其getType的实现去解析json字串直接获得对应的AndroidCommandType，然后把这个类的名字改成AndroidCommandParser得了。

　　那么我们往下看下AndroidCommand究竟是怎么对客户端命令进行解析的，它的方法都很短，所以我把它做成一个表，这样比较清晰点：

　　从表中的这些方法可以看出来，这个类所做的事情基本上都是怎么去解析appium从pc端过来的那串json字串。

　　2. Action与CommandHandler的映射关系

　　从上面描述可以知道，一个action就是一个代表该命令的字串，比如‘click’。但是一个字串是不能去执行的啊，所以我们需要有一种方式把它转换成可以执行的代码，这个就是AndroidCommandExecutor维护的一个静态HashMap map所做的事情：

class AndroidCommandExecutor {

private static HashMap<String, CommandHandler> map = new HashMap<String, CommandHandler>();

static {

map.put("waitForIdle", new WaitForIdle());

map.put("clear", new Clear());

map.put("orientation", new Orientation());

map.put("swipe", new Swipe());

map.put("flick", new Flick());

map.put("drag", new Drag());

map.put("pinch", new Pinch());

map.put("click", new Click());

map.put("touchLongClick", new TouchLongClick());

map.put("touchDown", new TouchDown());

map.put("touchUp", new TouchUp());

map.put("touchMove", new TouchMove());

map.put("getText", new GetText());

map.put("setText", new SetText());

map.put("getName", new GetName());

map.put("getAttribute", new GetAttribute());

map.put("getDeviceSize", new GetDeviceSize());

map.put("scrollTo", new ScrollTo());

map.put("find", new Find());

map.put("getLocation", new GetLocation());

map.put("getSize", new GetSize());

map.put("wake", new Wake());

map.put("pressBack", new PressBack());

map.put("pressKeyCode", new PressKeyCode());

map.put("longPressKeyCode", new LongPressKeyCode());

map.put("takeScreenshot", new TakeScreenshot());

map.put("updateStrings", new UpdateStrings());

map.put("getDataDir", new GetDataDir());

map.put("performMultiPointerGesture", new MultiPointerGesture());

map.put("openNotification", new OpenNotification());

map.put("source", new Source());

map.put("compressedLayoutHierarchy", new CompressedLayoutHierarchy());

}

　　这个map指定了我们支持的pc端过来的所有action，以及对应的处理该action的类的实例，其实这些类都是CommandHandler的子类基本上就只有一个：去实现CommandHandler的虚拟方法execute！要做的事情就大概就这几类：

　　UiDevice相关的action：调用UiDevice提供的方法

　　UiAutomator那5个对象都没有的action：该调用InteractionController的就反射调用，该调用QueryController的就反射调用。注意这两个类UiAutomator是没有提供直接调用的方法的，所以只能通过反射。更多这两个类的信息请翻看之前的UiAutomator源码分析相关的文章

　　其他：如取得compressedLayoutHierarchy

　　指导action向CommandHandler真正发生转换的地方是在这个AndroidCommandExecutor的execute方法中：

public AndroidCommandResult execute(final AndroidCommand command) {

try {

Logger.debug("Got command action: " + command.action());

if (map.containsKey(command.action())) {

return map.get(command.action()).execute(command);

} else {

return new AndroidCommandResult(WDStatus.UNKNOWN_COMMAND,

"Unknown command: " + command.action());

}

} catch (final JSONException e) {

Logger.error("Could not decode action/params of command");

return new AndroidCommandResult(WDStatus.JSON_DECODER_ERROR,

"Could not decode action/params of command, please check format!");

}

　　它首先叫上面的AndroidCommand解析器把json字串的action给解析出来

　　然后通过刚提到的map把这个action对应的CommandHandler的实现类给实例化

　　然后调用这个命令处理类的execute方法开始执行命令

　　3. 命令处理示例

　　我们这里就示例性的看下getText这个action对应的CommandHandler是怎么去通过AndroidElement控件进行设置文本的处理的：

public class GetText extends CommandHandler {

/*

* @param command The {@link AndroidCommand} used for this handler.

*

* @return {@link AndroidCommandResult}

*

* @throws JSONException

*

* @see io.appium.android.bootstrap.CommandHandler#execute(io.appium.android.

* bootstrap.AndroidCommand)

*/

@Override

public AndroidCommandResult execute(final AndroidCommand command)

throws JSONException {

if (command.isElementCommand()) {

// Only makes sense on an element

try {

final AndroidElement el = command.getElement();

return getSuccessResult(el.getText());

} catch (final UiObjectNotFoundException e) {

return new AndroidCommandResult(WDStatus.NO_SUCH_ELEMENT,

e.getMessage());

} catch (final Exception e) { // handle NullPointerException

return getErrorResult("Unknown error");

}

} else {

return getErrorResult("Unable to get text without an element.");

}

　　关键代码就是里面通过AndroidCommand的getElement方法：

　　解析传进来的AndroidCommand实例保存的pc端过来的json字串，找到’params‘项的子项’elementId'

　　通过这个获得的id去控件哈希表（请查看《Appium Android Bootstrap源码分析之控件AndroidElement》）中找到目标AndroidElement控件对象

　　然后调用获得的AndroidElement控件对象的getText方法：

　　最终通过调用AndroidElement控件成员UiObject控件对象的getText方法取得控件文本信息

　　4. 小结

　　bootstrap接收到appium从pc端发送过来的json格式的键值对字串有多个项：

　　cmd: 这是一个action还是一个shutdown

　　action：如果是一个action的话，那么是什么action，比如click

　　params:拥有其他的一些子项，比如指定操作控件在AndroidElementHash维护的控件哈希表的控件键值的'elementId'

　　在收到这个json格式命令字串后：

　　AndroidCommandExecutor会调用AndroidCommand去解析出对应的action

　　然后把action去map到对应的真实命令处理方法CommandHandler的实现子类对象中

　　然后调用对应的对象的execute方法来执行命令

最新内容请见作者的GitHub页：http://qaseven.github.io/

微信关注我们

原文链接：https://yq.aliyun.com/articles/129697

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

Appium Android Bootstrap之控件AndroidElement

AndroidElementHash的这个getElement命令要做的事情就是针对这两点来根据不同情况获得目标控件 /** * Return an elements child given the key (context id), or uses the selector * to get the element. * * @param sel * @param key * Element id. * @return {@link AndroidElement} * @throws ElementNotFoundException */ public AndroidElement getElement(final UiSelector sel, final String key) throws ElementNotFoundException { AndroidElement baseEl; baseEl = elements.get(key); UiObject el; if (baseEl == null) { el = new UiObject(sel); } els...

2017-07-03

679

　FlipTest是专为iOS设计的移动应用A/B测试框架，通过它，开发者可以无需重新向App Store提交应用或重构代码，只需添加一行代码，即可直接在iOS应用上进行A/B测试。对移动应用做 A/B 测试是非常难的，而 FlipTest 可以帮你简化这个过程。对于想要追求UI极致的开发者而言，FlipTest绝对是最合适的测试框架。FlipTest会为应用选择最恰当的用户界面，还会基于外观、可用性等众多因素返还测试结果，从而帮助开发者彻底解决UI问题。最新内容请见作者的GitHub页：http://qaseven.github.io/

2017-07-03

557

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。