java -jar appcrawler.jar --demo
demo.yml
# 插件列表
pluginList: [
"com.testerhome.appcrawler.plugin.LogPlugin",
"com.testerhome.appcrawler.plugin.TagLimitPlugin"
]
# 是否截图
saveScreen: true
reportTitle: "Test Report"
# 结果目录
resultDir: "D:\appcrawler\results\20190907221950"
# 在执行操作后等待多少毫秒刷新
waitLoading: 500
waitLaunch: 6000
# 结果报告是否展示没有遍历被取消的控件
showCancel: true
# 最大运行时间
maxTime: 10800
# 默认的最大深度10, 结合baseUrl可很好的控制遍历的范围
maxDepth: 10
# appium的capability通用配置
capability:
# Appium是否需要自动安装和启动应用。默认值true
autoLaunch: "true"
# 直接转换到 WebView 上下文。 默认值 false
autoWebview: ""
# 不要在会话前重置应用状态。默认值false。
noReset: "true"
fullReset: "false"
appium: "http://127.0.0.1:4723/wd/hub"
deviceName: "GWY0217124003040"
appPackage: "com.xueqiu.android"
appActivity: ".view.WelcomeActivityAlias"
# dontStopAppOnReset: true
automationName: "uiautomator2"
platformName: "Android"
#以下为重置手机输入法为appium输入法
unicodeKeyboard: true
resetKeyboard: true
# 测试用例
testcase:
name: "demo1"
steps:
- given: []
when: null
then: []
xpath: "/*"
action: "Thread.sleep(5000)"
actions: []
times: 0
# 默认遍历列表
selectedList:
- given: []
when: null
then: []
xpath: "//android.widget.TextView[@text='交易']"
action: "click"
actions: []
times: 0
- given: []
when: null
then: []
xpath: "//android.widget.TextView[@text='我的']"
action: "click"
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
# 优先遍历元素
firstList: [
xpath: "//android.widget.TextView[@text='交易']",
xpath: "//android.widget.TextView[@text='我的']"
]
# 最后变量列表
lastList:
- given: []
when: null
then: []
xpath: "//*[@selected='true']/..//*"
action: null
actions: []
times: 0
- given: []
when: null
then: []
xpath: "//*[@selected='true']/../..//*"
action: null
actions: []
times: 0
# 当所有元素都被点击后，默认后退的控件定位
backButton:
- given: []
when: null
then: []
xpath: "Navigate up"
action: null
actions: []
times: 0
# 特定条件触发执行动作的设置
triggerActions:
- given: []
when: null
then: []
xpath: "//android.widget.EditText[@text='请输入手机号或邮箱']"
action: "18701137212"
actions: []
times: 1
- given: []
when: null
then: []
xpath: "//android.widget.EditText[@text='请输入登录密码']"
action: "fengzi802300"
actions: []
times: 1
- given: []
when: null
then: []
xpath: "//android.widget.TextView[@text='登录']"
action: "click"
actions: []
times: 1
# 自动生成的xpath表达式里可以包含的匹配属性
xpathAttributes:
- "name"
- "label"
- "value"
- "resource-id"
- "content-desc"
- "instance"
- "text"
# 先按照深度depth排序，再按照list排序，最后按照selected排序。后排序是优先级别最高的
sortByAttribute:
- "depth"
- "list"
- "selected"
# 可选 default|android|id|xpath，默认状态会自动判断是否使用android定位或者ios定位
findBy: "default"
# 用来确定url的元素定位xpath 他的text会被取出当作url因素
defineUrl: []
# 设置一个起始url和maxDepth, 用来在遍历时候指定初始状态和遍历深度
baseUrl: []
# app白名单
appWhiteList: []
# url黑名单，用户排除某些页面
urlBlackList: []
# url白名单
urlWhiteList: []
# 黑名单列表 匹配风格, 默认排除内容是2个数字以上的控件
blackList:
- given: []
when: null
then: []
xpath: ".*[0-9]{2}.*"
action: null
actions: []
times: 0
# 在重启session之前做的事情
beforeRestart: []
# 在执行action之前和之后默认执行的动作，比如等待
beforeElement:
- given: []
when: null
then: []
xpath: "/*"
action: "Thread.sleep(500)"
actions: []
times: 0
# 是否需要刷新或者滑动
afterElement: []
afterPage: []
# afterPage执行多少次后才不执行，比如连续滑动2次都没新元素即取消
afterPageMax: 2
# 同祖先（同类型）的元素最多点击多少次
tagLimitMax: 2
# 个别控件可例外
tagLimit:
- 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: 1000
# 只需要写given与then即可
assertGlobal: []
参数说明：
1.testcase
given：所有的先决条件(通过xpath的方式进行匹配)
when：先决条件成立后的行为
then：断言集合
简写：
xpath：对应when里的xpath
action：对应when的action
2.动作支持 action
back 后退
backApp 回退到当前app
monkey 随机事件
xxx() 执行代码
Thread.sleep(3000)
driver.swipe(0.9,0.5,0.1,0.5)
click
longTap
其他为输入操作
3.动作次数 times
0 无数次