用Single-spa 建立基於 React 和 Vue 的微前端

Nader Dabit

翻譯：瘋狂的技術宅

原文：https://dev.to/dabit3/buildin...

Single SPA

Single SPA 是一個用於前端微服務的 javascript 框架。

它使你能夠在單頁應用中使用多個框架，這樣就能夠按功能拆分代碼，並 能使 Angular、React、Vue.js 程序一塊兒運行。

你可能已經習慣了 React 和 Vue 的 CLI，經過這些工具能夠快速建立項目，並準備好 webpack 的配置、依賴項和樣板代碼等。

若是你已經習慣了這種操做，那麼你可能會以爲本文的前半部分有些繁瑣。由於咱們要從頭建立全部內容，包括安裝所需的全部依賴項以及從零建立 webpack 和 babel 配置。

環境與配置

首先在終端下建立一個新目錄並進入其中：

mkdir single-spa-app

cd single-spa-app

接下來初始化 package.json 文件：

npm init -y

而後安裝項目所需的全部依賴項。爲了讓你們清楚的知道都安裝了些什麼，在這裏我把它們分解成單獨的步驟。

安裝依賴項

安裝常規依賴項

npm install react react-dom single-spa single-spa-react single-spa-vue vue

安裝 babel 依賴項

npm install @babel/core @babel/plugin-proposal-object-rest-spread @babel/plugin-syntax-dynamic-import @babel/preset-env @babel/preset-react babel-loader --save-dev

安裝 Webpack 依賴項

npm install webpack webpack-cli webpack-dev-server clean-webpack-plugin css-loader html-loader style-loader vue-loader vue-template-compiler --save-dev

在全部依賴項安裝完畢後，建立目錄結構。

咱們把項目代碼到 src 目錄中。在目錄中包含每一個程序的子文件夾。繼續在 src 目錄中建立 react 和 vue 程序的目錄：

mkdir src src/vue src/react

下面配置 webpack 和 babel。

環境配置

配置 Webpack

在主程序的根目錄中，建立 webpack.config.js 文件並添加一下內容：

const path = require('path');
const webpack = require('webpack');
const { CleanWebpackPlugin } = require('clean-webpack-plugin');
const VueLoaderPlugin = require('vue-loader/lib/plugin')

module.exports = {
  mode: 'development',
  entry: {
    'single-spa.config': './single-spa.config.js',
  },
  output: {
    publicPath: '/dist/',
    filename: '[name].js',
    path: path.resolve(__dirname, 'dist'),
  },
  module: {
    rules: [
      {
        test: /\.css$/,
        use: ['style-loader', 'css-loader']
      }, {
        test: /\.js$/,
        exclude: [path.resolve(__dirname, 'node_modules')],
        loader: 'babel-loader',
      },
      {
        test: /\.vue$/,
        loader: 'vue-loader'
      }
    ],
  },
  node: {
    fs: 'empty'
  },
  resolve: {
    alias: {
      vue: 'vue/dist/vue.js'
    },
    modules: [path.resolve(__dirname, 'node_modules')],
  },
  plugins: [
    new CleanWebpackPlugin(),
    new VueLoaderPlugin()
  ],
  devtool: 'source-map',
  externals: [],
  devServer: {
    historyApiFallback: true
  }
};

配置 babel

在根目錄中建立 .babelrc 文件並添加如下內容：

{
  "presets": [
    ["@babel/preset-env", {
      "targets": {
        "browsers": ["last 2 versions"]
      }
    }],
    ["@babel/preset-react"]
  ],
  "plugins": [
    "@babel/plugin-syntax-dynamic-import",
    "@babel/plugin-proposal-object-rest-spread"
  ]
}

初始化 Single-spa

這一步驟是對你的應用進行註冊，用來告訴 single-spa 找到、裝載和卸載程序的時機和方法。

在 webpack.config.js 文件中，把入口設置爲 single-spa.config.js。

在項目的根目錄中建立這個文件並進行配置。

single-spa.config.js

import { registerApplication, start } from 'single-spa'

registerApplication(
  'vue', 
  () => import('./src/vue/vue.app.js'),
  () => location.pathname === "/react" ? false : true
);

registerApplication(
  'react',
  () => import('./src/react/main.app.js'),
  () => location.pathname === "/vue"  ? false : true
);

start();

這個文件用來註冊用不一樣框架爲主單頁應用開發的每一個部分。每調用一次 registerApplication 都會註冊一個新的應用，它接受三個參數：

1. 應用的名稱
2. 要加載的函數（要加載的入口點）
3. 用來激活的函數（用於告知是否加載應用的邏輯）

接下來須要爲每一個應用建立代碼。

React 應用

在 src/react 目錄中建立如下兩個文件：

touch main.app.js root.component.js

src/react/main.app.js

import React from 'react';
import ReactDOM from 'react-dom';
import singleSpaReact from 'single-spa-react';
import Home from './root.component.js';

function domElementGetter() {
  return document.getElementById("react")
}

const reactLifecycles = singleSpaReact({
  React,
  ReactDOM,
  rootComponent: Home,
  domElementGetter,
})

export const bootstrap = [
  reactLifecycles.bootstrap,
];

export const mount = [
  reactLifecycles.mount,
];

export const unmount = [
  reactLifecycles.unmount,
];

src/react/root.component.js

import React from "react"

const App = () => <h1>Hello from React</h1>

export default App

Vue 應用

在 src/vue 目錄中建立如下兩個文件：

touch vue.app.js main.vue

src/vue/vue.app.js

import Vue from 'vue';
import singleSpaVue from 'single-spa-vue';
import Hello from './main.vue'

const vueLifecycles = singleSpaVue({
  Vue,
  appOptions: {
    el: '#vue',
    render: r => r(Hello)
  } 
});

export const bootstrap = [
  vueLifecycles.bootstrap,
];

export const mount = [
  vueLifecycles.mount,
];

export const unmount = [
  vueLifecycles.unmount,
];

src/vue/main.vue

<template>
  <div>
      <h1>Hello from Vue</h1>
  </div>
</template>

接下來，在程序的根目錄中建立 index.html 文件：

touch index.html

index.html

<html>
  <body>
    <div id="react"></div>
    <div id="vue"></div>
    <script src="/dist/single-spa.config.js"></script>
  </body>
</html>

用腳本更新 Package.json

在 package.json 中添加啓動腳本和構建腳本：

"scripts": {
  "start": "webpack-dev-server --open",
  "build": "webpack --config webpack.config.js -p"
}

運行程序

經過運行 start 執行程序：

npm start

如今能夠經過如下URL訪問了：

# 渲染基於全部框架的程序
http://localhost:8080/

# 只渲染 react
http://localhost:8080/react

# 之渲染 vue
http://localhost:8080/vue

總結

除了開始時的配置外，其餘工做都很輕鬆。若是之後 Single-spa 可以添加處理樣板文件和初始項目設置的 CLI 會更好。

若是你須要微前端這種類型的體系結構，那麼 Single-spa 無疑是如今最成熟的方法。

---

本文首發微信公衆號：前端先鋒

歡迎掃描二維碼關注公衆號，天天都給你推送新鮮的前端技術文章

歡迎繼續閱讀本專欄其它高贊文章：

• 深刻理解Shadow DOM v1
• 一步步教你用 WebVR 實現虛擬現實遊戲
• 13個幫你提升開發效率的現代CSS框架
• 快速上手BootstrapVue
• JavaScript引擎是如何工做的？從調用棧到Promise你須要知道的一切
• WebSocket實戰：在 Node 和 React 之間進行實時通訊
• 關於 Git 的 20 個面試題
• 深刻解析 Node.js 的 console.log
• Node.js 到底是什麼？
• 30分鐘用Node.js構建一個API服務器
• Javascript的對象拷貝
• 程序員30歲前月薪達不到30K，該何去何從
• 14個最好的 JavaScript 數據可視化庫
• 8 個給前端的頂級 VS Code 擴展插件
• Node.js 多線程徹底指南
• 把HTML轉成PDF的4個方案及實現

---

• 更多文章...