本文为霍格沃兹测试学院学院学员课程 AppCrawler 学习笔记。
定制化配置
自动遍历测试技术以及工具该如何选择和快速入门？经过对比和需求，最终选择测试架构师思寒大佬的 AppCrawler 作为自动遍历测试的工具。以下就分享 AppCrawler 自动遍历测试的一些最佳实践经验。
模板文件生成
运行命令java -jarappcrawler-2.4.0-jar-with-dependencies.jar --demo, 会在当前目录下生成一个 demo.yml 文件,这个文件就是我们进行定制化的配置文件模板：
#执行命令生成demo.yaml模板配置文件$ java -jar appcrawler-2.4.0-jar-with-dependencies.jar --demo2019-12-01 21:33:35 INFO [AppCrawler$.86.main]----------------AppCrawler 2.4.0 [霍格沃兹测试开发学社特别纪念版]Appium 1.8.1 Java8 testedapp爬虫, 用于自动遍历测试. 支持Android和iOS, 支持真机和模拟器项目地址: https://github.com/seveniruby/AppCrawler
--------------------------------
2019-12-01 21:33:35 INFO [AppCrawler$.223.parseParams] use default appium address 47232019-12-01 21:33:35 INFO [AppCrawler$.230.parseParams] appium address = Some(http://127.0.0.1:4723/wd/hub)2019-12-01 21:33:35 INFO [AppCrawler$.242.parseParams] result directory = 201912012133352019-12-01 21:33:36 INFO [AppCrawler$.286.parseParams] you can read /Users/qinzhen/Documents/TestDev/AppCrawler/demo.yml for demo
#查看配置文件已生成$ lsappcrawler-2.4.0-jar-with-dependencies.jardemo.yml
复制代码
---pluginList: []saveScreen: truereportTitle: ""resultDir: "20191201213335"waitLoading: 500waitLaunch: 6000showCancel: truemaxTime: 10800maxDepth: 10capability: noReset: "true" fullReset: "false" appium: "http://127.0.0.1:4723/wd/hub"testcase: name: "Ceshiren AppCrawler" steps: - given: [] when: null then: [] xpath: "/*" action: "Thread.sleep(5000)" actions: [] times: 0selectedList:- 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: 0firstList: []lastList:- given: [] when: null then: [] xpath: "//*[@selected='true']/..//*" action: null actions: [] times: 0- given: [] when: null then: [] xpath: "//*[@selected='true']/../..//*" action: null actions: [] times: 0backButton:- given: [] when: null then: [] xpath: "Navigate up" action: null actions: [] times: 0triggerActions:- given: [] when: null then: [] xpath: "share_comment_guide_btn" action: null actions: [] times: 0xpathAttributes:- "name"- "label"- "value"- "resource-id"- "content-desc"- "instance"- "text"sortByAttribute:- "depth"- "list"- "selected"findBy: "default"defineUrl: []baseUrl: []appWhiteList: []urlBlackList: []urlWhiteList: []blackList:- given: [] when: null then: [] xpath: ".*[0-9]{2}.*" action: null actions: [] times: 0beforeRestart: []beforeElement:- given: [] when: null then: [] xpath: "/*" action: "Thread.sleep(500)" actions: [] times: 0afterElement: []afterPage: []afterPageMax: 2tagLimitMax: 2tagLimit:- given: [] when: null then: [] xpath: "确定" action: null actions: [] times: 1000- given: [] when: null then: [] xpath: "取消" action: null actions: [] times: 1000- given: [] when: null then: [] xpath: "share_comment_guide_btn_name" action: null actions: [] times: 1000assertGlobal: []
复制代码
执行参数
同样，还是以雪球 App 为例，以实际操作运行来解释配置文件中各个参数的含义和用法
capability: noReset: "false" fullReset: "false" appium: "http://127.0.0.1:4723/wd/hub" appPackage: com.xueqiu.androi appActivity: .view.WelcomeActivityAlias automationName: uiautomator2 autoGrantPermissions: true
复制代码
这里再介绍两个很有趣也很有用的参数：
dontStopAppOnReset: true ;这个参数允许我们在某个页面继续执行遍历，比如我们希望 App 先进入到某个页面后再进行遍历，或者当一个 session 结束后继续下一个 session 的时候我们希望不要杀死 App 重新执行，而是继续上一次结束的页面开始执行
ignoreUnimportantViews: 这个参数设置为 true 的时候可以忽略不重要的 view，加速 pageSource 的加载，加快测试速度
执行参数
完整形态
允许我们以 given、when、then 的形式指定操作，如果学习过 Java 的接口自动化框架 rest-assured 话可以很容易理解这三个参数表达的含义：
具体写法如下：
testcase: name: "Ceshiren AppCrawler" steps: - when: xpath: //* action: driver.swipe(0.5, 0.8, 0.5, 0.2) - when: xpath: //* action: driver.swipe(0.5, 0.2, 0.5, 0.8) then: - //*[contains(@text, '美股')]
复制代码
执行参数
简写形态
另外实际使用中我们会经常使用简写形态
- xpath: 自选 action: click then: - //*[contains(@text, '美股')]
复制代码
注：定位模式除了可以使用 xpath 之外还可以使用正则和包含关系，只不过经常使用的是 xpath，也更为严谨；
这里以雪球首页搜索框输入 alibaba 的简单场景举例，在搜索前还需要处理掉升级弹框，修改完成如下:
testcase: name: "XueQiuTestDemo AppCrawler" steps: - { xpath: "//*[contains(@resource-id,'image_cancel')]", action: click } - xpath: home_search action: click - xpath: search_input_text action: alibaba
复制代码
如上的 testcase 写法还要多说几句：
也可以使用 {} 将需要执行的事件包裹起来，元素定位符和操作 action 时间用逗号隔开
{} 内若使用 xpath 表达式的话需要加双引号
xpath 中直接写 id 或 text 文本信息，就会默认使用包含去查找
需要点击的事件要明确指明 click，某则会报错；虽然思寒说过默认的 action 就是 click ，但是经过实测发现在 2.4.0 版本上必须指明 action：click ; 很可能是思寒本地使用的内部版本经过了优化更新还未来得及开源到 GitHub 上。
运行效果：
selectedList: 遍历范围设定这里如果想设置让其点击所有可点击的 TextView 和 ImageView 控件,修改完成如下:
selectedList:- xpath: //android.widget.ImageView[@clickable='true']- xpath: //*[@clickable='true' and contains(@class,"Text")]
复制代码
lastList:- { xpath: text_yes, action: click }
复制代码
triggerActions:- { xpath: android.widget.EditText, action: 123456abc, times: 2 }
复制代码
- { xpath: "//*[contains(@class, 'List')]//*", times: 1 }
复制代码
到这里，appcrawler 的基本语法和参数含义大致介绍了一遍，后面就是如何结合实际进行使用了。下一篇将进行详细的介绍。
评论