# 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 反向代理部署场景：

```bash
npm i
npm run h5:browser
```

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

### Electron 环境（桌面应用）

适用于 Electron 桌面应用场景：

```bash
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、文档生成等）。

**使用方法**：
```bash
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相关功能：

```bash
# 开发环境
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** 中启动：

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