mirror of
https://gitee.com/niucloud-team/niucloud.git
synced 2026-08-01 20:15:49 +00:00
164 lines
4.2 KiB
Markdown
164 lines
4.2 KiB
Markdown
# Niucloud-Admin V2.0 Beta 公测文档
|
||
|
||
## 一、公测项目
|
||
|
||
SaaS框架V2版本及插件
|
||
|
||
## 二、公测背景
|
||
|
||
V1版本中，插件安装后采用动态组合源码方式，需要进行一次编译后才能正常访问。由于插件的差异化可能导致编译失败，影响稳定性。
|
||
|
||
V2版本引入了**分离构建**机制：
|
||
|
||
- **admin/uni-app端** 分为 **框架编译** 和 **插件编译** 两部分
|
||
- 框架中初始内置框架编译后的源码
|
||
- 插件安装时，将插件的编译文件直接放到对应目录下：
|
||
- `public/admin/asset/addons`（Admin端）
|
||
- `public/wap/asset/addons`（WAP端）
|
||
- **无需进行编译即可正常访问**，大幅提升插件安装的稳定性和便捷性
|
||
|
||
## 三、编译命令
|
||
|
||
### 3.1 Admin 目录
|
||
|
||
| 命令 | 说明 |
|
||
|------|------|
|
||
| `npm run dev` | 项目运行（开发模式） |
|
||
| `npm run build` | 全部打包 |
|
||
| `npm run build:core` | 框架打包 |
|
||
| `npm run build:addon {插件key}` | 指定插件打包 |
|
||
|
||
### 3.2 Uni-app 目录
|
||
|
||
| 命令 | 说明 |
|
||
|------|------|
|
||
| `npm run dev:h5` | H5项目运行（开发模式） |
|
||
| `npm run build:h5` | H5全部打包 |
|
||
| `npm run build:h5:core` | H5框架打包 |
|
||
| `npm run build:h5:addon {插件key}` | H5指定插件打包 |
|
||
| `npm run build:mp-weixin` | 微信小程序全部打包 |
|
||
| `npm run build:mp-weixin:core` | 微信小程序框架打包 |
|
||
| `npm run build:mp-weixin:addon {插件key}` | 微信小程序指定插件打包 |
|
||
|
||
## 四、测试流程
|
||
|
||
### 第一步：安装框架
|
||
|
||
1. 部署并安装 niucloud-admin V2.0 Beta 框架
|
||
2. 确认框架基础功能正常运行
|
||
|
||
### 第二步：安装插件
|
||
|
||
1. 将插件放到 `niucloud/addon/` 目录下
|
||
2. 修改插件 `info.json` 文件，将 `support_version` 的值改为 `2.0.0`
|
||
3. 在管理后台执行插件安装操作
|
||
|
||
### 第三步：开发模式验证
|
||
|
||
1. 插件安装完成后，分别进入 **admin** 和 **uni-app** 目录
|
||
2. 安装依赖：
|
||
```bash
|
||
# admin 目录
|
||
npm install
|
||
|
||
# uni-app 目录
|
||
npm install
|
||
```
|
||
3. 运行项目，检测开发模式：
|
||
```bash
|
||
# admin 端
|
||
npm run dev
|
||
|
||
# uni-app H5 端
|
||
npm run dev:h5
|
||
```
|
||
4. 检查确认开发模式下插件各功能是否正常运行，有无报错或异常
|
||
|
||
### 第四步：编译插件
|
||
|
||
开发模式验证通过后，对插件进行编译，需要编译三个端口：
|
||
|
||
#### 4.1 Admin 端编译
|
||
|
||
```bash
|
||
npm run build:addon {插件key}
|
||
```
|
||
|
||
#### 4.2 Uni-app H5 端编译
|
||
|
||
```bash
|
||
npm run build:h5:addon {插件key}
|
||
```
|
||
|
||
#### 4.3 Uni-app 微信小程序端编译
|
||
|
||
```bash
|
||
npm run build:mp-weixin:addon {插件key}
|
||
```
|
||
|
||
> **编译问题处理：**
|
||
> - **代码问题**：自行调整修复
|
||
> - **框架兼容问题**：联系官方或发送邮件至 `2513189129@qq.com`
|
||
|
||
### 第五步：产品模式验证
|
||
|
||
1. 三个端口全部编译完成后，进入 **Admin端 → 开发 → 插件列表**
|
||
2. 点击 **插件打包** 按钮，完成插件打包
|
||
3. 打包完成后，**卸载插件**，然后**重新安装插件**
|
||
4. 在产品模式下验证插件各个端口功能是否正常，包括：
|
||
- Admin 管理端功能
|
||
- WAP/H5 端功能
|
||
- 微信小程序端功能
|
||
|
||
## 五、测试检查清单
|
||
|
||
### 框架基础功能
|
||
|
||
- [ ] 框架安装成功
|
||
- [ ] Admin 端正常运行
|
||
- [ ] Uni-app H5 端正常运行
|
||
- [ ] 微信小程序端正常运行
|
||
|
||
### 插件安装
|
||
|
||
- [ ] 插件 `info.json` 中 `support_version` 已修改为 `2.0.0`
|
||
- [ ] 插件安装成功，无报错
|
||
|
||
### 开发模式
|
||
|
||
- [ ] Admin 端插件功能正常
|
||
- [ ] Uni-app H5 端插件功能正常
|
||
- [ ] 微信小程序端插件功能正常
|
||
|
||
### 编译
|
||
|
||
- [ ] Admin 端插件编译成功
|
||
- [ ] Uni-app H5 端插件编译成功
|
||
- [ ] 微信小程序端插件编译成功
|
||
|
||
### 产品模式
|
||
|
||
- [ ] 插件打包成功
|
||
- [ ] 卸载重装后 Admin 端功能正常
|
||
- [ ] 卸载重装后 WAP/H5 端功能正常
|
||
- [ ] 卸载重装后微信小程序端功能正常
|
||
|
||
## 六、问题反馈
|
||
|
||
| 问题类型 | 处理方式 |
|
||
|----------|----------|
|
||
| 插件代码问题 | 自行调整修复 |
|
||
| 框架兼容问题 | 联系官方或发送邮件至 `2513189129@qq.com` |
|
||
|
||
### 反馈模板
|
||
|
||
```
|
||
插件名称：
|
||
插件版本：
|
||
问题类型：[代码问题 / 框架兼容问题]
|
||
问题端口：[Admin / H5 / 微信小程序]
|
||
问题描述：
|
||
复现步骤：
|
||
错误信息/截图：
|
||
```
|