dros

src文件夹说明

/API 定义和后端交互的API

内部按模块分组，按模块建文件夹，比如API/patient 表示和patient模块相关的API

构建说明

在linux arm64下执行h5类型构建

依次执行以下命令：

• npm i
• npm run h5_for_production

构建Windows平台的Electron应用程序分发包

• npm i
• npm run pack:win

构建linux平台的Electron应用程序分发包[arm64]

• npm i

• npm run pack:linux

构建 H5 Production

根据部署环境选择对应的构建命令：

浏览器环境（Web 服务器部署）

适用于 Nginx 反向代理部署场景：

npm i
npm run h5:browser

• API URL: 空字符串（由 Nginx 代理处理）
• MQTT URL: /mqtt（相对路径）

Electron 环境（桌面应用）

适用于 Electron 桌面应用场景：

npm i
npm run h5:electron

• API URL: http://localhost:6001
• MQTT URL: ws://localhost:8083/mqtt

提示：两个命令都支持通过环境变量 TARO_API_URL 和 TARO_MQTT_URL 覆盖默认配置

构建android平台的应用包[Hybrid]

• npm i
• npm run h5_for_production
• npm run build:android

环境要求：

• 已经安装了android studio，包括cmd-tools
• 连网。因为在执行 npm run build:android 命令时会从网拉取android项目模板

从模拟器启动打包后的apk：

• 启动虚拟设备。使用android studio或者通过命令行创建与启动设备
• 命令 “ adb devices ”查看设备是否已经创建

• 执行安装命令：

  adb install -r -t .build\dros\platforms\android\app\build\outputs\apk\debug\app-debug.apk
  

• 执行启动命令

  adb shell am start -n zskk.dros/.MainActivity
  

注意

1. gradle和java jvm版本匹配
2. Cordova 和 build-tools版本匹配

相关工具的推荐版本：

• gradle 9.0
• jvm 17+
• build-tools;35.0.0
• Cordova Android 14.0.1

pkg打包

命令：

npm run pkg

开发环境

启动 MSW（本地模拟接口）

修改.env.development中变量USE_MSW的值为true，然后执行npm run dev:h5命令

多语言文件处理

提取纯 JSON 格式的多语言文件

目的：将 src/assets/i18n/messages/*.js 文件转换为纯 JSON 格式，移除 JavaScript 语法（export default 和结尾的 ;），方便用于其他用途（如后端API、文档生成等）。

使用方法：

node scripts/extract-i18n-json.js

输出文件：

• scripts/output/i18n/zh.js - 中文翻译（纯JSON格式，.js扩展名）
• scripts/output/i18n/en.js - 英文翻译（纯JSON格式，.js扩展名）

注意：每次修改 src/assets/i18n/messages/*.js 后，可运行此脚本重新生成最新的 JSON 文件。

测试

e2e

启动

构建用于e2e的静态资源文件

• node .build/h5_for_local_e2e.js

然后执行测试命令：

• npx cypress open --e2e

最后人工选择要执行的用例

Monkey Testing 使用说明

启动方式

1. 启动时开启开发者菜单

通过启动参数启用开发者菜单，菜单中包含Monkey Testing相关功能：

# 开发环境
npm run start:electron -- --enable-dev-menu

# 生产环境（已打包的应用）
zsis.exe --enable-dev-menu
dros.exe --enable-dev-menu

参数说明：

• --enable-dev-menu : 启用开发者菜单，包含Monkey Testing启动选项
• --enable-dev-tools : 启动时自动打开开发者工具（可选）

2. 从菜单启动Monkey Test

启用开发者菜单后，在应用菜单栏的 View → Start Monkey Test 中启动：

1. 启动应用时添加 --enable-dev-menu 参数
2. 在菜单中选择 View → Start Monkey Test
3. 在弹出的参数输入窗口中设置：
   • Interval (ms): 操作间隔时间，默认1000ms
   • Duration (ms): 测试持续时间，默认30000ms (30秒)
   • Max Operations: 最大操作次数，默认30次
4. 点击 Start Test 开始测试

测试期间功能

菜单自动隐藏

• 测试启动后，应用菜单栏会自动隐藏，避免干扰测试
• 使用快捷键 Ctrl+Alt+M 可以临时显示菜单
• 菜单会在5秒后自动隐藏

停止测试

测试会根据设置的持续时间或操作次数自动停止，也可以：

• 再次按 Ctrl+Alt+M 显示菜单
• 手动停止测试（需要添加停止功能）

参数说明

参数	说明	默认值	单位
Interval	每次操作的时间间隔	100	毫秒
Duration	测试总持续时间	2147483646	毫秒
Max Operations	最大操作次数限制	600000	次

操作类型

Monkey Test 会随机执行以下操作：

• 鼠标移动到随机位置
• 鼠标左键点击
• 鼠标双击
• 鼠标右键点击
• 键盘按键输入（a、b、c、Enter、Space、Tab）

安全说明

• 所有操作仅限于应用窗口内部
• 自动避开窗口边缘50像素的安全区域
• 支持运行时动态启动和停止
• 测试期间菜单隐藏，但可通过快捷键访问

快捷键汇总

• Ctrl+Alt+M: 测试期间临时显示/隐藏菜单
• F12: 切换开发者工具（如果启用）