vue3项目下配置qiankun

1、新建名叫project-v3-qiankun的文件夹,用来放整个项目

npm init
npm i npm-run-all@4.1.5  -D

2、新建三个vue项目

main-app => 主项目
b-child => 子项目B
c-build => 子项目C
npx vue create main-app
npx vue create b-build
npx vue create c-build

3、主项目安装和配置

  • 安装
npm i qiankun@2.4.0
npm i vue-router@3.2.0 vuex@3.4.0
  • 代码
    qiankun.js
import {
  registerMicroApps,
  start
} from 'qiankun'

export const useQiankun = () => {
  const apps = [
    {
      name: 'b-child', // 必选,微应用的名称,微应用之间必须确保唯一
      entry: 'http://localhost:8022', // - 必选,微应用的入口
      container: '#appContainer', // -必选,微应用的容器节点的选择器或者 Element 实例
      activeRule: '/b-child', // - 必选,微应用的激活规则
      props: { // - 可选,主应用需要传递给微应用的数据。
        msg: '我是父应用传过来的值,传递给B应用'
      }
    },
    {
      name: 'c-child',
      entry: 'http://localhost:8033',
      container: '#appContainer',
      activeRule: '/c-child',
      props: {
        msg: '我是父应用传过来的值,传递给C应用'
      }
    }
  ]

  registerMicroApps(apps, {
    beforeLoad: [
      app => {
        console.log(`${app.name}的beforeLoad阶段`)
      }
    ],
    beforeMount: [
      app => {
        console.log(`${app.name}的beforeMount阶段`)
      }
    ],
    afterMount: [
      app => {
        console.log(`${app.name}的afterMount阶段`)
      }
    ],
    beforeUnmount: [
      app => {
        console.log(`${app.name}的beforeUnmount阶段`)
      }
    ],
    afterUnmount: [
      app => {
        console.log(`${app.name}的afterUnmount阶段`)
      }
    ]
  })

  start({ experimentalStyleIsolation: true, prefetch: 'all' })
}


App.vue
```powershell
    <!-- id为appContainer就是放置子应用的容器 -->
    <div id="appContainer"></div>

main.js
```powershell
import {
  useQiankun
} from './qiankun'
.........................
vueApp.$nextTick(() => {
  useQiankun()
})

4、子项目安装和配置(B和C除了名称都一样)

  • 安装
npm i vue-router@3.2.0 vuex@3.4.0
  • 代码
    public-path.js
/* eslint-disable camelcase */

if (window.__POWERED_BY_QIANKUN__) {
  // eslint-disable-next-line no-undef
  __webpack_public_path__ = window.__INJECTED_PUBLIC_PATH_BY_QIANKUN__
}
  • 修改main.js如下
import './public-path'
import Vue from 'vue'
import App from './App.vue'
import routes from './router'
import VueRouter from 'vue-router'
import store from './store'

Vue.config.productionTip = false

let router = null
let instance = null

function render ({ container, parentStore } = {}) {
  router = new VueRouter({
    base: window.__POWERED_BY_QIANKUN__ ? '/b-child' : process.env.BASE_URL,
    mode: 'history',
    routes
  })

  instance = new Vue({
    router,
    store,
    data () {
      return {
        parentStore
      }
    },
    render: h => h(App)
  }).$mount(container ? container.querySelector('#bChild') : '#bChild')
  // index.html 里面的 id 需要改成 appVueHash,否则子项目无法独立运行
}

if (!window.__POWERED_BY_QIANKUN__) {
  // 全局变量来判断环境
  render()
}

/**
 * bootstrap 只会在微应用初始化的时候调用一次,下次微应用重新进入时会直接调用 mount 钩子,不会再重复触发 bootstrap。
 * 通常我们可以在这里做一些全局变量的初始化,比如不会在 unmount 阶段被销毁的应用级别的缓存等。
 */
export async function bootstrap () {
  console.log('现在进入子应用b-child的bootstraped阶段')
}

/**
 * 应用每次进入都会调用 mount 方法,通常我们在这里触发应用的渲染方法
 */
export async function mount (props) {
  if (props.parentStore) {
    await props.parentStore.dispatch('getResource', { name: 'B应用的资源' })
  }

  console.log('现在进入子应用b-child的mount周期', props)

  render(props)
}

/**
 * 应用每次 切出/卸载 会调用的方法,通常在这里我们会卸载微应用的应用实例
 */
export async function unmount () {
  console.log('现在进入子应用b-child的unmount阶段')
  instance.$destroy()
  instance.$el.innerHTML = ''
  instance = null
  router = null
}

/**
 * 可选生命周期钩子,仅使用 loadMicroApp 方式加载微应用时生效
 */
export async function update (props) {
  console.log('update props', props)
}

vue.config.js
```powershell
module.exports = {
    ....................
  devServer: {
    ....................
    headers: {
      'Access-Control-Allow-Origin': '*'
    }
  },
  ....................
  configureWebpack: {
      ....................
    output: {
      // 把子应用打包成 umd 库格式
      library: `${name}-[name]`,
      libraryTarget: 'umd',
      jsonpFunction: `webpackJsonp_${name}`
    }
  }
}

5、运行

npm run dev-all
### 使用 Qiankun 框架与 Vue3 结合创建后台管理系统模板 Qiankun 是一个基于 Single-SPA 思想的微前端框架,能够帮助开发者轻松实现多个独立运行的应用程序在同一页面中共存。以下是关于如何使用 QiankunVue3 构建后台管理系统的详细介绍。 --- #### 1. **目初始化** 首先需要准备主应用和子应用的基础环境。这里以 Vue3 + Vite + TypeScript 为例进行说明。 ##### 主应用初始化 通过以下命令克隆官方提供的主应用模板: ```bash git clone https://github.com/wocwin/wocwin-admin.git cd wocwin-admin pnpm install ``` 此模板已经内置了 Qiankun 的支持[^1],可以直接用于启动主应用。 ##### 子应用初始化 同样可以基于相同的模板来创建子应用,只需调整入口文件中的配置即可满足需求。 --- #### 2. **集成 Qiankun 到主应用** 在主应用中引入 Qiankun 并完成基本设置: ```javascript import { registerMicroApps, start } from &#39;qiankun&#39;; // 加载子应用列表 import childrenApp from &#39;./children.json&#39;; if (window.__POWERED_BY_QIANKUN__) { __webpack_public_path__ = window.__INJECTED_PUBLIC_PATH_BY_QIANKUN__; } const apps = childrenApp.data?.children?.map(item => ({ name: item.packageName, entry: item.entry, container: &#39;#app&#39;, activeRule: item.activeRule, })); registerMicroApps( apps || [], { beforeLoad: async app => { console.log(`Before loading ${app.name}`); }, beforeMount: [async app => { console.log(`Before mounting ${app.name}`); }], afterUnmount: app => { console.log(`${app.name} has been unmounted`); } } ); start(); ``` 上述代码实现了动态加载子应用的功能,并定义了一些生命周期钩子函数以便更好地控制各个阶段的行为。 --- #### 3. **子应用适配** 为了让子应用能够在 Qiankun 中正常工作,需对其进行适当改造。主要包括以下几个方面: - 修改 Webpack 配置或 Vite 配置,使公共路径 (`publicPath`) 能够被注入。 - 添加必要的导出方法供主应用调用。 例如,在 Vite 环境下修改 `vite.config.ts` 文件如下: ```typescript export default defineConfig({ base: process.env.NODE_ENV === &#39;production&#39; ? &#39;/sub-app/&#39; : &#39;/&#39;, }); ``` 同时确保子应用根组件暴露特定 API 方法给主应用交互使用: ```javascript if (window.__POWERED_BY_QIANKUN__) { export function bootstrap() {} export function mount(props) { console.log(&#39;Props received:&#39;, props); } export function unmount() {} } ``` --- #### 4. **路由权限与状态共享** 为了保障用户体验一致性,通常还需要解决跨应用间的数据传递问题以及统一的身份认证机制等问题。 - **数据通信**:借助事件总线或者存储媒介(如 LocalStorage/SessionStorage)来进行简单的消息通知; - **身份验证同步**:建议由主应用负责处理用户的登录登出操作并将 token 下发至各子系统保存起来。 示例代码展示了如何利用 Vuex/Pinia 来保持全局状态的一致性[^2]: ```javascript import { createPinia } from &#39;pinia&#39;; const pinia = createPinia(); function syncGlobalState(stateKey, defaultValue) { const stateValue = sessionStorage.getItem(stateKey) ?? JSON.stringify(defaultValue); pinia.state.value[stateKey] = JSON.parse(stateValue); watchEffect(() => { sessionStorage.setItem(stateKey, JSON.stringify(pinia.state.value[stateKey])); }); } syncGlobalState(&#39;authInfo&#39;, {}); ``` --- #### 5. **性能优化** 由于涉及多模块组合渲染,因此特别关注整体效率显得尤为重要。可以从以下几个角度出发改善表现: - 合理划分边界减少不必要的重复计算开销; - 借助懒加载技术按需加载资源从而加快初始呈现时间; - 对静态资产启用 Gzip/Brotli 压缩进一步缩小传输体积。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值