30 lines
1.4 KiB
Markdown
30 lines
1.4 KiB
Markdown
|
# 11. Plugins 系统（library/plugins/*）
|
|||
|
|
|
|||
|
|
> 目标：明确本仓库“全局注入能力/指令/错误处理”的来源，避免抽取组件时漏掉运行时注入。
|
|||
|
|
|
|||
|
|
## 插件目录
|
|||
|
|
|
|||
|
|
- `library/plugins/vab.ts`：全局 gp 注入 + mitt 事件总线（`$pub/$sub/$baseMessage/...`）
|
|||
|
|
- `library/plugins/directive.ts`：自定义指令（`v-permissions`）
|
|||
|
|
- `library/plugins/errorLog.ts`：全局错误捕获（`app.config.errorHandler`）并写入 store
|
|||
|
|
- `library/plugins/support.ts`：构建信息输出与依赖存在性检查
|
|||
|
|
|
|||
|
|
## 安装方式
|
|||
|
|
|
|||
|
|
- 正常路径：`library/index.ts` 会自动加载 `library/plugins/**/*.ts` 并 `app.use()`（setupVab 链路内）
|
|||
|
|
- 抽取到目标项目：
|
|||
|
|
- 若不复用 `library/index.ts` 的自动加载逻辑，需要在入口手动 `app.use(plugin)`
|
|||
|
|
|
|||
|
|
## 最小依赖闭包
|
|||
|
|
|
|||
|
|
- `vab.ts`：依赖 Element Plus 全局 API（ElMessage/ElLoading/ElMessageBox/ElNotification）+ lodash + mitt + `src/config`
|
|||
|
|
- `directive.ts`：依赖 `src/utils/permission`（hasPermission 及其权限数据来源）
|
|||
|
|
- `errorLog.ts`：依赖 `src/store/modules/errorLog` 与 `src/config/errorLog`
|
|||
|
|
- `support.ts`：依赖 `__APP_INFO__` 构建注入
|
|||
|
|
|
|||
|
|
## 验收点（smoke）
|
|||
|
|
|
|||
|
|
- `vab`：`$baseMessage('ok')` 能弹出 message；`$pub/$sub` 能收发事件
|
|||
|
|
- `directive`：模板中 `v-permissions` 不报错且能按权限生效
|
|||
|
|
- `errorLog`：手动触发异常能写入 errorLog store
|