9.2 执行分析
9.2.1 手动执行
| 入口 | 说明 |
|---|---|
| 资源管理器右键【分析项目依赖与循环引用】 | 可对任意文件或目录右键;右键文件时报告面板会默认为该文件定位依赖 |
| 命令面板【分析项目依赖与循环引用】 | 命令 udmp.analyzeDependencies,无参数执行 |
| 命令面板【分析项目依赖与循环引用(JSON)】 | 命令 udmp.analyzeDependenciesJson,返回结构化结果,主要供脚本 / Agent 调用,界面无提示,见 9.2.4 |
执行时窗口底部显示进度「正在分析项目依赖…」,完成后在编辑区右侧打开【项目依赖与循环检测】面板;面板已打开时复用同一面板并刷新内容。
结果提示:
- 存在错误时弹出警告消息,提示发现的循环数与错误数,详情见报告面板;
- 未发现错误时提示「共 N 个文件,未发现错误」;
- 每次分析的结果同时写入输出面板的「操作」通道,便于回溯。
9.2.2 自动检查
开启自动检查(默认开启)后,以下时机会自动重新分析,结果同时刷新报告面板与 Problems 面板:
| 触发时机 | 分析范围 |
|---|---|
| 插件启动、工程文件清单扫描完成 | 全量 |
| BOM 加载或刷新完成 | 全量(补齐业务对象继承相关结果) |
| 规则文件保存 | 只重算该文件的出边,并重新计算环与问题 |
| 文件删除 | 移除对应节点后重新分析,其它文件的悬空引用随之更新 |
| 文件 / 目录改名 | 同步依赖图节点路径后重新分析 |
说明:
- 需要全量分析的触发做了 800 毫秒去抖,连续保存不会重复触发;保存单个已知文件时直接做增量更新,面板刷新另有 300 毫秒去抖,避免画面闪烁;
- 新增文件、规则包目录内容变化、以及找不到节点的变更会退化为全量分析;
- 目录改名时,插件还会自动把工程内引用了该规则包的文件同步为新的包名(可撤销),同步结果写入输出面板的「重构」通道;
- 如需关闭自动检查,将
udm.analysis.enableAutoAnalyze设为false,此后只能通过手动执行或面板【重新分析】按钮触发。
9.2.3 重新分析
报告面板右上角提供【重新分析】按钮,可在修改文件、切换分支或调整配置后立即刷新结果,无需重新执行命令。
9.2.4 编程调用(JSON)
供 UDM Agent、CI 或其它扩展调用的命令:
udmp.analyzeDependenciesJson(options?: { includeGraph?: boolean })
- 返回
{ success, report?, error? },无论内部是否异常都会返回结果对象,不向调用方抛出异常; - 默认结果会裁剪
nodes/edges(依赖树明细),只返回统计、问题、循环、悬空引用、继承与规则应用,以控制体积;传includeGraph: true可返回完整图数据; - 报告字段含义参见 9.3 报告面板 与 9.4 问题定位与导出。