Appium移动自动化测试教程

前言：本篇教程适合哪些人看？

• 你应该懂一点编程语言（Java或Python但不限于），配置环境变量当然更不在话下
• 本文将使用Java语言，如果你使用的是其他语言也似乎没关系，Appium支持多语言（python、java、ruby、js、c#等)
• 文章中原理不会讲的很细，主要是讲实操，快速上手并能编写自动化测试脚本

一、Appium简介？

1. Appium是什么

• Appium是一个开源的自动化测试框架，可用于本地、混合和移动web应用。
  它使用WebDriver协议驱动iOS、Android和Windows应用程序。

2. Appium的特点

• 支持多平台（Android、iOS等）
• 支持多语言（python、java、ruby、js、c#等)
• Appium是跨平台的，可以用在OSX，Windows以及Linux桌面系统上运行。

Appium选择了Client/Server的设计模式。只要client能够发送http请求给server，那么的话client用什么语言来实现都是可以的，这就是如何做到支持多语言的原因；

Appium扩展了WebDriver的协议，没有自己重新去实现一套。这样的好处是以前的WebDriver API能够直接被继承过来，以前的Selenium（WebDriver）各种语言的binding都可以拿来就用，省去了为每种语言开发一个client的工作量。

更多详细介绍参见Appium官网

二、环境准备

1. 安装JDK (镜像下载) 并配置环境变量
2. 安装Android SDK 并配置环境变量
3. 安装Appium Server
4. 安装夜神模拟器
   这里推荐夜神模拟器，安装模拟器主要用来获取页面元素，这个后面讲
5. 安装IDE( IDEA或Eclipse…)

三、基础知识

元素探测工具

用来定位APP元素的，比如需要点击某个按钮，需要获取到该按钮的元素才能对其进行操作（单击，双击等），这里推荐使用UIAutomatorViewer。

APP类型

APP页面布局

类似于HTML，页面由各个标签组成

Android 调试桥（adb）

adb常用命令

更多adb命令请参考：Android 调试桥 (adb)


注意

查看前台（即手机当前界面）应用包名: adb shell dumpsys activity | find “mFocusedActivity”
注意：如果是真机的话，Android版本一般是在8.0以上，命令需要改下adb shell dumpsys activity | find “mResumedActivity”

四、实战

使用UIAutomatorViewer获取App页面元素（重要）

1. 双击运行夜神模拟器 ，使用adb连接到模拟器，打开dos窗口运行命令：adb connect 127.0.0.1:62001 (127.0.0.1表示模拟器运行在本机、62001表示夜神的端口、其他模拟器端口自行查资料获取)
   
2. 进入Android SDK的安装目录，我的安装目录是D:\Android\android-sdk\tools 双击运行 uiautomatorviewer.bat 启动元素探测工具，uiautomatorviewer刷新获取元素，这个元素我们写自动化测试脚本的时候会用到，下面以微信为例：
   

Appium重要参数

1. deviceName：设备名即设备的连接地址 例如夜神的deviceName是127.0.0.1:62001
2. platformName: Android 或 IOS
3. appPackage：进入D:\Android\android-sdk\build-tools\29.0.3> 路径输入cmd 执行(将app安装包xxx.apk拖动到命令界面) appt dump badging D:\001-gwad01900121.apk
   找到：package: name=‘com.chinasofti.rcs’
4. appActivity：同上找到：launchable-activity: name=‘com.cmic.module_main.ui.activity.WelcomeActivity’ label=’’ icon=’’

在没有安装包xxx.apk的情况下（比如多开应用）怎么获取appPackage和appActivity呢？
使用adb logcat>D:/log.log：（真机）
1、需要配置好android的开发环境后，打开cmd命令窗口；
2.在命令窗口中输入，adb logcat>D:/log.log，输入D盘下，表示日志文件存储在D盘根目录
3、运行手机上app应用程序，需要获取到app应用程序
4、然后停止运行获取手机上logcat的文件，停止是直接按Ctrl+c
5、打开输入的日志文件：直接搜寻Displayed
6、通过抓取到log的日志，找到相应activity的应用程序
参考：实现获取appPackage和appActivity的方法

Android连接真机并编写测试脚本

1. Android无线调试方法（Root和非Root）

注：打开开发者选项、进入手机开发者选项，开启调试模式（USB调试、USB安装、USB调试（安全设置）），不同的手机请自行查询。

• 获取root权限的情况：

1. 手机安装无线调试工具，adbWireless.apk； 工具下载地址
2. 手机连接wifi（与电脑同局域网），打开adbWireless.apk软件，打开调试状态，界面会显示ip地址。
3. 在计算机命令行，进入sdk目录\android_sdk\platform-tools 输入 adb connect <设备的IP地址>:5555 连接成功会显示：connected to <设备的IP地址>:5555

• 非root状态下：

1. 使用USB数据线连接设备。
2. 在命令行输入adb tcpip 5555 ( 5555为端口号，可以自由指定）。
3. 断开 USB数据，此时可以连接你需要连接的USB设备。
4. 在计算机命令行，进入sdk目录\android_sdk\platform-tools (配置了环境变量直接进入dos窗口)输入 adb connect <设备的IP地址>:5555
   连接成功会显示：connected to <设备的IP地址>:5555

注：

1. 当端口为默认端口5555 时，adb connect <设备的IP地址> 等同于adb connect <设备的IP地址>:5555，如果 adb tcpip 连接的端口号不是 5555 时 adb connect 时 IP后需要需要加上端口号。
2. 设置ip可以在连接的WIFI信息里面看
3. 断开连接，执行：adb disconnect
   PS：如果手机 wifi 断了，也会自动中断连接，需要重新连接。

5. 如果需要恢复到USB数据线，可以在命令行输入adb usb

解决报错：
cannot connect to 10.73.11.28:5555: 由于目标计算机积极拒绝，无法连接。 (10061)
解决办法：
1、先使用USB连接手机，连接成功后使用电脑终端输入命令打开手机端的端口：
adb tcpip 5555//打开5555端口
2、断开USB，校验是否能正常远程连接
adb connect 10.73.11.28//将IP替换成自己手机的IP

2. 运行Appium

3. 编写测试脚本

• pom文件添加appium client依赖

<dependency>
      <groupId>io.appium</groupId>
      <artifactId>java-client</artifactId>
      <version>6.1.0</version>
</dependency>

• 测试脚本如下

	//1、创建配置对象
	DesiredCapabilities desiredCapabilities = new DesiredCapabilities();
	//2、添加配置
	//deviceName：可以找到我们测试的设备   adb devices   需要先连接设备(端口查资料获取)：adb connect 127.0.0.101:5555
	desiredCapabilities.setCapability("deviceName", "192.168.0.101:5555");
	//platformName：测试平台Android or IOS
	desiredCapabilities.setCapability("platformName", "Android");
	//desiredCapabilities.setCapability("platformVersion", "10.0");
	//不清除应用数据
	desiredCapabilities.setCapability("noReset", "true");
	
	//appPackage：找到要测试的App
	//进入D:\Android\android-sdk\build-tools\29.0.3>  路径输入cmd 执行(将app拖动到命令界面) appt dump badging D:\001-gwad01900121.apk
	//找到：package: name='com.chinasofti.rcs'
	String appPackage = "";
	desiredCapabilities.setCapability("appPackage", appPackage);
	//appActivity：测试App启动入口
	//同上找到：launchable-activity: name='com.cmic.module_main.ui.activity.WelcomeActivity'  label='' icon=''
	String appActivity = "";
	desiredCapabilities.setCapability("appActivity", appActivity);
	//3、创建驱动//传入两个参数
	    //第一个参数：Appium通讯地址
	    //第二个参数：配置对象
	AndroidDriver<WebElement> androidDriver = new AndroidDriver<>(
	        new URL("http://127.0.0.1:4723/wd/hub"),desiredCapabilities);
	//4. 隐式等待：全局设置元素等待时间、超时时间内未获取到元素会继续执行下面的代码
	androidDriver.manage().timeouts().implicitlyWait(30, TimeUnit.SECONDS);
	
	//5.业务,需要模拟操作的一系列过程...   id如何获取？ 查看上面：使用UIAutomatorViewer获取App页面元素
	androidDriver.findElementById("id").click();
	
	//6. 释放资源
	androidDriver.closeApp();

以上内容就是关于Appium移动自动化教程的一些总结，亲测有效，如有不正之处欢迎指出，一起交流。