AppCrawler运用总结

一.环境

1.环境准备：安装安卓SDK + 真机 + appcrawler-2.1.3.jar

在放 appcrawler-2.1.0.jar 的文件夹下执行以下命令:

1.生成yml的demo：java -jar appcrawler-2.1.3.jar –demo

2.更改并运行yml配置文件:java -jar appcrawler-2.1.3.jar  -c example. yml

3.Java -jar appcrawler-2.1.0.jar -a jingdata.apk -c config.yml --output wyy/

二.参数说明

1、java -jar appcrawler-2.1.0.jar –capability appPackage=xxxxxx,appActivity=xxxxxx 
2、命名启动appium:appium –session-override

3、配置文件使用：true和false是开启和关闭的意思 
logLevel：日志级别 
saveScreen：是否截图 
reportTitle：报告名字 
screenshotTimeout：屏幕超时时间 
currentDriver：当前设备（Android/iOS） 
resultDir：结果文件夹名，给定后，将不动态命名 
tagLimitMax：ios的元素tag控制 
tagLimit：给tag 
maxTime：最大运行时间 
showCancel：应该是控制是否展示注释 
capability：用于配置appium 
androidCapability：Android专属配置，最后会和capability合并 
iosCapability：iOS专属配置 
urlWhiteList/blackList：白名单/黑名单 
xpathAttributes：用来设定可以用那些种类型去定位控件 
defineUrl：用来确定url的元素定位xpath 他的text会被取出当作url因素（没理解） 
baseUrl：设置一个起始url和maxDepth, 用来在遍历时候指定初始状态和遍历深度 
maxDepth：默认的最大深度10, 结合baseUrl可很好的控制遍历的范围 
appWhiteList：app白名单，如果跳转到其他app，需要设定规则，是否允许停留在次app中 
headFirst：是否是前向遍历或者后向遍历 
enterWebView：是否遍历WebView控件 
urlBlackList：url黑名单.用于排除某些页面 
urlWhiteList：url白名单, 第一次进入了白名单的范围, 就始终在白名单中. 不然就算不在白名单中也得遍历. 
上层是白名单, 当前不是白名单才需要返回 
defaultBackAction：默认的返回动作（没看到例子，貌似不特指的话，是click） 
backButton：给一些返回控件，用于返回动作使用 
firstList：优先遍历元素 
selectedList：默认遍历列表，如果不是指定的类型，而是确定控件，会分别点击控件 
lastList：最后遍历的元素 
blackList：排除某些控件 
triggerActions：制定规则（action、xpath、times） 
autoCrawl：自动抓取，看源码指定true后运行crawl(conf.maxDepth)命令 
（crawl——清空堆栈 开始重新计数）应该是appcrawler的主要方法 
asserts：断言，用于是否失败的判断 
testcase：测试用例，看appcrawler日志，每次都是首先运行用例才会往下执行 
beforeElementAction：貌似没什么人用，字面意思在元素动作之前 
afterElementAction：与beforeElementAction的待遇差不多 
afterUrlFinished：也是很冷门的待遇 
monkeyEvents：monkey的点击数 
monkeyRunTimeSeconds：monkey运行时间 
given是条件 或输入 when是触发条件和动作 then是断言 
4、一次ctrl+c生成报告，两次ctrl+c是强行退出 
5、终端输入Scala进入Scala解释器，输入:q或:quit退出解释器 
6、遍历的深度应该怎么设置好，总是跳到其它页面，就回不到当前页面继续遍历了,看文档 通过黑白名单 
7、设置一个起始url和maxDepth, 用来在遍历时候指定初始状态和遍历深度

• WebDriver 
  1. 根据id class xpath进行定位

• AppCrawler 
  1. 先getPageSoruce获取所有的元素列表 
  2. 根据xpath直接选择元素 
  3. 截图时增加对选择控件的高亮区分 
  4. 宽松策略的自动化机制

• Page Source解读 
  Android 
  1. tag class 
  2. resource-id 
  3. content-desc 
  4. text 
  iOS 
  1. tag 
  2. name 
  3. label 
  4. value

• xpath的定位 
  绝对定位 /xxx/ddd/dddd 
  相对定位 //android.widget.Button 
  查找 
  1. //* 
  2. //*[contains(@resource-id,’login’)] 
  3. //*[@text=’登录’] 
  4. //*[contains(@resource-id,’login’) and contains(@text,’登录’)] 
  5. //[contains(@text,’看点’)]/ancestor:://*[contains(name(),’EditText’)] 
  6. //*[@clickable=”true”]//android.widget.TextView[string-length(@text)>0 and string-length(@text)<20]

• 多种方式匹配 
  xpath 
  1. //*[@resource-id=’xxxx’] 
  2. //*[contains(@text,’密码’)] 
  正则 
  1. ^确定￥ 
  2.^.输入密码 
  包含 
  1. 密码 
  2. 输入 
  3. 请

自动遍历过程 
信息的获取 
把当前app的界面dump为xml结构 
获取待遍历元素 
遍历范围selectedList 
过滤黑名单 小控制 不可见控件 blackList 
重新控件顺利firstList lastList 
跳过已点击 + 跳过限制点击的控件tagLimit 
跟进匹配的规则执行action 
循环上面的步骤

问题记录

1. 设置登录账号、密码

triggerActions:
- action: "click"
  xpath: "//*[@resource-id='com.xxx.myfinance:id/login_tv']"
  times: 1
- action: "153xxxxxxxx"
  xpath: "//*[@resource-id='com.xxx.myfinance:id/phone_edit']"
  times: 1
- action: "123456"
  xpath: "//*[@resource-id='com.xxx.myfinance:id/pwd_edit']"
  times: 1
- action: "click"
  xpath: "//*[@resource-id='com.xxx.myfinance:id/btn_submit']"
  times: 1

 2.  编辑EditText

方式一：

 triggerActions:
  - action: "10000"
  xpath: "//*[@class='android.widget.EditText']"
  times: 1  

备注：times只能写1，否则EditText控件一直在那复制剪切 
不适用需要多次输入的EditText

方式二：

testcase:
  name: "sui guan jia"
  steps:
    - when: 
      xpath: //*[@resource-id='com.feidee.myfinance:id/cash_amount']
      action: ${random.int[100,1000]}
      times: 0
    then: []

备注：可点击的EditText获取不到

clickedIndex=-1 action=Ready
 xpath=//*[@resource-id="com.feidee.myfinance:id/action_bar_root" and @index="0"]/*[@resource-id="android:id/content" and @index="0"]/*[@index="0"]/*[@resource-id="com.feidee.myfinance:id/common_toolbar" and @index="0"] 
 !!! CANCELED !!!

3 appcrawler经常会出现一些错误： 
2018-05-12 10:53:27 ERROR [Crawler.crawl.203] crawl not finish, return with exception 
2018-05-12 10:53:27 ERROR [Crawler.crawl.204] Unable to launch the app: Error: Trying to start logcat capture but it’s already started! (WARNING: The server did not provide any stacktrace information) 
Command duration or timeout: 0 milliseconds 
不太清楚，为什么会报错…… 总的感觉是getPageSoruce未获去到元素 
所以瞎改了

selectedList:
#android非空标签
- //*[@clickable='true']
#- //*[@clickable='true']//*[contains(name(), 'Text') and string-length(@text)>0 and string-length(@text)<10 ]
#通用的button和image
- //*[@clickable='true']//*[contains(name(), 'Button')]
- //*[@clickable='true']//*[contains(name(), 'Image')]
- //*[@clickable='true']//*[contains(name(), 'Layout')]
- //*[@class='android.view.ViewGroup']
- //*[@class='android.widget.EditText']

4 testcase 与 triggerActions 
自己试了一下，发现是先查找testcase，再查找triggerActions 
但是还是感觉逻辑关系有点混乱，或者没有办法支持复杂的逻辑关系，让自己的case更有逻辑顺序。

综合考虑：2 和 4纠结了好久，试了个遍，可能是appcrawler自己的缺陷，所以放弃了这个工具。

又看到了新的工具AIMonkey： https://testerhome.com/topics/11719 
后面准备研究下