Stay organized with collections Save and categorize content based on your preferences.

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