SuperAPI AI 工具集

compile

通用与其它

查看项目

更新于 10-15 16:51

技能介绍

用途:在提交 PR 前构建并验证 Apache SkyWalking 项目,使本地检查与 CI 保持一致。

前提条件:JDK 11、17 或 21(LTS 版本);Maven 3.6+,使用 ./mvnw 包装器。

Maven 配置档:backend(默认,构建 OAP 服务器模块)、ui(默认,构建 Web 应用)、dist(默认,生成发行包)、all(构建全部并初始化子模块)。

按参数执行的命令:all 或无参数为完整 CI 构建;backend 仅构建后端,速度更快;javadoc 仅做 javadoc 检查;checkstyle 仅做 checkstyle 检查;传入模块名可构建单个模块。

读取 javadoc 输出:Maven 会给所有 javadoc 输出加 [ERROR] 前缀,真正严重程度在行号后的消息中。只有含 error: 的行会导致构建失败,warning: 不会。常见错误包括 bad use of '>'、heading out of sequence、reference not found。

标题规则(JDK 13+):类、接口、枚举、包、模块从 h2 起;构造器、方法、字段从 h4 起;doc-files/ 下的独立 HTML 文件从 h1 起。JDK 11 不强制,JDK 17/21/25 会。

CI 参考:CI 在 Linux 上使用 JDK 11。dist-tar 作业与 code-style 作业分别运行对应命令。

限制:javadoc 依赖 delombok 输出,必须先运行 install,否则 ${delombok.output.dir} 未填充会漏报错误。资料未提供收费、价格或平台信息。