JaCoCo 命令行界面 (CLI) 详细分析与总结

概述

JaCoCo 提供了一个命令行界面,允许用户在命令行中执行基本操作。命令行工具及其所有依赖项打包在 jacococli.jar 中,并随 JaCoCo 下载提供。执行这些工具需要 Java 1.5 或更高版本。

注意事项

  • 虽然提供了 instrument 命令,但 JaCoCo 进行代码覆盖分析的首选方式是使用 JaCoCo Agent 进行即时插桩。离线插桩有多个缺点,仅在特定场景明确需要时才应使用。在使用此模式之前,请查阅有关离线插桩的文档。

可用命令

dump

请求在 'tcpserver' 输出模式下运行的 JaCoCo Agent 的执行数据。

shell 复制代码
java -jar jacococli.jar dump [--address <address>] --destfile <path> [--port <port>] [--quiet] [--reset] [--retry <count>]
  • 选项包括地址、目标文件、帮助、端口、静默模式、重置执行数据、重试次数等。
instrument

对 Java 类文件和 JAR 文件进行离线插桩。

shell 复制代码
java -jar jacococli.jar instrument [<sourcefiles> ...] --dest <dir> [--quiet]
  • 选项包括源文件列表、目标目录、帮助、静默模式等。
merge

合并多个 exec 文件到一个新的文件中。

shell 复制代码
java -jar jacococli.jar merge [<execfiles> ...] --destfile <path> [--quiet]
  • 选项包括执行文件列表、目标文件、帮助、静默模式等。
report

通过读取 exec 和 Java 类文件生成不同格式的报告。

shell 复制代码
java -jar jacococli.jar report [<execfiles> ...] --classfiles <path> [--csv <file>] [--encoding <charset>] [--html <dir>] [--name <name>] [--sourcefiles <path>] [--tabwith <n>] [--xml <file>]
  • 选项包括执行文件列表、类文件位置、CSV 输出文件、编码、HTML 输出目录、报告名称、源文件位置、制表位宽度、XML 输出文件等。
classinfo

打印提供位置的 Java 类文件的信息。

shell 复制代码
java -jar jacococli.jar classinfo [<classlocations> ...] [--verbose]
  • 选项包括类文件位置、帮助、静默模式、详细模式等。
execinfo

以人类可读的格式打印 exec 文件内容。

shell 复制代码
java -jar jacococli.jar execinfo [<execfiles> ...] [--quiet]
  • 选项包括执行文件列表、帮助、静默模式等。
version

打印 JaCoCo 版本信息。

shell 复制代码
java -jar jacococli.jar version [--quiet]
  • 选项包括帮助、静默模式等。

参数说明

  • ◼ 表示必须参数。
  • 表示可以多次指定的参数。

总结

JaCoCo CLI 提供了一套丰富的命令,用于代码覆盖率的生成、合并、报告等。用户可以根据自己的需求选择合适的命令和参数来执行特定的任务。虽然提供了离线插桩的命令,但推荐使用即时插桩以获得更好的效果和避免潜在的问题。

ref: https://www.eclemma.org/jacoco/trunk/doc/cli.html

相关推荐
稚辉君.MCA_P8_Java4 分钟前
kafka解决了什么问题?mmap 和sendfile
java·spring boot·分布式·kafka·kubernetes
乄bluefox6 分钟前
保姆级docker部署nacos集群
java·docker·容器
欣然~13 分钟前
百度地图收藏地址提取与格式转换工具 说明文档
java·开发语言·dubbo
玩毛线的包子33 分钟前
Android Gradle学习(十三)- 配置读取和文件写入
java
青岛少儿编程-王老师1 小时前
CCF编程能力等级认证GESP—C++6级—20250927
java·c++·算法
一條狗1 小时前
学习日报 20251007|深度解析:基于 Guava LoadingCache 的优惠券模板缓存设计与实现
java·oracle·loadingcache
Miraitowa_cheems2 小时前
LeetCode算法日记 - Day 64: 岛屿的最大面积、被围绕的区域
java·算法·leetcode·决策树·职场和发展·深度优先·推荐算法
Lisonseekpan2 小时前
Spring Boot 中使用 Caffeine 缓存详解与案例
java·spring boot·后端·spring·缓存
为java加瓦2 小时前
Rust 的类型自动解引用:隐藏在人体工学设计中的魔法
java·服务器·rust
SimonKing2 小时前
分布式日志排查太头疼?TLog 让你一眼看穿请求链路!
java·后端·程序员