_______ _______ _______ __ __ _______ _______ _______
| _ || || | | |_| || || || _ |
| |_| || _ || _ | | || ___||_ _|| |_| |
| || |_| || |_| | | || |___ | | | |
| || ___|| ___| | || ___| | | | |
| _ || | | | | ||_|| || |___ | | | _ |
|__| |__||___| |___| |_| |_||_______| |___| |__| |__|
基于 SpringBoot3 + VUE3 + Naive UI + Electron 应用快速开发、发布平台，旨在帮助使用者（包含但不限于开发人员、业务人员）快速响应业务需求，此仓库为前端，后端仓库详见app-meta-server。
可前往screenshot查看平台运行时截图。
项目包存放于
packages下
| 包名 | 说明 |
|---|---|
| basic | 基础函数、常量 |
| cli | 以命令行方式与后端进行交互 |
| client | 基于electron的客户端封装 |
| library | 工具库，为ui包、小程序等提供常用功能的一致性调用 |
| server | 开发阶段用于模拟 CAS 登录，基于 fastify |
| ui | 平台前端 |
| 命令 | 说明 |
|---|---|
| serve | 启动ui项目（基于 webpack5、Vue3） |
| build | 构建ui项目（用于部署上线） |
| client:start | 启动client项目（基于 Electron） |
| client:watch | 以热重载方式启动client（文件变动可自动重启进程） |
使用 webpack5 启动，约 45 秒；Rspack(0.3.14) 启动，约 17 秒。
.npmrc文件指定了 electron 下载镜像
2023-11-13起迁移到Rspack，截至0.3.11版本，不支持中文路径😔
| 命令 | 说明 | Rspack |
|---|---|---|
| build | 打包library及ui，约耗时50s |
8s |
| build | 打包cli（命令行工具），约耗时7s |
580ms |
| build:library | 单打打包library，约耗时9s |
1s |
以上统计数据来自设备
| 名称 | 参数 |
|---|---|
| 操作系统 | windows 11 |
| 处理器 | 11th Gen Intel(R) i5-11300H 3.11 GHz |
| 内存 | 16GB |
| node版本 | 20.8.0 |
| webpack版本 | 5.89.0 |
| rspack版本 | 0.3.11 |
## 附录
### 常见问题
#### electron 运行时控制台乱码
在控制台中执行`chcp 65001`，或者使用 `vite` 的 `createLogger` 组件
详见：[PowerShell 中文乱码](https://www.cnblogs.com/lobtao/articles/14421673.html)
### Rspack配置
> 2023年12月起，构建工具迁移至[Rspack](https://www.rspack.dev/)，首次启动速度约 20s，后续重启、打包约 6s（Vite5 启动约 12s，打包约 50s）
1. 请问如何配置 chunk 文件的存放目录
> 类似 vue-cli 的 assetsDir 配置项，如配置值位 `abc`， 达到的效果是将 js、css、img 等放置在 `dist/abc` 目录下
```text
chunkFilename 可以控制异步chunk位置，filename可以控制初始chunk位置
png 等文件可以通过https://webpack.js.org/configuration/module/#rulegeneratorfilename配置
- 引入 echarts
为兼容 Rspack（截至0.4.2），需要全量引入 import * as echarts from 'echarts'，否则在生产环境下会报 echarts 未引入错误
- 仅为个人学习项目