一个微前端框架,用于帮助前端项目进行融合与拆解,适用于大型应用的拆分、插件系统实现、多应用融合场景。
提供webpack插件,满足子应用在开发过程中与宿主应用集成调试的需求。
可以扩展应用接入模式,比如可以用于插件系统实现、动态路由集成,或者是一个完整的前端应用。常用的接入模式支持已通过 @jmodule/helper 提供支持。
支持子应用嵌套,子应用本身也可以是宿主应用,但仍以自应用的方式接入其它宿主应用。
npm install @jmodule/client
# 开发插件安装
npm install @jmodule/plugin-webpack
// 在 webpack 配置中增加
import WebpackJmodulePlugin from '@jmodule/plugin-webpack';
module.exports = {
plugins: [
new WebpackJmodulePlugin({
mode: 'modules',
devConfig: { // 开发联调时配置
currentServer: 'http://localhost:8084', // 子应用 server
platformServer: 'http://platformServer.com', // 主应用 server
platformLocalPort: 8088, // 本地联调端口
onAllServerReady: () => { // 所有服务就绪
console.log('ALL SERVER READY!');
opn('http://localhost:8088');
},
},
}),
];
}
// 在入口文件中添加
JModule.define(moduleKey, { mount() {} })
npm i @jmodule/client
import { JModule } from '@jmodule/client'
JModule.registerModules([
key: 'childApp',
url: 'http://localhost:8080',
]).then(modules => modules.forEach(module => module.load()));
// 通过 afterInit hook 注入子应用路由进行其它操作
JModule.registerHook('afterInit', (module, options) => {
const { routes } = options || {};
router.addRoutes(routes);
});
# 源码项目采用 pnpm 进行管理,需要先安装 pnpm
npm i -g pnpm@6
# Demo 代码位于 packages/demo
# 安装项目依赖
pnpm i
# 构建 client\helper包
pnpm --filter "*client" run build
pnpm --filter "*helper" run build
#### 完整示例
# 启动所有子项目
pnpm --filter "*child*" run serve
# 启动宿主应用并自动加载以上子应用
pnpm --filter "*host*" run serve:modules
#### 单应用调试
# 以纯净模式启动宿主应用(与前面含子应用的启动的示例相区别)
pnpm --filter "@jmodule-demo/host-vue2" run serve
# 启动指定的子应用,并在宿主应用中进行集成调试
pnpm --filter "@jmodule-demo/child-app-react" run serve
查看应用基本信息、资源信息,以及从注册到加载过程的事件触发时间信息。