Appium Android Bootstrap源码分析之控件AndroidElement

我们在脚本上对控件的认识就是一个WebElement:

WebElement addNote =  driver.findElementByAndroidUIAutomator("new UiSelector().text(\"Add note\")");

        WebElement addNote = driver.findElementByAndroidUIAutomator("new UiSelector().text(\"Add note\")");         addNote.getText();         addNote.click();

pc端传过来的json字串有几个fields：

• cmd:代表这个是什么命令类型，其实就是AndroidCommandType的那两个值

package io.appium.android.bootstrap;  /**  * Enumeration for all the command types.  *   */ public enum AndroidCommandType {   ACTION, SHUTDOWN }

• action: 具体命令
• params: 提供的参数，这里提供了一个elementId的键值对

• UiObject el ：uiautomator框架中代表了一个真实的窗口控件
• Sting id :  一个唯一的自动增加的字串类型整数，pc端就是通过它来在AndroidElementHash这个类中找到想要的控件的

3. AndroidElement控件哈希表

上一节我们说到appium pc端是通过id把WebElement和目标机器端的AndroidElement映射起来的，那么我们这一节就来看下维护AndroidElement的这个哈希表是怎么实现的。

首先，它拥有两个成员变量：

  private final Hashtable<String, AndroidElement> elements;   private       Integer                           counter;

• elements ：一个以AndroidElement 的id的字串类型为key，以AndroidElement的实例为value的的哈希表
• counter : 一个整型变量，有两个作用：其一是它代表了当前已经用到的控件的数目（其实也不完全是，你在脚本中对同一个控件调用两次findElement其实会产生两个不同id的AndroidElement控件），其二是它代表了一个新用到的控件的id，而这个id就是上面的elements哈希表的键

  /**    * Constructor    */   public AndroidElementsHash() {     counter = 0;     elements = new Hashtable<String, AndroidElement>();   }

  public static AndroidElementsHash getInstance() {     if (AndroidElementsHash.instance == null) {       AndroidElementsHash.instance = new AndroidElementsHash();     }     return AndroidElementsHash.instance;   }

  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;   }

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

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

[java] view plaincopy

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

• 2. 基于父控件查找：

[java] view plaincopy

1. 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控件对象保存到控件哈希表