用途:SonarJS 项目的构建与元数据生成流水线参考,适合在需要构建项目、重新生成元数据或运行 npm 构建脚本时查阅。
主要能力与用法:安装依赖用 npm ci;快速排查编译错误用 npx tsc -b packages(不生成输出);快速 JS/TS 构建(不含测试)用 npm run bbf,其流程为清空 lib、执行 generate-meta、再编译。修改规则 TS 代码后运行 npm run bbf;修改 config.ts 或 meta.ts 后先 npm run generate-meta 再 npm run bbf;修改 fields 数组后运行 npm run generate-meta 再 npm run generate-java-rule-classes。完整插件构建用 mvn install -DskipTests,含测试的完整清理构建用 mvn clean install。
元数据链路:generate-meta 读取 javascript-checks 资源目录下的 RSPEC 元数据 JSON(该目录已提交,共 526 个文件,是 generate-meta 的事实来源),写到 packages/analysis/src/jsts/rules/SXXXX/generated-meta.ts(被 gitignore)。resources/rule-data/ 与 lib/ 同样被 gitignore。
构建配置:mvn clean install -P coverage-report 可带 JaCoCo 覆盖率;SONARSOURCE_QA=true mvn clean install 运行集成测试。Maven 构建需要 GITHUB_TOKEN 环境变量并具备 SonarSource/rspec 的读取权限。
限制与注意:不要运行 npm run bridge:test 或 npm run ruling,耗时过长;如需可针对单个测试文件运行 npx tsx --test $test_file。generated-meta.ts、Java 与 CSS 检查类均为自动生成,请勿手动编辑。其他细节暂未提供。