Interface BuildScanCaptureSettings
-
public interface BuildScanCaptureSettings
Allows configuring what data will be captured as part of the build scan.- Since:
- 3.7
- See Also:
BuildScanExtension.getCapture()
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description boolean
isBuildLogging()
boolean
isTaskInputFiles()
boolean
isTestLogging()
void
setBuildLogging(boolean capture)
Specifies whether to capture build logging output.void
setTaskInputFiles(boolean capture)
Specifies whether to capture information about each file used as an input to a task.void
setTestLogging(boolean capture)
Specifies whether to capture test logging output.
-
-
-
Method Detail
-
setTaskInputFiles
void setTaskInputFiles(boolean capture)
Specifies whether to capture information about each file used as an input to a task.Defaults to
false
.Enabling this feature may increase the size of the build scan data. This requires more time to transmit to the server, and more storage space at the server. Most builds will not incur a noticeable difference when this feature is enabled. Large builds may increase the build scan data by a handful of megabytes. For most builds, the increase will be negligible.
If using Gradle Enterprise with a good connection to the server this capture should be enabled, as it allows comparing task inputs at a file level when comparing builds.
This property may also be set by the
"scan.capture-task-input-files"
system property. If this is set to any value other than"false"
, the capture will be enabled. If this is set to"false"
, the capture will be disabled. If the capture is enabled or disabled via system property, calling this method has no effect. That is, the system property takes precedence over the value set via this method.This method cannot be called after the root project has finished configuring. Doing so will produce a build time error.
- Parameters:
capture
- whether to capture information about each file use as an input to a task
-
isTaskInputFiles
boolean isTaskInputFiles()
- Returns:
- whether information about each file used as an input to a task will be captured
-
setBuildLogging
void setBuildLogging(boolean capture)
Specifies whether to capture build logging output.Defaults to
true
.This method cannot be called after the root project has finished configuring. Doing so will produce a build time error.
- Parameters:
capture
- whether to capture build logging output
-
isBuildLogging
boolean isBuildLogging()
- Returns:
- whether build logging output will be captured
-
setTestLogging
void setTestLogging(boolean capture)
Specifies whether to capture test logging output.Defaults to
true
.This method cannot be called after the root project has finished configuring. Doing so will produce a build time error.
- Parameters:
capture
- whether to capture test logging output
-
isTestLogging
boolean isTestLogging()
- Returns:
- whether test logging output will be captured
-
-