当前位置： 首页 > news >正文

深入解析AppCrawler：开源自动遍历测试工具配置指南

news 2025/9/29 8:03:47

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

配置文件格式

执行参数与配置文件

  • capability设置：与appium完全一致

  • testcase：用于启动app后的基础测试用例

  • selectedList：遍历范围设定

  • triggerActions：特定条件触发执行动作的设置

  • selectedList：需要被遍历的元素范围

  • firstList：优先被点击

  • lastList：最后被点击

  • tagLimitMax：同祖先（同类型）的元素最多点击多少次

  • backButton：当所有元素都被点击后默认后退控件定位

  • blackList：黑名单

  • maxDepth: 遍历的最大深度

配置的最小单元 测试用例模型

testcase的完整形态

  • given：所有的先决条件

  • when：先决条件成立后的行为

  • then：断言集合

testcase的简写形态

  • xpath：对应when里的xpath

  • action：对应when的action

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

  • given 前提条件

  • when 执行动作

  • then 写断言

简写形态

  • xpath xpath支持xpath表达式、正则、包含

  • action 支持

xpath定义

  • xpath - //[@resource-id=‘xxxx’] - //[contains(@text, ‘密码’)]

  • 正则 - ^确定$ - ^.*输入密码

  • 包含 - 密码 - 输入 - 请

action定义

  • "" 只是截图记录

  • back 后退

  • backApp 回退到当前的app 默认等价于back行为 可定制

  • monkey 随机事件

  • click

  • longTap

  • xxx() 执行scala或者java代码 - Thread.sleep(3000) - driver.swipe(0.9, 0.5, 0.1, 0.5)

  • 非以上所有行为是输入 xx ddd

完整配置文件

---
maxTimeDescription: "最大运行时间"
maxTime: 10800
maxDepthDescription: "默认的最大深度10, 结合baseUrl可很好的控制遍历的范围"
maxDepth: 10
capabilityDescription: "appium的capability通用配置，其中automationName代表自动化的驱动引擎，除了支持appium的\所有引擎外，额外增加了adb和selenium的支持"
capability:appActivity: ".ApiDemos"appium: "http://127.0.0.1:4723/wd/hub"noReset: "true"appPackage: "io.appium.android.apis"fullReset: "false"
testcaseDescription: "测试用例设置，用于遍历开始之前的一些前置操作，比如自动登录"
testcase:name: "AppCrawler TestCase"steps:- given: []when: nullthen: []xpath: "/*/*"action: "Thread.sleep(1000)"actions: []times: -1
triggerActionsDescription: "在遍历过程中需要随时处理的一些操作，比如弹框、登录等"
triggerActions:- given: []when: nullthen: []xpath: "permission_allow_button"action: ""actions: []times: 3- given: []when: nullthen: []xpath: "允许"action: ""actions: []times: 3
selectedListDescription: "默认遍历列表，只有出现在这个列表里的控件范围才会被遍历"
selectedList:- given: []when: nullthen: []xpath: "//*[contains(name(), 'Button')]"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[contains(name(), 'Text') and @clickable='true' and string-length(@text)<10]"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[@clickable='true']//*[contains(name(), 'Text') and string-length(@text)<10]"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[contains(name(), 'Image') and @clickable='true']"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[@clickable='true']/*[contains(name(), 'Image')]"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[contains(name(), 'Image') and @name!='']"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[contains(name(), 'Text') and @name!='' and string-length(@label)<10]"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//a"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[contains(@class, 'Text') and @clickable='true' and string-length(@text)<10]"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[@clickable='true']//*[contains(@class, 'Text') and string-length(@text)<10]"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[contains(@class, 'Image') and @clickable='true']"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[@clickable='true']/*[contains(@class, 'Image')]"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[@clickable='true' and contains(@class, 'Button')]"action: ""actions: []times: -1
blackListDescription: "黑名单列表 matches风格, 默认排除内容包含2个数字的控件"
blackList:- given: []when: nullthen: []xpath: ".*[0-9]{2}.*"action: ""actions: []times: -1
firstListDescription: "优先遍历列表，同时出现在selectedList与firstList中的控件会被优先遍历"
firstList: []
lastListDescription: "最后遍历列表，同时出现在selectedList与lastList中的控件会被最后遍历"
lastList:- given: []when: nullthen: []xpath: "//*[@selected='true']/..//*"action: ""actions: []times: -1- given: []when: nullthen: []xpath: "//*[@selected='true']/../..//*"action: ""actions: []times: -1
backButtonDescription: "后退按钮列表，默认在所有控件遍历完成后，才会最后点击后退按钮。目前具备了自动判断返回按钮的能力，默认不需要配置"
backButton:- given: []when: nullthen: []xpath: "Navigate up"action: ""actions: []times: -1
xpathAttributesDescription: "在生成一个控件的唯一定位符中应该包含的关键属性"
xpathAttributes:- "name()"- "name"- "label"- "value"- "resource-id"- "content-desc"- "text"- "id"- "name"- "innerText"- "tag"- "class"
sortByAttributeDescription: "陆续根据属性进行遍历排序微调，depth表示从dom中最深层的控件开始遍历，list表示dom中列表优先，\selected表示菜单最后遍历，这是默认规则，一般不需要改变"
sortByAttribute:- "depth"- "list"- "selected"
findByDescription: "默认生成控件唯一定位符的表达式风格，可选项 default|android|id|xpath，默认会自动判断是否使用android定\位或者ios定位"
findBy: "xpath"
baseUrlDescription: "设置一个起始点，从这个起始点开始计算深度，比如默认从登录后的界面开始计算"
baseUrl: []
appWhiteListDescription: "app白名单，允许在这些app里进行遍历"
appWhiteList: []
urlBlackListDescription: "url黑名单，用于排除某些页面的遍历"
urlBlackList: []
urlWhiteListDescription: "url白名单，仅在这些界面内遍历"
urlWhiteList: []
beforeStartWaitDescription: "启动一个app默认等待的时间"
beforeStartWait: 6000
beforeRestart: []
beforeElementDescription: "在遍历每个控件之前默认执行的动作"
beforeElement: []
afterElementDescription: "在遍历每个控件之后默认执行的动作"
afterElement: []
afterElementWaitDescription: "在遍历每个控件之后默认等待的时间，用于等待新页面加载"
afterElementWait: 500
afterAllDescription: "在遍历完当前页面内的所有控件后，是否需要刷新或者滑动"
afterAll: []
afterAllMaxDescription: "afterAll的最大重试次数，比如连续滑动2次都没新元素即取消"
afterAllMax: 2
tagLimitMaxDescription: "相似控件最多点击几次"
tagLimitMax: 2
tagLimitDescription: "设置部分相似控件的最大遍历次数"
tagLimit:- given: []when: nullthen: []xpath: "确定"action: ""actions: []times: 1000- given: []when: nullthen: []xpath: "取消"action: ""actions: []times: 1000- given: []when: nullthen: []xpath: "share_comment_guide_btn_name"action: ""actions: []times: 1000
assertGlobalDescription: "全局断言"
assertGlobal: []
suiteNameDescription: "报告中的测试套件名字可以由列表内的控件内容替换，增强报告中关键界面的辨识度"
suiteName:- "//*[@selected='true']//android.widget.TextView/@text"
screenshotDescription: "是否截图"
screenshot: true
reportTitleDescription: "报告的title"
reportTitle: "AppCrawler"
resultDirDescription: "结果目录，如果为空会自动创建对应时间戳_报名的结果目录"
resultDir: ""
showCancelDescription: "是否展示跳过的控件记录"
showCancel: true
pluginListDescription: "插件列表，暂时禁用，太高级了，很多人不会用"
Description: "。在selectedList firstList lastList等很多配置中，需要填充的是测试步骤Step类型。Step类型由given（\满足条件）when（条件满足的行为）then（断言）三部分组成。Step可以简化为xpath（定位表达式，支持xpath 正则 包含关系）与action（点击\\ 输入等行为）。"
pluginList: []

金牌赞助商（Gold Sponsor）

图片

 

霍格沃兹测试开发学社 是 测吧（北京）科技有限公司 旗下业界领先的测试开发技术高端教育品牌。 学院课程均由名企一线测试大牛设计，提供实战驱动的系列课程。涵盖移动app自动化测试、接口自动化测试、性能测试、持续集成/持续交付/DevOps 、测试左移、测试右移、测试管理等课程。

测吧（北京）科技有限公司 是一家服务于测试领域的高科技公司，为企业提供全方位的自动化测试技术支持、测试平台开发定制、测试效能提升等咨询与科研合作服务。 先后服务于华为、工信部、信通院等知名企业与机构。

编译

mvn clean package

技术交流

由霍格沃兹测试开发学社维护，技术交流与issue提交请移步 https://ceshiren.com/c/opensource/appcrawler/ 

测试开发全景图：AI测试、智能驱动、自动化、测试开发、左移右移与DevOps的持续交付 

推荐阅读

精选技术干货

精选文章

  • 打造高效极简工作流
  • Playwright MCP浏览器自动化指南
  • 新手轻松上手：零基础搭建Qwen智能体指南
  • 大模型部署实战：四大工具赋能个人探索与企业级应用
  • Playwright MCP 实现小红书全自动发布的全流程指南
  • AI 测试平台新功能揭秘：自动化测试用例运行的奥秘

学社精选

  • 测试开发之路 大厂面试总结

  • 【面试】分享面试题总结

  • 测试人生 | 从外包菜鸟到测试开发，薪资一年翻三倍，连自己都不敢信！（附面试真题与答案）

  • 人工智能与自动化测试结合实战-探索人工智能在测试领域中的应用

  • 爱测智能化测试平台

  • 自动化测试平台

  • 精准测试平台

  • AI测试开发企业技术咨询服务

人工智能测试开发学习专区

  • 人工智能/AI/为什么测试工程师需要掌握AI

  • 人工智能在音频、视觉、多模态领域的应用

  • 从0到1打造AI工作流：测试用例/测试架构图/测试报告/简历/PPT全自动生成

  • 视觉识别在自动化测试中的应用-UI测试与游戏测试

  • 人工智能产品测试：从理论到实战

  • AI驱动的全栈测试自动化与智能体开发

  • 大语言模型应用开发框架 LangChain

http://www.dtcms.com/a/419050.html

相关文章：

  • 24届（华为OD）Java面经
  • 20届-测试面经-华为OD
  • 重庆seo整站优化效果百度竞价推广属于什么广告
  • 朝阳区住房和城乡建设部网站营销模式有几种
  • linux学习笔记（5）计算机基本硬件结构
  • 自定义分页控件，只显示当前页码的前后N页
  • 软件开发和网站建设的区别做车贷的网站
  • PC16550串口中断接收与异常处理程序
  • 自动化脚本提升效率
  • mysql旧版本存储嵌入模型的向量数据
  • 公司网站建设宣传话语申请一个域名可以建设一个网站吗
  • 合川做网站临汾网站建设
  • HGAME 2023 week1]a_cup_of_tea
  • vue 打包element plus组件生成对应css文件的问题
  • 网站 接入微信公众号登陆入口
  • 做网站和做appwordpress category模板
  • Windows---进程状态信息获取的核心接口＜Psapi.h＞
  • flink状态管理
  • 有成功案例的网站汉口北做网站
  • k8s的kube-prosy
  • 手机网站费用电商都有哪些平台
  • 自动驾驶中的传感器技术56——USS（2）
  • 快速上手 iFlow CLI：你的终端 AI 助手
  • AI编程工具：ChatGPT + Copilot使用体验
  • vue3+ts 封装跟随弹框组件，支持多种模式【多选，分组，tab等】
  • 网站开发注意事项wordpress 专业版主题
  • 2025甄选范文“论事件驱动的架构”，软考高级，系统架构设计师论文
  • 高通平台WiFi学习--深入解析 WCN39xx/PMIC GPIO/LDO 状态读取与调试
  • 评估止损算法在历史极端行情中表现的一些复盘
  • 英飞凌Coolgan提升Poe性能