9.5 部署与编译前校验

为避免把带循环依赖或悬空引用的规则发布到服务器,插件在执行部署、编译打包前会先做一次依赖校验。

9.5.1 触发入口

入口 命令 校验范围
资源管理器右键规则文件【部署到UDM服务器】 udmp.deploy 该文件及其可达的依赖子图
编程调用【编译并打包】 udmp.compileAndPackage 全项目规则文件(供 Agent / CI 调用,未注册到命令面板)

校验范围按「目标文件引用了什么」向下展开(出边方向):目标文件、它引用的文件、以及继续向下引用的文件都算受影响;如果目标是规则包目录,则该目录下的所有文件都算受影响。

9.5.2 校验与拦截

  • 校验前会重新执行一次分析,因此结果始终反映磁盘最新内容;
  • 只要受影响范围内存在错误级问题(循环依赖、悬空引用、循环继承),校验即判定为阻断;
  • 存在阻断问题时弹出模态确认框,标题为「部署前检测到依赖问题,是否仍然继续?」(编译打包时为「编译并打包前检测到依赖问题,是否仍然继续?」);
  • 确认框详情最多列出 12 条问题,格式为 【问题类型】来源文件:问题描述;超出部分提示「另有 N 条问题,详情见依赖分析报告」;
  • 选择【仍然继续】继续执行部署 / 打包;选择【取消】中止本次操作。

9.5.3 关闭校验

将配置 udm.analysis.blockOnDeploy 设为 false 后,部署与编译打包前不再校验,也不会弹出确认框。

关闭后仍可在部署前手动执行一次【分析项目依赖与循环引用】,从报告面板确认没有问题后再发布。

9.5.4 异常处理

校验过程本身出错(例如分析异常)时不会阻断主流程,仅在调试控制台记录错误;此时部署、打包照常执行。

9.5.5 建议流程

  1. 修改规则文件并保存,等待自动分析刷新 Problems 面板;
  2. 打开【项目依赖与循环引用】报告面板,确认「循环依赖」「悬空引用」「业务对象继承」三个区块均为空;
  3. 需要在评审或归档时留存证据,点击【导出报告】或【导出 Problems】;
  4. 执行【部署到UDM服务器】或【编译并打包】,如果仍出现确认框,按 9.4 / 9.3 的定位方式逐条核对后再决定是否继续。

results matching ""

    No results matching ""