基于ESM作用域映射与在线代理的插件联调方法及系统与流程
本发明涉及前端插件调试,尤其涉及基于esm作用域映射与在线代理的插件联调方法及系统。
背景技术:
1、在插件化前端架构中,宿主平台通常向插件暴露公共运行时与共享依赖,以降低重复打包并维持框架、状态库等模块的单例特性。插件开发需要运行于宿主平台真实上下文,才能验证生命周期、路由、状态共享及样式隔离等行为。常规构建方案通过打包器外部化配置,将公共依赖保留为裸模块标识符,再由浏览器原生 es 模块加载、导入映射表或模块联邦等机制解析至宿主平台资源。调试环节多采用本地开发服务器承载插件源码,并借助反向代理把线上页面中的生产产物请求转发至本地。
2、传统做法在单一插件、单一开发者场景下尚可运行。多个插件并行开发时,不同插件对同一公共依赖的请求均表现为相同裸模块标识符,缺少插件作用域区分,浏览器模块缓存与宿主运行时上下文难以判断请求来源,容易造成模块重复实例化、单例状态分裂或运行时污染。生产构建与开发构建往往共用一套外部化配置,开发期引入的路径重写或调试映射误入生产产物,增加构建风险与维护成本。
3、本地调试对反向代理的依赖存在可用性问题。代理配置通常固定指向本地开发服务器,本地服务未启动、端口变更或网络异常时,线上页面无法继续加载,调试链路中断。远程环境与本地环境切换依赖人工修改代理规则,难以在协作开发、持续集成和远程联调场景中保持稳定,制约插件开发调试效率与宿主平台可靠性。
技术实现思路
1、本发明实施例提供基于esm作用域映射与在线代理的插件联调方法及系统,能够解决现有技术中的问题。
2、本发明实施例的第一方面,提供基于esm作用域映射与在线代理的插件联调方法,包括:
3、构建阶段,读取构建环境参数以区分生产构建与插件开发构建;当为生产构建时,扫描宿主平台底层共享依赖,生成由裸模块标识符指向宿主平台公共模块资源路径的裸模块映射表,且不注入插件开发作用域重写规则;
4、当为插件开发构建时,在所述裸模块映射表基础上,为每个已注册插件开发作用域动态扩展生成由带插件作用域前缀的模块标识符指向所述宿主平台公共模块资源路径的作用域映射表;
5、调试阶段,本地开发服务器接收插件代码更新,将插件内部的公共依赖请求改写为带插件作用域前缀的模块标识符,浏览器依据所述作用域映射表将所述模块标识符请求重定向至宿主平台公共模块资源路径,复用宿主平台运行时上下文,保持模块单例一致;
6、本地反向代理网关拦截线上平台对生产编译产物的请求,将所述请求重写为指向本地开发服务器源码入口的请求,主转发节点指向本地开发服务器,备份转发节点指向远程环境,当本地开发服务器未启动时自动降级转发至远程环境。
7、生成由裸模块标识符指向宿主平台公共模块资源路径的裸模块映射表,包括:
8、读取构建命令中携带的环境参数,判断所述环境参数是否表征生产构建;当所述环境参数表征生产构建时,进入生产构建流程,并将本次构建产生的映射表标记为面向生产环境发布,同时关闭插件开发作用域映射的生成功能;
9、遍历宿主平台底层共享依赖清单,逐项提取各共享依赖的依赖名称与裸模块标识符,并依据所述依赖名称确定各共享依赖在宿主平台公共模块资源服务器上对应的资源路径;
10、将各共享依赖的裸模块标识符与所述资源路径建立一一对应关系,使每个裸模块标识符唯一确定一个资源路径,据此生成仅保留裸模块标识符至资源路径映射关系的裸模块映射表,并输出所述裸模块映射表供浏览器在生产环境中解析模块请求;
11、在所述裸模块映射表中不写入任何带插件作用域前缀的模块标识符的映射关系,使生产环境与开发调试作用域相互隔离,杜绝将开发态调试路由暴露至生产环境,防止对生产环境注入调试相关的模块解析规则。
12、遍历宿主平台底层共享依赖清单,包括:
13、解析宿主平台底层共享依赖清单,逐项提取各共享依赖的依赖名称与版本号,所述依赖名称与版本号共同标识一个共享依赖,所述版本号标识各共享依赖在宿主平台公共模块资源服务器上的具体发布版本;
14、依据各共享依赖的依赖名称与版本号,确定各共享依赖在宿主平台公共模块资源服务器上对应的资源路径,所述资源路径由宿主平台公共模块资源服务器的地址与所述依赖名称、版本号共同确定,使同一共享依赖在开发构建与生产构建下均对应同一资源路径;
15、将各共享依赖的裸模块标识符固化指向所述资源路径,使每个共享依赖的裸模块标识符唯一确定资源路径,并将所述裸模块标识符与资源路径的固化对应关系写入所述裸模块映射表;
16、使插件在开发构建与生产构建中引用同一共享依赖时,均解析至同一资源路径,保证开发态与生产态共享依赖的版本一致,避免因版本差异导致的模块单例失效,从而消除开发态与生产态之间的公共依赖版本漂移。
17、生成由带插件作用域前缀的模块标识符指向所述宿主平台公共模块资源路径的作用域映射表,包括:
18、当所述环境参数表征插件开发构建时,读取已注册插件列表,并确定每个已注册插件对应的插件标识与插件开发作用域,所述已注册插件列表记录插件开发模式下需要联调的全部插件,所述插件开发作用域为每个插件在本地开发服务器中对应的模块解析作用域;
19、为每个插件开发作用域,将带插件作用域前缀的模块标识符映射至所述宿主平台公共模块资源路径,所述带插件作用域前缀的模块标识符由插件标识与插件内部公共依赖的裸模块标识符组合而成;
20、依据各插件开发作用域及对应的映射关系,在保留所述裸模块映射表原有映射关系的基础上,追加插件开发作用域对应的映射关系,动态扩展生成作用域映射表,使所述作用域映射表同时包含裸模块标识符映射与带插件作用域前缀的模块标识符映射;
21、使浏览器加载插件源码并发出带插件作用域前缀的模块标识符请求时,能够依据所述作用域映射表解析所述带插件作用域前缀的模块标识符。
22、依据各插件开发作用域及对应的映射关系,在保留所述裸模块映射表原有映射关系的基础上,追加插件开发作用域对应的映射关系,包括:
23、读取本地开发服务器在热替换模式下对插件内部公共依赖请求的改写规则,所述改写规则记载插件内部公共依赖请求的原始裸模块标识符与改写后带插件作用域前缀的模块标识符之间的对应关系,并随本地开发服务器接收的插件代码更新而同步更新;
24、依据所述改写规则,确定插件内部公共依赖请求被改写后带插件作用域前缀的模块标识符的格式,所述格式包括插件开发作用域前缀与插件内部公共依赖的裸模块标识符之间的组合方式;
25、依据所述格式,为每个插件开发作用域中的各公共依赖,建立带插件作用域前缀的模块标识符至所述宿主平台公共模块资源路径的映射关系,使所述带插件作用域前缀的模块标识符指向与所述裸模块映射表中相同公共依赖一致的资源路径;
26、将所述映射关系写入所述作用域映射表,使所述带插件作用域前缀的模块标识符在所述作用域映射表中能够被精准命中,避免因改写格式差异导致的所述作用域映射表未命中。
27、浏览器依据所述作用域映射表将所述模块标识符请求重定向至宿主平台公共模块资源路径,包括:
28、浏览器加载插件源码,解析插件源码中的模块导入语句,所述模块导入语句由插件源码中引用公共依赖的语句构成,确定所述模块导入语句对应的带插件作用域前缀的模块标识符,并发出所述带插件作用域前缀的模块标识符请求;
29、发出所述请求时,在所述作用域映射表中匹配与所述模块标识符前缀相同的映射关系,所述作用域映射表按插件开发作用域组织各映射关系,依据所述模块标识符中携带的插件开发作用域前缀,逐项比对所述作用域映射表中各映射关系的前缀;
30、命中所述映射关系后,将所述请求重定向至所述映射关系对应的宿主平台公共模块资源路径,所述宿主平台公共模块资源路径与所述裸模块映射表中相同公共依赖对应的资源路径一致,使所述请求解析至宿主平台公共模块资源服务器;
31、复用宿主平台运行时上下文,保持模块单例一致,避免插件在开发态重复加载宿主平台的公共依赖,使插件与宿主平台共享同一运行时上下文,实现插件对宿主平台公共依赖的复用。
32、复用宿主平台运行时上下文,包括:
33、将所述带插件作用域前缀的模块标识符请求重定向至宿主平台公共模块资源路径后,浏览器获取所述资源路径对应的公共依赖的模块实例,所述模块实例由宿主平台在加载所述公共依赖时生成并登记于宿主平台运行时上下文;
34、当所述公共依赖已被宿主平台加载时,浏览器直接获取宿主平台已加载的模块实例;当所述公共依赖尚未被宿主平台加载时,由宿主平台加载所述公共依赖并生成模块实例,所述模块实例为宿主平台运行态中已注册的模块单例;
35、插件与宿主平台共享所述模块实例,使插件在开发态引用的公共依赖与宿主平台运行态引用的公共依赖为同一模块实例,使插件与宿主平台对公共依赖的引用均指向所述模块实例,所述模块实例在宿主平台与插件之间仅存在一份;
36、消除插件与宿主平台之间的公共依赖重复加载,避免因重复加载导致的单例对象失效,保证插件与宿主平台在浏览器端的模块单例与运行时上下文一致,避免模块状态不一致。
37、本发明实施例的第二方面,提供一种基于esm作用域映射与在线代理的插件联调系统,包括:
38、构建区分单元,用于构建阶段,读取构建环境参数以区分生产构建与插件开发构建;
39、生产映射单元,用于当为生产构建时,扫描宿主平台底层共享依赖,生成由裸模块标识符指向宿主平台公共模块资源路径的裸模块映射表,且不注入插件开发作用域重写规则;
40、开发映射单元,用于当为插件开发构建时,在所述裸模块映射表基础上,为每个已注册插件开发作用域动态扩展生成由带插件作用域前缀的模块标识符指向所述宿主平台公共模块资源路径的作用域映射表;
41、调试复用单元,用于调试阶段,本地开发服务器接收插件代码更新,将插件内部的公共依赖请求改写为带插件作用域前缀的模块标识符,浏览器依据所述作用域映射表将所述模块标识符请求重定向至宿主平台公共模块资源路径,复用宿主平台运行时上下文,保持模块单例一致;
42、代理降级单元,用于本地反向代理网关拦截线上平台对生产编译产物的请求,将所述请求重写为指向本地开发服务器源码入口的请求,主转发节点指向本地开发服务器,备份转发节点指向远程环境,当本地开发服务器未启动时自动降级转发至远程环境。
43、本发明实施例的第三方面,提供一种电子设备,包括:
44、处理器;
45、用于存储处理器可执行指令的存储器;
46、其中,所述处理器被配置为调用所述存储器存储的指令,以执行前述所述的方法。
47、本发明实施例的第四方面,提供一种计算机可读存储介质,其上存储有计算机程序指令,所述计算机程序指令被处理器执行时实现前述所述的方法。
48、本技术的有益效果如下:
49、生产构建与插件开发构建分离,生产构建仅生成裸模块映射表且不注入开发作用域重写规则,避免开发态解析逻辑进入生产产物,保障线上模块加载路径稳定纯净,降低构建配置误用引发的运行风险。裸模块映射表集中管理宿主共享依赖,减少重复打包与版本漂移,提升生产资源复用率与加载性能。
50、开发构建在裸模块映射表上动态扩展作用域映射表,为不同插件开发作用域建立独立映射关系,使带插件作用域前缀的模块标识符准确指向宿主公共模块资源路径。多插件并行开发依赖请求互不干扰,抑制作用域冲突与版本覆盖,增强插件隔离性与可扩展性。
51、调试阶段本地开发服务器接收插件代码更新,将公共依赖请求改写为带作用域前缀标识符,浏览器依据作用域映射表重定向至宿主公共模块资源路径,复用宿主平台运行时上下文,保持模块单例一致。避免依赖重复实例化与状态分裂,插件热更新后仍与宿主运行时无缝协同,提升调试准确性与响应速度。
52、本地反向代理网关拦截线上平台对生产编译产物的请求,将其重写为本地开发服务器源码入口请求,主转发节点指向本地开发服务器,备份转发节点指向远程环境,本地开发服务器未启动时自动降级转发至远程环境。线上页面可联调本地插件源码,无需发布生产包,兼顾调试效率与远程可用性,降低联调对线上稳定性影响。
版权声明:本站专利文献数据主要来源于国家知识产权局等公开渠道,由 技术新讯 进行整理汇编。页面设计及数据汇编的著作权归本站所有。全部内容仅供个人学习、科研评估与技术交流参考,严禁用于任何商业用途(包括但不限于直接生产制造、技术转让、倒卖数据等)。
免责条款:专利技术具有时效性,本站不对资料的绝对准确性、完整性和可实施性提供任何明示或暗示的担保。因参考本站内容造成的直接或间接损失,本站不承担相关法律责任。若您认为本站内容有侵权问题,请及时提供权属证明与我们联系,本站将在核实后依法处理。反馈意见:yyfuon@163.com