樣例代碼可以點擊這里下載臼寄,搭建流程如下
項目創(chuàng)建
項目由 vue 的官方腳手架創(chuàng)建登钥,基項目 base 和子項目 app_first、app_second
vue create base
vue create app_first
vue create app_second
基項目修改
添加本地運行配置文件 vue.config.js
module.exports = {
devServer: {
host: 'localhost'
, port: 3000
}
}
安裝 micro-app 插件
npm install @micro-zoe/micro-app --save
添加 micro/index.js
文件
import microApp from '@micro-zoe/micro-app'
import * as config from './config'
// 啟用 micro
microApp.start({
preFetchApps: config.MICRO_APPS //加載子項目
, globalAssets: config.GLOBAL_ASSETS // 加載全局資源
})
添加 micro/config.js
文件
// 子應用前綴
export const CHILD_PREFIX = 'app'
// 子應用地址
export const MICRO_APPS = [
{ name: 'first-child', url: `http://localhost:3001/` }
, { name: 'second-child', url: `http://localhost:3002/` }
]
// 全局資源
export const GLOBAL_ASSETS = {
js: []
, css: []
}
修改入口文件 main.js
,引入 micro-app 配置
import './micro'
...
修改 App.vue
文件
<template>
<div>
<!--路由鏈接-->
...
</div>
<div>
<micro-app
v-if="isChild"
v-bind="micro"
destory
@datachange='handleDataChange'></micro-app>
<router-view v-else></router-view>
</div>
</template>
<script>
import { MICRO_APPS, CHILD_PREFIX } from './micro/config.js'
export default {
...
, data(){
return {
...
, isChild: false // 是否是子模塊
, micro: {
url: '' // 子應用地址滔灶,不包含路由地址
, key: '' // Vue 標簽的 key 值,用于不同子模塊間的切換時吼肥,組件重新渲染
, name: '' // 子模塊名稱录平,值唯一
, data: {} // 需要傳入子模塊的數(shù)據
, baseroute: '' // 子模塊路由地址
}
}
}
, watch: {
$route (val){
// 監(jiān)聽路由變化,改變子模塊渲染
this.changeChild(val)
}
}
, created () {
this.changeChild(this.$route)
}
, methods: {
...
, getAppUrl (name) { // 獲取子模塊 url 和 name
return MICRO_APPS.find(app => app.name === name) || {}
}
, changeChild (route) { // 修改子視圖顯示
let path = route.path.toLowerCase()
, paths = path.split('/')
// 判斷是否為子模塊缀皱,子模塊有固定的前綴
this.isChild = paths.length > 2 && paths[1] === CHILD_PREFIX
if (this.isChild) {
let app = this.getAppUrl(paths[2])
this.micro = {
...app
, data: { name: route.name } // 根據路由和子項目跳轉方式斗这,傳入對應參數(shù)
, key: `${app.name}`
, baseroute: `/${CHILD_PREFIX}/${paths[2]}`
}
}
}
, handleDataChange (event) { // 獲取子路由傳遞的信息
let data = event.detail.data
if(data.route) this.$router.push({ name: data.route.name })
}
}
}
</script>
修改路由文件 router/index.js
...
import { CHILD_PREFIX } from '@/micro/config.js'
const routes = [
...
, { // app_first 項目路由
path: `/${CHILD_PREFIX}/first-child`
, name: 'FirstChild'
, children: [
{
path: 'home'
, name: 'FirstHome'
}
, {
path: 'about'
, name: 'FirstAbout'
}
]
}
, { // app_second 項目路由
path: `/${CHILD_PREFIX}/second-child`
, name: 'SecondChild'
, children: [
{
path: 'home'
, name: 'SecondHome'
}
, {
path: 'about'
, name: 'SecondAbout'
}
]
}
]
...
子項目修改
添加本地運行配置文件 vue.config.js
,設置允許跨域訪問
module.exports = {
devServer: {
host: 'localhost'
, port: 3001
, headers: { // 設置本地運行的跨域權限
'Access-Control-Allow-Origin': '*',
}
}
}
添加 micro/index.js
文件
// 設置 webpack 的公共路徑
__webpack_public_path__ = window.__MICRO_APP_PUBLIC_PATH__ || '/'
入口文件修改 mian.js
import './micro'
...
let app
/**
* 掛載函數(shù)
*/
function mount () {
app = new Vue({
el: '#app'
, router
, render: function (h) { return h(App) }
})
}
/**
* 卸載函數(shù)
*/
function unmount () {
app.$destroy()
app.$el.innerHTML = ''
app = null
}
// 微前端環(huán)境下啤斗,注冊mount和unmount方法
if (window.__MICRO_APP_ENVIRONMENT__)
window[`micro-app-${window.__MICRO_APP_NAME__}`] = { mount, unmount }
else
mount()
修改 App.vue
文件
<template>
<div id="app">
<div id="nav">
<router-link :to="`${prefix}/home`">Home</router-link> |
<router-link :to="`${prefix}/about`">About</router-link> |
<button @click="goto('SecondHome')">SecondHome</button> |
<button @click="goto('SecondAbout')">SecondAbout</button>
</div>
<router-view />
</div>
</template>
<script>
export default {
...
, methods: {
...
, dataListener (data) {
// 不判斷時會報一個“冗余導航【NavigationDuplicated】”的異常
if (data.name !== this.$route.name)
this.$router.push({ name: data.name })
}
, goto (name) {
// 向基項目發(fā)送數(shù)據
window.microApp.dispatch({ route: { name } })
}
}
, created () {
// 綁定數(shù)據【data屬性】監(jiān)聽事件
window.microApp && window.microApp.addDataListener(this.dataListener)
}
, destroyed () {
// 移除數(shù)據【data屬性】監(jiān)聽事件
window.microApp && window.microApp.removeDataListener(this.dataListener)
}
}
</script>
修改路由文件 router/index.js
...
const routes = [
{
path: window.__MICRO_APP_BASE_ROUTE__ || '/' // 根據項目運行的不同環(huán)境表箭,設置路徑的前綴
, name: 'Home'
, redirect: { name: 'FirstHome' }
, component: () => import('../views/Empty.vue') // Empty.vue 是一個只包含 router-view的頁面,用于渲染 children
, children: [
...
]
}
]
...
項目啟動
分別進入項目文件夾钮莲,在 CMD 下運行 npm run serve
免钻,啟動項目彼水,訪問 localhost:3000
查看完整的項目,也可以打開 localhost:3001
或者 localhost:3002
訪問單個子項目
一些問題處理
公共模塊代碼
可以將公共代碼單獨創(chuàng)建一個倉庫极舔,在各個項目中以子模塊的形式引入到項目中Nginx 部署
微前端在部署到多個地址時凤覆,可以通過 nginx 的反向代理,把子項目的地址代理到主項目地址下拆魏,這樣可以是主項目和子項目使用相同的 storage 存儲
server {
listen 3000;
server_name localhost;
location / {
root D:/base/dist/;
index index.html index.htm;
try_files $uri $uri/ /index.html;
}
# 代理子項目
location /first_child/ {
proxy_pass http://localhost:3001/;
}
}
# 子項目訪問端口
server {
listen 3001;
server_name localhost;
# 設置跨域訪問權限
add_header Access-Control-Allow-Origin *;
location / {
root D:/first_child/dist/;
index index.html index.htm;
try_files $uri $uri/ /index.html;
}
}
原文鏈接:MicroApp樣例搭建【Vue】