uniapp 自动化测试-插件版

插件说明

该插件，用于在HBuilderX内运行uni-app自动化测试，支持H5、微信小程序、android、ios自动化测试。

主要功能有：

• 初始化测试环境（创建测试配置文件、以及安装测试所需的环境）
• 运行测试 (运行项目下所有测试用例、运行某一个测试用例)
• 新建测试用例 （uni-app pages页面，右键菜单【新建测试用例】）
• 查看历史测试报告 （HBuilderX顶部运行菜单）

测试注意事项

1. 本插件支持uni-app普通项目和uniapp-cli项目。uniapp-cli项目，运行自动化测试，需要在当前项目下安装自动化测试依赖。
2. Windows电脑不支持运行测试到ios手机。
3. MacOSX电脑，仅支持运行测试到iOS模拟器，不支持ios真机，测试iOS模拟器，需要电脑装安装XCode。
4. 运行测试到H5，仅支持chrome浏览器，不支持其它浏览器。
5. 运行测试到Android手机，如果HBuilderX仅检测到一个android设备，直接运行测试到当前已连接设备。多个设备时，会弹窗要求选择手机。
6. node: 当本机未安装node时，将使用HBuilderX内置node运行测试。反之，本机安装了node，则使用本机的node。
7. 运行测试到微信小程序，必须在manifest.json内，配置微信小程序 appid。如果微信开发者工具无法成功打开项目，首次请手动打开。

插件地址

https://ext.dcloud.net.cn/plugin?id=5708

测试环境安装

插件依赖：

• H5、微信、ios、android自动化测试依赖puppeteer、adbkit、node-simctl、jest、playwright，运行插件时，如果未安装此依赖，将会弹窗自动安装。
• 注意：本插件0.0.3版本及以下，node: 当本机未安装node时，将使用HBuilderX内置的node运行测试。反之，本机安装了node，则使用本机的node。
• 注意：本插件0.0.4+版本，新增配置项 支持自定义设置使用何种node版本进行uni-app编译

特别注意：

• uni-app普通项目，需要通过插件hbuilderx-for-uniapp-test来安装测试环境。
• uniapp-cli项目，只需在项目下安装相关测试依赖即可。

uni-app普通项目

uni-app普通项目，初始化测试环境或运行测试时，如果未安装相关依赖，会自动安装。

如下图所示，项目管理器，选中项目，右键菜单【初始化测试环境】

注意：安装环境依赖时，如果检测到项目下不存在测试配置文件 env.js 和jest.config.js，则会自动创建测试配置文件。

uniapp 自动化测试-jest.config.js

uniapp-cli项目

uniapp-cli项目，自动化测试运行，将使用项目下的依赖库。

打开命令行，进入项目目录，输入如下命令进行安装:

npm install --save cross-env puppeteer adbkit node-simctl jest playwright @playwright/test

创建测试用例

测试运行

创建测试用例之后，选中项目，右键菜单【运行uni-app自动化测试】，选择运行平台，即可开始运行测试。

注意：如果要运行指定的测试用例，请在项目管理器选中要运行的用例，右键菜单【运行当前测试用例】