实现 vue&react 混合开发项目步骤-微前端

发布于:2024-04-27 ⋅ 阅读:(25) ⋅ 点赞:(0)

微前端是一种将多个小型前端应用组合成一个大型应用的架构方式。它允许团队独立开发、测试、部署和维护应用的各个部分。Vue.js 和 React 是两个流行的前端框架,它们可以在同一微前端架构下协同工作。

一、常规流程

1. 项目规划
确定项目的范围和目标。
设计应用的模块化结构,决定哪些部分使用 Vue 开发,哪些使用 React。
2. 搭建微前端架构
选择一个微前端框架或库,如 Bit、Single-spa 或 qiankun。
创建一个主应用(主框架),它将作为其他应用的宿主。
3. 创建独立应用
Vue 应用:使用 Vue CLI 创建新的 Vue 应用。
React 应用:使用 Create React App 创建新的 React 应用。
4. 定义应用入口和出口
为每个应用定义清晰的入口点和出口点,以便于主应用加载和卸载。
5. 配置路由
如果使用 qiankun,可以利用其提供的 bootstrap、mount、unmount 生命周期钩子进行路由配置。
对于 Single-spa,每个微前端应用可能是一个独立的 SPA,需要单独配置路由。
6. 通信机制
实现应用间的通信机制,如事件总线、全局状态管理(如 Redux)、或者通过主应用提供的上下文(context)传递数据。
7. 样式隔离
确保 Vue 和 React 应用的 CSS 是隔离的,避免样式冲突。
8. 构建和部署
配置构建系统(如 Webpack)以支持多应用构建。
部署时,确保每个应用的资源(如 JavaScript、CSS 和图片)都能正确加载。
9. 测试
对每个独立应用进行单元测试和端到端测试。
测试应用间的通信和数据传递是否正常。
10. 性能优化
对每个应用进行性能优化,如代码分割、懒加载等。
优化主应用与微应用之间的加载和切换性能。
11. 文档和规范
编写详细的开发文档和通信协议,确保团队成员理解整个系统的工作方式。
12. 维护和迭代
持续集成和持续部署(CI/CD)以支持应用的独立迭代。
定期审查架构,确保它仍然满足项目的需求。
注意事项
框架差异:Vue 和 React 在内部实现上有所不同,需要特别注意组件间通信和数据管理。
状态共享:如果需要共享全局状态,考虑使用 Redux 或其他状态管理库。
样式隔离:使用 CSS Modules 或 Scoped CSS 来隔离样式,避免冲突。
性能:微前端应用可能会增加页面加载时间,因此性能优化尤为重要。

二、简单案例

步骤 1: 初始化主应用 (React)

首先,使用 create-react-app 初始化一个 React 应用,这个应用将作为主应用:

npx create-react-app main-app
cd main-app
npm start

步骤 2: 创建 Vue 微应用

然后,使用 Vue CLI 创建一个 Vue 应用,这个应用将作为一个微应用:

vue create vue-micro-app
cd vue-micro-app
npm run serve

步骤 3: 配置 qiankun

在主应用中安装 qiankun 并进行配置:

npm install qiankun --save
在 main-app/src/index.js 中:

import React from 'react';
import ReactDOM from 'react-dom';
import { qiankun } from 'qiankun';
import './index.css';
import App from './App';

qiankun().bootstrap(() => {
  ReactDOM.render(
    <App />,
    document.getElementById('root')
  );
});

步骤 4: 注册 Vue 微应用

在主应用中,使用 qiankun 提供的 API 注册 Vue 微应用:

// main-app/src/App.js
import React from 'react';
import { registerMicroApps, start } from 'qiankun';

const App = () => {
  // 注册 Vue 微应用
  registerMicroApps([
    {
      name: 'vueMicroApp', // 微应用名称
      entry: '//localhost:4200', // Vue 微应用的入口地址
      container: '#vue-container', // 微应用挂载点的 CSS 选择器
      activeRule: '/vue-micro-app', // 微应用的路由规则
    },
  ]);

  return (
    <div>
      <h1>React 主应用</h1>
      <div id="vue-container">Vue 微应用将挂载到这里</div>
    </div>
  );
};

export default App;

// 启动 qiankun
start();

确保在 main-app/public/index.html 中添加一个容器元素:


<div id="root">
  <!-- React 主应用内容 -->
  <div id="vue-container"></div>
</div>

步骤 5: 配置 Vue 微应用

在 Vue 微应用中,安装 qiankun 并进行配置:

cd vue-micro-app
npm install qiankun --save

在 vue-micro-app/src/main.js 中:

import Vue from 'vue';
import App from './App.vue';
import { bootstrap, mount, unmount } from 'qiankun';

// Vue 微应用的 bootstrap、mount 和 unmount 生命周期钩子
bootstrap(Vue, {
  Vue,
  App,
  // 其他配置...
});

mount(() => {
  // 渲染微应用
});

unmount(() => {
  // 卸载微应用
});

步骤 6: 启动应用

启动 React 主应用和 Vue 微应用:

# 在两个不同的终端中运行
cd main-app
npm start

cd vue-micro-app
npm run serve

通过浏览器访问 React 主应用,并在其中看到 Vue 微应用的内容。


网站公告

今日签到

点亮在社区的每一天
去签到