原配置产出的是「在别的系统里跑不起来」的产物,三处一起修:
1. **external 与 globals 对不上**
原来 external 了 funjia-axios 却没有 output.globals 映射,
rollup 自己猜的全局名与宿主挂的 window.axios 不一致,插件静默失效。
现在 external / globals 收口到一张 HOST_GLOBALS 表,只列宿主真正提供的
三个全局:vue / funjiaui / axios。顺带修掉 external 里 'axois' 的拼写错误。
element-plus 改为**不 external**(共享它需要宿主 import * as ElementPlus,
会关掉 tree-shaking 把整个库塞进宿主包),由插件自带。
2. **output.exports 必须是 default**
视图模型是 export default class,宿主直接把它当类用。
用 named(或 rollup 见到 __esModule 时自动选 named)会产出命名空间对象
window.Notice = { default: [class] },表现为「脚本加载成功、控制台无报错、
但表格一列都不出来」的静默失败。
3. **入口/全局名不再手工改配置文件**
新增 scripts/build-vm.mjs,用法 `npm run build:vm Notice`:
由 VIEWMODEL 环境变量驱动 entry 与 lib.name,并对名字做合法性校验、
对入口文件做存在性校验、失败时列出可用的视图模型。
脚本内不走 npx(Windows 上 .bin 符号链接缺失时会报「vite 不是内部或外部命令」),
直接用 process.execPath 跑 vite 的 JS 入口;日志保持纯 ASCII,
避免控制台 GBK 代码页把中文输出变成乱码。
顺带:
- package.json 的 git 依赖 http:// 改 https://(80 端口不可达),
funjiaui 升到 v1.4.0(宿主用的版本,装饰器语义要对齐)
- doc.md 补「怎么用」(链路 / 契约 / 注意事项),下半部分代码解析保留
已验证:npm run build:vm Notice 产出 12.2 KiB 的 IIFE,
在 vm 里执行后 window.Notice 是可实例化的类(含 getList / onAdd / getDetail /
onEdit / delByIds 与 operateWidth / isEdit),放进宿主静态目录后
「通知」「标签」两页正常渲染出表格(分别 6 行 / 10 行真实数据,控制台无报错)。
161 lines
5.4 KiB
TypeScript
161 lines
5.4 KiB
TypeScript
import { defineConfig } from 'vite'
|
|
import vue from '@vitejs/plugin-vue'
|
|
import AutoImport from 'unplugin-auto-import/vite'
|
|
import Components from 'unplugin-vue-components/vite'
|
|
import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
|
|
import ElementPlus from 'unplugin-element-plus/vite'
|
|
import { existsSync } from 'fs'
|
|
import { resolve } from "path";
|
|
|
|
/**
|
|
* 视图模型插件打包配置。
|
|
*
|
|
* ## 这个仓库的产出是什么
|
|
*
|
|
* 每次构建产出**一个视图模型**的 IIFE 脚本,上传到宿主后端的静态目录,
|
|
* 由宿主的 `UmRemoteClass` 在运行时加载 —— 于是新增一张表格页不需要改前端代码。
|
|
*
|
|
* ## 三处与「宿主契约」强绑定的地方,改之前先读宿主项目的 src/common/host.ts
|
|
*
|
|
* 1. **`lib.name` 会成为 IIFE 的全局名。**
|
|
* 宿主取的是 `window[首字母大写的 name]`,所以
|
|
* `lib.name = 'Notice'` 必须对应菜单路由里 `/app/dynamicTable/notice/...` 的 `notice`。
|
|
* 2. **`external` + `output.globals` 必须与宿主挂的全局一致。**
|
|
* 宿主挂的是 `window.vue` / `window.funjiaui` / `window.axios`
|
|
* (前两个由 `installHostRuntime()` 安装)。
|
|
* 历史问题:这里 external 了 `funjia-axios` 却没有 globals 映射,
|
|
* rollup 自己猜的全局名和宿主挂的 `axios` 对不上,插件静默失效。
|
|
* 3. **`element-plus` 不 external**,让插件把它打进产物。
|
|
* 共享它需要宿主 `import * as ElementPlus`,会关掉 tree-shaking、
|
|
* 把整个组件库塞进宿主包,代价不划算。重复一份 element-plus 是无害的;
|
|
* 但 `vue` 绝不能重复 —— 两份 Vue 会破坏响应式与实例识别。
|
|
*
|
|
* ## 用法
|
|
*
|
|
* ```bash
|
|
* # 构建 Notice.ts(产出 dist/Notice.iife.js,上传这个文件)
|
|
* npm run build:vm Notice
|
|
*
|
|
* # 或者用环境变量
|
|
* VIEWMODEL=Tag npm run build:vm
|
|
* ```
|
|
*/
|
|
|
|
const NAME = process.env.VIEWMODEL || process.env.VIEWMODEL_ENTRY || 'Magnet'
|
|
|
|
if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(NAME)) {
|
|
throw new Error(
|
|
`视图模型名不合法: "${NAME}"。\n` +
|
|
`它会成为 IIFE 的全局名(lib.name),必须是合法的 JS 标识符:\n` +
|
|
`以字母 / _ / $ 开头,其后只含字母、数字、_、$。`
|
|
)
|
|
}
|
|
|
|
const ENTRY = `./src/${NAME}.ts`
|
|
|
|
if (!existsSync(resolve(__dirname, ENTRY))) {
|
|
throw new Error(
|
|
`找不到入口文件: ${ENTRY}\n` +
|
|
`视图模型请放在 src/<名字>.ts,且名字与要构建的视图模型一致。\n` +
|
|
`当前 src/ 下已有的视图模型:见 src/ 目录下的 *.ts`
|
|
)
|
|
}
|
|
|
|
/**
|
|
* external → 全局名映射。**这份表要与宿主 src/common/host.ts 的 PLUGIN_GLOBALS 保持一致。**
|
|
*/
|
|
const HOST_GLOBALS: Record<string, string> = {
|
|
vue: 'vue', // 宿主 window.vue
|
|
funjiaui: 'funjiaui', // 宿主 window.funjiaui
|
|
'funjia-axios': 'axios', // 宿主 window.axios(带鉴权与解包拦截器)
|
|
}
|
|
|
|
export default defineConfig({
|
|
plugins: [vue(),
|
|
AutoImport({
|
|
resolvers: [ElementPlusResolver()],
|
|
}),
|
|
Components({
|
|
resolvers: [ElementPlusResolver()],
|
|
}),
|
|
ElementPlus({
|
|
// options
|
|
})
|
|
],
|
|
server: {
|
|
host: "0.0.0.0",
|
|
proxy: {
|
|
"^/api": {
|
|
target: "http://localhost:4873/",
|
|
changeOrigin: true,
|
|
},
|
|
"^/static": {
|
|
target: "http://localhost:4873/resource/",
|
|
changeOrigin: true,
|
|
},
|
|
"^/set/log/level": {
|
|
target: "http://192.168.1.89:4873/",
|
|
changeOrigin: true,
|
|
},
|
|
"^/cache/image/": {
|
|
target: "http://192.168.1.102:1221/",
|
|
changeOrigin: true,
|
|
},
|
|
"^/get/service/": {
|
|
target: "http://192.168.1.102:1221/",
|
|
changeOrigin: true,
|
|
},
|
|
}
|
|
},
|
|
resolve: {
|
|
alias: {
|
|
"@": resolve(__dirname, "src"),
|
|
},
|
|
},
|
|
build: {
|
|
cssCodeSplit: true,
|
|
sourcemap: false,
|
|
target: 'modules',
|
|
chunkSizeWarningLimit: 550,
|
|
assetsInlineLimit: 4096,
|
|
minify: 'terser',
|
|
// 产出目录固定 dist,文件名带上视图模型名,上传时不容易拿错
|
|
outDir: 'dist',
|
|
emptyOutDir: false,
|
|
lib: {
|
|
// 入口与全局名都由 VIEWMODEL 决定,不再手工改这个文件
|
|
entry: ENTRY,
|
|
name: NAME,
|
|
formats: ['es', 'iife'],
|
|
fileName: (format) => (format === 'iife' ? `${NAME}.iife.js` : `${NAME}.es.js`),
|
|
},
|
|
rollupOptions: {
|
|
external: Object.keys(HOST_GLOBALS),
|
|
output: {
|
|
globals: HOST_GLOBALS,
|
|
/**
|
|
* ⚠️ 必须是 `default`,不能是 `named`,也不能省。
|
|
*
|
|
* 视图模型是 `export default class Xxx`,宿主取的是 `window[Xxx]`
|
|
* 并**直接当作配置类**交给 UmByClassEnhance。
|
|
*
|
|
* 若用 `named`(或 rollup 在存在 __esModule 标记时自动选 named),
|
|
* 产物会变成 `window.Notice = { default: [class Notice] }` —— 一个命名空间对象。
|
|
* 宿主拿到它之后:脚本加载「成功」、控制台没有报错、但表格**渲染不出任何列**,
|
|
* 是最难查的一类静默失败。
|
|
*
|
|
* 代价:视图模型只能有 default 导出。若某个视图模型需要具名导出,
|
|
* 构建会明确报错,别为了绕过它改回 named。
|
|
*/
|
|
exports: 'default',
|
|
}
|
|
},
|
|
terserOptions: {
|
|
compress: {
|
|
drop_console: true,
|
|
drop_debugger: true
|
|
}
|
|
}
|
|
}
|
|
})
|