准备阶段
!!! 因为node版本或者vue-cli版本不同可能造成
1) 主应用抓取不到子应用,报错 “xxx died xxx”
2)初始化项目 , 项目的结构不同导致文章阅读比较麻烦. !!!
1.例子中node版本是 v14.17.0 , node历史版本下载链接
2. powershlell 中输入 vue --version 查看vue-cli的版本 , 本文例子是3.11.0 , vue-cli的2, 3 和4 的项目构造和安装方法都是不同的
3. yarn 或者 npm均可
1、乾坤的适用场景:
1.1 不同框架的前端项目整合成一个项目
1.2 老项目迁移到某个项目中去
1.3 大型项目分为几个独立的项目,分别部署、开发,各自发版不受影响
2、创建乾坤主应用
2.1 vue create XXX 搭建一个前端项目,记得添加router
2.2 安装乾坤依赖
yarn add qiankun 或者 npm i qiankun
2.3 在入口文件main.js中注册子应用
import { registerMicroApps, start } from "qiankun";
// 在主应用中注册子应用
registerMicroApps([
{
name: "vueApp", //子应用名称
entry: "//localhost:8081", //子应用启动的地址
container: "#container", // 子应用在主应用的容器名称
activeRule: "/app-vue", // 路由地址
props: {
data: "child子应用",
}, //传参
},
{
name: "vueApp2", //子应用名称
entry: "//localhost:8082", //子应用启动的地址
container: "#container2", // 子应用在主应用的容器名称
activeRule: "/testapp", // 路由地址
props: {
data: "child子应用",
}, //传参
},
]);
// 启动
start();
2.4 主应用配置跨域,项目根目录下创建 vue.config.js
module.exports = {
transpileDependencies: true,
devServer: {
port: 8080, //主应用启动端口号,视情况而定
headers: {
"Access-Control-Allow-Origin": "*", // 允许跨域访问子应用页面
},
},
}
2.5 在主应用中注册一个路由,默认路径为 /
2.6 主应用的App.vue中,写入跳转信息
<div id="app">
<router-link to="/">产品化</router-link>
<router-link to="/testapp">个性化1</router-link>
<router-link to="/app-vue">个性化2</router-link>
<router-view />
<div id="container"></div>
<div id="container2"></div>
</div>
id为container和container2的两个盒子,分别为两个子应用的容器
3.子应用创建
3.1 vue create XXX , 记得添加路由
3.2 在src文件夹下新建public-path.js,代码如下
if (window.__POWERED_BY_QIANKUN__) {
__webpack_public_path__ = window.__INJECTED_PUBLIC_PATH_BY_QIANKUN__;
}
3.3 在入口文件main.js中添加代码
import Vue from "vue";
import App from "./App.vue";
import router from "./router";
import './public-path'
Vue.config.productionTip = false;
let instance = null;
function render(props = {}) {
const { container } = props;
instance = new Vue({
router,
render: (h) => h(App),
}).$mount(container ? container.querySelector("#app-vue") : "#app-vue");
}
// 独立运行时
if (!window.__POWERED_BY_QIANKUN__) {
render();
}
export async function bootstrap() {
console.log("bootstraped");
}
export async function mount(props) {
console.log("mount");
render(props);
}
export async function unmount() {
console.log("unmount")
instance.$destroy();
instance.$el.innerHTML = "";
instance = null;
}
new Vue({
router,
render: (h) => h(App),
}).$mount("#app-vue");
3.4 配置子应用跨域,项目根目录下新建vue.config.js
const { name } = require("./package");
module.exports = {
transpileDependencies: true,
devServer: {
port: 8081, //子应用启动端口号,不可随意修改,与上文中父应用注册的子应用端口号对应
headers: {
"Access-Control-Allow-Origin": "*", //循序跨域
},
},
configureWebpack: {
output: {
library: `${name}-[name]`,
libraryTarget: "umd", // 把微应用打包成 umd 库格式
// jsonpFunction: `webpackJsonp_${name}`,
},
},
};
3.5 路由配置,在src/router/index.js 中,修改代码
import Vue from 'vue'
import VueRouter from 'vue-router'
import HomeView from '../views/HomeView.vue'
Vue.use(VueRouter)
const routes = [
{
path: '/',
name: 'home',
component: HomeView
},
]
const router = new VueRouter({
// 这里和主应用中注册子应用时的activeRule对应
base: window.__POWERED_BY_QIANKUN__ ? "/app-vue" : "/",
mode: "history",
routes,
});
export default router
3.6 将项目中index.html 和App.vue中的id 都改为 app-vue
注意:
1、 主应用的路由、app.vue的id,应该和注册的子应用的路由、id不同
2、 子应用中app.vue和index.html中的id记得修改并保持一致
3、 本地运行时,将主、子应用都跑起来,注意端口号