一文详解！appium自动化测试

前言：

Appinum前置知识

Andriod SDK

元素获取—UI Automator

adb命令实践

adb常用命令

小结

Package与Activity

Activity页面布局元素

monkey简介

monkey事件

操作事件简介

monkey参数

事件类参数

约束类参数

调试类参数

Monkey参数应用综合案例

Monkey脚本API简介

monkey日志管理

monkeyrunner

MonkeyRunner API

Appium

Appium组件

Capability

Capability启动App演示

appium元素定位

UIAutomator

Toast

屏幕截图

前言：

Appium是一种用于自动化移动设备应用程序的开源工具，它具有跨平台的特性，能够在iOS和Android等多种移动设备上进行测试。Appium提供了一套API，开发人员可以使用多种编程语言来编写自动化脚本。

Appinum前置知识

app类型和区别

Andriod SDK

元素获取—UI Automator

adb命令实践

Android 调试桥

adb ( Android Debug Bridge)是一个通用命令行工具，其允许您与模拟器实例或连接的 Android 设备进行通信。它可为各种设备操作提供便利，如安装和调试应用。

Tips：在 android_sdk/platform-tools/ 中找到 adb 工具，然后根据其具体的路径配置好环境变量。然后启动cmd 输入‘adb’即可查看是否配置成功。

adb 的工作原理

启动一个 adb 客户端时，此客户端首先检查是否有已运行的 adb 服务器进程。如果没有，它将启动服务器进程。当服务器启动时，它与本地 TCP 端口 5037 绑定，并侦听从 adb 客户端发送的命令—所有 adb 客户端均使用端口 5037 与 adb 服务器通信。

启用 adb 调试

要在通过 USB 连接的设备上使用 adb，您必须在设备系统设置中启用 USB debugging（位于 Developer options 下）。

在运行 Android 4.2 及更高版本的设备上，Developer options 屏幕默认情况下处于隐藏状态。如需将其显示出来，请转到 Settings > About phone 并点按 Build number 七次。返回上一屏幕，在底部可以找到 Developer options。

注：当您连接运行 Android 4.2.2 或更高版本的设备时，系统将显示一个对话框，询问您是否接受允许在这台计算机上调试的 RSA 密钥。这种安全机制可以保护用户设备，因为它可以确保只有在您能够解锁设备并确认对话框的情况下才能执行 USB 调试和其他 ADB 命令。

adb常用命令

查看adb版本

adb  version

连接夜神模拟器（此处分别演示模拟器和真机连接）

adb connect 127.0.0.1:62001

Tips:

夜神模拟器的端口是规律的，第一个模拟器端口是62001，第二个模拟器端口是62025，第三个是62025+1，依此类推。

模拟器1：Android 4.4.2 地址：127.0.0.1:62001
模拟器2: Andriod 5.1.1 地址：127.0.0.1:62025
更多详情：夜神安卓模拟器adb命令详解

查看设备信息

adb devices

如果出现如下提示：

adb server version (31) doesn't match this client (36); killing...

原因： adb版本不对 ,Androd SDK的版本和模拟器的adb版本不一致
解决方案：将Android SDK的 adb替换掉模拟器的adb即可。模拟器adb路径：{安装Path}\Nox\bin

adb shell

android 设备底层是 linux 系统。 shell 是 linux 系统的字符交互界面。

adb shell
#进入指定设备shell
adb  -s 127.0.0.1:62001 shell
 
#退出adb shell
exit

进入adb shell后有两种状态显示：#代表有root权限，$代表没有root权限

root@android:/ #
 
shell@mx4:/ $

root用户是系统中唯一的超级管理员，它具有等同于操作系统的权限。一些需要root权限的应用，譬如广告阻挡，卸载系统预装App是需要root权限的。可问题在于root比windows的系统管理员的能力更大，足以把整个系统的大部分文件删掉，导致系统完全毁坏，不能再次使用。所以，用root进行不当的操作是相当危险的，轻微的可以死机，严重的甚至不能开机。所以，在Unix、Linux及Android中，除非确实需要，一般情况下都不推荐使用root。

在设备安装apk

adb install | -r <apkName>  -r 覆盖原安装文件 -s 可以指定设备
eg:
 
#默认安装
adb install "C:\Users\Shuqing\Desktop\Appium 自动化测试教程\wandoujia.apk"
 
#覆盖安装
adb install -r  "C:\Users\Shuqing\Desktop\Appium 自动化测试教程\wandoujia.apk"
 
#指定设备安装
adb  -s 127.0.0.1:62001 install  C:\Users\Shuqing\Desktop\Appium\kaoyan3.1.0.apk 自动化测试教程\wandoujia.apk"

如遇到报错：Failure [INSTALL_FAILED_INVALID_URI]

解决方案： cmd命令行下执行以下命令：

第一步、adb remount
第二步、adb shell
第三步、cd /data
第四步、chmod 777 local
重新安装apk，ok了。

卸载apk

1.首先进入设备的/data/app目录找到app包名

adb shell
cd /data/app/

2.执行命令删除

adb uninstall  | -k  <apkName>  卸载软件
 
adb uninstall  com.wandoujia.phoenix2

Tips：安装后的包名系统会在末尾加上-1之类的数字，要去掉才可以成功卸载。软件名称为包名，不要包含.apk

-k 加 -k 参数,为卸载软件但是保留配置和缓存文件.

查看设备上面安装的应用包名

adb shell pm list package

文件读取写入

将文件从PC写入到设备

adb push <本地路径> <设备路径>
eg：
adb push C:\Users\Shuqing\Desktop\kyb.txt /sdcard
C:\Users\Shuqing\Desktop\kyb.txt: 1 file pushed. 0.1 MB/s (462 bytes in 0.005s)

将文件从设备读取到PC

adb pull <remote> <local>
eg:
adb pull /sdcard/server.log  C:\Users\Shuqing\Desktop
/sdcard/server.log: 1 file pulled. 0.0 MB/s (196 bytes in 0.004s)

注意：由于权限问题，不能直接pull到电脑磁盘根目录，否则会报错：

C:\Users\Shuqing>adb pull /sdcard/server.log  D:\\
adb: error: cannot create file/directory 'D:\\': No such file or directory

屏幕截图

$ adb shell screencap /sdcard/screen.png
adb pull /sdcard/screen.png  C:\Users\Shuqing\Desktop

adb服务启动和关闭

adb kill-server                        关闭adb服务
adb start-server                      开启adb服务

Tips：如果5037端口被占用可以使用如下命令释放端口

C:\Users\Shuqing> netstat -ano | findstr "5037"
  TCP    127.0.0.1:5037         0.0.0.0:0              LISTENING       11072
  TCP    127.0.0.1:5037         127.0.0.1:59519        TIME_WAIT       0
 
taskkill -f -pid XXX

小结

adb是自动化非常重要的一个工具
目前很多PC客户端手机助手也是基于adb连接原理进行封装的。
可以将常用的adb命令封装成bat命令，随时可以运行。如：

adbdevices.bat

adb devices
pause

AdbConnect.bat

adb connect 127.0.0.1:62025
adb devices
pause

Package与Activity

adb shell pm list package 查看所有的package包

Package

Package 包。只是在我们的app中这个Package是唯一的，就像你身份证号码一样。在我们做app自动化时，我们就需要知道他的Package，我们知道了Package那么也就知道我们需要对哪个app做自动化。注意和.apk文件包名不同。

Activity

Android中，activity是所有程序的根本，所有程序的流程都运行在activity之中，activity可以算是开发者遇到的最频繁，也是android当中最基本的模块之一。在android的程序中，activity一般代表手机屏幕的一屏。如果把手机比作一个浏览器，那么activity就相当于一个网页。在activity当中可以添加一些Button、Checkbox等控件，可以看到activity概念和网页的概念相当类似。

一般一个android应用是由多个activity组成的，这多个activity之间可以进行相互跳转。例如，按下一个Button按钮后，可能会跳转到其他的activity，与网页跳转稍微有点不一样的是，activity之间的跳转有可能返回值。

Tips：activity的生命周期：即“产生、运行、销毁”，但是这其中会调用许多方法onCreate（创建）、onStart（激活）、onResume（恢复）、onPause（暂停）、onStop（停止）、onDestroy（销毁）、onRestart（重启）。

Activity获取

研发提供

aapt

aapt即Android Asset Packaging Tool，在SDK的build-tools目录下。该工具可以查看，创建，更新ZIP格式的文档附件(zip, jar, apk)。也可将资源文件编译成二进制文件。获取命令如下：

aapt dump badging xxxx.apk
aapt dump badging xxxx.apk | find "launchable-activity"

可以把appt配置到环境变量（系统变量中的Path），这样运行便捷一些，appt路径：\Andriod_SDK\build-tools{version}

Activity页面布局元素

FrameLayout

FrameLayout是最简单的布局了。所有放在布局里的控件，都按照层次堆叠在屏幕的左上角。后加进来的控件覆盖前面的控件。

LinearLayout

LinearLayout按照垂直或者水平的顺序依次排列子元素，每一个子元素都位于前一个元素之后。如果是垂直排列，那么将是一个N行单列的结构，每一行只会有一个元素，而不论这个元素的宽度为多少；如果是水平排列，那么将是一个单行N列的结构。如果搭建两行两列的结构，通常的方式是先垂直排列两个元素，每一个元素里再包含一个LinearLayout进行水平排列。

RelativeLayout

RelativeLayout相对布局允许子元素指定它们相对于其父元素或兄弟元素的位置，这是实际布局中最常用的布局方式之一。

AbsoluteLayout

AbsoluteLayout是绝对位置布局。在此布局中的子元素的android:layout_x和android:layout_y属性将生效，用于描述该子元素的坐标位置。屏幕左上角为坐标原点（0,0），第一个0代表横坐标，向右移动此值增大，第二个0代表纵坐标，向下移动，此值增大。在此布局中的子元素可以相互重叠。在实际开发中，通常不采用此布局格式，

TableLayout

TableLayout 为表格布局，适用于N行N列的布局格式。一个TableLayout由许多TableRow组成，一个TableRow就代表TableLayout中的一行。

TextView

通常用于显示文字用的。

ImageView

通常用于显示图片用的。

monkey简介

Monkey简介

在Android的官方自动化测试领域有一只非常著名的“猴子”叫Monkey，这只“猴子”一旦启动，就会让被测的Android应用程序像猴子一样活蹦乱跳，到处乱跑。人们常用这只“猴子”来对被测程序进行压力测试，检查和评估被测程序的稳定性。

Moneky 路径

Monkey程序是Android系统自带的，其启动脚本是位于Android系统的/system/bin目录的Monkey文件，其jar包是位于Android系统的/system/framework目录的Monkey.jar文件。用户主要是通过adb命令来启动Monkey的，Monkey在运行时，会根据命令行参数的配置，生成伪随机的事件流，并在Android设备上执行对应的测试事件。同时，Monkey还会对测试系统进行监测，当出现以下三种情况时会进行特殊处理：

如限定了Monkey运行在特定包上，当监测到试图转到其他包的操作，将对其进行阻止。
如应用程序崩溃或接收到任何失控异常，Monkey将记录对应的错误日志，并根据命令行参数判断是停止运行还是继续运行。
如果应用程序发生了程序无响应（application not responding）的错误，Monkey将记录对应的错误日志，并根据命令行参数判断是停止运行还是继续运行。
按照选定的不同级别的反馈信息，在Monkey中还可以看到其执行过程报告和生成的事件。

Monkey启动步骤

连接移动设备
连接成功后输入命令

adb shell

进入到指定目录

cd /system/bin

4.输入 monkey命令看到如下提示则说明启动成功。

强制关闭monkey

adb shell ps 查看全部在运行的进程
查找出com.android.commands.monkey 进程PID
adb shell kill pid 杀掉monkey进程

monkey 命令

monkey命令格式如下：

$ adb shell monkey [options] <event-count>

[options] 是指monkey可传入的参数，是可选项（如果不指定options，Monkey将以无反馈模式启动，并把事件任意发送到安装在目标环境中的全部包）
是指随机发送事件数。如：输入100就是执行100个伪随机事件，为必选项。

monkey事件

触摸事件、手势时间、二指缩放事件、轨迹事件、屏幕旋转事件、基本导航事件、主要导航事件、系统按键事件、启动Activity事件、键盘事件、其他类型事件

操作事件简介

Monkey所执行的随机事件流中包含11大事件，分别是触摸事件、手势事件、二指缩放事件、轨迹事件、屏幕旋转事件、基本导航事件、主要导航事件、系统按键事件、启动Activity事件、键盘事件、其他类型事件。Monkey通过这11大事件来模拟用户的常规操作，对手机App进行稳定性测试。下面让我们来详细了解这11大事件。

1.触摸事件

触摸事件是指在屏幕某处按下并抬起的操作，可通过–pct-touch参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到。该事件由一组Touch（ACTION_DOWN）和Touch（ACTION_UP）事件组成，在手机上看到实际操作类似于点击。

2.手势事件

手势事件是指在屏幕某处的按下、随机移动、抬起的操作，即直线滑动操作。可通过–pct-motion参数来配置其事件百分比。

该事件是由一个ACTION_DOWN事件、一系列ACTION_MOVE事件和一个ACTION_UP事件组成的，在手机上看到的实际操作是一个没有拐弯的直线滑动操作。

3.二指缩放事件

二指缩放事件是指在屏幕上的两处同时按下，并同时移动，最后同时抬起的操作，即智能机上的放大缩小手势操作。可通过–pct-pinchzoom参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到：

该事件起始是一个ACTION_DOWN事件和一个ACTION_POINTER_DOWN事件，即模拟两个手指同时点下；中间是一系列的ACTION_MOVE事件，即两个手指同时在屏幕上直线滑动；结束是由一个ACTION_POINTER_UP事件和一个ACTION_UP事件组成的，即两个手指同时放开。

4.轨迹事件

轨迹事件是由一个或多个随机的移动组成的，有时会伴随着点击。很早之前的Android手机带有轨迹球，这个事件就是模拟的轨迹球的操作。现在的手机几乎都没有轨迹球，但轨迹球事件中包含曲线滑动操作，如果被测程序需要曲线滑动时可以选用此参数。可通过–pct-trackball参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到：

该事件是由一系列的Trackball（ACTION_MOVE）事件组成的，观察手机上的操作，即为一系列的曲线滑动操作。

5.屏幕旋转事件

屏幕旋转事件是一个隐藏事件，在Android官方文档中并没有记录这个事件。它其实是模拟的Android手机的横屏和竖屏切换。可通过–pct-rotation参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 该事件由一个rotation事件组成，其中degree表示的是旋转方向，顺时针旋转，0表示旋转90度的方向，1表示旋转180度的方向，2表示旋转270度的方向，3表示旋转360度的方向。在执行过程中，可以看到手机屏幕在横竖屏之间不断地切换。

6.基本导航事件

基本导航事件是指点击方向输入设备的上、下、左、右按键的操作，现在手机上很少有上、下、左、右按键，这种事件一般用得比较少。可通过–pct-nav参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到：

该事件是由一个Key（ACTION_DOWN）和一个Key（ACTION_UP）组成的，点击的就是上、下、左、右四个方向按键。

7.主要导航事件

主要导航事件是指点击“主要导航”按键的操作，这些按键通常会导致UI界面中的动作，如键盘的中间键、回退按键、菜单按键。可通过–pct-majornav参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 该事件是由一个Key（ACTION_DOWN）和一个Key（ACTION_UP）组成的，点击的按键就是中间键和菜单键。

8.系统按键事件

系统按键事件是指点击系统保留使用的按键的操作，如点击Home键、返回键、音量调节键等。可通过–pct-syskeys参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 该事件是由一个Key（ACTION_DOWN）和一个Key（ACTION_UP）组成的，点击的就是上面说到的几个系统按键。

9.启动Activity事件

启动Activity事件是指在手机上启动一个Activity的操作。在随机的时间间隔中，Monkey将执行一个startActivity（）方法，作为最大限度上覆盖被测包中全部Activity的一种方法。可通过–pct-appswitch参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 该事件是由一个Switch操作组成的，从手机上看，上面的操作实际是打开了com.android.settings这个应用的一个com.android.settings.Settings的Activity界面。

10.键盘事件

键盘事件主要是一些与键盘相关的操作。比如点击输入框、键盘弹起、点击输入框以外区域、键盘收回等。可通过–pct-flip参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 如日志所示，这里主要是键盘的打开和关闭操作。

11.其他类型事件

其他类型事件包括了除前面提到的10种事件外其他所有的事件，如按键、其他不常用的设备上的按钮等。可通过–pct-anyevent参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 该事件是由一个Key（ACTION_DOWN）和一个Key（ACTION_UP）组成的，点击的按键就是其他的一些系统按键，如字母按键、数字按键等。因为现在手机很少带字母按键或数字按键，所以这个事件一般使用得比较少。

monkey参数

参数分类

常规类参数
事件类参数
约束类参数
调试类参数

常规类参数

常规类参数包括帮助参数和日志信息参数。帮助参数用于输出Monkey命令使用指导；日志信息参数将日志分为三个级别，级别越高，日志的信息越详细。

1.帮助类参数

monkey -h

2.日志级别

$ adb shell monkey -v <event-count>

-v：打印出日志信息，每个-v将增加反馈信息的级别。-v越多日志信息越详细，不过目前最多支持3个-v，即：

事件类参数

事件类参数的作用是对随机事件进行调控，从而使其遵照设定运行，如设置各种事件的百分比、设置事件生成所使用的种子值等。频率参数主要限制事件执行的时间间隔。

1.执行指定脚本

$ adb shell monkey -f <scriptfile> <event-count>
 
eg：
$ adb shell monkey -f /mnt/sdcard/test1

2.伪随机数生成种子值

使用 -s命令可以重复执行之前的伪随机操作。本身每次执行伪随机事件操作也会默认生成一个seed值
$ adb shell monkey -s <seed> <event-count>
 
eg:
$ adb shell monkey -s 666 100

3.设置间隔如果你希望在每一个指令之间加上固定的间隔时间，可以用–throttle（注意，前面是–）命令。

$ adb shell monkey --throttle <milliseconds>
eg:
$ adb shell monkey --throttle 3000  5

–throttle：后面接时间，单位为ms（），表示事件之间的固定延迟（即执行每一个指令间隔的时间），若不接该选项，monkey将不会延迟。

4.调整触摸事件百分比

如果你希望调整触摸事件的百分比，记住使用–pct-touch。

$ adb shell monkey --pct-touch
eg:
$ adb shell monkey -v -v --pct-touch 100 200

–pct-touch：后面接触摸事件百分比

注意：触摸事件不单单是按键，它泛指发生在某一位置的一个down-up事件。

5.调整手势事件百分比

$ adb shell monkey --pct-motion
eg:
$ adb shell monkey -v -v --pct-motion 100 200

6.调整应用启动事件的百分比

如果你希望调整应用启动事件的百分比，记住使用–pct-app-switch。

$ adb shell monkey --pct-appswtich <percent>

–pct-appswitch：后面接应用启动事件百分比。

应用启动事件（即activity launches）俗称打开应用，通过调用startActivity()方法最大限度地开启该package下的所有应用。

7.调整屏幕旋转事件百分比

$ adb shell monkey --pct-rotation <percent>

–pct-rotation 后面接屏幕旋转事件的比例值。

8.其他参数

约束类参数

**1.**包约束

-p：后面接一个或多个包名（），如果应用需要访问其他包里的Activity，那相关的包也需要在此同时指定。如果不指定任何包，monkey将允许系统启动全部包里的Activity。

$ adb shell monkey -p <allowed-package-name> <event-count>
eg：
$ adb shell monkey -p com.tal.kaoyan 500
 
$ adb shell monkey -p com.tal.kaoyan -p com.tencent.mm 500

2.activity****类约束

如果你希望将monkey限制在一个或几个类别中，使用如下命令：

adb shell monkey -c <main-category> <event-count>

以下命令表示运行Intent.CATEGORY_LAUNCHER类别的Activity并发送1000个随机事件。

$ adb shell monkey -c Intent.CATEGORY_LAUNCHER  1000

调试类参数

**1.**应用程序崩溃后继续发送事件

如果你希望monkey在应用程序崩溃后继续发送事件，则需要用到–ignore-crashes命令

$ adb shell monkey --ignore-crashes <event-count>

在设置此选项后，当应用程序崩溃或发生失控异常时，monkey将继续运行直到计数完成。如果不设置此选项，monkey遇到上述崩溃或异常将停止运行。

**2.**超时错误继续发送事件

如果你希望monkey在任何超时错误发生后继续发送事件，则需要用到–ignore-timeouts命令。

$ adb shell monkey --ignore-timeouts

–ignore-timeouts：在设置此选项后，当应用程序发生任何超时错误（如ANR，即Application Not Responding）时，monkey将继续运行直到计数完成。如果不设置此选项，monkey遇到此类超时对话框将停止运行。

**3.**应用程序权限错误发生后继续发送事件

如果你希望monkey在应用程序权限错误发生后继续发送事件，则需要用到–ignore-security-exceptions命令。

$ adb shell monkey --ignore-security-exceptions

–ignore-security-exceptions：在设置此选项后，当应用程序发生任何权限错误（如启动一个需要某些权限的Activity）时，monkey将继续运行直到计数完成。如果不设置此选项，monkey遇到此类权限错误将停止运行。

4.其他

Monkey参数应用综合案例

测试场景

测试考研帮app Android版。测试希望通过Monkey来模拟用户的随机操作，检查被测应用是否会出现异常（应用崩溃或者无响应）。

需求分析

1、测试是指定应用，因此需要使用-p指定被测app包名：com.tal.kaoyan

2、这个测试的目的是希望模拟用户操作，因此需要让Monkey执行的事件尽可能地接近用户的常规操作，这样才可以最大限度地发现用户使用过程中可能出现的问题。因此需要对Monkey执行的事件百分比做一些调整:

触摸事件和手势事件是用户最常见的操作，所以通过–pct-touch和–pct-motion将这两个事件的占比调整到40%与25%；目标应用包含了多个Activity，为了能覆盖大部分的Activity，所以通过–pct-appswitch将Activity切换的事件占比调整到10%；被测应用在测试中出现过不少横竖屏之间切换的问题，这个场景也必须关注，因此通过–pct-rotation把横竖屏切换事件调整到10%。

3、使用-s参数来指定命令执行的seed值 Monkey会根据seed值来生成对应事件流，同一个seed生成的事件流是完全相同的。这里指定了seed值，是为了测试发现问题时，便于进行问题复现。

4、使用–throttle参数来控制Monkey每个操作之间的时间间隔指定操作之间的时间间隔，一方面是希望能更接近用户的操作场景，正常用户操作都会有一定的时间间隔；另一方面也是不希望因为过于频繁的操作而导致系统崩溃，尤其是在比较低端的手机上执行测试时。因此通过–throttle设置Monkey每个操作固定延迟0.4秒。

5、使用–ignore-crashs和–ignore-timeouts参数使Monkey遇到意外时能继续执行在执行Monkey测试时，会因为应用的崩溃或没有响应而意外终止，所以需要在命令中增加限制参数–ignore-crash和–ignore-timeouts，让Monkey在遇到崩溃或没有响应的时候，能在日志中记录相关信息，并继续执行后续的测试。

6、使用-v指定log的详细级别 Monkey的日志输出有3个级别：日志的级别越高，其详细程度也越高。为了方便问题的定位，这里将日志设为 -v -v.

测试命令

adb shell monkey -p com.tal.kaoyan
--pct-touch 40 --pct-motion 25 
--pct-appswitch 10
--pct-rotation 5
-s 1666 --throttle 400
--ignore-crashes
--ignore-timeouts
-v -v  200

Monkey脚本API简介

LaunchActivity(pkg_name, cl_name)：启动应用的Activity。参数：包名和启动的Activity。

Tap(x, y, tapDuration)：模拟一次手指单击事件。参数：x,y为控件坐标，tapDuration为点击的持续时间，此参数可省略。

UserWait(sleepTime)：休眠一段时间

DispatchPress(keyName)：按键。参数： keycode。 RotateScreen(rotationDegree, persist)：旋转屏幕。参数：rotationDegree为旋转角度， e.g. 1代表90度；persist表示旋转之后是否固定，0表示旋转后恢复，非0则表示固定不变。

DispatchString(input)：输入字符串。

DispatchFlip(true/false)：打开或者关闭软键盘。

PressAndHold(x, y, pressDuration)：模拟长按事件。

Drag(xStart, yStart, xEnd, yEnd, stepCount)：用于模拟一个拖拽操作。

PinchZoom(x1Start, y1Start, x1End, y1End, x2Start, y2Start, x2End, y2End, stepCount)：模拟缩放手势。

LongPress()：长按2秒。

DeviceWakeUp()：唤醒屏幕。

PowerLog(power_log_type, test_case_status)：模拟电池电量信息。

WriteLog()：将电池信息写入sd卡。

RunCmd(cmd)：运行shell命令。

DispatchPointer(downtime,eventTime,action,x,yxpressure,size,metastate,xPrecision,yPrecision,device,edgeFlags)：向指定位置，发送单个手势。

DispatchPointer(downtime,eventTime,action,x,yxpressure,size,metastate,xPrecision,yPrecision,device,edgeFilags)：发送按键消息。

LaunchInstrumentation(test_name,runner_name)：运行一个instrumentation测试用例。

DispatchTrackball：模拟发送轨迹球事件。

ProfileWait：等待5秒。

StartCaptureFramerate()：获取帧率。

EndCaptureFramerate(input)：结束获取帧率。

Monkey脚本格式

脚本主要包含两部分，一部分是头文件信息，一部分是具体的monkey命令

type = raw events  
count = 1  
speed = 1.0  
//下面为monkey命令  
start data >>   
具体的monkey脚本内容

编写脚本

kyb.txt

#头文件信息
 
type = raw events 
 
count = 1
 
speed = 1.0
 
#启动测试
start data >>
 
LaunchActivity(com.tal.kaoyan,com.tal.kaoyan.ui.activity.SplashActivity)
UserWait(2000)
 
Tap(624,900,1000) #点击取消升级
UserWait(2000)
 
Tap(806,64,1000) #点击跳过
UserWait(2000)
 
Tap(217,378,1000) #点击用户名输入框
DispatchString(zxw1234)
UserWait(2000)
 
Tap(197,461,1000) #点击密码输入框
DispatchString(zxw123456)
UserWait(2000)
 
Tap(343,637,1000) #点击登录按钮

执行脚本

脚本编写完成后，传到手机设备上，然后执行。

adb push C:\Users\Shuqing\Desktop\kyb1.txt /sdcard
 
adb shell monkey -f /sdcard/kyb1.txt -v 1

执行结果

C:\Users\Shuqing>adb shell monkey -f /sdcard/kyb.txt -v 1
:Monkey: seed=1524592021303 count=1
:IncludeCategory: android.intent.category.LAUNCHER
:IncludeCategory: android.intent.category.MONKEY
Replaying 0 events with speed 1.0
:Switch: #Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10200000;component=com.tal.kaoyan/.ui.activity.SplashActivity;end
    // Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.tal.kaoyan/.ui.activity.SplashActivity } in package com.tal.kaoyan
:Sending Touch (ACTION_DOWN): 0:(267.0,1233.0)
    // Allowing start of Intent { act=com.android.systemui.recent.action.TOGGLE_RECENTS cmp=com.android.systemui/.recent.RecentsActivity } in package com.android.systemui
:Sending Touch (ACTION_UP): 0:(267.0,1233.0)
Events injected: 5
:Sending rotation degree=0, persist=false
:Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0
## Network stats: elapsed time=7201ms (0ms mobile, 0ms wifi, 7201ms not connected)
// Monkey finished

注意事项

头文件代码书写注意“=”两边预留空格，否则会出现如下报错。

java.lang.NumberFormatException: Invalid int: ""

monkey日志管理

日志管理作用

Monkey日志管理是Monkey测试中非常重要的一个环节，通过日志管理分析，可以获取当前测试对象在测试过程中是否会发生异常，以及发生的概率，同时还可以获取对应的错误信息，帮助开发定位和解决问题。

monkey日志保存方法

保存在PC中
保存在手机上
标准流和错误流分开保存

保存在PC中

>adb shell monkey [option] <count> >d:\monkey.txt
 
eg：
C:\Users\Shuqing>adb shell monkey -v -v 100 >d:\monkeylog.txt

保存在手机上

C:\Users\Shuqing>adb shell
monkey -v 100 >/sdcard/monkeylog.log

注意：不能写成C:\Users\Shuqing>adb shell monkey -f /sdcard/kyb.txt -v 1 > /mnt/sdcard/monkey.log 否则会报错“系统找不到指定的路径”。

标准流和错误流分开保存

标准流与错误流分开保存，代码如下：

Monkey [option] <count> 1>/sdcard/monkey.txt 2>/sdcard/error.txt
 
C:\Users\Shuqing>adb shell monkey -v 100 1>d:\monkey.log  2>d:\error.log

执行以上命令，Monkey的运行日志和异常日志将被分开保存。此时Monkey的运行日志将被保存在monkey.txt文件中，而异常日志将被保存在D盘下的error.txt中。

日志内容分析

运行命令：

adb shell monkey -v 100

monkeyrunner

monkeyrunner简介

MonkeyRunner工具是使用Jython(使用Java编程语言实现的Python)写出来的，它提供了多个API，通过monkeyrunner API 可以写一个Python的程序来模拟操作控制Android设备app,测试其稳定性并通过截屏可以方便地记录出现的问题。

monkeyrunner 路径：Andriod_SDK\tools

MonkeyRunner功能

多设备控制：API可以跨多个设备，一次启动全部模拟器来实施测试套件;
功能测试：为应用自动执行一次功能测试，然后观察输出结果的截屏。
可扩展自动化：因为monkeyrunner是一个API工具包，你可以开发基于Python模块的整个系统来控制Android设备;

Monkeyrunner与Monkey区别

monkeyrunner和money没有什么直接的关系，monkey是在设备直接运行adb shell命令生成随机事件来进行测试的。相比较而言，monkeyrunner则是通过API发送特定的命令和事件来控制设备。

monkeyrunner环境搭建

安装并配置好jdk环境
安装android sdk
安装python 安装配置教程
monkeyrunner环境变量配置： {Path}\Andriod_SDK\tools

安装结果检测

在控制台输入命令：monkeyrunner出现如下显示内容则说明安装成功

C:\Users\Shuqing>monkeyrunner
Jython 2.5.3 (2.5:c56500f08d34+, Aug 13 2012, 14:54:35)
[Java HotSpot(TM) 64-Bit Server VM (Oracle Corporation)] on java1.8.0_05
>>>

Tips：退出monkeyrunner命令行模式可以使用快捷键 ctrl+D退出。

MonkeyRunner API

MonkeyRunner工具主要有三个类：

MonkeyRunner
MonkeyDevice
MonkeyImage

1.MonkeyRunner类：

MonkeyRunner提供连接真机和模拟器、输入、暂停、警告框等方法。

常用方法

waitForConnection(float timeout,string deviceid)，
from com.android.monkeyrunner import MonkeyRunner as mr
print("connect devices...")
 
device=mr.waitForConnection()
# device=mr.waitForConnection(5,'127.0.0.1:62001')

2.MonkeyDevice类

MonkeyDevice类提供了安装和卸载程序包、开启Activity、发送按键和点击事件、运行测试包等方法。

常用方法

installPackage (string path) 安装包
removePackage (string package) 卸载包
startActivity (string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, flags) 启动
touch (integer x, integer y, integer type) 点击

touch****参数说明

integer x，x坐标值。

integer y，y坐标值。

integer type，key event类型（如DOWN、UP、DOWN_AND_UP）。

DOWN为按下事件 UP为弹起事件 DOWN_AND_UP为按下弹起事件。

drag (tuple start, tuple end, float duration, integer steps)

drag****参数详细说明如下：

tuple start，拖拽起始位置，为tuple类型的(x,y)坐标点。

tuple end，拖拽终点位置，为tuple类型的(x,y)坐标点。

float duration，拖拽手势持续时间，默认为1.0s。

-integer steps，插值点的步数，默认值为10。

代码实现

kyb_start.py

from com.android.monkeyrunner import MonkeyRunner as mr
from com.android.monkeyrunner import MonkeyDevice as md 
print("connect devices...")
device=mr.waitForConnection()
print("install app...")
device.installPackage(r'C:\Users\Shuqing\Desktop\kaoyan3.1.0.apk')
package = 'com.tal.kaoyan'
activity = 'com.tal.kaoyan.ui.activity.SplashActivity'
runComponent = package + '/' + activity 
print("launch App...")
device.startActivity(component=runComponent)

代码执行方式

monkeyrunner scripfile
 
C:\Users\Shuqing>monkeyrunner E:\monkeyrunner_script\kyb.py

3.MonkeyImage类

MonkeyImage类在测试过程中用来保存各种格式的测试截图，并可以进行图像对比。

常用方法

takeSnapshot() 进行屏幕截图
writeToFile() 保存图像文件到指定的文件路径

用法示例

from com.android.monkeyrunner import MonkeyImage as mi  
print("takeSnapshot")
screenshot=device.takeSnapshot()  
screenshot.writeToFile(r'E:\monkeyrunner_script\test.png','png')

综合实践

测试场景

连接设备，自动安装并启动考研帮app
启动后登录账号（账号zxw1234 密码：zxw123456），然后截图并保存到指定文件位置。

思路分析

连接设备
安装app
启动app
输入用户名密码点击登录按钮
截图

脚本实现

kyb_login.py

from com.android.monkeyrunner import MonkeyRunner as mr
from com.android.monkeyrunner import MonkeyDevice as md
from com.android.monkeyrunner import MonkeyImage as mi
 
print("connect devices...")
 
device=mr.waitForConnection()
 
print(" install app")
device.installPackage(r'C:\Users\Shuqing\Desktop\kaoyan3.1.0.apk')
 
print("launch app...")
package='com.tal.kaoyan'
activity='com.tal.kaoyan.ui.activity.SplashActivity'
runComponent=package+'/'+activity
 
device.startActivity(component=runComponent)
mr.sleep(3)
 
print("touch cancel button")
device.touch(618,895,'DOWN_AND_UP')
mr.sleep(1)
 
print("touch skip button")
device.touch(804,67,'DOWN_AND_UP')
mr.sleep(1)
 
print("input username and password")
device.touch(57,373,'DOWN_AND_UP')
mr.sleep(2)
device.type('zxw1234')
 
device.touch(152,480,'DOWN_AND_UP')
mr.sleep(2)
device.type('zxw123456')
mr.sleep(2)
 
print("touch login button")
device.touch(331,634,'DOWN_AND_UP')
 
print("takeSnapshot")
screenshot=device.takeSnapshot()
screenshot.writeToFile(r'D:\monkeyrunner\kyb.png','png')

注意事项

方法调用错误

AttributeError: type object 'com.android.monkeyrunner.XXXXX' has no attribute XXXXXX

检查调用的方法名是否写错，特别是注意区分大小写。

字符编码错误

SyntaxError: Non-ASCII character in file 'E:\monkeyrunner_script\kyb.py', but no encoding declared;

需要在代码顶部补充 # -- coding: utf-8 -- 或者去掉代码中的中文字符

Appium

Appium简介

Appium是一个开源测试自动化框架，可用于原生，混合和移动Web应用程序测试。它使用WebDriver协议驱动iOS，Android和Windows应用程序。

Appium官网
Appium github主页
官方中文文档
Appium官方论坛
Testerhome中文社区

Appium优势

可以跨平台同时支持android、ios
支持多种语言，java、python、php、Ruby等等
不用为复杂的环境发愁
如果你有selenium经验，直接上手。

Appium架构原理

Android（版本>4.3）：UIAutomator，Android 4.3之后系统自带的UI自动化测试工具。
Android（版本≤4.3）：Selendroid，基于Android Instrumentation框架实现的自动化测试工具。
iOS：UIAutomation（instruments框架里面的一个模板），iOS系统自带的UI自动化测试工具。

运行原理

我们的电脑（client）上运行自动化测试脚本，调用的是webdriver的接口，appium server接收到我们client上发送过来的命令后他会将这些命令转换为UIautomator认识的命令，然后由UIautomator来在设备上执行自动化。

Appium的架构原理如上图所示，由客户端（Appium Client）和服务器（Appium Server）两部分组成，客户端与服务器端通过JSON Wire Protocol进行通信。

Appium服务器

Appium服务器是Appium框架的核心。它是一个基于Node.js实现的HTTP服务器。Appium服务器的主要功能是接受从Appium客户端发起的连接，监听从客户端发送来的命令，将命令发送给bootstrap.jar（iOS手机为bootstrap.js）执行，并将命令的执行结果通过HTTP应答反馈给Appium客户端。

Bootstrap.jar。

Bootstrap.jar是在Android手机上运行的一个应用程序，它在手机上扮演TCP服务器的角色。当Appium服务器需要运行命令时，Appium服务器会与Bootstrap.jar建立TCP通信，并把命令发送给Bootstrap.jar；Bootstrap.jar负责运行测试命令。

Appium客户端。

它主要是指实现了Appium功能的WebDriver协议的客户端Library，它负责与Appium服务器建立连接，并将测试脚本的指令发送到Appium服务器。现有的客户端Library有多种语言的实现，包括Ruby、Python、Java、JavaScript（Node.js）、Object C、PHP和C#。Appium的测试是在这些Library的基础上进行开发的。

Appium组件

Appium Server

Appium Server就是Appium的服务端——一个web接口服务，使用Node.js实现。引用官网解释说明。

Appium Desktop

Appium Desktop是一款适用于Mac，Windows和Linux的开源应用程序，它以美观而灵活的用户界面为您提供Appium自动化服务器的强大功能。它是几个Appium相关工具的组合：

Appium Server的图形界面。您可以设置选项，启动/停止服务器，查看日志等…您也不需要使用Node 的NPM来安装Appium，因为Node运行时与Appium Desktop捆绑在一起。
您可以使用Inspector查看应用程序的元素，获取有关它们的基本信息，并与它们进行基本的交互。

Appium GUI

Appium GUI是Appium desktop的前身。这个也是把Appium server封装成了一个图形界面，降低使用门槛，如同最初的操作系统Dos都是敲命令，后面都是图形界面操作系统，如Windows系统。很多初学者对下面这个界面应该不陌生吧，这个就是Windows版本的Appium GUI界面。测试人员可以手动启动，配置相关server 服务，如果不用这个启动的话，需要命令启动服务。因为大部分教程都是基于这个GUI来讲解的，所以很多人一说Appium就认为是这个。

Appium Clients

因为Appium是一个C/S结构，有了服务端的肯定还有客户端，Appium Clients就是客户端，它会给服务端Appium Server发送请求会话来执行自动化任务。就像我们浏览器访问网页，浏览器是客户端，通过操作发送请求服务器来获取数据。我们可以使用不同的客户端浏览器（IE，Firefox,Chrome）访问一个网站。 Appium客户端可以使用不同的语言来实现，如Python，java等。具体详见下表：

Language/Framework	Github Repo and Installation Instructions
Ruby	https://github.com/appium/ruby_lib
Python	https://github.com/appium/python-client
Java	https://github.com/appium/java-client
JavaScript (Node.js)	https://github.com/admc/wd
Objective C	https://github.com/appium/selenium-objective-c
PHP	https://github.com/appium/php-client
C# (.NET)	https://github.com/appium/appium-dotnet-driver
RobotFramework	https://github.com/jollychang/robotframework-appiumlibrary

Appium-desktop

Appium-desktop主界面包含三个菜单Simple,Advanced、Presets

Capability

什么是Capability

desired capability的功能是配置Appium会话。他们告诉Appium服务器您想要自动化的平台和应用程序。

Desired Capabilities是一组设置的键值对的集合，其中键对应设置的名称，而值对应设置的值。（如：“platformName”: “Android”）Desired Capabilities主要用于通知Appium服务器建立需要的Session。

Session

Appium的客户端和服务端之间进行通信都必须在一个Session的上下文中进行。客户端在发起通信的时候首先会发送一个叫作“Desired Capabilities”的JSON对象给服务器。服务器收到该数据后，会创建一个session并将session的ID返回到客户端。之后客户端可以用该session的ID发送后续的命令。

常用Capability配置讲解

Capability官方完整文档

如果有了解过Capability的人会发现一个问题，其实他主要分成了三部分：公共部分、ios部分、android部分，如果你android想用ios的那是不可能的，so，老老实实去了解每个平台有哪些，他们的作用是什么。下面我们介绍一些公用常用的,红色标记的为常用的选项。

公用Capability

Android独有Capability

ios独有Capability

Capability启动App演示

New Session Window 会话建立

Automatic Server 本地AppiumServer服务
Custom Server：例如，如果要针对运行在网络中另一台计算机上的Appium服务器启动Inspector会话，这很有用。
Sauce Labs：如果您无法访问机器上的iOS模拟器，则可以利用Sauce Labs帐户在云中启动Appium会话。
TestObject：您还可以利用TestObject的真实设备云来进行真机测试。
headspin:使用远程设备来创建会话。

desired capability参数Josin

{
  "platformName": "Android",
  "platformVersion": "5.1.1",
  "deviceName": "127.0.0.1:62025",
  "appPackage": "com.tal.kaoyan",
  "appActivity": "com.tal.kaoyan.ui.activity.SplashActivity",
  "noReset": true
}

新的会话窗口允许您构造一组desired capabilities，用于启动Appium会话。您可以针对当前运行的Appium Desktop服务器(默认的)启动一个会话，或者您可以针对各种其他端点启动一个会话。

因为不需要使用Appium Desktop自己的服务器，您可以在不启动Appium Desktop服务器的情况下进入新的会话窗口。只需点击“File”(Windows / Linux)或“Appium”(Mac)，然后选择“New Session…”，它将打开新的会话窗口，而不必启动本地服务器。在这种情况下，将禁用附加到本地服务器。

Inspector元素获取

启动成功之后就可以使用 Inspector来进行元素空间获取了。注意：默认的元素定位有一些不准，需要切换到第二个坐标点定位选项后再切换回来才能准确定位。在这里插入图片描述

appium元素定位

元素定位

与Web自动化测试一样，app自动化测试过程中最重要一个环节就是元素定位，只有准确定位到了元素才能进行相关元素的操作，如输入、点击、拖拽、滑动等。appium提供了许多元素定位的方法，如id定位、name定位、class定位、层级定位等等… 接下来将会给大家来实践运用这些定位技巧。

元素定位方式

id
name
class name
List定位
相对定位
Xpath定位
H5页面元素定位
Uiautomator定位

UIAutomator

UIAutomator定位简介

UIAutomator元素定位是 Android 系统原生支持的定位方式，虽然与 xpath 类似，但比它更加好用，且支持元素全部属性定位.定位原理是通过android 自带的android uiautomator的类库去查找元素。 Appium元素定位方法其实也是基于Uiautomator来进行封装的。

使用方法 find_element_by_android_uiautomator() 可以运用UiAutomator元素定位。

定位方法

id定位
text定位
class name定位

id定位

id定位是根据元素的resource-id属性来进行定位，使用 UiSelector().resourceId()方法即可。

text定位

text定位就是根据元素的text属性值来进行定位，new UiSelector()

class name定位

与Appium class定位方式一样，也是根据元素的class属性来进行定位。

元素等待

思考

在自动化过程中，元素出现受网络环境，设备性能等多种因素影响。因此元素加载的时间可能不一致，从而会导致元素无法定位超时报错，但是实际上元素是正常加载了的，只是出现时间晚一点而已。那么如何解决这个问题呢？

元素等待作用

设置元素等待可以更加灵活的制定等待定位元素的时间，从而增强脚本的健壮性，提高执行效率。

元素等待类型

强制等待

设置固定的等待时间，使用sleep()方法即可实现

from time import sleep
#强制等待5秒
sleep(5)

隐式等待

隐式等待是针对全部元素设置的等待时间

driver.implicitly_wait(20)

显式等待

显式等待是针对某个元素来设置的等待时间。

方法WebDriverWait格式参数如下：

from selenium.webdriver.support.ui import WebDriverWait
 
WebDriverWait(driver, timeout, poll_frequency=0.5, ignored_exceptions=None)
driver : WebDriver
timeout : 最长超时时间，默认以秒为单位
poll_frequency : 休眠时间的间隔时间，默认为0.5秒
ignored_exceptions : 超时后的异常信息，默认情况下抛NoSuchElementException异常。

WebDriverWait()一般和until()或until_not()方法配合使用，另外，lambda提供了一个运行时动态创建函数的方法。

from selenium.webdriver.support.ui import WebDriverWait
WebDriverWait(driver,10).until(lambda x:x.find_element_by_id("elementID"))

Toast

Toast简介

Android中的Toast是一种简易的消息提示框。当视图显示给用户，在应用程序中显示为浮动。和Dialog不一样的是，它永远不会获得焦点，无法被点击。

Toast

类的思想就是尽可能不引人注意，同时还向用户显示信息，希望他们看到。而且Toast显示的时间有限，一般3秒左右就消失了。因此使用传统的元素定位工具，我们是无法定位到Toast元素的（传说中低调奢华有内涵）。

Appium Toast内容获取

Appium 1.6.3开始支持识别Toast内容，主要是基于UiAutomator2，因此需要在Capablity配置如下参数：

desired_caps['automationName']='uiautomator2'

安装appium-uiautomator2-driver: 安装命令如下：

cnpm install appium-uiautomator2-driver

注意：Toast内容为中文时，顶部必须注释#

coding=utf-8 否则会因为编解码导致文字识别失败。

屏幕截图

应用背景

在实际自动化项目运行过程中，很多时候App可以会出现各种异常，为了更好的定位问题，除了捕捉日志我们还需要对运行时的设备状态来进行截屏。从而达到一种“有图有真相”的效果。

截图方法

方法1

save_screenshot() 该方法直接保存当前屏幕截图到当前脚本所在文件位置。
driver.save_screenshot('login.png')

方法2

get_screenshot_as_file(self, filename)

将截图保留到指定

作为一位过来人也是希望大家少走一些弯路，希望能对你带来帮助。（WEB自动化测试、app自动化测试、接口自动化测试、持续集成、自动化测试开发、大厂面试真题、简历模板等等），相信能使你更好的进步！

留【自动化测试】即可【自动化测试交流】：574737577（备注ccc）http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=8hUKwUHn9HhVpR8qWhqfT2u-kU-3hpsF&authKey=47BBG1nwHVOka38EQeJevQFCP%2BeVEf%2Bpd8QqotS1%2FqyJdrGAo1A6%2BfS9ef3wJij2&noverify=0&group_code=574737577