利器 | AppCrawler 自动遍历测试实践(三)：动手实操与常见问题汇总

Shell 是什么呢？很多人以为的Shell就是命令行，一条条可以百度出来的命令行。而简历上你只会写熟悉Linux？今天用摩拜App给大家讲解下如何使用 Shell 去操作 Android 设备进行自动化测试。

上两篇文章介绍了自动遍历的测试需求、工具选择和 AppCrawler 的环境安装、启动及配置文件字段基本含义，这里将以实际案例更加细致的说明配置文件的用法和一些特殊场景的处理。

下面我们继续之前的例子，在雪球搜索框输入搜索内容后的页面开始：

• testcase：设置测试用例，输入 alibaba 后，点选"阿里巴巴"

yaml 写法如下：

testcase:
  name: "XueQiuTestDemo AppCrawler"
    steps:
      - { xpath: "//*[contains(@resource-id,'image_cancel')]", action: click }
      -   - xpath: home_search
      -     action: click
      -   - xpath: search_input_text
      -     action: alibaba
      -   - { xpath: 阿里巴巴, action: click }

• selectedList：遍历范围设定
• • 接上一步点选"阿里巴巴"后到达如下界面:

我们先看demo配置文件中的原始写法,如下：

selectedList:
- given: []
-   when: null
-   then: []
-   xpath: "//*[contains(name(), 'Button')]"
-   action: null
-   actions: []
-   times: 0
- - given: []
-   when: null
-   then: []
-   xpath: "//*[contains(name(), 'Text') and @clickable='true' and string-length(@text)<10]"
-   action: null
-   actions: []
-   times: 0
- - given: []
-   when: null
-   then: []
-   xpath: "//*[@clickable='true']/*[contains(name(), 'Text') and string-length(@text)<10]"
-   action: null
-   actions: []
-   times: 0
- - given: []
-   when: null
-   then: []
-   xpath: "//*[contains(name(), 'Image') and @clickable='true']"
-   action: null
-   actions: []
-   times: 0
- - given: []
-   when: null
-   then: []
-   xpath: "//*[@clickable='true']/*[contains(name(), 'Image')]"
-   action: null
-   actions: []
-   times: 0
- - given: []
-   when: null
-   then: []
-   xpath: "//*[contains(name(), 'Image') and @name!='']"
-   action: null
-   actions: []
-   times: 0
- - given: []
-   when: null
-   then: []
-   xpath: "//*[contains(name(), 'Text') and @name!='' and string-length(@label)<10]"
-   action: null
-   actions: []
-   times: 0

原始文件中将所有可点击的控件类型都包括了进去，再加上了部分 text 长度的限制 现在我们按照自己平常的简便写法重新编写,先设置所有 clickable 等于 true 的控件进行点击：

selectedList:
 - { xpath: "//*[@clickable='true']", action: click }

• blackList：黑名单，将不想要被点击的元素加入黑名单中
• • 配置文件原始写法如下，表示将带有2位数字的排除在外，可能是App中包含了很对关于股价展示的，不需要挨个点击：

blackList:
- given: []
-   when: null
-   then: []
-   xpath: ".*[0-9]{2}.*"
-   action: null
-   actions: []
-   times: 0

我们现在希望不要点击到叉号❌和取消按钮，否则会跳出此页面，那么就可以把其加入黑名单中，如下：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-v2B6RDHr-1650513797266)(https://ceshiren.com/uploads/default/original/3X/3/6/36b925e1fd9a0ab3f6a7d4ce1156f42753c90322.png)]

blackList:
 - xpath: ".*[0-9]{2}.*"
 -  - xpath: //*[@resource-id='action_delete_text']
 -  - xpath: //*[@resource-id='action_close']

• firstList: 优先被遍历
• • 这里我们设置让text包含"股票"的优先遍历
• firstList:
• • { xpath: “//*[contains(@text,‘股票’)]”, action: click }

- lastList：最后被点击
- - 在页面中有很多标签页(例如综合、股票、用户、组合)： 
- - 
- [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-3bJrhVWx-1650513807046)(https://ceshiren.com/uploads/default/original/3X/7/3/73095afef2706e7b9feea15db4813d076e2e5428.png)]
每个标签页下面对应着很多控件需要被操作，可是在当前页面下的控件未被遍历完的时候就有可能会点击到其他标签页中了，我们希望的是在一个标签页下完全遍历结束后最后再点击标签控件，这个就可以借助lastList来完成，让元素在点进标签页后的内容为最后遍历

lastList:

• { xpath: “//[contains(@resource-id,‘ti_tab_indicator’)]//”, action: click }

- backButton: 当所有元素都被点击后默认后退控件定位
- - AppCrawler是不知道后退按钮是哪一个的，这个可能会造成的一种情况是，当我们进入一个页面时，还没有对这个页面完全遍历就点到了后退按钮，这样就会造成测试不充分 

因此我们可以给它设置一个默认的后退按钮，使所有事件完成后再 back

backButton:

• { xpath: “//*[contains(@resource-id,‘action_back’)]”, action: click }

- maxDepth: 遍历的最大深度
- - 有时候我们的页面层次可能很深，每次遍历测试的需求可能不同，有时候可能需要在短时间内测试主要常用界面的功能，有时候可能需要全面的测试，所以测试的深度就不相同，我们可以依靠 maxDepth 来进行需求定制，这里以遍历 2 层深度为例：
- ```
- maxDepth: 2

• findBy：定位方式的选择
• • findBy 可以设置定位方式，有 default、android、id、xpth 方式可选，默认状态会自动判断是否是要 Android 定位或者 iOS 定位。当我们的定位很精准的时候，用默认的 default 速度会快一点；若是定位符写的不是很精准，在切换到 Android 定位的时候可能找不到，这个时候就可以尝试将其设置为 Xpath方式定位。
• findBy: “xpath”

- defineUrl = List[String]()：用来确定url的元素定位 xpath，他的 text 会被取出当做 url 因素；就是说如果想要当前的页面布局与某个控件之间有层级关系，给定一个标记控件，以此来区分不同的界面(语言的描述怎么样都有点晦涩，还是结合下面的示例来理解吧。。。）
- - 
- 有时候我们会遇见这种情况：设置了 clickable 未 true 的控件都被遍历，可是运行时发现很多控件都没有被遍历到，一般这种情况有一下两种原因：
- - 元素属性 clickable 本身就为 false 或者它的父节点等都为 false，这样自然是无法遍历到的。
- - 还有一种情况是同属性的控件在两个tag页面都存在，在其中一个tag页遍历一遍之后，再到下一个tag页中就会默认已经遍历，不会再进行遍历，如下这种：
在“股票”和“用户”tag页中，“加自选”和“关注”控件的clickable及id属性一样。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-mfQUUjRZ-1650513859993)(https://ceshiren.com/uploads/default/original/3X/5/3/53e5fa20e9afcca1daa988a9c87531a6b519d984.jpeg)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-JSLKNEce-1650513863541)(https://ceshiren.com/uploads/default/original/3X/5/7/575847e6a54aac91d18d4de8e4676658d4fa82c7.jpeg)]

他们所属的页面属性也一样，所以会被看做是同一个页面下的同一个控件：
 
 [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-I8ozV276-1650513870175)(https://ceshiren.com/uploads/default/original/3X/5/d/5d17a4bb025ca66de5c92486b0f980e38bb5be61.png)]
 [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-FFYPgIBz-1650513876906)(https://ceshiren.com/uploads/default/original/3X/4/d/4dab861e1585a5f75294487bab48a7ada01610ab.jpeg)]
 如上这种情况肯定不是我们想要的，我们想要它在股票和用户页都分别进行遍历，更好的覆盖测试，那么就要借助于 defineUrl 了；
1）按照上面的介绍，我们首先要找一个标志控件，用来做页面的区分，那么我们首先想到的就是从“股票”和“用户”这两个 tag 标签属性上来找，遗憾的是最终发现这两个控件的属性全都一毛一样：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-5ESZj20l-1650513886504)(https://ceshiren.com/uploads/default/original/3X/c/d/cd2ae3528af1c147be058764808910b3bd3eeb1d.png)]

2）接着我们就必须从 tag 页内部来找标志控件了，我们发现在“股票”和“用户”页中搜索出来的结果名称的 id 是不同的：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-cbh5xTwn-1650513892895)(https://ceshiren.com/uploads/default/original/3X/4/1/41facaf39b00b9d6e8d5d698c73740a28a0ce438.png)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-O2Qoa6IK-1650513898719)(https://ceshiren.com/uploads/default/original/3X/4/5/45e9a0eaa7281f76b53bb4f65b7739b686193e26.jpeg)]

3）上面介绍过了 defineUrl 是取的 text 属性值作为标志区分，所以这里取股票页的第一个元素“阿里巴巴”和用户页的第二个元素“阿里巴巴四十大盗”，
具体 yaml 写法如下：

defineUrl:

• (//*[contains(@resource-id, “stockName”)])[1]
• • (//*[contains(@resource-id, “user_name”)])[2]

缺点：上面的做法虽然解决了页面区分的问题，但是有一个缺点就是我们定义了遍历的深度，然而使用 defineUrl 之后将每个标志符在的页面都视为一个新的 activity，因此遍历深度就会从这里开始重新计算

4）继续解决上述的缺点，我们可以在 clickable 之前指定所属的页面，当判断不在此页面后就会自动跳回

selectedList:

• { xpath: “//[@resource-id=‘com.xueqiu.android:id/ll_search_result’]//[@clickable=‘true’]//*”, action: click }

5）另外我们之前在 selectList 中写了 clickable=true, 而 clickable=true 通常只是布局元素，布局元素一般是没有任何属性的，不知道控件里包含什么，这样在截图和生成报告的时候就会造成不精准，截图中的步骤框就很可能选择错误，对我们定位分析问题造成困扰;

所以我们要继续往下找标志符，以 Text 作为定位标志符：

selectedList:

• { xpath: “//[@resource-id=‘com.xueqiu.android:id/ll_search_result’]//[@clickable=‘true’]//*[contains(@class,‘Text’)]”, action: click }

用 Text 作为标志符以后所有的 Text 属性都会遍历一遍，还可以进一步优化，使用id非空作为判定条件,并且通常研发将控件设置 id 的话很可能此控件有关键的作用

selectedList:

• { xpath: “//[@resource-id=‘com.xueqiu.android:id/ll_search_result’]//[@clickable=‘true’]//*[@resource-id!=‘’]”, action: click }

6）按照上面的写法又引发了新的问题，就是 id 不为空的时候，我们的 tag 控件无法被选中了，因为 tag 控件的 id 正好为空：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-rvr3Ebbo-1650513935065)(https://ceshiren.com/uploads/default/original/3X/3/d/3d12d3c6691b63ae1ced4b85b24838dd2932700a.jpeg)]

因此我们又需要对 selectedList 进行修改，单独增加一条判定条件用来过滤出 tag 控件；我们注意到它们同属一片有 id 的区域，并且各自自身有 text：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sguW6fjg-1650513946369)(https://ceshiren.com/uploads/default/original/3X/8/4/84c7dce46c733df90bf4a710ba5566192d6830a1.jpeg)]

修改后的selectedList如下：

selectedList:

• { xpath: “//[@clickable=‘true’]//[contains(@class,‘Text’)]”, action: click }
• • { xpath: “//[contains(@resource-id, ‘ti_tab_indicator’)]//[contains(@class,‘Text’)]”,

- tagLimitMax：最大的点击次数
- - 有时候页面中可能会有多个相同类型的控件，这些控件之间可能只是展示的信息不同，其他功能属性都一直，那么为了保证测试效率可以只设置让它被点击少数次或者一次，通过 tagLimitMax 设置即可。 

tagLimitMax: 1

缺点：这个设置是一个全局的，一旦设置，那么所有的同类型的控件都只会被点击一次，但是像上个例子中的 4 个tag标签控件虽然是同类型的，但是每一个都需要被点击一次，这样显然就不符合我们的需求了，这个时候就需要 tagLimit 参数了

- tagLimit：自定义控件类型的点击次数
- ```
- tagLimit:
-  - xpath: //*[contains(@resource-id, 'ti_tab_indicator')]//*[contains(@class,'Text')]
-   action: click
-   times: 4

• triggerActions：触发器，特定条件触发执行动作的设置 这个参数是一个非常有用的参数，比如我们可能会遇到如下的情况
• • • 广告、升级弹框在测试过程中突然出现
• • • 某些动作需要输入
• • • 某些动作需要特定次数的操作
• • 这样每次出现弹框都会被处理
• • • 测试中途碰到了账号密码输入框需要输入的可以提前在triggerActions中设置
• triggerActions:
• • xpath: //*[contains(@resource-id,‘image_cancel’)]
• action: click
• times: 1

1. App 运行比较慢，容易超时怎么办？
2. 答：AppCrawler 默认每次操作时会等待 500ms; 通过 triggeraction 来解决需要等待的条件，xpath 为进度条，action 为 sleep 1s。
3. tagLimit 会限制同属性但不同层级的元素吗?
4. 答：tagLimit 限制的是相同的父节点层级，不管属性，是看布局的层级。
5. 如何防止遍历的时候不小心跳到别的应用？跳到别的应用后怎么回来？
6. 答：会自动跳转回来的。除非设置了 App 的白名单
7. 页面需要在当前页不停滑动加载测试
8. 答：遍历完当前页后用 afterpage 参数设置滑动
9. firstList 和 lastList 可以写多个表达式吗？他们是如何执行的？
10.答：顺序是这样排列的

10. app 运行比较慢，容易超时怎么办？
11.答：AppCrawler 默认每次操作时会等待 500ms;通过 triggeraction 来解决需要等待的条件，xpath 为进度条，action 为 sleep 1s

11. tagLimit 会限制同属性但不同层级的元素吗？
12.答：tagLimit 限制的是相同的父节点层级，不管属性，是看布局的层级

12. 如何防止遍历的时候不小心跳到别的应用？跳到别的应用后怎么回来？
13.答：会自动跳转回来的。除非设置了 App 的白名单

13. 页面需要在当前页不停滑动加载测试
14.答：遍历完当前页后用 afterpage 参数设置滑动

14. firstList 和 lastList 可以写多个表达式吗？他们是如何执行的？
15. 答：顺序是这样排列的
16. ```
17. firstList[0]
18. firstList[1]
19. 排除lastList firstList之后剩下的元素
20. lastList[0]
21. lastList[1]
22. backbutton

23. Appclawer ==>maxDepth:这个层级是如何定义的？
24. 答：maxDepth 可以从 log 中看到，AppCrawler.log 中有一个 Stack 的输出，里面默认保存的是所有 activity 的栈记录。
    Main
    Main->UserProfile
    Main->UserProfile->Login
    Main
    maxDepth是判断这个堆栈最长的长度，一旦超过就回退

AppCrawler 的使用就告一段落了。大家还有疑问，可以在文章末尾扫码入群一起交流。

想系统进阶提升测试开发技能的同学，推荐霍格沃兹测试学院出品的 《测试开发从入门到高级实战》系统进阶班课程。

4 个月由浅入深，强化集训，测试大咖思寒领衔亲授，通过 8+ 企业级项目实战演练，带你一站式掌握 BAT 测试开发工程师必备核心技能（对标阿里巴巴P6+，挑战年薪50W+）！学员直推 BAT 名企测试经理，普遍涨薪 50%+！

点一下好看，就少一个 Bug！
原文链接

获取更多技术文章分享
首先我们需要准备一部手机或者一个Android模拟器。然后电脑上需要配置Android开发环境。

• 下载 Android SDK：，按照系统版本下载相应的zip包。请按照自己的系统按需下载。

• zip包解压缩，会生成一个tools目录。需新建一个sdk目录，然后把tools目录移动到sdk目录下。

• • 设置环境变量，根据新建sdk目录的位置来添加ANDROID_HOME的路径：
• • 使用 sdkmanager 下载工具包

Android 调试桥 (adb) 是一个通用命令行工具，其允许您与模拟器实例或连接的 Android 设备进行通信。它可为各种设备操作提供便利，如安装和调试应用，并提供对 Unix shell（可用来在模拟器或连接的设备上运行各种命令）的访问。该工具作为一个客户端-服务器程序，包括三个组件：

• 客户端：该组件发送命令。客户端在开发计算机上运行。您可以通过发出 adb 命令从命令行终端调用客户端。
• • 后台程序：该组件在设备上运行命令。后台程序在每个模拟器或设备实例上作为后台进程运行。
• • 服务器：该组件管理客户端和后台程序之间的通信。服务器在开发计算机上作为后台进程运行。
• 您可以在 sdk/platform-tools/ 中找到 adb 工具。
• 
  我们通常使用adb devices来查看电脑上连接的Android设备，使用adb shell打开Android设备上的终端来执行各种命令。使用adb logcat来查看Android设备产生的log信息。

如果不想使用usb线来连接Android设备，可以使用adb tcpip 端口在Android设备上启动一个指定的端口，然后使用adb connect Android设备ip:端口远程连接Android设备。

uiautomator 是一个 java 库，包含用于创建自定义功能UI测试的API，以及用于自动执行和运行测试的执行引擎。使用uiautomator help可以查看帮助信息。此处我们主要使用uiautomator dump来获取当前屏幕的UI层次结构的XML文件。默认存储文件的位置/sdcard/window_dump.xml，也可以指定存放的位置uiautomator dump /data/local/tmp/ui.xml。

input可以用来模拟各种输入操作，例如：发送文本、点击控件、滑动坐标。使用input可以查看帮助信息。

• input text abc：输入文本abc
• • input tap x坐标 y坐标：点击坐标位置x，y
• • input swipe x1坐标 y1坐标 x2坐标 y2坐标：从x1，y1坐标滑动到x2，y2坐标
• 
  好了，当我们配置好Android开发环境，大概了解adb命令的作用之后，同时知道了Android设备上的uiautomator和input命令后，就开始我们进入今天的重点了，使用这些命令来组合成自动化的操作。

首先呢，我们需要找一个我们练习用的APP，今天我们选择的是”摩拜单车“。大家可以在此处下载安装包文件。

下载完成之后，我们把Android设备使用usb线连接到电脑。使用adb devices来确认设备是否连接成功。

设备已经连接成功，我们需要把“摩拜单车”应用安装到Android设备上，执行adb install 摩拜单车安装文件，“有些手机权限管理比较严格，可能需要在手机上点击同意安装此应用。”

进入Android设备的终端下

我们先打开摩拜单车应用，然后去查看一下页面的源码
执行后会生成一个.xml文件。文件结构如下。每个控件都是由组成。

我们可以按照、结构来进行拆分。使用的命令行为：

点击
根据控件中的bounds="[x1,y1][x2,y2]"属性来查找控件中心点的 x,y轴坐标，计算方法是(x1+x2)/2，(y1+y2)/2

然后使用上面的方法得到的x，y坐标来点击应用图标input tap 167.5 219。最后写成一个函数，只要传递控件的名字就能点击相应的图标啦。

点击坐标，因为我的手机上面显示了两条关于摩拜应用的坐标，一个是应用图标的，一个是应用文本的，选择其中一个即可。

wm size命令可以查看屏幕分辨率，然后提取分辨率的数值adb shell wm size |awk -F ’ |x’ '{print $3,$4} ，这里使用了空格或者x做分隔符。

使用swipe x1 y1 x2 y2进行滑动。例如（下面数值均为随机数值）：
从右向左滑动：swipe 0.3 0.8 0.7 0.8
从左向右滑动：swipe 0.7 0.8 0.3 0.8
从上向下滑动：swipe 0.8 0.7 0.8 0.3
从下向上滑动：swipe 0.8 0.3 0.8 0.7

打开APP并停留12秒
整体的运行效果是这样的。

关闭提示并登录
整体的运行效果是这样的。

输入手机号并登录
整体的运行效果是这样的（上图手机号为随机填写）。

当然，脚本自动化远不止上面这些。你需要知道更多。比如awk，sed 命令功能深入了解，adb到底还有什么好用的参数？adb 的运行原理？

想要摩拜自动化脚本的小伙伴，也可以添加小助手微信回复“第十期”进群。更多干货在霍格沃兹测试学院第十期：Linux脚本自动化。

- 今日互动 -

欢迎留言并分享给其他爱学习的测试小伙伴

（别忘了长按添加小助手微信，

回复“第十期”即可入群）

获取更多技术文章分享