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

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

README.md 2.9 KB Історія Запис