爱奇艺号前端工程基于 Vue 的框架已经使用了 3 年,这一版本虽有不错的可扩展性,但随着接入的业务越来越多,项目复杂度和代码行数增长,现有框架需要将框架与业务更加解耦以方便其他团队进行维护,同时也需要模块的独立部署、发布等提高迭代效率。基于种种原因,爱奇艺号技术团队基于 Vue 定制开发了微前端框架,此文从偏向实践的方面来简要介绍这套框架的实现原理。
容器应用
首先需要一个容器应用,这个容器应用需要有最基本的代码架构,比如 Vue、主路由、vuex 及其他基础的通用代码,但需要将这些通用代码中任何业务相关的部分剥离。简单来说,容器应用是一个基于 Vue 的框架,其作用是将其他分散的各个微前端模块通过页面路由攒在一起,再组成一个个的页面。
除了基本的 Vue 启动应用等功能,微前端容器的架构逻辑需要做到下面几点:
将微前端模块需要的通用代码绑定至全局函数;
基于请求的 url 获取相对应的微前端模块部署的 js 文件地址列表(列表 中包含业务自己定义的路由、js 模块的地址列表);
通过匹配微前端模块中定义的路由获取页面所需的微前端模块;
加载每个微前端模块的具体 js 文件地址并将其渲染。
下面我们来依次对容器应用中各个部分进行介绍:
app.js
这一部分用于进行 Vue 的初始化的相关逻辑。与正常 Vue 初始化逻辑相比,这里唯一不同的是需要将一些其他微前端模块必需的通用组件绑定到全局变量中(此处用 ,也可以自己定义一个全局变量),比如:
在框架中,为了方便子模块的运行,全部通用组件被绑定到 下,如 .mp.Vue 等,这为子模块按需取用提供便利。
hosts 配置
因微前端容器应用中不引用任何子模块的依赖,需要直接通过正常 url 访问获取子模块的 js 代码,所以容器应用需要通过自定义的配置文件来获得每个子模块所在的服务器 host,以便拼凑出需要加载的 js 具体路径。每当增加一个新的模块,就需要在这里添加模块部署的相应地址,否则容器应用不会成功解析。
例如:
配置中可以包含多个不同服务器环境的地址,在不同的环境中自动使用相对应的 url。值得注意的是,本地环境 build 中使用 加 port 的地址,方便本地启动调试模块。本地启动时,需要将容器应用以及全部微前端模块一起启动,页面才会正常运行。
路由
在微前端中路由实现分治,即每个微前端模块(业务)维护各自的路由,容器应用负责匹配并拉取即将访问的页面相对应的模块及其路由。在这里我们首先为主容器定义一个非常宽泛的路由定义,比如 path: '*',然后在路由的钩子函数如 中实现微前端模块的路由获取,并将其添加进主路由中。
从子模块生成的 .json(后面微前端模块部分会介绍)中获取子模块的路由 js 文件并将其解析,再加入主路由中。经过此番操作后,同一个窗口再次访问这个地址时就会直接匹配成功主路由了。
微前端模块渲染
容器应用中最重要的部分就是如何获取并渲染微前端模块。现提供一个 .vue 模块专门负责拉取并渲染微前端模块,则 .vue 需要做的事情如下:
通用模块注册为懒加载组件
在业务中经常会碰到一些通用的代码需要被引用,这些代码如果是两三行,引用相对简单,但如果是成百上千行或是一个通用的组件,每个微前端模块都通过 引用它,则会极大增加用户浏览器需要下载并解析的代码量,拖累页面性能。所以在容器应用中(或者容器应用引用的一个 组件中)需要将重复引用的代码注册为全局引用的方法。
需要注意的是,以往在 Vue 中注册全局组件往往需要在 app.js 中 ,这会增加页面初始化 app.js 文件的大小,所以为避免这一问题,在注册组件时可以利用 的动态加载 的方式进行,这样一来则只有在组件需要的时候才会真正引入这个组件的代码,而不是直接将其打包进 app.js 中。在 时加入 的注释可以起到告诉 打包后 chunk 的文件名的作用。,比如下面引入 的方式:
微前端模块
完整的微前端模块可以代表一个单独的业务,其中可以包括一个或多个子模块,比如一个关于收入的微前端模块,其中包括收入概览、收入图表、收入按天列表等多个子模块,这就要求每个微前端模块都有如下功能:
下面我们来详细介绍微前端模块的组成:
相关配置
微前端模块的 相比主容器,有下面几点不同:
路由
一个微前端模块可能代表了一个业务,而每个业务可能会频繁变化路由配置,所以如果路由分配能由业务微前端模块自行配置,不同团队则能更方便的进行更改而不需要重新上线容器应用。上文已经介绍了主容器如何获取并使用微前端中的路由配置,这里详细介绍模块中如何配置自己的路由。
在 jobs/.js 中,我们绑定一个全局函数用来让主容器获取到我们自己配置的路由信息,类似下面的代码 jobs/route.js:
可见,子模块的路由完全遵循 Vue 的路由规范(或遵循自身使用的框架的规范),这样可以让容器应用毫不费力地直接添加引用。容器应用加载完成 js 文件后,可以直接调用 .mp.() 获来取已定义好的 配置。
子模块的 entry 文件(jobs/*.js)
每一个子模块都需要一个单独的 entry 文件,这类似于主容器的 jobs/app.js,能用于初始化子模块代码、绑定全局渲染函数等。entry 文件与正常的初始化 Vue 方式一样,只是需要将初始化逻辑包裹在一个全局函数中,以便主容器能在加载此模块 js 完毕后,方便的进行渲染调用。例如:
根据以上代码,渲染出来的 Vue 模块会被放到指定的 #${}中,这个 ID 由主容器在渲染时动态传入,以便将模块插入到指定的页面位置。
子模块代码开发
子模块代码开发与正常的 Vue 开发并无不同,可以轻松迁移老代码,只需要注意一些通用代码的引用并通过上文提到的懒加载模式引入。
后记
爱奇艺号技术团队基于 Vue 定制开发了微前端框架,通过应用上面介绍的基本方法及其他的自定义逻辑,我们搭建了与业务代码开发、代码迭代非常契合的一套微前端框架。我们认为微前端的主要好处有:
未来,我们会继续完善前端框架,使其性能更加优秀,进一步提升爱奇艺号前端代码的开发效率,实现不同应用之间页面级别的自由组合,从而可生成个性化控制台。
实现微前端有很多技术方法,不同的企业有不同的对策;从服务端转换到 和 元框架和 Web 组件等都是可选的微前端方案。