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版本匹配

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: 切换开发者工具（如果启用）

README.md 5.2 KB Verlauf Originalformat