微信小程序UI自动化测试实践：Minium+PageObject

青旅半醒 2023-10-15 12:43 54阅读 0赞

![73ebd0c923e4482294954fe0cff117b7.png][]

小程序架构上分为**渲染层**和**逻辑层**，尽管各平台的运行环境十分相似，但是还是有些许的区别（如下图），比如说JavaScript 语法和 API 支持不一致，WXSS 渲染表现也有不同，所以不论是手工测试，还是UI自动化测试，都必须要在 iOS 和 Android 上分别检查小程序的真实表现。

![图片][1805cc681e1eb759e006ae1caabb4c00.png]

由于**生态方面**的原因，目前可选择的小程序UI自动化框架较少。在框架选取过程中，我考察了Appium、Airtest和Minium三个框架，并将三者做了对比，形成了以下图表：

![图片][f40caa64ef443d19d8854f644e64f7d6.png]

Appium实现微信小程序自动化测试的手段基本上还是套用针对 Hybrid App 的测试方案，**通过定位H5 App资源控件，并结合屏幕坐标的方式来操控小程序的页面元素；**网易推出的Airtest则是基于图像识别和Poco控件识别，之前也对此框架做过比较深入的了解，但是和Appium一样，对于小程序自动化测试来说，以上两者无法深入小程序逻辑层，只能作用于渲染层，从另外一个角度来说，这两个框架还**属于黑盒自动化测试的范畴。**

### **01 Minium** ###

接下来再介绍一下今天的主角：**Minium**。它是微信小程序官方推出自动化框架，提供了 Python3 和 JavaScript 版本（后者目前已停止维护，后文中的minium单指Python版本），目前最新的版本为1.0.0b2。minium**不仅限于 UI 自动化，它还提供了很多有用的特性，**比如说支持调用和 Mock 部分 wx 对象上的接口，支持获取和设置小程序页面数据，支持直接触发小程序元素绑定事件等等。

另外，**minium提供一个基于unittest封装好的测试框架，**利用这个简单的框架对小程序测试也可以起到事半功倍的效果。有了以上功能，不但可以简化用例的一些前期准备工作，更可以对小程序做更针对和更全面的测试。

minium的下载安装和官方文档，可以在代码库查看。官方文档写的还算较为清晰，除此之外，以下网站在学习过程中也有帮助：

*  **微信开放社区**: 一些minium使用方面的问题，可以在右上角搜索 "minium" 寻找答案或发起提问；
 *  **微信开发者工具**: minium与微信开发者工具强关联，开发调试脚本都需要使用微信开发者工具；
 *  **Minium Demo:** 官方提供的python版本的demo，内容非常简单，可以用来简单熟悉一下框架，若要运行demo需要先下载示例小程序代码；

### **02 Minium + Page Object** ###

早期 GUI 自动化测试脚本，无论是Selenium还是UFT，脚本通常是由一系列的页面控件的顺序操作组成的，有点像操作级别的“流水账”，**这主要体现在以下几个方面：**

*  脚本逻辑层次不够清晰，属于 All-in-one 的风格，既有页面元素的定位查找，又有对元素的操作；
 *  脚本的可读性差，在实际项目中，很难从代码中直观看出到底脚本在操作哪个控件，并且脚本的每一行都直接描述各个页面上的元素操作，无法直观的看出脚本更高层的业务测试流程；
 *  通用步骤会在大量测试脚本中重复出现；

Page Object 就是为了解决以上问题而出现的，它是UI自动化测试项目开发实践的最佳设计模式，**采用分层封装的设计思想，不同层关心不同的问题。**页面对象层只关心元素定位问题，测试用例只关心测试的数据。通过对界面元素和功能模块的封装减少冗余代码，在后期维护中，若元素定位或功能模块发生变化，只需要调整页面元素或功能模块封装的代码，**显著提高测试用例的可维护性。**

基于PO模式，小程序UI自动化测试Demo项目的目录结构及说明**如下：**

![图片][ac8f346ab7a39e4d17456ac91de7f089.png]

*  cases/： 存放业务测试用例；
 *  outputs/： Minium测试报告；
 *  pages/：页面对象模型；
 *  \*config.json：Minium项目配置文件；
 *  suite.json：Minium测试计划文件；
 *  route.py：统一存放小程序页面路由；
 *  utils.py：存放一些公共方法；

### **03 具体代码** ###

下面从具体代码入手，简单讲述一下项目的设计思路。

首先是BasePage，它是页面模型基类，用于封装所有页面公用的方法。

import abc
    
    import time
    
    
    
    class BasePage(abc.ABC):
    
        def __init__(self, mini, route, title=""):
             self.mini = mini
             self.route = route
             self.title = title 
      
      def open(self):
           """跳转到小程序目标页面"""
            self._open(self.route, self.title, open_type='redirect')
    
        def check_element(self):
            """页面元素审查
            在子类中实现此方法时，建议使用Minium框架中提供的断言方法，原因如下：
            调用 Minium 框架提供的断言方法，会拦截 assert 调用，记录运行时数据和截图，自动在测试报告
            中生成截图 (需要在配置文件中将 assert_capture 设置为True)
            但是如果直接assert或使用unittest.TestCase提供的断言，当断言失败时，无法自动生成截图
            """
            raise NotImplementedError    def on_page(self, route,title=None, wait_util_page_contain_keys: list = None):
            """通过对title和route断言，校验跳转进入的当前页是否符合预期"""
            if wait_util_page_contain_keysis not None and isinstance(wait_util_page_contain_keys, list):
                self.mini.page.wait_data_contains(wait_util_page_contain_keys)
            else:
                time.sleep(2)
    
            self.mini.assertEqual(self.current_route, route,
                                  msg="页面路由不匹配, 预期:{},实际:{}".format(route, self.current_route))
            if title:
                self.mini.assertEqual(self.current_title, title,
                                      msg="页面标题不匹配, 预期:{},实际:{}".format(title, self.current_title))
    
         @property
         def current_title(self) -> str:
            """获取当前页面 head title, 具体项目具体分析,以下代码仅用于演示"""
            return self.mini.page.get_element("XXXXXX").inner_text
    
         @property
         def current_route(self) -> str:
            """获取当前页面route, 具体项目具体分析, 以下代码仅用于演示"""
            return self.mini.app.get_current_page().path     
    
    def _open(self, route, title, open_type=None):
            """
            小程序页面跳转可以使用以下三个方法, 一些区别如下：
            1.`navigate_to`: 此方法会保留当前页面，并跳转到应用内的某个页面(不能跳到tabbar页面). 小程序中页面栈最多十层, 如果超过十层时，再使用此方法
            跳转页面, 会抛出以下异常：`minium.framework.exception.MiniAppError: webview count limit exceed`. 因此需要在运行用例后及时清除页面栈;
            2. `redirect_to`: 关闭当前页面，重定向到应用内的某个页面，使用此方法跳转页面时，会替换页面栈，因此页面栈不会超限，但是也导致不支持页面回退;
            3. `relaunch`: 关闭所有页面，清空页面栈，打开到应用内的某个页面;
            """
            open_type = 'redirect' if open_type is None else open_type       if open_type.lower() == "navigate":
                self.mini.app.navigate_to(route)
            elif open_type.lower() == "redirect":
                self.mini.app.redirect_to(route)
            else:
                self.mini.app.relaunch(route)
    
            self.on_page(route, title)

具体业务的页面模型对象都需要继承BasePage，**以IndexPage为例，代码如下所示：**

from pages.BasePage import BasePage
    
    from route import XXXXX
    
    
    
    class IndexPage(BasePage):
    
        locators = {
            "AAA": "view#aaa",  
            "BBB": "view.bbb>image"
        }
    
        def check_element(self):
            self.mini.assertTrue(self.mini.page.element_is_exists(IndexPage.locators['AAA']) is True)
            self.mini.assertTrue(self.mini.page.element_is_exists(IndexPage.locators['BBB']) is True)
    
        def click_query_btn(self):
            self.mini.page.get_element("view", inner_text="xxxx").click()
            self.on_page(route=XXXXX.XXXX.route, title=XXXXX.XXXX.title)

BaseEntity为测试用例基类，用于统一设置用例准备和清理工作，所有项目的测试用例都继承此类：

from pathlib import Path
    
    import minium
    
    
    
    class BaseEntity(minium.MiniTest):
    
        """测试用例基类"""
        @classmethod
        def setUpClass(cls):
             super(BaseEntity, cls).setUpClass()
             output_dir = Path(cls.CONFIG.outputs)
             if not output_dir.is_dir():
                 output_dir.mkdir()
    
        @classmethod
        def tearDownClass(cls):
            super(BaseEntity, cls).tearDownClass()
            cls.app.go_home()
    
        def setUp(self):
            super(BaseEntity, self).setUp()
    
        def tearDown(self):
            super(BaseEntity, self).tearDown()

cases.Moudle\_1.index\_test.IndexTest**代码内容如下：**

from cases import BaseEntity
    
    from pages.Moudle_1.IndexPage import IndexPage
    
    from route import XXXXX
    
    
    
    class ParkIndexTest(BaseEntity):
    
        def test_index_page(self):
             index_page = IndexPage(self, XXXXX.INDEX.route, XXXXX.INDEX.title)
             index_page.open()
             index_page.check_element()
             index_page.click_query_btn()

**总结：**

*  **优点：**PO模式对页面界面交互细节进行了封装，而测试用例基于页面对象完成具体操作，这样可以使我们的自动化测试脚本案例更关注业务，而非界面细节，**提高了测试案例的可读性。**
 *  **缺点**（个人观点）：开发和维护页面对象的类（Page Class），是一件很耗费时间和体力的事儿。
    
    待研究方案：小程序页面对象自动生成，不用再手工维护 Page Class ，只需要提供页面路由，就会自动生成这个页面上控件的定位信息，并自动生成 Page Class；

**最后：**下方这份完整的软件测试视频教程已经整理上传完成，需要的朋友们可以自行领取**【保100%免费】**

![8b0171187dce405e878f274a8cdd9ec0.png][]

#### **软件测试面试文档** ####

我们学习必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有字节大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。

![a3e4226c935c4242804cbdf26b571bc6.png][]

![58df6cd288094ad8874e814f2477620b.gif][]

[73ebd0c923e4482294954fe0cff117b7.png]: https://img-blog.csdnimg.cn/73ebd0c923e4482294954fe0cff117b7.png
[1805cc681e1eb759e006ae1caabb4c00.png]: https://img-blog.csdnimg.cn/img_convert/1805cc681e1eb759e006ae1caabb4c00.png
[f40caa64ef443d19d8854f644e64f7d6.png]: https://img-blog.csdnimg.cn/img_convert/f40caa64ef443d19d8854f644e64f7d6.png
[ac8f346ab7a39e4d17456ac91de7f089.png]: https://img-blog.csdnimg.cn/img_convert/ac8f346ab7a39e4d17456ac91de7f089.png
[8b0171187dce405e878f274a8cdd9ec0.png]: https://img-blog.csdnimg.cn/8b0171187dce405e878f274a8cdd9ec0.png
[a3e4226c935c4242804cbdf26b571bc6.png]: https://img-blog.csdnimg.cn/a3e4226c935c4242804cbdf26b571bc6.png
[58df6cd288094ad8874e814f2477620b.gif]: https://img-blog.csdnimg.cn/58df6cd288094ad8874e814f2477620b.gif