SuperAPI AI 工具集

merging-devtools-module

编程与开发

查看项目

更新于 11-06 18:11

技能介绍

该技能说明如何把 DevTools 的一个子模块(例如 panels/timeline/extensions)合并进其父模块(例如 panels/timeline)。目标是合并 BUILD.gn 配置、简化构建,同时保留原有源码文件目录结构。

前置信息:需要父模块路径(主模块所在目录)和子模块路径(待合并子模块目录)。

使用方式按以下步骤执行:

  1. 分析构建配置:分别阅读子模块与父模块的 BUILD.gn,从子模块中找出 devtools_module 的 sources 列表、ts_deps(含非 TypeScript 依赖)以及 devtools_entrypoint("bundle") 的入口。

  2. 修改父模块 BUILD.gn:把子模块 sources 追加到父模块 sources 中,路径保持相对父目录(如 extensions/ExtensionUI.ts);把子模块 ts_deps 及非 TypeScript 依赖并入父模块并去重;删除父模块中对子模块 bundle 的依赖(如 ./extensions:bundle)。

  3. 删除子模块 BUILD.gn:父模块配置补齐后,执行 rm <child_module_path>/BUILD.gn。

  4. 更新 config/gni/devtools_grd_files.gni:从 grd_files_bundled_sources 中删除子模块打包后的 JavaScript 文件(通常对应其入口);把子模块原有 TypeScript 源文件(.ts)加入 grd_files_unbundled_sources。

文档给出了 panels/timeline/extensions 合并进 panels/timeline 的示例,展示修改前后 BUILD.gn 的 sources、ts_deps 差异,删除子模块 BUILD.gn 的命令,以及 .gni 中 bundled 与 unbundled 源文件列表的调整方式。

合并后可能仍存在仅做再导出的 barrel 文件(如 index.ts 或 extensions.ts),应予以移除。手动更新所有依赖这些 barrel 的导入既繁琐又易错,可用 unbarrelify 工具自动把来自 barrel 文件的导入替换为对源文件的直接导入;按其仓库说明安装并在项目中运行,文档强烈推荐用它完成重构。

限制与注意事项:文档仅覆盖上述构建配置合并与 barrel 清理流程,未提供其他构建系统、回滚方案或验证测试的说明;示例中的路径与依赖需按实际模块替换。