微前端与项目实施方案研究
一、前言
微前端(micro-frontends)是近几年在前端领域出现的一个新概念，主要内容是将前端应用分解成一些更小、更简单的能够独立开发、测试、部署的小块，而在用户看来仍然是内聚的单个产品。微前端的理念源于微服务，是将庞大的整体拆成可控的小块，并明确它们之间的依赖关系，而它的价值在于能将低耦合的代码与组件进行组合，基座+基础协议模式能接入大量应用，进行统一的管理和输出，许多公司与团队也都在不断尝试和优化相关解决技术与设计方案，为这一概念的落地和推广添砖加瓦。结合自身遇到的问题，适时引用微前端架构能起到明显的提效赋能作用。
二、背景
目前我司拥有大量的内部系统，这些系统采用相同的技术栈，在实际开发和使用过程中，逐渐暴露出如下几个问题：
1.有大量可复用的部分，虽然有组件库，但是依赖版本难统一；
2.静态资源体积过大，影响页面加载和渲染速度；
3.应用切换目前是通过链接跳转的方式实现，会有白屏和等待时长的问题，对用户体验不够友好；
针对上述几个问题，决定采用微前端架构对内部系统进行统一的管理，本文也是围绕微前端落地的技术预研方案。
三、方案调研
目前业界有多种解决方案，有各自的优缺点，具体如下：
路由转发：路由转发严格意义上不属于微前端，多个子模块之间共享一个导航即可 简单，易实现 体验不好，切换应用整个页面刷新；
嵌套 iframe：每个子应用一个 iframe 嵌套 应用之间自带沙箱隔离 重复加载脚本和样式；
构建时组合：独立仓储，独立开发，构建时整体打包，合并应用 方便依赖管理，抽取公共模块 无法独立部署，技术栈，依赖版本必须统一；
运行时组合：每个子应用独立构建，运行时由主应用负责应用管理，加载，启动，卸载，通信机制 良好的体验，真正的独立开发，独立部署 复杂，需要设计加载，通信机制，无法做到彻底隔离，需要解决依赖冲突，样式冲突问题；
开源微前端框架也有多种，例如阿里出品的qiankun，icestark，还有针对angular提出的mooa等，都能快速接入项目，但结合公司内部系统的特点，直接采用会有有些限制，例如要实现定制界面，无刷新加载应用，且不能对现有项目的开发和部署造成影响，因此决定自研相关技术。
四、架构设计
4.1 应用层
应用层包括所有接入微服务工作台的内部系统，他们各自开发与部署，接入前后没有多大影响，只是需要针对微服务层单独输出打包一份静态资源；
4.2 微服务层
微服务层作为核心模块，拥有资源加载、路由管理、状态管理和用户认证管理几大功能，具体内容将在后面详细阐述，架构整体工作流程如下：
4.3 基础支撑层
基础支撑层作为基座，提供微服务运行的环境和容器，同时接入其他后端服务，丰富实用场景和业务功能；
五、技术重难点
要实现自定义微前端架构，难点在于需要管理和整合多个应用，确保应用之间独立运行，彼此不受影响，需要解决如下几个问题：
5.1 资源管理
5.1.1资源加载
每个应用有一个应用资源管理和注册的文件(app.regiser.js)，其中包含路由信息，应用配置信息(configs.js)和静态资源清单，当首次切换到某应用时，首先加载app.register.js文件，完成路由和应用信息的注册，然后根据当前浏览器路由地址加载对应的静态文件，完成页面渲染，从而将各应用的静态资源串联起来，其中注册入口文件通过webpack插件来实现，具体实现如下：
FuluAppRegisterPlugin.prototype.apply = function(compiler) {
appId = extraAppId();
var entry = compiler.options.entry;
if (isArray(entry)) {
for (var i = 0; i < entry.length; i++) {
if (isIndexFile(entry[i])) { // 入口文件
indexFileEdit(entry[i]);
entry[i] = entry[i].replace(indexEntryRegx, indeEntryTemp); // 替换入口文件
i = entry.length;
}
}
} else {
if (isIndexFile(entry)) { // 入口文件
indexFileEdit(entry); // 重新生成和编辑入口文件
compiler.options.entry = compiler.options.entry.replace(indexEntryRegx, indeEntryTemp); // 替换入口文件
}
}
compiler.hooks.done.tap('fulu-app-register-done', function(compilation) {
fs.unlinkSync(tempFilePath); // 删除临时文件
return compilation;
});
compiler.hooks.emit.tap('fulu-app-register', function(compilation) {
var contentStr = 'window.register("'+ appId + '", {\nrouter: [ \n ' + extraRouters() + ' \n],\nentry: {\n'; // 全局注册方法
var entryCssArr = [];
var entryJsArr = [];
for (var filename in compilation.assets) {
if (filename.match(mainCssRegx)) { // 提取css文件
entryCssArr.push('\"' + filename + '\"');
} else if (filename.match(mainJsRegx) || filename.match(manifestJsRegx) || filename.match(vendorsJsRegx)) { // 提取js文件
entryJsArr.push('\"' + filename + '\"');
}
}
contentStr += ('css: ['+ entryCssArr.join(', ') +'],\n'); // css资源清单
contentStr += ('js: ['+ entryJsArr.join(', ') +'],\n }\n});\n'); // js资源清单
compilation.assets['resources/js/' + appId + '-app-register.js'] = { // 生成appid-app-register.js入口文件
source: function() {
return contentStr;
},
size: function() {
return contentStr.length;
}
};
return compilation;
});
};
5.1.2资源文件名
微服务输出打包模式下，静态资源统一打包形式以项目id开头，形如10000092-main.js，
文件名称的修改通过webpack的插件实现；
核心实现代码如下：
FuluAppRegisterPlugin.prototype.apply = function(compiler) {
......
compiler.options.output.filename = addIdToFileName(compiler.options.output.filename, appId);
compiler.options.output.chunkFilename = addIdToFileName(compiler.options.output.chunkFilename, appId);
compiler.options.plugins.forEach((c) => {
if (c.options) {
if (c.options.filename) {
c.options.filename = addIdToFileName(c.options.filename, appId);
}
if (c.options.chunkFilename) {
c.options.chunkFilename = addIdToFileName(c.options.chunkFilename, appId);
}
}
});
......
};
5.2 路由管理
路由分为应用级和菜单级两大类，应用类以应用id为前缀，将各应用区分开，避免路由地址重名的情况，菜单级的路由由各应用的路由系统自行管理，结构如下：
5.3 状态分隔
前端项目通过状态管理库来进行数据的管理，为了保证各应用彼此间独立，因此需要修改状态库的映射关系，这一部分需要借助于webpack插件来进行统一的代码层面调整，包括model和view两部分代码，model定义了状态对象，view借助工具完成状态对象的映射，调整规则为【应用id+旧状态对象名称】，下面来讲解一下插件的实现；
插件的实现原理是借助AST的搜索语法匹配源代码中的状态编写和绑定的相关代码，然后加上应用编号前缀，变成符合预期的AST，最后输出成目标代码：
module.exports = function(source) {
var options = loaderUtils.getOptions(this);
stuff = 'app' + options.appId;
isView = !!~source.indexOf('React.createElement'); // 是否是视图层
allFunc = [];
var connectFn = "function connect(state) {return Object.keys(state).reduce(function (obj, k) { var nk = k.startsWith('"+stuff+"') ? k.replace('"+stuff+"', '') : k; obj[nk] = state[k]; return obj;}, {});}";
connctFnAst = parser.parse(connectFn);
const ast = parser.parse(source, { sourceType: "module", plugins: ['dynamicImport'] });
traverse(ast, {
CallExpression: function(path) {
if (path.node.callee && path.node.callee.name === 'connect') { // export default connext(...)
if (isArray(path.node.arguments)) {
var argNode = path.node.arguments[0];
if (argNode.type === 'FunctionExpression') { // connect(() => {...})
traverseMatchFunc(argNode);
} else if (argNode.type === 'Identifier' && argNode.name !== 'mapStateToProps') { // connect(zk)
var temp_node = allFunc.find((fnNode) => {
return fnNode.id.name === argNode.name;
});
if (temp_node) {
traverseMatchFunc(temp_node);
}
}
}
} else if (path.node.callee && path.node.callee.type === 'SequenceExpression') {
if (isArray(path.node.callee.expressions)) {
for (var i = 0; i < path.node.callee.expressions.length; i++) {
if (path.node.callee.expressions[i].type === 'MemberExpression'
&& path.node.callee.expressions[i].object.name === '_dva'
&& path.node.callee.expressions[i].property.name === 'connect') {
traverseMatchFunc(path.node.arguments[0]);
i = path.node.callee.expressions.length;
}
}
}
}
},
FunctionDeclaration: function(path) {
if (path.node.id.name === 'mapStateToProps' && path.node.body.type === 'BlockStatement') {
traverseMatchFunc(path.node);
}
allFunc.push(path.node);
},
ObjectExpression: function(path) {
if (isView) {
return;
}
if (isArray(path.node.properties)) {
var temp = path.node.properties;
for (var i = 0; i < temp.length; i++) {
if (temp[i].type === 'ObjectProperty' && temp[i].key.name === 'namespace') {
temp[i].value.value = stuff + temp[i].value.value;
i = temp.length;
}
}
}
}
});
return core.transformFromAstSync(ast).code;
};
5.4 框架容器渲染
完成以上步骤的改造，就可以实现容器中的页面渲染，这一部分涉及到组件库框架层面的调整，大流程如下图：
六、构建流程
6.1 使用插件
构建过程中涉及到两款自开发的插件，分别是fulu-app-register-plugin和fulu-app-loader；
6.1.1 安装
npm i fulu-app-register-plugin fulu-app-loader -D;
6.1.2 配置
webpack配置修改:
const FuluAppRegisterPlugin = require('fulu-app-register-plugin');
module: {
rules: [{
test: /\.jsx?$/,
loader: 'fulu-app-loader',
}
]
}
plugins: [
new FuluAppRegisterPlugin(),
......
]
6.2.编译
编译过程与目前项目保持一致，相比以前，多输出了一份微前端项目编译代码，流程如下：
七、遗留问题
7.1 js环境隔离
由于各应用都加载到同一个运行环境，因此如果修改了公共的部分，则会对其他系统产生不可预知的影响，目前没有比较好的办法来解决，后续将持续关注这方面的内容，逐渐优化达到风险可制的效果。
7.2.获取token
目前应用切换使用重定向来完成token获取，要实现如上所述的微前端效果，需要放弃这种方式，改用接口调用异步获取，或者其他解决方案。
