在這里就不講微前端的各種優(yōu)缺點(diǎn)矫夯,直接假設(shè)你在負(fù)責(zé)一個(gè)中后臺(tái)管理系統(tǒng)的開(kāi)發(fā)唧龄,所有的業(yè)務(wù)模塊全部都在一個(gè)項(xiàng)目中打包,隨著業(yè)務(wù)量的不斷增長(zhǎng)蔚润,編譯越來(lái)越慢磅氨,你期望可以從老的項(xiàng)目中將新的業(yè)務(wù)進(jìn)行獨(dú)立開(kāi)發(fā)、獨(dú)立部署抽碌,以微應(yīng)用的形式嵌入到老項(xiàng)目中悍赢。
本篇文章的受眾是那些希望在新老的項(xiàng)目中,在不需要你對(duì)老項(xiàng)目進(jìn)行改動(dòng)老項(xiàng)目的前提下货徙,嵌入微應(yīng)用左权,如果本篇文章對(duì)你有幫助,請(qǐng)點(diǎn)個(gè)??痴颊!
核心要素
- 構(gòu)建生產(chǎn)環(huán)境代碼赏迟,輸出遠(yuǎn)程組件所需的 JSON
- 通過(guò) ajax 請(qǐng)求,拿到這個(gè) JSON 的數(shù)據(jù)蠢棱,傳給 遠(yuǎn)程組件
新項(xiàng)目的搭建
對(duì)于項(xiàng)目的搭建锌杀,在這里就不再仔細(xì)的展開(kāi)講了,大家直接看Genesis項(xiàng)目快速開(kāi)始的文檔吧
修改編譯代碼
import path from 'path';
import fs from 'fs';
import { Build } from '@fmfe/genesis-compiler';
import { ssr } from './genesis';
const start = async () => {
/**
* 創(chuàng)建一個(gè)編譯實(shí)例
*/
const build = new Build(ssr);
/**
* 開(kāi)始執(zhí)行編譯程序泻仙,構(gòu)建生產(chǎn)環(huán)境應(yīng)用包
*/
await build.start();
/**
* 編譯完成后糕再,創(chuàng)建一個(gè)渲染器,輸出遠(yuǎn)程組件所需的內(nèi)容
*/
const renderer = ssr.createRenderer();
/**
* CSR 渲染輸出 JSON
*/
const result = await renderer.render({ mode: 'csr-json' });
/**
* 將 JSON 保存到客戶端目錄
*/
fs.writeFileSync(
path.resolve(ssr.outputDirInClient, 'app.json'),
JSON.stringify(result.data, null, 4),
'utf8'
);
};
start();
如果你是根據(jù)官方文檔來(lái)走的話玉转,你只需要自己修改一下 genesis.build.ts
文件即可突想。如果你自定義了文件名,只要在 await build.start()
方法執(zhí)行完成后,創(chuàng)建一個(gè)渲染器猾担,將 CSR 的渲染結(jié)果保存到一個(gè) JSON 文件即可袭灯。
編譯完成后,你得到的大概是這樣的一個(gè)文件
你只需要將 client
目錄的靜態(tài)文件部署到你的服務(wù)器即可绑嘹。
[圖片上傳失敗...(https://fmfe.github.io/genesis-docs/assets/img/20200525210729.5d79f1dd.jpg)]
老項(xiàng)目遠(yuǎn)程組件加載
假設(shè)你的靜態(tài)資源的基本路徑是 /ssr-genesis/
稽荧,那么你就可以通過(guò) /ssr-genesis/app.json
訪問(wèn)到這個(gè)文件。
在你的老項(xiàng)目上安裝遠(yuǎn)程組件
npm install @ fmfe/genesis-remote axios
在你對(duì)應(yīng)的路由上工腋,使用遠(yuǎn)程組件姨丈,加載此組件即可。
<template>
<div class="app">
<RemoteView :fetch="fetch" />
</div>
</template>
<script lang="ts">
import Vue from 'vue';
import axios from 'axios';
import { RemoteView } from '@fmfe/genesis-remote';
export default Vue.extend({
components: {
RemoteView
},
methods: {
async fetch() {
const res = await axios.get('/ssr-genesis/app.json');
if (res.status === 200) {
return res.data;
}
return null;
}
}
});
</script>
多歷史模式的支持
如果你老項(xiàng)目使用歷史模式夷蚊,在子應(yīng)用也使用歷史模式构挤,會(huì)導(dǎo)致 router.push('/xxx')
產(chǎn)生多條歷史記錄,為了解決這個(gè)問(wèn)題惕鼓,你可以在子應(yīng)用使用 abstract
模式筋现,或者使用 @fmfe/genesis-app 幫你處理多個(gè) Router 實(shí)例使用歷史模式產(chǎn)生的BUG,注意箱歧,你需要在新老項(xiàng)目一起使用 @fmfe/genesis-app 包裝后的 Router
拓展
/**
* CSR 渲染輸出 HTML
*/
const result = await renderer.render({ mode: 'csr-html' });
/**
* 將 html 保存到客戶端目錄
*/
fs.writeFileSync(
path.resolve(ssr.outputDirInClient, 'index.html'),
result.data
'utf8'
);
如果你僅僅只是想做 CSR 的項(xiàng)目矾飞,只需要渲染出 html 即可,和平常的 CSR 項(xiàng)目一樣呀邢,將 client
目錄部署到服務(wù)器洒沦。
總結(jié)
Genesis 只是一個(gè) Vue SSR 的渲染庫(kù),它不是框架价淌,它只是給你提供了最基礎(chǔ)的 SSR 渲染能力申眼。
后面有時(shí)間,專門寫一篇介紹一些 Genesis 的一些設(shè)計(jì)理念和誕生的初衷蝉衣。