README.md
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
注意
- gradle和java jvm版本匹配
- 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启动选项 , 如果期望点击 Toggle developer tools菜单项唤出开发者工具面板，需要同时传递启动选项 --enable-dev-tools--enable-dev-tools: 启动时自动打开开发者工具（可选）
2. 从菜单启动Monkey Test
启用开发者菜单后，在应用菜单栏的 View → Start Monkey Test 中启动：
- 启动应用时添加
--enable-dev-menu参数 - 在菜单中选择 View → Start Monkey Test
- 在弹出的参数输入窗口中设置：
- Interval (ms): 操作间隔时间，默认1000ms
- Duration (ms): 测试持续时间，默认30000ms (30秒)
- Max Operations: 最大操作次数，默认30次
- 点击 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: 切换开发者工具（如果启用）