appium笔记

来自各处的appium的笔记

具体介绍：

中文网站：http://appium.io/slate/cn/master/?Java#about-appium

其他参考：http://blog.sina.com.cn/s/blog_c2c7d41b0102xd47.html

Appium支持IOS、Android及FirefoxOS平台。Appium使用WebDriver的json wire协议，来驱动Apple系统的UIAutomation库、Android系统的UIAutomator框架。Appium也集成了Selendroid，来支持老android版本。

二、Appium的工作原理

2.1 Android

在Android端，appium基于WebDriver协议，利用Bootstrap.jar，最后通过调⽤用UiAutomator的命令，实现App的自动化测试。

UiAutomator测试框架是Android SDK自带的App UI自动化测试Java库。

另外由于UiAutomator对H5的支持有限，appium引入了chromedriver以及safaridriver等来实现基于H5的自动化。

appium 在android端工作流

1. client端也就是我们 test script是我们的webdriver测试脚本。

2. 中间是起的Appium的服务，Appium在服务端起了一个Server（4723端口），跟selenium Webdriver测试框架类似， Appium⽀持标准的WebDriver JSONWireProtocol。在这里提供它提供了一套REST的接口,Appium Server接收web driver client标准rest请求，解析请求内容，调⽤用对应的框架响应操作。

3. appium server会把请求转发给中间件Bootstrap.jar ，它是用java写的，安装在手机上.Bootstrap监听4724端口并接收appium 的命令，最终通过调⽤用UiAutomator的命令来实现。

4. 最后Bootstrap将执行的结果返回给appium server。

5. appium server再将结果返回给 appium client。

2.2 ios

在IOS端，appium同样使⽤WebDriver的一套协议。

与Android端测试框架不同的是，appium ios封装了apple的 Instruments框架，主要用了Instrument里的UI Automation（Apple的⾃自动化测试框架），然后在设备中注⼊入bootstrap.js进⾏行监听。

appium 在ios端工作流

1. client端 依然是 test script是我们的webdriver测试脚本。

2. 中间是起的Appium的服务，Appium在服务端起了一个Server（4723端口），跟selenium Webdriver测试框架类似， Appium⽀持标准的WebDriver JSONWireProtocol。在这里提供它提供了一套REST的接口,Appium Server接收web driver client标准rest请求，解析请求内容，调⽤用对应的框架响应操作。

3. appium server调用instruments.js 启动⼀一个socket server，同时分出一个⼦子进程运⾏instruments.app，将bootstrap.js（一个UIAutomation脚本）注⼊入到device⽤于和外界进行交互

4. 最后Bootstrap.js将执行的结果返回给appium server

5. appium server再将结果返回给 appium client。

所以我们可以看到android与ios区别在于appium 将请求转发到bootstrap.js或者bootstrap.jar.然后由bootstrap 驱动UIAutomation和UiAutomator去devices上完成具体的动作。

appium采用的第三方测试框架

iOS: 苹果的 UIAutomation

Android 4.2+: Google's UiAutomator

Android 2.3+: Google's Instrumentation. (Instrumentation由单独的项目Selendroid提供支持 )

appium的安装参考：http://blog.csdn.net/baoqqwww200/article/details/56480709

android定位：

driver.findElement(By.id(resrouce-id));/By.Classname/By.xpath()/By.AccessibilityId(content-desc)/By.name(1.5之前可以使用，1.5之后无法定位文案text)

或者driver.findElementById(resrouce-id)等

或者通过AndroidUIAutomator定位元素

driver.findElementByAndroidUIAutomator("new UiSelector().resourceId(\"xxxx\")");

亦可简写成driver.findElementByAndroidUIAutomator("resourceId(\"xxxx\")");//其他包括textContains，textStartsWith，className等

具体参考：https://developer.android.com/reference/android/support/test/uiautomator/UiSelector.html

获取控件的内容：

getAttribute():参考android的uiautomation中列出的元素属性，getAttribute("text")/getAttribute("resource-id")

xpath获取路径

http://blog.csdn.net/hqzxsc2006/article/details/51066362

一、xpath基本语法：

表达式	描述
nodename	选取此节点的所有子节点。
/	从根节点选取。
//	从匹配选择的当前节点选择文档中的节点，而不考虑它们的位置。
.	选取当前节点。
..	选取当前节点的父节点。
@	选取属性。

路径表达式	结果
/bookstore/book[1]	选取属于 bookstore 子元素的第一个 book 元素。
/bookstore/book[last()]	选取属于 bookstore 子元素的最后一个 book 元素。
/bookstore/book[last()-1]	选取属于 bookstore 子元素的倒数第二个 book 元素。
/bookstore/book[position()<3]	选取最前面的两个属于 bookstore 元素的子元素的 book 元素。
//title[@lang]	选取所有拥有名为 lang 的属性的 title 元素。
//title[@lang='eng']	选取所有 title 元素，且这些元素拥有值为 eng 的 lang 属性。
/bookstore/book[price>35.00]	选取 bookstore 元素的所有 book 元素，且其中的 price 元素的值须大于 35.00。
/bookstore/book[price>35.00]/title	选取 bookstore 元素中的 book 元素的所有 title 元素，且其中的 price 元素的值须大于 35.00。

子控件相应顺序从1开始，而不是从0开始

举例：

//input[@class=’input’]选择元素中的属性
//input[@class]选择有属性名为class的input标签
//input[@]选择有属性的input标签
1、精确匹配  //UIAButton[@name="全部"]
2、模糊匹配 //UIAButton[@name starts-with "全"]
3、模糊匹配 //UIAButton[@name contains "全"]

Ios定位相关

采用macaca app-inspector定位界面

具体安装方法http://blog.csdn.net/baoqqwww200/article/details/58587011

由于xpath定位的准确性与效率问题，采用findelementByIosNSPredicate进行定位（ios10以及以上版本使用，9以及以下使用iosUIAutomation）

NSPredicate的相关使用内容

driver.findElementByIosNsPredicate("name = 'head new'"); // 等于

driver.findElementByIosNsPredicate("name LIKE '*new'");  // 模糊匹配

driver.findElementByIosNsPredicate("name MATCHES '^$'"); // 正则表达式匹配

driver.findElementByIosNsPredicate("name = 'Settings' AND type = 'XCUIElementTypeButton'"); // 多个条件

name为app inspector获取到的元素名称比如type，label等

=为关系词，包括LIKE（模糊匹配），MATCHES（匹配正则式）, CONTAINS, BEGINSWITH, ENDSWITH, 等

webview相关

前提需要app的webview是可调试的，app源码中需要加入代码

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
            m_webview.getSettings().setMediaPlaybackRequiresUserGesture(false);
        }

测试代码中：

//获取所有的context，若未开启webview调试，则不会出现WEBVIEW_xxx.xxx.xxxx

Set<String> contexts = driver.getContextHandles();
        for (String context : contexts) {
            System.out.println(context); //会打印出  NATIVE_APP（原生app handle）和WEBVIEW_com.example.testapp(webview的 handle)
        }
//进入webview中
        driver.context("WEBVIEW_com.example.testapp");

firefox中采用插件user agent switcher可以切换成手机显示，以用来查看手机上webview显示