基于 uiRecorder 录制脚本的 自动化用例工程化模型 分享

一纸荒年

不太会写，就简单直接的描述一下！希望对初学者上手会有些帮助；
其中还有许多需要完善和补充后面会陆续进行改进提交, 希望有同学能参与 补充完善！

首先需要感谢，macaca 项目组的各位大神 提供的这一系列的 测试工具； 感谢！

模型简介：
1.可以录制；
2.可以回放；
3.可以固化用例，多层分离管理！

简单操作方式如下：
录制：
uirecorder start --mobile sample/test.IOS3.js

回放：
source run.sh sample/test.IOS3.js

执行固化用例：
source run.sh testsuite/test.B2C.3.0.4.js

固化用例采用4层分离模式：
第一层： 页面元素数据层；
第二层：页面操作层；
第三层：用例层，或耦合关键字层；
第四层：suite层，业务场景层；

核心：
通用方法js模块；
commons.js

接入手机自动识别、app启动、用例执行、用例截图 等方法，这个是从录制脚本中抽离出来的，只多加了 reuse
参数 可以配置要不要预装app；
commBrowser.js
浏览器或手机操作方法；
commElem.js
被测元素对象公共操作方法；
commShould.js
公共断言方法；

分层结构如下图：

1. 第一层：元素数据层
   
2. 存放，元素对象的 xpath id 等；
   
3. 
   
4. 如：
   
5. 
   
6. exports.btnLoginPar = {
   
7.         androidElem: '//*[@resource-id="com.ndol.sale.starter:id/btn_login"]',
   
8.         iosElem: '//*[@name="登录/注册"]',
   
9.         elementDesc: '登录/注册',
   
10.         waitTime: 30000
    
11. };
    
12. 
    
13. // 商品分类 ，商品列表中 商品的 名称
    
14. exports.goodsNamePar = {
    
15.         androidElem: '//*[@resource-id="com.ndol.sale.starter:id/projuctTitle"]',
    
16.         elementDesc: '商品名称'
    
17. };
    
18. 第二层：页面操作层
    
19. 存放，对页面元素的操作方法；
    
20. 
    
21. 如：
    
22. 
    
23. exports.swipeGoodsName = function (type, index){commElem.waitElemAndSwipe(goodsPageUI.goodsNamePar, type, index, 5);};
    
24. exports.swipeGoodsNameLastToFrist = function (){
    
25.     commElem.waitElemAndSwipeLastToFrist(goodsPageUI.goodsNamePar);
    
26. };
    
27. 第三层：用例层，或耦合关键字层
    
28. 
    
29. 如：
    
30. 
    
31. exports.goodsListSwipeTest = function(){
    
32.     //适用版本  3.0.0--3.0.4
    
33.     commBrowser.testCaseDoc("验证商品列表 向上滑动，隐藏 列表上方 tab 和 下方 tab ");
    
34.     unitPage.clickGoods();
    
35.     goodsPage.clickCategoryXXSP();
    
36.     // goodsPage.getGoodsNameSize();    //打印出 元素对象 的坐标信息
    
37.     goodsPage.swipeGoodsName('up', 1);   //将第2个商品向上滑动
    
38.     // commBrowser.swipeOnce(600,1000,600,400);   //滑屏
    
39.     commShould.elemCanNotFind('全部');    // 全部 等 上方 tab 被隐藏
    
40.     commShould.elemCanNotFind('分类');    // 分类 等 下方 tab 被隐藏
    
41.     goodsPage.swipeGoodsName('down', 1);   //将第2个商品向下滑动
    
42.     commShould.elemCanFind('全部');    // 全部 等 上方 tab 显示
    
43.     commShould.elemCanFind('分类');    // 分类 等 下方 tab 显示
    
44. 
    
45. };
    
46. 
    
47. exports.loginTest = function(){
    
48.     //适用版本  3.0.0--3.0.4
    
49.     commBrowser.testCaseDoc("登录流程 ");
    
50.     unitPage.clickMine();   //点击 “我的”
    
51.     minePage.clickBtnLogin();   //点击注册登录
    
52.     minePage.login(userName, password);
    
53.     minePage.clickIvAvatar();   //点击 “我的资料”
    
54.     unitPage.clickArrowBack();      //返回 我的
    
55. };
    
56. 第四层：suite层，业务场景层
    
57. 启动被测app，运行测试前准备，执行用例 等；
    
58. 
    
59. var commons = require('../commons/commons');
    
60. var rootPath = commons.rootPath;
    
61. var appPath = rootPath + '/app/b2c_v3.0.4_112.apk';
    
62. function testcase(){
    
63.     var b2c_mine = require('../testcase/mineTest');
    
64.     var b2c_goods = require('../testcase/goodsTest');
    
65.     var b2c_order = require('../testcase/orderTest');
    
66.     var b2c_home = require('../testcase/homeTest');
    
67. 
    
68. 
    
69.     // app安装完成，开始执行用例***************************
    
70.     b2c_home.unloginDismissCouponTest();
    
71.     b2c_home.unloginStatusToLoginTest();
    
72.     b2c_order.unloginStatusToLoginTest();
    
73.     b2c_mine.unloginStatusToLoginTest();
    
74.     b2c_mine.userSettingTest();
    
75.     b2c_goods.goodsListSwipeTest();
    
76.     b2c_goods.findGoodsByName();
    
77.     b2c_goods.addCartTest();
    
78.     b2c_goods.addCartTest2();   
    
79.     // ************登录后用例****************************
    
80.     b2c_mine.loginTest();
    
81.     b2c_mine.getUserInfo();
    
82.     b2c_mine.loginStatusToLoginTest();
    
83.     b2c_order.allOrderListTest();
    
84. 
    
85.     // // ************退出登录****************************
    
86.     b2c_mine.loginOffTest();
    
87. 
    
88.     // 用例执行结束**************************************
    
89. }
    
90. 
    
91. 
    
92. if(module.parent && /mocha\.js/.test(module.parent.id)){
    
93.     commons.runThisSpec(appPath, testcase);
    
94. }
    
95. 
    
96. function callSpec(name){
    
97.     try{
    
98.         require(rootPath + '/' + name)();
    
99.     }
    
100.     catch(e){
     
101.         console.log(e)
     
102.         process.exit(1);
     
103.     }
     
104. }
     
105. 
     
106. 
     
107. 通用操作方法
     
108. 如：
     
109. 
     
110. /*
     
111. *等待 对象的出现 ,向指定 方向 拖拽
     
112. * @param androidElem 安卓对应的元素对象的获取方式 及 值
     
113. * @param iosElem ios对应的元素对象的获取方式 及 值
     
114. * @param elementDesc 控件描述文案
     
115. * @param waitTime 等待元素对象刷新的 等待时间
     
116. * @param type 滑动的方向 'up'、down'、'right'、'left'
     
117. * @param index 元素的位标 从 0 开始
     
118. * @param times 移动距离（宽或高）的倍数，默认1
     
119. */
     
120. exports.waitElemAndSwipe = function (parameter,type,index,times){
     
121.     var androidElem = parameter.androidElem;
     
122.     var iosElem = parameter.iosElem?parameter.iosElem:parameter.androidElem; //如果没有传ios的默认使用Android的
     
123.     var elementDesc = parameter.elementDesc;
     
124.     var waitTime = parameter.waitTime?parameter.waitTime:5000;
     
125.     var index = index || 0;
     
126.     var times = times || 1;
     
127.     var type = type || 'up';
     
128.     it('拖拽: 将第 ' + index + ' 个 ' + elementDesc + ' 元素，向' + type + '拖拽' + times + '个自身高度或宽度', function (){
     
129.         if(platformName === 'Android'){
     
130.             return driver.wait(androidElem, waitTime).get(index)
     
131.                         .rect()
     
132.                         .then(_get_element_rect)
     
133.                         .then(function(par){
     
134.                             // console.log(par);
     
135.                             return _swipeElemByType(par, type, times);
     
136.                         });
     
137.         }else{
     
138.             return driver.wait(iosElem, waitTime).get(index)
     
139.                         .rect()
     
140.                         .then(_get_element_rect)
     
141.                         .then(function(par){
     
142.                             // console.log(par);
     
143.                             return _swipeElemByType(par, type, times);
     
144.                         });
     
145.         };
     
146.     });
     
147. };
     
148. 
     
149. 
     
150. /*
     
151. * 在当前页面 对 textAffirm 进行 未显示 断言
     
152. * @param androidElem 安卓对应的元素对象的获取方式 及 值
     
153. * @param iosElem ios对应的元素对象的获取方式 及 值
     
154. * @param elementDesc 控件描述文案
     
155. * @param waitTime 等待元素对象刷新的 等待时间
     
156. * @param textAffirm 断言
     
157. */
     
158. exports.elemCanNotFind = function (textAffirm){
     
159.     it('不存在断言：当前页面不存在文本元素对象 "' + textAffirm + '"', function (){
     
160.         if(platformName === 'Android'){
     
161.             return driver.find('//*[@text="' + textAffirm + '"]')
     
162.                 .should.is.empty;    //判断当前页面没有找到该元素对象
     
163.         }else{
     
164.             return driver.find('//*[@name="' + textAffirm + '"]')
     
165.                 .should.is.empty;
     
166.         };
     
167.     });
     
168. };
     

复制代码

在后边说一些题外话！可以忽略！
开始使用 uiRecorder 录制，是为了 方便学习，后来发现录制完之后，用例显得特别臃肿庞大，
而且大量冗余，不方便工程化，就试着将录制的脚本进行固化、工程化，然后慢慢的就有了下面这些东西；

使用过程中 发现 对 IOS的录制和回放 相对 Android 要慢太多，希望各位大神 持续改进，好跟着喝汤！

所以模型中的东西，虽然是针对Android 和 IOS做方法统一，但实际上大部分只能Android跑通；

当然 我 用这一套的目的，也并不是要用来做 严谨的 业务逻辑UI自动化验证（这一块主要通过接口自动化实
现，已大量覆盖），
主要的目的是做一些：
日常 功能及功能页面巡检（每天定时跑个几次）；
兼容性，就是接上不同的机型 各跑几次；
验证 一些 前端处理的简单逻辑 ；
等等

llq_629

相比于使用java或者python 手动编写的  有什么优势吗