微信小程序自动化测试—自定义测试（Minium）

测试秃头怪

已于 2024-05-16 16:36:16 修改

阅读量1.8k

点赞数 19

文章标签： python 软件测试自动化测试职场和发展测试用例测试工具单元测试

于 2024-05-16 16:34:46 首次发布

本文链接：https://blog.csdn.net/huace3852/article/details/138966737

版权

🍅 视频学习：文末有免费的配套视频可观看

🍅 点击文末小卡片 ，免费获取软件测试全套资料，资料在手，涨薪更快

录制回放支持输入，文本查找，断言等自动化测试基础操作，无需编写代码，用例生成效率高，但是部分操作不支持，对复杂业务场景有局限性。如果用户希望适用复杂的业务场景，自主制定测试场景，可以尝试自定义测试（Minium）方案。

小程序测试框架 Minium 是微信测试团队为小程序开发或测试同学提供的一套测试接口，它实现了miniprogram-automator 中小程序自动化所有能力，如可以直接触发小程序页面元素，设置页面数据，向AppService注入代码片段，Mock/Hook wx对象的接口等。此外，他还支持并封装了所有的原生操作都进行了封装，屏蔽了iOS/Android底层差异，实现了一套脚本在三端同时运行。

用户写好的Minium脚本，可以再本地执行，也可以直接上传到微信小程序云测服务执行，无需准备和维护真机环境。

一、编写用例

编写小程序自动化测试脚本，常见操作包括：

基本操作：如页面跳转，元素定位及相关操作
处理小程序API
处理小程序的原生控件，如处理授权弹窗
支持数据驱动测试

基本操作

对小程序页面元素定位，元素操作，或页面跳转等。简单的UI测试，例如以下用例

class FirstTest(minium.MiniTest):    
      def test_network(self):
          # 页面跳转
          self.app.navigate_to("/packageAPI/pages/get-network-type/get-network-type")
          # 元素定位
          ele = self.page.get_element("button", inner_text="获取手机网络状态")
          # 元素点击
          ele.click()
          # 打印元素文本
          self.logger.info(self.page.get_element("/page/view/view[2]/view/view[1]/text").inner_text)

处理小程序API

Minium框架提供处理小程序开放API方法，根据需求选择相应方法，例如

mock_wx_method() — mock掉小程序API的调用
hook_wx_method() — hook小程序API的调用
call_wx_method() — 调用小程序的API
…

更多接口方法参考 Minium接口

调用小程序API获取回调信息用例，例如

class FirstTest(minium.MiniTest): 
    def test_call_wx_method(self):
        """
        调用小程序API，获取回调对象
        :return:
        """
        sys_info = self.app.call_wx_method("getSystemInfo").get("result", {}).get("result")
        self.assertIsInstance(sys_info, dict, "is dict")
        self.assertTrue(True if sys_info else False, "not empty")

处理小程序原生控件

Minium提供了针对小程序内涉及原生控件(授权弹窗、弹窗、地图、分享小程序等)的操作封装
注意：部分封装的接口暂不支持IDE平台调用。若跑测平台是IDE，则需要在config.json中配置mock_native_modal配置项，后通过mock的方式实现

处理模态弹窗用例示例如下

class FirstTest(minium.MiniTest): 
        def test_native(self):
              self.mini.clear_auth()
              self.app.redirect_to("/pages/testnative/testnative")
              called = threading.Semaphore(0)
              callback_args = None

              def callback(args):
                  nonlocal callback_args
                  called.release()
                  callback_args = args

             # hook showModal方法，获取回调后执行callback
             self.app.hook_wx_method("showModal", callback=callback)
             self.page.get_element("#testModal").tap()
             time.sleep(2)
             # 点击弹窗 确定
             self.native.handle_modal("确定")
             is_called = called.acquire(timeout=10)
             # 释放hook showModal方法
             self.app.release_hook_wx_method("showModal")
             self.assertTrue(is_called, "callback called")
             self.assertDictContainsSubset( {"errMsg": "showModal:ok", "cancel": False, "confirm": True}, callback_args[0])

跑测平台IDE，config.json 配置 mock_native_modal 示例如下

"mock_native_modal": {
    "showModal": {
      "title": "test modal",
      "content": "modal content"
    },
  }

数据驱动

自动化测试往往需多组数据测试，若采用录制回放测试，则需录制多个用例，不够灵活，所以若需测试同一个用例不同组测试数据，可使用**数据驱动（DDT）**模式，实现测试数据与测试脚本的分离，通过DDT将测试数据加载到脚本中。

数据驱动（DDT）有以下优点：

灵活配置
测试数据与功能代码分开
易维护

下面是我们集成数据驱动测试(基于ddt封装)的例子

@minium.ddt_class
class BaseTest(minium.MiniTest):

    @minium.ddt_case([], ["1", "2"])
    def test_evaluate_sync(self, args):
        """
        向 app Service 层注入代码 同步返回结果
        :param args:
        :return:
        """
        # 参数 args: []   args: ["1", "2"]
        result = self.app.evaluate(
            "function(...args){return `test evaluate: ${args}`}", args, sync=True
        )
        self.assertEqual(
            result.get("result", {}).get("result"), "test evaluate: {}".format(",".join(args))
        )

此外，还能给具体的 test data 命名，自定义命名会体现在测试方法名中。数据驱动详情可参考测试流程控制 & 数据驱动测试

二、执行用例

开发者编写完 Python 用例脚本后，可本地调试，也可在云测上测试。

本地执行

开发者将编写好的用例进行本地调试，minitest命令加载用例，初始化环境，开启自动化能力，进行环境检查，后执行用例。需IDE依赖，支持USB真机调试。

在初始化环境过程中遇到常见问题如下：

开发者工具没有自动打开，先排查开发者工具自动化能力，进行环境检查
配置了真机环境但无法拉起真机上的小程序，排查是否使用了真机调试2.0，如果是，切换回真机调试1.0
报错traceback中有出现 _miniClassSetUp 的调用，确认下开发者工具上选用的基础库是最新的：开发者工具项目窗口右上角 -> 详情 -> 本地设置 -> 调试基础库

Minium为了保证同一套代码在IDE，Android，IOS上运行，环境组成比较复杂，所以测试用例的运行依赖于配置文件。支持配置运行平台、IDE监听端口号、连接手机的参数、账号信息、自动处理授权弹窗等等，可参考项目配置

执行完用例后，会生成日志文件，提供本地测试报告，包括截图、运行日志、错误日志。具体实践可参考示例