GcovCodeCoverageCollector

public final class GcovCodeCoverageCollector
extends BaseDeviceMetricCollector implements IConfigurationReceiver

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.GcovCodeCoverageCollector

A BaseDeviceMetricCollector that will pull gcov coverage measurements off of the device and log them as test artifacts.

Summary

Public constructors
`GcovCodeCoverageCollector()`

Public methods
`ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Initialization of the collector with the current context and where to forward results.
`void`	`logCoverageMeasurements(ITestDevice device, String runName)` Pulls native coverage measurements from the device and logs them.
`void`	`onTestRunEnd(DeviceMetricData runData, runMetrics)` Callback when a test run is ended.
`void`	`setCollectOnTestEnd(boolean collect)` Sets whether to collect coverage on testRunEnded.
`void`	`setConfiguration(IConfiguration config)` Injects the `IConfiguration` in use.

Public constructors

GcovCodeCoverageCollector

public GcovCodeCoverageCollector ()

Public methods

init

public ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Initialization of the collector with the current context and where to forward results. Will only be called once per instance, and the collector is expected to update its internal context and listener. Init will never be called during a test run always before.

Do not override unless you know what you are doing.

Parameters
`context`	`IInvocationContext`: the `IInvocationContext` for the invocation in progress.
`listener`	`ITestInvocationListener`: the `ITestInvocationListener` where to put results.

Returns
`ITestInvocationListener`	the new listener wrapping the original one.

Throws
`DeviceNotAvailableException`

logCoverageMeasurements

public void logCoverageMeasurements (ITestDevice device, 
                String runName)

Pulls native coverage measurements from the device and logs them.

Parameters
`device`	`ITestDevice`
`runName`	`String`

Throws
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 runMetrics)

Callback when a test run is ended. This should be the time for clean up.

Parameters
`runData`	`DeviceMetricData`: the `DeviceMetricData` holding the data for the run. Will be the same object as during `BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`runMetrics`	: the current map of metrics passed to `ERROR(/#testRunEnded(long,Map))`.

Throws
`DeviceNotAvailableException`

setCollectOnTestEnd

public void setCollectOnTestEnd (boolean collect)

Sets whether to collect coverage on testRunEnded.

Set this to false during re-runs, otherwise each individual test re-run will collect coverage rather than having a single merged coverage result.

Parameters
`collect`	`boolean`

setConfiguration

public void setConfiguration (IConfiguration config)

Injects the IConfiguration in use.

Parameters
`config`	`IConfiguration`