微页面配置文档
官方文档:https://qiankun.umijs.org/
参考Demo:https://github.com/wl-ui/wl-mfe
注:所有文件的相关代码在文档末尾附件提供,将文件类型有txt改为js就可使用
一、[endif]主应用配置
1、安装qiankun2.0
$ yarn add qiankun # 或者 npm i qiankun -S
2、配置主应用main.js,在主应用入口文件main.js写入以下四行代码
a、register.js:利用qiankun2.0框架注册(registerMicroApps)并启动(start)子应用,并开启一些监控及全局错误异常处理。如下图:
b、initGlStore.js:利用qiankun2.0框架提供通信(initGlState)来定义和初始化全局状态字段,然后实现主应用、子应用的通信及通信监听。如下图:
props根据系统业务需要定义需要传入子页面的公共数据,可以包含公共组件、公共方法、主应用路由、http请求等。
3、[endif]如何在主应用的某个路由页面加载微应用
官方文档地址:https://qiankun.umijs.org/zh/faq#如何在主应用的某个路由页面加载微应用
a、必须保证微应用加载时主应用这个路由页面也加载了。
主应用注册这个路由时给path 加一个 *,注意:如果这个路由有其他子路由,需要另外注册一个路由,仍然使用这个组件即可。
const routes = [
{
path: '/portal/*',
name: 'portal',
component: () => import('../views/Portal.vue'),
},
];
b、微应用的activeRule 需要包含主应用的这个路由 path。
registerMicroApps([
{
name: 'app1',
entry: 'http://localhost:8080',
container: '#container',
activeRule: '/portal/app1',
},
]);
c、注意事项:在Portal.vue 这个组件的 mounted 周期调用 start 函数,注意不要重复调用。
import { start } from 'qiankun';
export default {
mounted() {
if (!window.qiankunStarted) {
window.qiankunStarted = true;
start();
}
},
};
二、子应用配置(不需要安装qiankun2.0)
1、在 src 目录新增 public-path.js。如下图:
2、配置子应用入口文件main.js (注:为了避免根id #app 与其他的 DOM 冲突,按需修改)。如下图:
3、打包配置修改(vue.config.js)。如下图:
4、子应用接受主应用的传值
a、在子应用的main.js中调用app-store.js的appStore方法。
b、appStore的具体处理。接受保存供子应用使用
5、微应用打包之后css 中的字体文件和图片加载 404
官方地址:https://qiankun.umijs.org/zh/faq#微应用打包之后css中的字体文件和图片加载 404
选择的是官方第三种方案。如下图:
三、其他一些问题
1、如何同时激活两个微应用?
官网地址:https://qiankun.umijs.org/zh/faq#如何同时激活两个微应用
2、[endif]如何确保主应用跟微应用之间的样式隔离
官网地址:https://qiankun.umijs.org/zh/faq#如何确保主应用跟微应用之间的样式隔离
附件:百度网盘链接
链接:https://pan.baidu.com/s/1xU8zBa4cqXWWkmBYhPWC_A
提取码:oef6
1、主应用register.js
2、主应用initGlStore.js
3、子应用main.js
4、子应用app-store.js
5、子应用public-path.js
6、子应用vue.config.js