如何借助JS工具链打包全依赖JS库(如cytoscape.js布局扩展)供非JS工程使用
完全可以实现目标效果,最终产出的单文件资源和jQuery UI构建器输出的可直接通过script标签引入的资源表现完全一致,整个流程和业务前端代码完全解耦,不需要把业务代码迁入JS构建工程,所有依赖的全深度兼容版本解析、打包、压缩都可以自动完成。
方案不绑定特定技术:可以替换为yarn/pnpm作为依赖管理工具、rollup/terser作为打包器,最终产出效果完全一致,完全适配无JS构建流程的非JS工程使用场景。
整个流程只需要搭建一个独立的、仅用于打包依赖的空JS目录,所有业务代码仍然保留在原有项目中,完全不耦合。
第一步:初始化独立打包工程
新建空目录作为打包专用空间,执行npm init -y初始化项目,通过npm自动拉取所有兼容版本的依赖,不需要手动从零散渠道收集文件:npm install cytoscape cytoscape-cola cytoscape-cise cytoscape-dagre npm install esbuild --save-devnpm会自动解析每个依赖的嵌套依赖树,匹配所有布局扩展要求的Cytoscape核心版本范围,自动拉取dagre、cola布局对应的底层算法依赖,不会出现版本冲突问题。
第二步:编写极简入口文件
在打包目录下新建bundle-entry.js,仅负责引入所有依赖、注册扩展、把核心对象暴露到全局供老的jQuery/原生JS代码调用:import cytoscape from 'cytoscape'; import cola from 'cytoscape-cola'; import cise from 'cytoscape-cise'; import dagre from 'cytoscape-dagre'; // 全局注册所有布局扩展,业务侧无需重复注册 cytoscape.use(cola); cytoscape.use(cise); cytoscape.use(dagre); // 挂载到全局对象,适配原有老项目的调用逻辑 window.cytoscape = cytoscape;第三步:执行打包生成单文件
用ESBuild执行打包,通过参数匹配“仅基础压缩、不做符号混淆、输出可直接引用的单文件”的要求,执行如下命令:npx esbuild bundle-entry.js \ --bundle \ --minify-whitespace \ --minify-syntax \ --keep-names \ --format=iife \ --outfile=./dist/cytoscape-full-bundle.js各参数的作用完全匹配实际需求:
--bundle:自动把入口文件关联的所有依赖(包括全深度嵌套的底层依赖)全部聚合进单文件,不需要手动整理依赖引入顺序--minify-whitespace、--minify-syntax:仅做空格移除、安全语法简化的基础压缩,不做任何侵入式代码改写--keep-names:强制保留所有变量、函数、类的原始命名,不做符号混淆,业务代码调用时不会出现方法、属性名被改写找不到的问题--format=iife:输出立即执行函数格式的代码,不依赖任何模块加载器,直接通过script标签即可引入使用
- 生成的
cytoscape-full-bundle.js可以作为静态资源托管在任意后端技术栈的项目下,不管是Java、PHP、Python还是纯静态站点,只要在HTML里通过<script>标签引入即可 - 原有业务代码不需要做任何改动:之前怎么调用cytoscape初始化图、怎么配置布局参数,现在可以完全复用,所有注册好的cola、cise、dagre布局可以直接在配置项里启用,不需要额外引入其他零散JS文件
- 整个打包工程完全独立:只要依赖版本不升级,生成的单文件可以长期复用,不需要在每次修改业务代码时重新执行打包流程
这个流程下的打包策略和预期完全匹配:因为打包流程无法预判业务侧实际会用到哪些API、哪些布局参数,所以默认不开启代码剪枝(tree-shaking),会把所有引入的库的全量代码打包进文件,仅做无侵入的基础压缩,避免出现“业务调用的方法没被打进包里”的故障。最终文件体积经过压缩后完全可以满足内部业务系统的使用需求,不会为了追求极致体积牺牲兼容性和稳定性。
内容的提问来源于stack exchange,提问作者Marek Sebera

