umi-plugin-qiankun

Umi plugin for qiankun.

试验性质的项目，不要用于生产环境。

Questions & Suggestions

Please open an issue here.

Why

验证 SingleSPA 在 umi 下的可行性，作为微前端其中一种方式的探索，可能是最佳实践，也可能不是。灵感来源于内部的 OneX 项目和前端微服务化进阶 1 - 基于 umi 的子模块方案。

RFC

• RFC: 微前端（umi-plugin-single-spa） by sorrycc · Pull Request #3 · umijs/rfcs · GitHub

如何验证这个项目

效果如下，导航是主应用，App1 和 App2 是主应用，

注：依赖 umi 的这个 PR，等 umi 更新个版本（或者先本地 link 过来跑）。

安装依赖，

$ yarn

编译 src 为 lib 目录，

$ yarn build

在 test/fixtures 下的 master、app1 和 app2 下同时运行，

$ umi dev

Feature

• ✔︎ 基于 qiankun
• ✔︎ 支持主应用和子应用都用 umi
• ✔︎ 按需加载子应用资源
• ✔︎ Config Entry
• ✔︎ CSS 隔离
• ✔︎ 父子应用通讯
• ✔︎ 运行时配置 bootstrap()、mount() 和 unmount()

TODO

暂没很多时间深入，有需求的同学最好自己上。

• [ ] HTML Entry
• [ ] JS 沙箱
• [ ] 公共依赖加载策略
• [ ] 预加载
• [ ] 支持 browserHistory
• [ ] 子应用嵌套
• [ ] 子应用单独调试
• [ ] 基于 Hooks 的父子应用通讯（需强制 external React 保证一个 React 实例）

Installation

$ yarn add umi-plugin-single-spa

Usage

主应用

配 umi-plugin-single-spa/master 插件，

export default {
  plugins: [
    ['umi-plugin-qiankun/master', {
      // 注册子应用信息
      apps: [
        {
          // 唯一 id，传给 qiankun
          name: 'app1',
          // 支持 config entry
          entry: {
            scripts: [],
            styles: [],
          },
        },
        {
          name: 'app2',
          // 支持 html entry（暂不支持）
          entry: {
            html: '/path/to/app/index.html',
          },
        },
      ],
      // JS 沙箱（暂不支持）
      jsSandBox: false,
    }],
  ],
}

子应用

配 umi-plugin-qiankun/slave 插件，

export default {
  plugins: [
    ['umi-plugin-qiankun/slave', {
      mountElementId: 'app-root',
    }],
  ],
}

父子应用通讯

• 约定父应用中在 src/rootExports.js 里 export 内容
• 子应用中通过 import { useRootExports } from 'umi'; const rootExports = useRootExports(); 取到

运行时配置

在子应用的 src/app.js 里输出 singleSpa，

export const singleSpa = {
  bootstrap() {
    console.log('app1 bootstrap');
  },
  mount() {
    console.log('app1 mount');
  },
  unmount() {
    console.log('app1 unmount');
  },
}

相关

• umi-example-monorepo - 之前尝试的另一种简单粗糙的微前端试验

LICENSE

MIT