Skip to content

Latest commit

 

History

History
218 lines (137 loc) · 4.28 KB

README.md

File metadata and controls

218 lines (137 loc) · 4.28 KB

micro-web

介绍

基于 qiankun 的微前端demo项目

基于 micro-app 的在 micro-app-jd 分支

预览

http://micro.icode.link

项目

主应用 micro-base：react^17.0.2

子应用1 micro-react-app-01：react^17.02

子应用2 micro-react-app-02：react^17.0.2

子应用3 micro-vue-app-01：vue^3.2.40

子应用4 micro-angular-app-01：angular^15.2.0

功能

  • 主应用

    • 统一监听地址变化，主动拦截未授权页面
    • 拥有主应用单独的页面
    • 统一处理404
    • history 模式

  • 子应用

    • 可独立开发
    • 可独立运行（在构建后可独立运行）
    • 支持全懒加载
    • history 模式

  • 扩展

    • 父子通信功能

快速启动测试

一键安装依赖 & 一键启动 dev

pnpm start:serve

主应用运行在 http://localhost:8881

一键安装依赖 & 一键构建 & 一键预览

pnpm start:preview

运行在 http://localhost:38003

开发

使用了 pnpm 管理依赖包

安装依赖

单独安装(分别进入5个应用安装)

快速安装 pnpm run i

端口配置

react 项目： .env

vue 项目： vue.config.js 配置

angular 项目： webpack.extra.js 配置

子应用配置

micro-base/src/micro.config.ts

启动

react: pnpm start:xxx

vue: pnpm serve

angular: pnpm start

主应用运行在 http://localhost:8881/

当基座主应用运行后加载子应用时报 ChunkLoadError: Loading chunk {x} failed.(missing: http://localhost:8882/static/js/{x}.chunk.js) 错或空白页时，打开控制台禁用缓存可解决

部署

单独部署

删除 micro-base 下 .env.production 的 PUBLIC_URL 配置

删除 micro-react-app-01 下 .env.production 的 PUBLIC_URL 配置

删除 micro-react-app-02 下 .env.production 的 PUBLIC_URL 配置

删除 micro-vue-app-01 下 vue.config.js 的 publicPath 配置

删除 micro-angular-app-01 下 package.json script.build 的 --base-href 选项配置

更改 micro-base/src/micro.config.ts 的 entry 配置

集合部署

在构建完之后目录需整理如下（运行快速测试参考 /public 结构）：

|-- index.html 
|-- micro-base
    |-- index.html
    |-- static
|-- micro-react-app-01
    |-- index.html
    |-- static
|-- micro-react-app-02
    |-- index.html
    |-- static
|-- vue-app-01
    |-- index.html
    |-- static
|-- angular-app-01
    |-- index.html
    |-- ...js/css/xx

构建后禁止子应用单独运行

子应用入口文件：

if (window.__POWERED_BY_QIANKUN__) {
  __webpack_public_path__ = window.__INJECTED_PUBLIC_PATH_BY_QIANKUN__
} else {
  /**
   * @description 构建后不允许单独运行
   * */
  if (process.env.NODE_ENV === 'production') {
    // 集合部署
    location.href = '/'
    // 单独部署则跳转至主应用地址
    // location.href = '//main'
  } else {
    render({});
  }
}

通信

主子应用可以自定义 事件 进行通信，可查看 demo 示例

实现

主应用：

主应用新建一个单例事件对象，该 events 对象来自 nodejs

import EventEmitter from 'events'
export default new EventEmitter()

在注册子应用时将该事件传入 props

const micro = microApps.map(item => {
  return {
    props: {
      microEvent
    }
  }
})

子应用：

子应用新建设置和获取单例事件的方法

import { EventEmitter as Type } from 'events'

type EventEmitterType = Type | null

let microEvent: EventEmitterType = null

export const setMicroEvent = (_: EventEmitterType) => {
  microEvent = _
}
export const getMicroEvent = (): EventEmitterType => microEvent

子应用接受事件单例对象并保存

export async function mount(props) {
  setMicroEvent(props.microEvent)
}

子应用使用

import { getMicroEvent } from '@/micro/event'
getMicroEvent()?.on('main-message', onMicroMessageHandle)