前言：

前段时间学习Android自动化测试，网上关于Appium的介绍和学习资料比较散乱，大多不齐全，官网API看的也是一脸懵，所以决定自己整理一份文档，供自己学习，也希望能帮助到正在学习Appium和自动化测试的朋友们。
在本地写了一个md文档之后，放到了GitHub上维护。鉴于简书的颜值，我决定转战简书写博客，但是简书的Markdown貌似不只是页内锚点跳转，所以本文的所有锚点都无效了。文章有些长，需要pdf的朋友们可以去我的GitHub上拿。

为什么选择Appium

学习Android自动化测试的时候，看了google官方推荐的几个工具和测试框架，比如Espresso和UI Automator，其中在使用UI Automator来做UI自动化测试的时候，发生一点问题：向控件输入字符的时候无效！不管是中文还是英文都无法输入，而且最终竟然还显示测试通过。经过多方搜索都找不到解决办法，最终还是选择Appium，并且Appium是跨平台的，可以测试ios和Android还有webApp；其中Android平台上是基于UI Automator的，所以可以无缝切换使用UI Automator的API。

作者：GeeJoe
邮箱：geejoe_developer@outlook.com
GitHub：https://github.com/GeeJoe/AppiumDoc
更新时间：2017-09-14 16:44

Appium使用指南

• 环境配置
• 启动Appium Server
• 学习DesiredCapabilities
• Session简介
• 元素定位
• 使用UI Automator定位元素
• 使用JUnit组织测试用例
• 显式等待和隐式等待

环境配置

• 安装Nodejs
• 安装Appium
• 配置IDE

安装NodeJs

到 Nodejs官网 下载最新版本的NodeJs并直接安装。安装完毕后，打开命令行，输入 node -v ，出现类似下面的信息说明安装成功。

V4.0.0

安装Appium

到 Appium 官网 载和你所使用系统一致的版本进行安装。

验证安装

当确认Appium安装完毕后，我们可以通过 appium-doctor 的命令来检查当前appium安装是否完善，当前的JDK、SDK等环境是否配置正确。

如果 appium-doctor 返回的内容是有错的，请根据返回的具体的提示，将你的环境搭建完善。
如果返回的结果类似如下，说明安装成功

...
...
Android Checks were successful.
All Checks were successful

需要注意的是，如果你是通过安装包安装的，使用 appium-doctor 命令时必须切换到
C:\Program Files (x86)\Appium\node_modules.bin 目录;为了方便，需要把.bin目录添加到环境变量Path中。

配置IDE

配置AndroidStudio

1. 新建一个项目，AndroidStudio新建项目会自动生成一个 androidTest 包和 test 包
2. 下载 Appium java client 及 Selenium Java standalone server 两个库对应的 jar 包
3. 将两个jar包复制到项目module里的 libs 目录
4. 选择两个jar包，单击鼠标右键，选择Add as Library
5. 配置成功，可以在 test 包中新建测试用例了

启动Appium Server

通过图形化界面启动

双击Appium图标，打开Appium应用

appium_start.png

点击箭头所指的按钮即可启动

从命令行启动

只需要一个命令：

appium

若显示如下信息则启动成功：

info: Welcome to Appium v1.4.16 (REV ae6877eff263066b26328d457bd285c0cc62430d)
info: Appium REST http interface listener started on 0.0.0.0:4723
info: Console LogLevel: debug

若需要退出，按下 ctrl+c 即可

配置启动参数

启动时可以手动配置参数，了解所有参数，可查阅 Appium 官方文档

这些参数同样可以在图形界面设置：

setting.png

学习DesiredCapabilities

DesiredCapabilities简介

DesiredCapabilities 携带了一些配置信息，在启动session的时候是必须提供，如启动模式、apk/app配置、package/activity配置、浏览器配置、键盘配置等。

Desired Capabilities关键字

Desired Capabilities的重要作用是在启动时传递信息给Appium Server。
下表中列举了Appium常用的 Desired Capabilities 关键字。

Android 独有

Session简介

Session 是指我们的测试脚本从打开应用到最终执行完毕关闭应用的整个过程。
对于测试脚本，从申请到退出一个 session 的整个过程如下：

//打开一个应用，也可以称为“申请一个Session”
AndroidDriver driver = new AndroidDriver<>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);

//此处的所有代码处于一个Session中
...

//关闭应用，也可以称为“退出一个Session”
driver.quit();

元素定位

注： 每一个方法对应着一个findElementsBy***方法，后者返回一个Element集合List，表示一个符合查找规则的一个Element集合

findElementByName

在Android中，没有合适的方法可以找到控件的Name属性，但是大多数情况下可以用控件的text代替name。

findElementByAndroidUIAutomator

使用UI Automator查找控件：

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

更多关于UI Automator定位元素的方法，详见：UI Automator定位元素

findElementByClassName

WebElement el = driver.findElementByClassName("android.weight.TextView");

findElementById

WebElement el = driver.findElementById("android:id/title");

如果目标设备的API Level低于18则UIAutomatorViewer不能获得对应的Resource ID，只有等于大于18的时候才能使用。

findElementByAccessibilityId

WebElement el = driver.findElementByAccessibilityId("menu_add_note_description");

Accessibility ID在Android上面就等同于contentDescription

findEelementByXPath

WebElement el = driver.findElementByXPath("//android.widget.TextView[contains(@text,'Add note')]");  

xPath是一种路径，在uiautomatorviewer中可以查看当前页面的元素层级，XPath就是用来描述这种层级关系的一种路径表达方式，比如，下图中的例子，想找列表中第二个note1，则可以这样写：

UIAutomatorviewer.png

WebElement el = driver.findElementByXPath("//android.widget.LinearLayout[1]/android.widget.FrameLayout/android.widget.ListView/android.widget.TextView[contains(@index,0)]");  

findElementByCssSelector

这个方法是针对WebView容器下面的控件定位的，因为现在针对的是Native App暂时还没有用到，所以先标记下，今后需要的时候加上去。

findElementByLinkText

这个方法是针对WebView容器下面的控件定位的，因为现在针对的是Native App暂时还没有用到，所以先标记下，今后需要的时候加上去。

findElementByPartialLinkText

这个方法是针对WebView容器下面的控件定位的，因为现在针对的是Native App暂时还没有用到，所以先标记下，今后需要的时候加上去。

UI Automater定位元素

UI Automator中主要通过UISelector类查找元素

通过文本信息定位

通过description定位

通过ResourceId定位

通过类名定位

通过层级关系

使用JUnit组织测试用例

使用JUnit来组织Appium测试用例，可以添加@Before、@Test或者@After等注解来使测试代码的运行变得更加灵活。

比如在开始测试之前，需要配置Capability和连接Appium服务器，而且一般需要安装应用或者打开应用的某个Activity。这时候可把这些操作放到一个方法中，并且方法添加@Before注解，则在运行的时候，@Before方法会先于@Test方法执行。

同理，测试结束后需要关闭session，回收资源等等，可以把这些操作放到一个@After方法中，@After方法在所有@Test方法结束之后执行。

显式等待和隐式等待

有时候，由于网络或者其他原因，页面跳转之后，某些元素没有立即显示出来，此时查找元素会失败。这种情况就需要引入显式等待和隐式等待

线程等待

直接使用Thread.sleep();

隐式等待

driver.manage().timeouts().implicitlyWait(30, TimeUnit.SECONDS);

全局等待30秒，不管元素是否已经加载

显式等待

WebDriverWait 显示等待，显示等待时间可以通过 WebDriverWait 和 util 来决定,比如这个 timeOut 是60，如果该元素60s以内出现就不在等待。

WebDriverWait wait = new WebDriverWait(driver, 60);
    WebElement e= wait.until(new  ExpectedCondition<WebElement>() {
            @Override
            public WebElement apply(WebDriver d) {
                return d.findElement(By.id("q"));
            }
        })