更新记录

4.2.0（2025-10-27） 下载此版本

• 新增 扩展HBuilderX cli uni测试 web用法。示例: cli uniapp.test web --project <ProjectPath> --browser chrome
• 调整 uni-app 测试依赖安装提示语（主要为playwright提示）
• 调整 uni-app 设置测试报告默认输出路径

4.1.0（2025-10-16） 下载此版本

• 调整 cli uniapp.test 选项，调整后:
  • 运行到Android: cli uniapp.test app-android --project <project_path>
  • 运行到Harmony: cli uniapp.test app-harmony --project <project_path>
  • 运行到iOS: cli uniapp.test app-ios-simulator --project <project_path>
  • 运行到微信: cli uniapp.test mp-wexin --project <project_path>
  • 运行到Chrome: cli uniapp.test web-chrome --project <project_path>
  • 运行到Safari: cli uniapp.test web-safari --project <project_path>
  • 运行到Firefox: cli uniapp.test web-firefox --project <project_path>
• 新增 HBuilderX cli uniapp.test，增加参数 --device_id, 用于指定android、ios、鸿蒙测试设备ID。cli uniapp.test app-android --project <project_path> --device_id <uuid>
• 新增 HBuilderX cli uniapp.test，增加参数 --testcaseFile, 用于指定测试用例文件路径。cli uniapp.test app-android --project <project_path> --testcaseFile <testcaseFile>

4.0.0（2025-10-15） 下载此版本

• 新增 HBuilderX cli支持运行uni-app (x) 自动化测试. cli uniapp.test --project <project_path> --platform <platfome_name>

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

完整文档教程

hbuilderx-for-uniapp-test

本插件，用于在HBuilderX内运行uni-app自动化测试。

主要功能有：

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

测试注意事项

1. 本插件支持uni-app普通项目和uniapp-cli项目。uniapp-cli项目，运行自动化测试，需要在当前项目下安装自动化测试依赖。
2. Windows电脑不支持运行测试到ios手机。
3. MacOSX电脑，仅支持运行测试到ios模拟器，不支持ios真机。
4. 运行测试到H5，仅支持chrome浏览器，不支持其它浏览器。
5. 运行测试到Android手机，如果HBuilderX仅检测到一个Android设备，直接运行测试到当前已连接设备。多个设备时，会弹窗要求选择手机。