public class JacocoTaskExtension extends Object
Modifier and Type | Class | Description |
---|---|---|
static class |
JacocoTaskExtension.Output |
The types of output that the agent can use for execution data.
|
Constructor | Description |
---|---|
JacocoTaskExtension(ObjectFactory objects,
org.gradle.internal.jacoco.JacocoAgentJar agent,
JavaForkOptions task) |
Creates a Jacoco task extension.
|
Modifier and Type | Method | Description |
---|---|---|
String |
getAddress() |
IP address or hostname to use with
JacocoTaskExtension.Output.TCP_SERVER or JacocoTaskExtension.Output.TCP_CLIENT . |
FileCollection |
getAgentClasspath() |
The Jacoco agent classpath.
|
String |
getAsJvmArg() |
Gets all properties in the format expected of the agent JVM argument.
|
File |
getClassDumpDir() |
Path to dump all class files the agent sees are dumped to.
|
File |
getDestinationFile() |
The path for the execution data to be written to.
|
List<String> |
getExcludeClassLoaders() |
List of classloader names that should be excluded from analysis.
|
List<String> |
getExcludes() |
List of class names that should be excluded from analysis.
|
List<String> |
getIncludes() |
List of class names that should be included in analysis.
|
JacocoTaskExtension.Output |
getOutput() |
The type of output to generate.
|
int |
getPort() |
Port to bind to for
JacocoTaskExtension.Output.TCP_SERVER or JacocoTaskExtension.Output.TCP_CLIENT . |
String |
getSessionId() |
An identifier for the session written to the execution data.
|
boolean |
isDumpOnExit() |
Whether or not to dump the coverage data at VM shutdown.
|
boolean |
isEnabled() |
Whether or not the task should generate execution data.
|
boolean |
isIncludeNoLocationClasses() |
Whether or not classes without source location should be instrumented.
|
boolean |
isJmx() |
Whether or not to expose functionality via JMX under
org.jacoco:type=Runtime . |
void |
setAddress(String address) |
|
void |
setClassDumpDir(File classDumpDir) |
Sets path to dump all class files the agent sees are dumped to.
|
void |
setDestinationFile(File destinationFile) |
|
void |
setDestinationFile(Provider<File> destinationFile) |
Set the provider for calculating the destination file.
|
void |
setDumpOnExit(boolean dumpOnExit) |
|
void |
setEnabled(boolean enabled) |
|
void |
setExcludeClassLoaders(List<String> excludeClassLoaders) |
|
void |
setExcludes(List<String> excludes) |
|
void |
setIncludeNoLocationClasses(boolean includeNoLocationClasses) |
|
void |
setIncludes(List<String> includes) |
|
void |
setJmx(boolean jmx) |
|
void |
setOutput(JacocoTaskExtension.Output output) |
|
void |
setPort(int port) |
|
void |
setSessionId(String sessionId) |
@Incubating public JacocoTaskExtension(ObjectFactory objects, org.gradle.internal.jacoco.JacocoAgentJar agent, JavaForkOptions task)
objects
- the object factoryagent
- the agent JAR to use for analysistask
- the task we extend@Input public boolean isEnabled()
true
.public void setEnabled(boolean enabled)
@Nullable @Optional @OutputFile public File getDestinationFile()
public void setDestinationFile(Provider<File> destinationFile)
destinationFile
- Destination file providerpublic void setDestinationFile(File destinationFile)
@Nullable @Optional @Input public List<String> getIncludes()
@Nullable @Optional @Input public List<String> getExcludes()
@Nullable @Optional @Input public List<String> getExcludeClassLoaders()
public void setExcludeClassLoaders(@Nullable List<String> excludeClassLoaders)
@Input public boolean isIncludeNoLocationClasses()
false
.
This property is only taken into account if the used JaCoCo version supports this option (JaCoCo version >= 0.7.6)public void setIncludeNoLocationClasses(boolean includeNoLocationClasses)
@Nullable @Optional @Input public String getSessionId()
@Input public boolean isDumpOnExit()
true
.public void setDumpOnExit(boolean dumpOnExit)
@Input public JacocoTaskExtension.Output getOutput()
JacocoTaskExtension.Output.FILE
.public void setOutput(JacocoTaskExtension.Output output)
@Nullable @Optional @Input public String getAddress()
JacocoTaskExtension.Output.TCP_SERVER
or JacocoTaskExtension.Output.TCP_CLIENT
. Defaults to localhost.@Input public int getPort()
JacocoTaskExtension.Output.TCP_SERVER
or JacocoTaskExtension.Output.TCP_CLIENT
. Defaults to 6300.public void setPort(int port)
@Nullable @Optional @LocalState public File getClassDumpDir()
public void setClassDumpDir(@Nullable File classDumpDir)
@Input public boolean isJmx()
org.jacoco:type=Runtime
. Defaults to false
.
The configuration of the jmx property is only taken into account if the used JaCoCo version supports this option (JaCoCo version >= 0.6.2)public void setJmx(boolean jmx)
@Classpath public FileCollection getAgentClasspath()