需求背景

业务变更快速
业务线众多
业务流程复杂
依赖第三方接口较多

业务常见问题举例

功能问题
- app某界面崩溃
- app某接口有报错
- 详情页中特定信息字段内容丢失或者数据异常
- 微信分享不可用
兼容性问题
- 用户网络慢时发出请求后退出当前页面发生崩溃
- 某些界面在4.4和5.0的系统上操作体验不同

测试痛点

快速迭代中传统的基于用例维护的自动化用例使用不当
- 没有采用合理的分层测试体系，尝试用UI自动化覆盖所有测试场景
- 没有采用PageObject模式导致自动化用例维护成本大
- 对自动化框架掌握程度不够
测试内容太多导致手工测试无法充分覆盖
- UI自动化只能覆盖核心业务逻辑，新功能来不及上自动化
- 产品业务测试量较大，新版发布后，老功能来不及全面回归，容易漏测
- 时间长，强度大的工作后，人容易产生疲乏，对数字的位数，文字的显示等错误信息的敏感度下降
- 产品的界面深度很深，且包含大量的展示信息功能
- 专项测试回归难度大：内存泄漏、健壮性测试、弱网等测试太多

什么是 AppCrawler？

Appcrawler 是一个基于自动遍历的App爬虫工具，支持 Android 和 IOS，支持真机和模拟器。最大的特点是灵活性高，可通过配置来设定遍历的规则。

环境准备

JDK版本 ≥ 1.8
jar包下载地址：https://github.com/seveniruby/AppCrawler/releases/
SDK 环境

基本使用-命令行参数

选项	说明
-a	Android或者iOS的文件地址, 可以是网络地址, 赋值给appium的app选项
-e	设置编码格式，例如UTF-8 GBK
-c	配置文件路径
-p	平台类型android或者ios, 默认会根据app后缀名自动判断
-t	最大运行时间. 单位为秒. 超过此值会退出. 默认最长运行3个小时
-u	appium的url地址
-o	遍历结果的保存目录. 里面会存放遍历生成的截图和日志

基本使用-命令行参数

选项	说明
–capability k1=v1,k2=v2…	Valuappium capability选项, 这个参数会覆盖-c指定的配置模板参数, 用于在模板配置之上的参数微调
-r	输出html和xml报告
–template	输出代码模板
-v	是否展示更多debug信息
-vv	是否展示更多trace信息
–help	显示帮助信息

基本使用-配置文件参数

capability设置：与appium完全一致
testcase：用于启动app后的基础测试用例
selectedList：遍历范围设定
triggerActions：特定条件触发执行动作的设置
selectedList：需要被遍历的元素范围
firstList：优先被点击
lastList：最后被点击
tagLimitMax：同祖先（同类型）的元素最多点击多少次
backButton：当所有元素都被点击后默认后退控件定位
blackList：黑名单，讲不想被点击的元素加入黑名单
maxDepth: 遍历的最大深度
waitAppLoadedTimeout：等待app启动时间
waitAppLoaded：设置APP成功启动的标识；若元素加载出来，则认为APP已成功启动

testcase 配置示例

启动APP后，通过testcase进行登录，完成前置操作

testcase:
  name: "霍格沃兹测试开发学社"
  steps:
    - xpath: "//*[@text='我的']"
      action: click
    - xpath: "//*[@text='未登录']"
      action:  click
    - xpath: "//*[@resource-id='login_account']"
      action: hogwarts
    - xpath: "//*[@text='请输入8-16位密码']"
      action: hogwarts
    - xpath: "//*[@text='请输入验证码']"
      action: 6666
    - xpath: "//*[@text='登录']"
      action: click

selectedList 配置示例

遍历页面内元素属性name包含Button的元素

selectedList:
  - xpath: //*[contains(name(), 'Button')]

triggerActions 配置示例

当页面存在取消这个元素时，会先点击取消
当页面有支付这个元素时，会执行 back 操作
times 规则的使用次数

triggerActions: 
  - xpath: //*[@text='取消']
  - xpath: 支付
    action: driver.back()
  - xpath: //*[contains(@text, '支付成功后')]
    times: 5

action 定义

driver.back() 后退
driver.swipe(0.5,0.4,0.5,0.45) 滑动（百分比）
click 点击

功能介绍

生成样板配置示例

java -jar appcrawler.jar –demo
会在当前目录下生成一个demo.yml

执行方式-参数模式

执行参数比配置文件优先级别高

java -jar <appcrawler.jar路径> appcrawler --capability \
"appPackage=com.xueqiu.android,appActivity=.view.\
WelcomeActivityAlias"

执行方式-配置文件 [推荐方式]

java -jar <appcrawler.jar路径> -c example.yml

xpath示例

绝对定位 /xxx/ddd/dddd
相对定位 //android.widget.Button
查找
- 所有元素：//*
- 包含条件：//*[contains(@resource-id, ‘login’)]
- 满足属性值：//*[@text=‘登录’]
多条件联合
- //*[contains(@resource-id, ‘login’) and contains(@text, ‘登录’)]]
- //*[contains(@text, ‘登录’) or contains(@label, ‘登录’)]]
当多控件同时出现：
- //*[contains(@text, '看点')]/ancestor::*//*[contains(name(), ‘EditText’)]
根据可点击属性和文本内容长度筛选：
- //*[@clickable="true"]//android.widget.TextView[string-length(@text)>0 and string-length(@text)<20]