# 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

- npm i
- npm run h5_for_production

## 构建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

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