qiankun项目搭建实战(以Vue项目为例)

本文详细介绍了如何使用Qiankun框架在Vue项目中实现主应用与多个子应用的集成,包括主应用安装Qiankun包、配置registerMicroApps和子应用的自定义设置,以及如何在页面结构中挂载子应用。
摘要由CSDN通过智能技术生成

qiankun项目搭建实战(以Vue项目为例)

  • 创建多个Vue项目

  vue create master-app
  vue create son1-app
  vue create son2-app

在这里插入图片描述

  • 主应用(基座应用)安装 qiankun 包,并配置相关文件

    npm i qiankun -S
    
    // 在main.js文件添加如下代码
    import { registerMicroApps, start } from 'qiankun';
    
    registerMicroApps([
      {
        name: 'son1', // // 微应用的名字,自拟最好能一眼看出这个应用的功能
        entry: '//localhost:8081', // 微应用的入口地址
        container: '#sonDiv', // 微应用要挂载的容器id
        activeRule: '/son1', // 微应用对应的路由匹配规则
      },
      {
        name: 'son2', // // 微应用的名字,自拟最好能一眼看出这个应用的功能
        entry: '//localhost:8082', // 微应用的入口地址
        container: '#sonDiv', // 微应用要挂载的容器id
        activeRule: '/son2', // 微应用对应的路由匹配规则
      }
    ]);
    
    start();
    
    
    
    ### 注意
    ============需要提供子应用回显的容器,这个容器最好放到App.vue下  代码参考如下 =============================
    <template>
      <div id="app">
        <nav>
          <router-link to="/">Home</router-link> |
          <router-link to="/about">About</router-link>
          <router-link to="/son1">son1</router-link>
          <router-link to="/son2">son2</router-link>
        </nav>
        <router-view/>
        <!-- 子应用挂在的容器 -->
        <!-- <div id="son1"></div>
        <div id="son2"></div> -->
        <div id="sonDiv" class="test"></div>
      </div>
    </template>
    
    <style lang="less">
    #app {
      font-family: Avenir, Helvetica, Arial, sans-serif;
      -webkit-font-smoothing: antialiased;
      -moz-osx-font-smoothing: grayscale;
      text-align: center;
      color: #2c3e50;
    }
    
    nav {
      padding: 30px;
    
      a {
        font-weight: bold;
        color: #2c3e50;
    
        &.router-link-exact-active {
          color: #42b983;
        }
      }
    }
    </style>
    <style lang="less" scoped>
    .test {
      width: 100%;
      height: 100%;
      background-color: orange;
    }
    </style>
  • 子应用 (不需要安装qiankun,只需要修改几个配置文件就可以了,配置文件的部分内容需要和主应用下main.js 下 registerMicroApps(属性的相应值匹配上)

 ### // 首先需要在子应用 son1 vue.config.js 添加如下代码
  const { defineConfig } = require('@vue/cli-service')
  let packageName = 'son1'
  module.exports = defineConfig({
    devServer: {
      headers: {
        'Access-Control-Allow-Origin': '*',
        'Access-Control-Allow-Credentials': 'true',
      },
    },
    transpileDependencies: true,
    configureWebpack: {
      output: {
        library: `${packageName}-[name]`,
        libraryTarget: 'umd',
        chunkLoadingGlobal: `webpackJsonp_${packageName}`,
      }
    }
  })
  
  
  
  ###   // 然后在子项目根目录下新建 public-path.js 文件(内容如下)
  if (window.__POWERED_BY_QIANKUN__) {
    __webpack_public_path__ = window.__INJECTED_PUBLIC_PATH_BY_QIANKUN__;
  }
  
  
  ###   // 最后在子应用的入口文件 main.js 添加如下代码
  import '../public-path'
  import VueRouter from 'vue-router';
  
  let router = null;
  let instance = null;
  function render(props = {}) {
    const { container } = props;
    router = new VueRouter({
      base: window.__POWERED_BY_QIANKUN__ ? '/son1/' : '/',
      mode: 'history',
      routes,
    });
  
    instance = new Vue({
      router,
      render: (h) => h(App),
    }).$mount(container ? container.querySelector('#app') : '#app');
  }
  
  // 独立运行时
  if (!window.__POWERED_BY_QIANKUN__) {
    console.log('我在独立运行中~');
    render();
  }
  
  export async function bootstrap() {
    console.log('[vue] vue app bootstraped');
  }
  export async function mount(props) {
    console.log('[vue] props from main framework', props);
    render(props);
  }
  export async function unmount() {
    instance.$destroy();
    instance.$el.innerHTML = '';
    instance = null;
    router = null;
  }
  
  ### 这里需要注意的是  import routes from './router' 这行代码  routes  必须返回的是个数组才可以  vuecli 默认返回的不是一个数组,需要自行修改一下,不然会报错
  ### 找到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
    },
    {
      path: '/about',
      name: 'about',
      // route level code-splitting
      // this generates a separate chunk (about.[hash].js) for this route
      // which is lazy-loaded when the route is visited.
      component: () => import(/* webpackChunkName: "about" */ '../views/AboutView.vue')
    }
  ]
  
  // const router = new VueRouter({
  //   routes
  // })
  
  export default routes
  
  

最终效果展示

QQ录屏20240316195148

qiankun运行逻辑:

  • 将主应用与子应用都运行起来后,由于主应用的main.js配置了registerMicroApps这个,里面是个数组,数组中一个对象代码一个子应用, name不太重要,运行逻辑如下:当在浏览器地址栏输入主应用的对应路由地址,主应用发现与activeRule的路由匹配上之后,会将此activeRule下的entry下跑的子应用界面渲染到container容器里(此容器我们之前写在了App.vue)
  • 简单点说就是
  • 主应用监听发现路由地址变化 (例如地址最后输入/son1)
  • 主应用从main.js 的 registerMicroApps之中寻找对应匹配的规则地址
  • 将此条规则的entry(这里填写的就是子应用目前跑在的地址),渲染到 container 下的容器里
  • 24
    点赞
  • 27
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

想学吉他!

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值