查看 single-spa demo

1. 微前端概述

Why Not Iframe

1.1 什么是微前端

  • 微前端是一种多个团队通过独立发布功能的方式来共同构建现代化 web 应用的技术手段及方法策略。
  • 微前端建构与框架无关,每个微应用都可以使用不同的框架,甚至不使用框架。
    微前端

1.2 微前端的价值

  • 增量迁移
    迁移是一项非常耗时且艰难的任务,比如有一个管理系统使用 JQuery 开发维护已经有三年时间,但是随时间的推移和团队成员的变更,无论从开发成本还是用人需求上,JQuery 已经不能满足要求,于是团队想要更新技术栈,想在其他框架中实现新的需求,但是现有项目怎么办?直接迁移是不可能的,在新的框架中完全重写也不太现实。

    使用微前端架构就可以解决问题,在保留原有项目的同时,可以完全使用新的框架开发新的需求,然后再使用微前端架构将旧的项目和新的项目进行整合。这样既可以使产品得到更好的用户体验,也可以使团队成员在技术上得到进步,产品开发成本也降到的最低。

  • 独立发布
    在目前的单页应用架构中,使用组件构建用户界面,应用中的每个组件或功能开发完成或者bug修复完成后,每次都需要对整个产品重新进行构建和发布,任务耗时操作上也比较繁琐。

    在使用了微前端架构后,可以将不同的功能模块拆分成独立的应用,此时功能模块就可以单独构建单独发布了,构建时间也会变得加快。

  • 允许单个团队做出技术决策
    因为微前端构架与框架无关,当一个应用由多个团队进行开发时,每个团队都可以使用自己擅长的技术栈进行开发,也就是它允许适当的让团队决策使用哪种技术,从而使团队协作变得不再僵硬。

微前端的使用场景:

  1. 拆分巨型应用,使应用变得更加可维护
  2. 兼容历史应用,实现增量开发

1.3 如何实现微前端

  • 多个微应用如何进行组合?
    在微前端架构中,除了存在多个微应用以外,还存在一个容器应用,每个微应用都需要被注册到容器应用中。

    微前端中的每个应用在浏览器中都是一个独立的 JavaScript 模块,通过模块化的方式被容器应用启动和运行。

    使用模块化的方式运行应用可以防止不同的微应用在同时运行时发生冲突。

  • 在微应用中如何实现路由?
    在微前端架构中,当路由发生变化时,容器应用首先会拦截路由的变化,根据路由匹配微前端应用,当匹配到微应用以后,再启动微应用路由,匹配具体的页面组件。

  • 微应用与微应用之间如何实现状态共享?
    在微应用中可以通过发布订阅模式实现状态共享。

  • 微应用与微应用之间如何实现框架和库的共享?
    通过 import-map(允许我们加载网络模块) 和 webpack 中的 externals 属性。

2. 模块化解决方案Systemjs

2.1 介绍

  • 在微前端架构中,微应用被打包为模块,但浏览器对模块化的支持不够好,需要使用 systemjs 实现浏览器中的模块化。

  • systemjs 是一个用于实现模块化(动态的加载模块)的 JavaScript 库,有属于自己的模块化规范。

  • 在开发阶段我们可以使用 ESM 模块规范,然后使用 webpack 将其转换为 systemjs 支持的模块。

    示例:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    <!DOCTYPE html>
    <html lang="en">
    <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>systemjs-vue</title>
    <script type="systemjs-importmap">
    {
    "imports": {
    "vue": "https://cdn.jsdelivr.net/npm/vue@3.2.37/dist/vue.global.min.js",
    "vue-router": "https://cdn.jsdelivr.net/npm/vue-router@4.0.16/dist/vue-router.global.min.js",
    "vuex": "https://cdn.jsdelivr.net/npm/vuex@4.0.2/dist/vuex.global.min.js"
    }
    }
    </script>
    <script src="https://cdn.jsdelivr.net/npm/systemjs@6.12.1/dist/system.min.js"></script>
    </head>

    <body>
    <div id="root"></div>
    <script>
    System.import("./index.js")
    </script>
    </body>
    </html>

3. 微前端框架single-spa

3.1 single-spa 概述

single-spa 是一个实现微前端架构的框架。

single-spa 框架中有三种类型的微前端应用:

  1. single-spa-application:微前端架构中的微应用,可以用vue、react、angular 等框架。
  2. single-spa root config:创建微前端容器应用。
  3. utility modules:公共模块应用,非渲染组件,用于跨应用共享javascript 逻辑的微应用。

    3.2 创建容器应用

    1. 安装 single-spa 脚手架工具:
      1
      npm instal create-single-spa -g
    2. 创建微前端应用目录: mkdir mmc-site && cd "$_"
    3. 创建容器应用:create-single-spa
    4. 项目名称:root
    5. 选择微应用类型:single-spa root config
    6. 组织名称:mmc-site
    7. 启动应用:npm start
    8. root config 模板文件:src/index.ejs
    9. root config 入口文件:src/[项目名称]-root-config.js

      3.3 创建不依赖框架的应用

    10. 初始化:
    11. mkdir store && cd "$_"
    12. 初始化项目:
      1. npm init -y
      2. 安装依赖:npm install @babel/core single-spa webpack webpack-cli webpack-config-single-spa webpack-dev-server webpack-merge -D
    13. 修改配置:
      webpack:
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      // webpack.config.js
      const webpackMerge = require('webpack-merge');
      const singleSpaDefaults = require('webpack-config-single-spa');

      module.exports = webpackConfigEnv => {
      const defaultConfig = singleSpaDefaults({
      // The name of the organization this application is written for
      orgName: 'mmc-site',
      // The name of the current project. This usually matches the git repo's name
      projectName: 'store',
      // See https://webpack.js.org/guides/environment-variables/#root for explanation of webpackConfigEnv
      webpackConfigEnv,
      })
      return webpackMerge.merge(defaultConfig, {
      // modify the webpack config however you'd like to by adding to this object
      devServer: {
      port: 9001
      }
      })
      }
      添加启动命令:
      1
      2
      3
      4
      // package.json
      scripts: {
      "start": "webpack server"
      }
    14. 添加应用内容:
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      // src/mmc-site-store.js
      let appContainer = null

      export const bootstrap = async () => {
      console.log('store 初始化')
      }

      export const mount = async () => {
      console.log('store 挂载')

      appContainer = document.createElement('div')
      appContainer.id = 'app-store'
      appContainer.innerHTML = 'hello mmc-site-store'

      document.body.appendChild(appContainer)
      }

      export const unmount = async () => {
      console.log('store 卸载')

      document.body.removeChild(appContainer)
      }
    15. 在容器应用中注册该微应用
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      // root/src/mmc-site-root-config.js
      // 修改默认应用
      const loadingWelcome = () => {
      return System.import(
      "https://unpkg.com/single-spa-welcome/dist/single-spa-welcome.js"
      )
      }
      registerApplication(
      '@single-spa/welcome',
      loadingWelcome,
      location => location.pathname === '/'
      );

      // 注册 store 应用
      registerApplication({
      name: "@mmc-site/store",
      app: () => System.import("@mmc-site/store"),
      activeWhen: ["/store"]
      });
    16. 在模板文件中指定模块访问地址
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      // root/src/index.ejs
      <script type="systemjs-importmap">
      {
      "imports": {
      "@mmc-site/root-config": "//localhost:9000/mmc-site-root-config.js",

      // 指定访问地址
      "@mmc-site/store": "//localhost:9001/mmc-site-store.js"
      }
      }
      </script>

      3.4 创建基于 Vue 的应用

    17. 初始化:
    18. create-single-spa
    19. 项目名称:report
    20. 选择微应用类型:single-spa application parcel
    21. 框架类型: Vue2
    22. 组织名称:mmc-site
    23. 提取公共模块
      1
      2
      3
      4
      5
      6
      7
      8
      9
      // vue.config.js
      module.exports = {
      chainWebpack: config => {
      config.externals(['vue', 'vue-router'])
      },
      devServer: {
      port: 9002
      }
      }
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    // root/src/index.ejs

    <script type="systemjs-importmap">
    {
    "imports": {
    "single-spa": "https://cdn.jsdelivr.net/npm/single-spa@5.9.0/lib/system/single-spa.min.js",
    "vue": "https://cdn.jsdelivr.net/npm/vue@2.6.11/dist/vue.min.js",
    "vue-router": "https://cdn.jsdelivr.net/npm/vue-router@3.0.6/dist/vue-router.min.js"
    }
    }
    </script>
    1. 修改启动命令
      1
      2
      3
      4
      // package.json
      "scripts": {
      "start": "npm run serve"
      }
    2. 修改入口文件 main.js
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      import Vue from 'vue';
      import VueRouter from 'vue-router';
      import singleSpaVue from 'single-spa-vue';

      import App from './App.vue';

      Vue.config.productionTip = false;

      Vue.use(VueRouter)

      const Index = {
      template: '<div>Index</div>'
      }
      const About = {
      template: '<div>About</div>'
      }

      const routes = [
      { path: '/index', component: Index },
      { path: '/about', component: About }
      ]

      const router = new VueRouter({
      routes,
      mode: 'history',
      base: '/report'
      })

      const vueLifecycles = singleSpaVue({
      Vue,
      appOptions: {
      router,
      render(h) {
      return h(App, {
      props: {
      // single-spa props are available on the "this" object. Forward them to your component as needed.
      // https://single-spa.js.org/docs/building-applications#lifecycle-props
      // if you uncomment these, remember to add matching prop definitions for them in your App.vue file.
      /*
      name: this.name,
      mountParcel: this.mountParcel,
      singleSpa: this.singleSpa,
      */
      },
      });
      },
      },
      });

      export const bootstrap = vueLifecycles.bootstrap;
      export const mount = vueLifecycles.mount;
      export const unmount = vueLifecycles.unmount;
    3. 修改入口模板 App.vue
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      <template>
      <div id="app">
      <img alt="Vue logo" src="./assets/logo.png">
      <div>
      <router-link to="/index">Index</router-link> |
      <router-link to="/about">About</router-link>

      <router-view></router-view>
      </div>
      </div>
      </template>

      <script>
      export default {
      name: 'App',
      components: {

      }
      }
      </script>

      <style>
      #app {
      text-align: center;
      }
      </style>
    4. 在容器应用中注册该微应用
      1
      2
      3
      4
      5
      6
      7
      8
      // root/src/mmc-site-root-config.js

      // 注册 report 应用
      registerApplication({
      name: "@mmc-site/report",
      app: () => System.import("@mmc-site/report"),
      activeWhen: ["/report"]
      });
    5. 在模板文件中指定模块访问地址
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      // root/src/index.ejs
      <script type="systemjs-importmap">
      {
      "imports": {
      "@mmc-site/root-config": "//localhost:9000/mmc-site-root-config.js",
      "@mmc-site/report": "//localhost:9001/mmc-site-store.js",

      // 指定访问地址
      "@mmc-site/report": "//localhost:9002/js/app.js"
      }
      }
      </script>

      3.5 创建跨应用共享逻辑utility module

      无需注册

    6. 初始化:
    7. create-single-spa
    8. 项目名称:share
    9. 选择微应用类型:in-browser utility module
    10. 框架类型: none
    11. 包管理工具:npm
    12. 组织名称:mmc-site
  1. 修改端口号
    1
    2
    3
    4
    5
    6
    7
    8
    // webpack.config.js

    return merge(defaultConfig, {
    // modify the webpack config however you'd like to by adding to this object
    devServer: {
    port: 9003
    }
    });
  2. 在模板文件中指定模块访问地址
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    // root/src/index.ejs
    <script type="systemjs-importmap">
    {
    "imports": {
    "@mmc-site/root-config": "//localhost:9000/mmc-site-root-config.js",
    "@mmc-site/report": "//localhost:9001/mmc-site-store.js",
    "@mmc-site/report": "//localhost:9002/js/app.js",

    // 指定访问地址
    "@mmc-site/share": "//localhost:9003/mmc-site-share.js"
    }
    }
    </script>
  3. 编写公共代码
    1
    2
    3
    4
    5
    // share/src/mmc-site-share.js

    export const greet = (app) => {
    console.log(`%cgreeting from ${app}`, 'color: #66b587');
    }
  4. 使用公共模块(以Vue微应用为例)
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    // report/src/App.vue

    <button @click="handleClick">greet</button>

    methods: {
    async handleClick() {
    const share = await window.System.import('@mmc-site/share')

    share?.greet('@mmc-site/report')
    }
    }

思考:如何实现跨应用通信?
思考:运行时模块和构建时模块?