ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger, ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener

Known indirect subclasses

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BuddyInfoMetricCollector, BugreportCollector, BugreportzMetricCollector, CodeCoverageListener, CodeCoverageTestBase.CoverageCollectingListener, CollectingTestListener, ConsoleResultReporter, DeviceUnavailEmailResultReporter, DumpHeapCollector, EmailResultReporter, ExecCommandTracker, FailureEmailResultReporter, and 43 others.

AtraceCollector	A `IMetricCollector` that runs atrace during a test and collects the result and log them to the invocation.
AtraceRunMetricCollector	Collects the traces from all the test directory under the given directory from the test device, log the test directory and post process the trace files under the test directory and aggregate the metrics.
BaseDeviceMetricCollector	Base implementation of `IMetricCollector` that allows to start and stop collection on `onTestRunStart(DeviceMetricData)` and `onTestRunEnd(DeviceMetricData, Map)`.
BuddyInfoMetricCollector	A `ScheduledDeviceMetricCollector` to collect fragmentation at regular intervals.
BugreportCollector	A pass-through `ITestInvocationListener` that collects bugreports when configurable events occur and then calls `ITestLogger.testLog(String, LogDataType, InputStreamSource)` on its children after each bugreport is collected.
BugreportzMetricCollector	A `ScheduledDeviceMetricCollector` to collect zipped bugreport at regular intervals.
CodeCoverageListener	A `ResultForwarder` that will pull coverage measurements off of the device and log them as test artifacts.
CodeCoverageTestBase.CoverageCollectingListener	A `ResultForwarder` which collects coverage files.
CollectingTestListener	A `ITestInvocationListener` that will collect all test results.
ConsoleResultReporter	Result reporter to print the test results to the console.
DeviceUnavailEmailResultReporter	An `EmailResultReporter` that will send email when invocation fails due to a device not available exception.
DumpHeapCollector	A `ScheduledDeviceMetricCollector` to collect memory dumps of processes at regular intervals.
EmailResultReporter	A simple result reporter base class that sends emails for test results.
ExecCommandTracker
FailureEmailResultReporter	An `EmailResultReporter` that sends notifications if either a test failure or invocation failure occurred.
FileMetadataCollector	A listener that collects and uploads metadata about saved log files.
FilePullerDeviceMetricCollector	A `BaseDeviceMetricCollector` that listen for metrics key coming from the device and pull them as a file from the device.
FilePullerLogCollector	Logger of the file reported by the device-side.
FormattedGeneratorReporter	Reporter that allows to generate reports in a particular format.
GraphicsStatsMetricCollector	A `ScheduledDeviceMetricCollector` to collect graphics stats at regular intervals.
ICommandScheduler.IScheduledInvocationListener	Listener for invocation events when invocation completes.
ILogSaverListener	Allows for `ITestInvocationListener`s to listen for when log files are saved.
IMetricCollector	This interface will be added as a decorator when reporting tests results in order to collect matching metrics.
IShardableListener	A `ITestInvocationListener` that can be sharded.
ITestSummaryListener
InstrumentationTest.FailedTestLogcatGenerator	A `ResultForwarder` that will forward a logcat snapshot on each failed test.
InstrumentationTest.FailedTestScreenshotGenerator	A `ResultForwarder` that will forward a screenshot on test failures.
InvocationFailureEmailResultReporter	An `EmailResultReporter` that can also restrict notifications to just invocation failures.
InvocationToJUnitResultForwarder	A class that listens to `ITestInvocationListener` events and forwards them to a `TestListener`.
IonHeapInfoMetricCollector	A `ScheduledDeviceMetricCollector` to collect audio and system memory heaps at regular intervals.
JsonHttpTestResultReporter	A result reporter that encode test metrics results and branch, device info into JSON and POST into an HTTP service endpoint
LegacySubprocessResultsReporter	A class for freezed subprocess results reporter which is compatible with M & N version of CTS.
LogSaverResultForwarder	A `ResultForwarder` for saving logs with the global file saver.
LogcatCrashResultForwarder	Special listener: on failures (instrumentation process crashing) it will attempt to extract from the logcat the crash and adds it to the failure message associated with the test.
MemInfoMetricCollector	A `ScheduledDeviceMetricCollector` to collect memory dumps at regular intervals.
MetricsXMLResultReporter	MetricsXMLResultReporter writes test metrics and run metrics to an XML file in a folder specified by metrics-folder parameter at the invocationEnded phase of the test.
ModuleListener	Listener attached to each `IRemoteTest` of each module in order to collect the list of results.
NameMangleListener	A proxy listener to translate test method, class, and package names as results are reported.
PagetypeInfoMetricCollector	A `ScheduledDeviceMetricCollector` to collect free page counts at regular intervals.
PrettyTestEventLogger	Logger matching the events and logging them in order to make it easier to debug.
ProcessMaxMemoryCollector	A `ScheduledDeviceMetricCollector` to measure peak memory usage of specified processes.
PythonBinaryHostTest.PythonForwarder	Result forwarder to replace the run name by the binary name.
ResultForwarder	A `ITestInvocationListener` that forwards invocation results to a list of other listeners.
ScheduleMultipleDeviceMetricCollector	A `IMetricCollector` that makes runs multiple metric collectors periodically.
ScheduledDeviceMetricCollector	A `IMetricCollector` that allows to run a collection task periodically at a set interval.
ShardListener	A `ITestInvocationListener` that collects results from a invocation shard (aka an invocation split to run on multiple resources in parallel), and forwards them to another listener.
ShardMasterResultForwarder	A `ResultForwarder` that combines the results of a sharded test invocations.
SubprocessResultsReporter	Implements `ITestInvocationListener` to be specified as a result_reporter and forward from the subprocess the results of tests, test runs, test invocations.
SuiteResultReporter	Collect test results for an entire suite invocation and output the final results.
TemperatureCollector	A `ScheduledDeviceMetricCollector` to measure min and max device temperature.
TestFailureEmailResultReporter	An `EmailResultReporter` that can also restrict notifications to just test failures.
TestFailureListener	Listener used to take action such as screenshot, bugreport, logcat collection upon a test failure when requested.
TextResultReporter	A test result reporter that forwards results to the JUnit text result printer.
TraceCmdCollector	A `IMetricCollector` that collects traces during the test using trace-cmd, and logs them to the invocation.
TraceMetricCollector	A `ScheduledDeviceMetricCollector` to collect kernel debug trace at regular intervals.
TradefedSandboxRunner.StubScheduledInvocationListener	A stub `ICommandScheduler.IScheduledInvocationListener` that does nothing.
XmlFormattedGeneratorReporter	Implementation of the `FormattedGeneratorReporter` which format the suite results in an xml format.
XmlResultReporter	Writes JUnit results to an XML files in a format consistent with Ant's XMLJUnitResultFormatter.

Listener for test results from the test invocation.

A test invocation can itself include multiple test runs, so the sequence of calls will be

invocationStarted(BuildInfo)
testRunStarted
testStarted
[testFailed]
testEnded
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[testLog+]
invocationEnded
getSummary

Summary

Public methods
`default TestSummary`	`getSummary()` Allows the InvocationListener to return a summary.
`default void`	`invocationEnded(long elapsedTime)` Reports that the invocation has terminated, whether successfully or due to some error condition.
`default void`	`invocationFailed(Throwable cause)` Reports an incomplete invocation due to some error condition.
`default void`	`invocationInterrupted()` Called on `ICommandScheduler.shutdown()`, gives the invocation the opportunity to do something before terminating.
`default void`	`invocationStarted(IInvocationContext context)` Reports the start of the test invocation.
`default void`	`testModuleEnded()` Reports the end of a module run.
`default void`	`testModuleStarted(IInvocationContext moduleContext)` Reports the beginning of a module running.

Public methods

getSummary

public TestSummary getSummary ()

Allows the InvocationListener to return a summary.

Returns
`TestSummary`	A `TestSummary` summarizing the run, or null

invocationEnded

public void invocationEnded (long elapsedTime)

Reports that the invocation has terminated, whether successfully or due to some error condition.

Will be automatically called by the TradeFederation framework.

Parameters
`elapsedTime`	`long`: the elapsed time of the invocation in ms

invocationFailed

public void invocationFailed (Throwable cause)

Reports an incomplete invocation due to some error condition.

Will be automatically called by the TradeFederation framework.

Parameters
`cause`	`Throwable`: the `Throwable` cause of the failure

invocationInterrupted

public void invocationInterrupted ()

Called on ICommandScheduler.shutdown(), gives the invocation the opportunity to do something before terminating.

invocationStarted

public void invocationStarted (IInvocationContext context)

Reports the start of the test invocation.

Will be automatically called by the TradeFederation framework. Reporters need to override this method to support multiple devices reporting.

Parameters
`context`	`IInvocationContext`: information about the invocation

testModuleEnded

public void testModuleEnded ()

Reports the end of a module run.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Reports the beginning of a module running. This callback is associated with testModuleEnded() and is optional in the sequence. It is only used during a run that uses modules: ITestSuite based runners.

Parameters
`moduleContext`	`IInvocationContext`: the `IInvocationContext` of the module.

ITestInvocationListener

Summary

Public methods

Public methods

getSummary

invocationEnded

invocationFailed

invocationInterrupted

invocationStarted

testModuleEnded

testModuleStarted

Interfaces

Classes

Enums