本教程适合于qiankun新手,手把手教你搭建一个简单的本地前端微服务,附完整代码
一、什么是微前端
微前端是一种多个团队通过独立发布功能的方式来共同构建现代化 web 应用的技术手段及方法策略。
微前端架构核心价值:
- 技术栈无关:主框架不限制接入应用的技术栈,微应用具备完全自主权
- 独立开发、独立部署:微应用仓库独立,前后端可独立开发,部署完成后主框架自动完成同步更新
- 增量升级:在面对各种复杂场景时,我们通常很难对一个已经存在的系统做全量的技术栈升级或重构,而微前端是一种非常好的实施渐进式重构的手段和策略
- 独立运行时:每个微应用之间状态隔离,运行时状态不共享
二、qiankun 的核心设计理念
- 简单
由于主应用微应用都能做到技术栈无关,qiankun 对于用户而言只是一个类似 jQuery 的库,你需要调用几个 qiankun 的 API 即可完成应用的微前端改造。同时由于 qiankun 的 HTML entry 及沙箱的设计,使得微应用的接入像使用 iframe 一样简单。 - 解耦/技术栈无关
微前端的核心目标是将巨石应用拆解成若干可以自治的松耦合微应用,而 qiankun 的诸多设计均是秉持这一原则,如 HTML entry、沙箱、应用间通信等。这样才能确保微应用真正具备 独立开发、独立运行 的能力。
特性
- 基于 single-spa 封装,提供了更加开箱即用的 API。
- 技术栈无关,任意技术栈的应用均可 使用/接入,不论是 React/Vue/Angular/JQuery 还是其他等框架。
- HTML Entry 接入方式,让你接入微应用像使用 iframe 一样简单。
- 样式隔离,确保微应用之间样式互相不干扰。
- JS 沙箱,确保微应用之间 全局变量/事件 不冲突。
- 资源预加载,在浏览器空闲时间预加载未打开的微应用资源,加速微应用打开速度。
- umi 插件,提供了 @umijs/plugin-qiankun 供 umi 应用一键切换成微前端架构系统。
三、代码演示
1、创建并配置主应用
- 通过
pnpm create vue@latest
创建一个Vue3项目为主应用。 - 安装qiankun:
pnpm i qiankun -S
- 注册微应用并启动
打开src下的main.ts文件,注册微应用,代码如下,这里注册了两个子应用sub-vue、sub-react
import {
registerMicroApps, start } from 'qiankun'
// 注册微应用
registerMicroApps([
{
name: 'sub-vue', //子应用的名称
entry: '//localhost:3001', //子项目启动后的地址
container: '#container', //加载的容器
activeRule: '/sub-vue' //匹配的路由
},
{
name: 'sub-react',
entry: '//localhost:3002',
container: '#container',
activeRule: '/sub-react'
}
])
// 启动 qiankun
start()
2、创建并配置Vue子项目
- 通过
pnpm create vue@latest
创建一个Vue3子应用。 - 通过
pnpm i vite-plugin-qiankun
安装vite-plugin-qiankun
依赖包。 - 在vite.config.js文件中配置qiankun插件,
import {
fileURLToPath, URL