Appium Android Bootstrap源码分析之启动运行

• 启动命令:uiautomator runtest AppiumBootstrap.jar -c io.appium.android.bootstrap.Bootstrap

public class Bootstrap extends UiAutomatorTestCase {    public void testRunServer() {     SocketServer server;     try {       server = new SocketServer(4724);       server.listenForever();     } catch (final SocketServerException e) {       Logger.error(e.getError());       System.exit(1);     }    } }

• 创建一个socket服务器并监听4724端口，Appium在pc端就是通过连接这么端口来把命令发送过来的
• 循环监听获取Appium从pc端发送过来的命令数据，然后进行相应的处理

  public SocketServer(final int port) throws SocketServerException {     keepListening = true;     executor = new AndroidCommandExecutor();     try {       server = new ServerSocket(port);       Logger.debug("Socket opened on port " + port);     } catch (final IOException e) {       throw new SocketServerException(           "Could not start socket server listening on " + port);     }    }

  public void listenForever() throws SocketServerException {     Logger.debug("Appium Socket Server Ready");     ...     try {       client = server.accept();       Logger.debug("Client connected");       in = new BufferedReader(new InputStreamReader(client.getInputStream(), "UTF-8"));       out = new BufferedWriter(new OutputStreamWriter(client.getOutputStream(), "UTF-8"));       while (keepListening) {         handleClientData();       }       in.close();       out.close();       client.close();       Logger.debug("Closed client connection");     } catch (final IOException e) {       throw new SocketServerException("Error when client was trying to connect");     }     ... }

 private void handleClientData() throws SocketServerException {     try {       input.setLength(0); // clear        String res;       int a;       // (char) -1 is not equal to -1.       // ready is checked to ensure the read call doesn't block.       while ((a = in.read()) != -1 && in.ready()) {         input.append((char) a);       }       String inputString = input.toString();       Logger.debug("Got data from client: " + inputString);       try {         AndroidCommand cmd = getCommand(inputString);         Logger.debug("Got command of type " + cmd.commandType().toString());         res = runCommand(cmd);         Logger.debug("Returning result: " + res);       } catch (final CommandTypeException e) {         res = new AndroidCommandResult(WDStatus.UNKNOWN_ERROR, e.getMessage())             .toString();       } catch (final JSONException e) {         res = new AndroidCommandResult(WDStatus.UNKNOWN_ERROR,             "Error running and parsing command").toString();       }       out.write(res);       out.flush();     } catch (final IOException e) {       throw new SocketServerException("Error processing data to/from socket ("           + e.toString() + ")");     }   }

• 通过刚才建立的socket读取对象去读取appium发送过来的数据
• 把获得的的json命令字串发送给getCommand方法来实例化我们的AndroidCommand这个类，然后我们就可以通过这个解析器来获得我们想要的json命令项了

  private AndroidCommand getCommand(final String data) throws JSONException,       CommandTypeException {     return new AndroidCommand(data);   }

4.控件是如何加入到控件哈希表的

WebElement el = driver.findElement(By.name("Add note"));

• cmd:指定是一个action
• action:指定这个action是一个find命令
• params
  • strategy:指定选择子的策略是根据空间名name来进行查找
  • selector: 指定选择子的内容是"Add note"
  • context: 指定空间哈希表中目标控件的键值id，这里为空，因为该控件我们之前没有用过
  • multiple: 表明你脚本代码用的是findElements还是findElement，是否要获取多个控件

• 第一步：获得控件的选择子策略，以便跟着通过该策略来建立uiautomator的UiSelector

  public AndroidCommandResult execute(final AndroidCommand command)       throws JSONException {     final Hashtable<String, Object> params = command.params();      // only makes sense on a device     final Strategy strategy;     try {       strategy = Strategy.fromString((String) params.get("strategy"));     } catch (final InvalidStrategyException e) {       return new AndroidCommandResult(WDStatus.UNKNOWN_COMMAND, e.getMessage());     }    ... }

public enum Strategy {   CLASS_NAME("class name"),   CSS_SELECTOR("css selector"),   ID("id"),   NAME("name"),   LINK_TEXT("link text"),   PARTIAL_LINK_TEXT("partial link text"),   XPATH("xpath"),   ACCESSIBILITY_ID("accessibility id"),   ANDROID_UIAUTOMATOR("-android uiautomator");

• 第二步：获取appium发过来的选择子的其他信息如内容，控件哈希表键值，是否是符合选择子等

  public AndroidCommandResult execute(final AndroidCommand command)       throws JSONException {     final Hashtable<String, Object> params = command.params();    ...      final String contextId = (String) params.get("context");     final String text = (String) params.get("selector");     final boolean multiple = (Boolean) params.get("multiple");    ... }

• 第三步，在获得一样的选择子的信息后，就可以根据该选择子信息建立真正的UiSelector选择子列表了,这里用列表应该是考虑到今后的复合选择子的情况，当前我们并没有用到，整个列表只会有一个UiSelector选择子

  public AndroidCommandResult execute(final AndroidCommand command)       throws JSONException {    ...     try {       Object result = null;       List<UiSelector> selectors = getSelectors(strategy, text, multiple);        ...       }     ... }

• 第四步：组建好选择子UiSelector列表后，Find会根据你是findElement还是findElement，也就是说是查找一个控件还是多个控件来查找控件，但是无论是多个还是一个，最终都是调用fetchElement这个方法来取查找的

  public AndroidCommandResult execute(final AndroidCommand command)       throws JSONException {    ...     try {       Object result = null;       List<UiSelector> selectors = getSelectors(strategy, text, multiple);        if (!multiple) {         for (final UiSelector sel : selectors) {           try {             Logger.debug("Using: " + sel.toString());             result = fetchElement(sel, contextId);           } catch (final ElementNotFoundException ignored) {           }           if (result != null) {             break;           }         }       }else {         List<AndroidElement> foundElements = new ArrayList<AndroidElement>();         for (final UiSelector sel : selectors) {           // With multiple selectors, we expect that some elements may not           // exist.           try {             Logger.debug("Using: " + sel.toString());             List<AndroidElement> elementsFromSelector = fetchElements(sel, contextId);             foundElements.addAll(elementsFromSelector);           } catch (final UiObjectNotFoundException ignored) {           }         }         if (strategy == Strategy.ANDROID_UIAUTOMATOR) {           foundElements = ElementHelpers.dedupe(foundElements);         }         result = elementsToJSONArray(foundElements);       }    ... } 

而fetchElement最终调用的控件哈希表类的getElements:

  private ArrayList<AndroidElement> fetchElements(final UiSelector sel, final String contextId)       throws UiObjectNotFoundException {      return elements.getElements(sel, contextId);   }

AndroidElementHash的这个方法我们在前一篇文章《Appium Android Bootstrap源码分析之控件AndroidElement》已经分析过，我们今天再来温习一下.

从Appium发过来的控件查找命令大方向上分两类：

• 1. 直接基于Appium Driver来查找，这种情况下appium发过来的json命令是不包含控件哈希表的键值信息的

WebElement addNote = driver.findElement(By.name("Add note"));

• 2. 基于父控件查找：

WebElement el = driver.findElement(By.className("android.widget.ListView")).findElement(By.name("Note1"));

以上的脚本会先尝试找到Note1这个日记的父控件ListView,并把这个控件保存到控件哈希表，然后再根据父控件的哈希表键值以及子控件的选择子找到想要的Note1:

AndroidElementHash的这个getElement命令要做的事情就是针对这两点来根据不同情况获得目标控件的

[java] view plaincopy

1. /** 
2.  * Return an elements child given the key (context id), or uses the selector 
3.  * to get the element. 
4.  *  
5.  * @param sel 
6.  * @param key 
7.  *          Element id. 
8.  * @return {@link AndroidElement} 
9.  * @throws ElementNotFoundException 
10.  */  
11. public AndroidElement getElement(final UiSelector sel, final String key)  
12.     throws ElementNotFoundException {  
13.   AndroidElement baseEl;  
14.   baseEl = elements.get(key);  
15.   UiObject el;  
16.   
17.   if (baseEl == null) {  
18.     el = new UiObject(sel);  
19.   } else {  
20.     try {  
21.       el = baseEl.getChild(sel);  
22.     } catch (final UiObjectNotFoundException e) {  
23.       throw new ElementNotFoundException();  
24.     }  
25.   }  
26.   
27.   if (el.exists()) {  
28.     return addElement(el);  
29.   } else {  
30.     throw new ElementNotFoundException();  
31.   }  
32. }  

• 如果是第1种情况就直接通过选择子构建UiObject对象，然后通过addElement把UiObject对象转换成AndroidElement对象保存到控件哈希表
• 如果是第2种情况就先根据appium传过来的控件哈希表键值获得父控件，再通过子控件的选择子在父控件的基础上查找到目标UiObject控件，最后跟上面一样把该控件通过addElement把UiObject控件转换成AndroidElement控件对象保存到控件哈希表

以下就是把控件添加到控件哈希表的addElement方法

  public AndroidElement addElement(final UiObject element) {     counter++;     final String key = counter.toString();     final AndroidElement el = new AndroidElement(key, element);     elements.put(key, el);     return el;   }

5. 小结

• Appium的bootstrap这个jar包以及里面的o.appium.android.bootstrap.Bootstrap类是通过uiautomator作为一个uiautomator的测试包和测试方法类启动起来的
• Bootstrap测试类继承于uiautomator可以使用的UiAutomatorTestCase
• bootstrap会启动一个socket server并监听来自4724端口的appium的连接
• 一旦appium连接上来，bootstrap就会不停的去获取该端口的appium发送过来的命令数据进行解析和执行处理，然后把结果写到该端口返回给appium
• bootstrap获取到appium过来的json字串命令后，会通过AndroidCommand这个命令解析器解析出命令action，然后通过AndroidCommandExecutor的action到CommandHandler的map把action映射到真正的命令处理类，这些类都是继承与CommandHandler的实现类，它们都要重写该父类的execute方法来最终通过UiObject,UiDevice或反射获得UiAutomator没有暴露出来的QueryController/InteractionController来把命令真正的在安卓系统中执行
• appium获取控件大概有两类，一类是直接通过Appium/Android Driver获得，这一种情况过来的appium查找json命令字串是没有带控件哈希表的控件键值的；另外一种是根据控件的父类控件在控件哈希表中的键值和子控件的选择子来获得，这种情况过来的appium查找json命令字串是既提供了父控件在控件哈希表的键值又提供了子控件的选择子的
• 一旦获取到的控件在控件哈希表中不存在，就需要把这个AndroidElement控件添加到该哈希表里面