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(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.

logCoverageMeasurements

public void logCoverageMeasurements (String runName)

Pulls native coverage measurements from the device and logs them.

Parameters
runName String

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 ITestLifeCycleReceiver.testRunEnded(long, Map).

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