第九章(应用场景篇)Qiankun微前端深度解析与实践教程

本文涉及的产品
全局流量管理 GTM,标准版 1个月
云解析 DNS,旗舰版 1个月
公共DNS(含HTTPDNS解析),每月1000万次HTTP解析
简介: 第九章(应用场景篇)Qiankun微前端深度解析与实践教程

Qiankun微前端深度解析与实践教程

引言

随着互联网技术的飞速发展,前端领域也在不断地进行着变革。从最初的页面制作,到后来的SPA(单页应用),再到现在的微前端,每一次变革都为我们带来了更多的可能性和挑战。今天,我将带领大家深入探索一个颇具影响力的微前端解决方案——Qiankun。

一、微前端概述

微前端,顾名思义,就是将一个庞大的前端应用拆分成多个小型、独立的前端应用,每个应用都可以独立开发、测试、部署,最终通过某种方式集成到一起,形成一个完整的应用。这种方式可以有效地解决大型前端项目中的一些问题,如代码耦合度高、开发效率低下等。

二、Qiankun简介

Qiankun是一个基于single-spa的微前端实现库。它提供了一种简单、高效的方式来集成多个独立的前端应用。Qiankun的核心思想是通过劫持前端路由,来实现不同应用之间的隔离和通信。

三、Qiankun核心原理

  1. 应用加载机制

Qiankun通过注册子应用的方式,在主应用中预留出子应用的挂载点。当路由匹配到子应用时,Qiankun会加载子应用的资源,并将子应用挂载到预留的位置。这个过程是动态的,也就是说,子应用可以在任何时候被加载和卸载。

  1. JS沙箱

为了保证子应用的独立性,Qiankun为每个子应用创建了一个JS沙箱。这个沙箱可以隔离子应用的全局变量、样式等,防止不同子应用之间的污染。

  1. 样式隔离

除了JS沙箱外,Qiankun还提供了样式隔离的功能。通过为每个子应用添加唯一的样式前缀,可以确保子应用的样式不会影响到其他应用。

  1. 应用通信

Qiankun提供了一套完整的应用通信机制。主应用可以通过props向子应用传递数据,子应用也可以通过特定的方式向主应用发送消息。

四、Qiankun实践

下面,我们将通过一个简单的例子来演示如何使用Qiankun构建一个微前端应用。

1. 创建主应用

首先,我们创建一个基于Vue的主应用。在主应用中,我们需要安装qiankun

npm install qiankun

然后,在Vue项目中设置主应用的路由和子应用的挂载点。

main.js (主应用入口)

import Vue from 'vue';
import App from './App.vue';
import router from './router';
import { registerMicroApps, start } from 'qiankun';

Vue.config.productionTip = false;

new Vue({
  router,
  render: h => h(App),
}).$mount('#app');

// 注册子应用
registerMicroApps([
  {
    name: 'micro-app', // 子应用名称
    entry: '//localhost:8081', // 子应用入口,可以是相对路径或绝对URL
    container: '#micro-container', // 子应用挂载点
    activeRule: '/micro-app', // 激活子应用的路由规则
  },
]);

// 启动Qiankun
start();

App.vue (主应用组件)

<template>
  <div id="app">
    <router-view />
    <div id="micro-container"></div> <!-- 子应用挂载点 -->
  </div>
</template>

<script>
export default {
  name: 'App',
};
</script>

router/index.js (主应用路由配置)

import Vue from 'vue';
import VueRouter from 'vue-router';

Vue.use(VueRouter);

const routes = [
  {
    path: '/',
    name: 'Home',
    component: () => import('../views/Home.vue'),
  },
  // ... 其他主应用路由
];

const router = new VueRouter({
  mode: 'history',
  base: process.env.BASE_URL,
  routes,
});

export default router;

2. 注册子应用

在主应用中,我们已经通过registerMicroApps方法注册了子应用。现在,让我们看看子应用如何配置。

子应用可以是一个独立的Vue项目,它可以有自己的路由、状态管理和组件等。

子应用的public/index.html

确保子应用的index.html中没有使用绝对路径引用资源,因为子应用会被加载到主应用的容器中,并且URL将会是基于主应用的。

子应用的main.js

import Vue from 'vue';
import App from './App.vue';
import router from './router';
import store from './store';

let instance = null;

function render(props) {
  instance = new Vue({
    router,
    store,
    render: h => h(App),
  }).$mount('#app');
}

// 导出qiankun生命周期函数
export async function bootstrap() {
  console.log('micro app bootstraped');
}

export async function mount(props) {
  render(props);
}

export async function unmount() {
  instance.$destroy();
  instance.$el.innerHTML = '';
  instance = null;
}

if (!window.__POWERED_BY_QIANKUN__) {
  render();
}

在上面的代码中,我们导出了三个生命周期函数bootstrapmountunmount,它们是Qiankun在加载、挂载和卸载子应用时会调用的。

3. 路由配置

在主应用中,我们已经为子应用配置了一个激活规则/micro-app。当路由匹配到这个规则时,Qiankun会自动加载并挂载子应用。

子应用内部的路由应该使用history模式,并且基础路径应该设置为相对路径,以避免与主应用的路由冲突。

4. 子应用开发

子应用可以像任何常规的SPA应用一样进行开发。它可以有自己的路由配置、组件、状态管理等。

5. 应用通信

Qiankun提供了几种通信机制,包括props传递、全局状态管理、事件通信等。

通过props传递数据

在主应用中,我们可以在注册子应用时通过props向子应用传递数据:

registerMicroApps([
  {
    // ... 其他配置
    props: { dataFromMain: 'Hello from main app' },
  },
]);


在子应用的mount函数中,我们可以接收这些数据:

export async function mount(props) {
  console.log(props.dataFromMain); // 打印 "Hello from main app"
  render(props);
}

事件通信

子应用可以通过props中的onGlobalStateChangesetGlobalState函数来与主应用进行全局状态通信。


此外,子应用可以使用window对象或自定义事件来发送和接收消息,但这种方法不是Qiankun特有的,而是Web开发中常用的一种通信方式。

请注意,以上代码示例仅用于演示目的,并且可能需要根据你的项目结构和需求进行调整。确保你已经正确设置了主应用和子应用的开发环境,并且它们可以独立运行。在整合时,还需要处理跨域、样式隔离、路由冲突等潜在问题。

五、Qiankun优化与扩展

在使用Qiankun的过程中,我们可能会遇到一些问题,如加载性能、错误处理等。针对这些问题,Qiankun提供了一些优化和扩展的方式。


  1. 预加载

为了提高应用的加载性能,我们可以使用Qiankun提供的预加载功能。通过预加载,我们可以在用户访问子应用之前,提前加载子应用的资源。

  1. 错误处理

Qiankun提供了一套完整的错误处理机制。当子应用加载失败或运行时出错时,我们可以捕获这些错误,并进行相应的处理。

  1. 扩展功能

除了核心功能外,Qiankun还提供了一些扩展功能,如应用状态管理、应用间跳转等。这些功能可以帮助我们更好地管理和控制微前端应用。

最后对比Qiankun和EMP两种微前端架构

image.png

附录:

(1) 介绍 - qiankun - umijs.org. https://qiankun.umijs.org/zh/guide.

(2) 微前端wujie、qiankun、micro-app、EMP 方案比较 - 简书. https://www.jianshu.com/p/112920162512.

(3) qiankun 和 emp 在国内微前端中为啥这么受欢迎? - 知乎. https://zhuanlan.zhihu.com/p/406574778.

(4) 微前端技术框架qiankun技术分享 - 知乎 - 知乎专栏. https://zhuanlan.zhihu.com/p/135343332.

(5) undefined. http://example.com.

(6) undefined. https://wujie-micro.github.io/demo-main-vue/home.

(7) undefined. https://github.com/Tencent/wujie.

相关文章
|
6天前
|
前端开发 JavaScript 安全
前端性能调优:HTTP/2与HTTPS在Web加速中的应用
【10月更文挑战第27天】本文介绍了HTTP/2和HTTPS在前端性能调优中的应用。通过多路复用、服务器推送和头部压缩等特性,HTTP/2显著提升了Web性能。同时,HTTPS确保了数据传输的安全性。文章提供了示例代码,展示了如何使用Node.js创建一个HTTP/2服务器。
16 2
|
1天前
|
编解码 前端开发 UED
探索无界:前端开发中的响应式设计深度解析与实践####
【10月更文挑战第29天】 本文深入探讨了响应式设计的核心理念,即通过灵活的布局、媒体查询及弹性图片等技术手段,使网站能够在不同设备上提供一致且优质的用户体验。不同于传统摘要概述,本文将以一次具体项目实践为引,逐步剖析响应式设计的关键技术点,分享实战经验与避坑指南,旨在为前端开发者提供一套实用的响应式设计方法论。 ####
20 4
|
2天前
|
安全 编译器 PHP
PHP 8新特性解析与实践应用####
————探索PHP 8的创新功能及其在现代Web开发中的实际应用
|
7天前
|
Rust 前端开发 JavaScript
前端性能革命:WebAssembly在高性能计算中的应用探索
【10月更文挑战第26天】随着Web应用功能的日益复杂,传统JavaScript解释执行模式逐渐成为性能瓶颈。WebAssembly(Wasm)应运而生,作为一种二进制代码格式,支持C/C++、Rust等语言编写的代码在浏览器中高效运行。Wasm不仅提升了应用的执行速度,还具备跨平台兼容性和安全性,显著改善了Web应用的响应速度和用户体验。
23 4
|
6天前
|
前端开发 数据管理 测试技术
前端自动化测试:Jest与Cypress的实战应用与最佳实践
【10月更文挑战第27天】本文介绍了前端自动化测试中Jest和Cypress的实战应用与最佳实践。Jest适合React应用的单元测试和快照测试,Cypress则擅长端到端测试,模拟用户交互。通过结合使用这两种工具,可以有效提升代码质量和开发效率。最佳实践包括单元测试与集成测试结合、快照测试、并行执行、代码覆盖率分析、测试环境管理和测试数据管理。
17 2
|
7天前
|
前端开发 安全 应用服务中间件
前端性能调优:HTTP/2与HTTPS在Web加速中的应用
【10月更文挑战第26天】随着互联网的快速发展,前端性能调优成为开发者的重要任务。本文探讨了HTTP/2与HTTPS在前端性能优化中的应用,介绍了二进制分帧、多路复用和服务器推送等特性,并通过Nginx配置示例展示了如何启用HTTP/2和HTTPS,以提升Web应用的性能和安全性。
14 3
|
7天前
|
前端开发 JavaScript 数据可视化
前端自动化测试:Jest与Cypress的实战应用与最佳实践
【10月更文挑战第26天】前端自动化测试在现代软件开发中至关重要,Jest和Cypress分别是单元测试和端到端测试的流行工具。本文通过解答一系列问题,介绍Jest与Cypress的实战应用与最佳实践,帮助开发者提高测试效率和代码质量。
21 2
|
7天前
|
前端开发 JavaScript API
前端框架新探索:Svelte在构建高性能Web应用中的优势
【10月更文挑战第26天】近年来,前端技术飞速发展,Svelte凭借独特的编译时优化和简洁的API设计,成为构建高性能Web应用的优选。本文介绍Svelte的特点和优势,包括编译而非虚拟DOM、组件化开发、状态管理及响应式更新机制,并通过示例代码展示其使用方法。
21 2
|
26天前
|
缓存 Java 程序员
Map - LinkedHashSet&Map源码解析
Map - LinkedHashSet&Map源码解析
60 0

推荐镜像

更多