# Hook 客户端打包说明 本文档记录 `Studio-Medical-Client-SCRM-Desktop` 的 Windows 测试环境和线上环境打包方式。 ## 打包前 在 PowerShell 中进入客户端项目目录: ```powershell cd D:\1024\project_med_refactor\Studio-Medical-Client-SCRM-Desktop ``` 打包使用 `package.json` 中的 `version` 字段作为版本号。当前版本为 `2.1.20`。需要发布新的版本时,先更新 `package.json` 和 `package-lock.json` 根项目版本,再执行打包;本地验证可沿用当前版本。 ## 测试环境 ### 免安装目录版(推荐用于测试) ```powershell npm run build:test npx electron-builder --win --dir --config=electron-builder.test.yml ``` ### 安装包 ```powershell npm run build:test:win ``` 测试包配置来自: - 环境构建模式:`test`。 - 测试环境接口地址和定时表达式:`resources/runtime-config.test.json`。 - `electron-builder.test.yml` 会把该文件打入 `resources/unpacked/runtime-config.json`。 - 测试环境当前 `WEL_TIME` 为 `0 30 17 * * *`,客户端每天北京时间 17:30 进入定时任务轮询窗口;群欢迎任务轮询窗口为 10 分钟。 ## 线上环境 ### 免安装目录版 ```powershell npm run build npx electron-builder --win --dir --config=electron-builder.yml ``` ### 安装包 ```powershell npm run build:win ``` 线上包使用 `production` 构建模式。环境配置在 `localServer/config/envConfig.ts` 的 `production` 项中;线上每日北京时间 19:30 进入群欢迎任务轮询窗口,窗口为 30 分钟。生产构建不会附带测试用的 `runtime-config.test.json`。 ## 产物位置 默认输出到 `dist`: - 免安装目录版:`dist\win-unpacked`,运行其中的 `hf-scrm.exe`。 - 测试安装包:`dist\hf-scrm-<版本号>-test-setup.exe`。 - 线上安装包:`dist\hf-scrm-<版本号>-setup.exe`。 重复使用默认输出目录打包时,electron-builder 会重建 `dist\win-unpacked`,并可能覆盖同名安装包。若文件被运行中的客户端占用,可指定新的输出目录,例如: ```powershell npx electron-builder --win --dir --config=electron-builder.test.yml --config.directories.output=dist/portable-test ``` ## 注意 - 测试客户端需要和服务端的测试 Nacos 周期配置匹配;客户端配置正确不代表服务端任务已按小时生成。 - 免安装目录版不是单个 exe。需要保留并分发整个 `win-unpacked` 目录。 - 本文档只说明本地构建,不代表已将包上传、部署或发布。