Effective in 2026, to align with our trunk stable development model and ensure platform stability for the ecosystem, we will publish source code to AOSP in Q2 and Q4. For building and contributing to AOSP, we recommend utilizing android-latest-release instead of aosp-main. The android-latest-release manifest branch will always reference the most recent release pushed to AOSP. For more information, see Changes to AOSP.

IRemoteTest

public interface IRemoteTest

com.android.tradefed.testtype.IRemoteTest

Known indirect subclasses

AndroidJUnitTest, ArtGTest, ArtRunTest, ArtTest, AtestExecutionPlanSuiteRunner, AtestRunner, BaseTestSuite, ClusterCommandLauncher, CodeCoverageTest, CompanionAwareTest, CoverageMeasurementForwarder, CtsTestLauncher, DeviceBatteryLevelChecker, DeviceTestCase, DeviceTestSuite, and 43 others.

AndroidJUnitTest	A Test that runs an instrumentation test package on given device using the android.support.test.runner.AndroidJUnitRunner.
ArtGTest
ArtRunTest	A test runner to run ART run-tests.
ArtTest
AtestExecutionPlanSuiteRunner	Implementation of `ITestSuite`
AtestRunner	Implementation of `ITestSuite`
BaseTestSuite	A Test for running Compatibility Test Suite with new suite system.
ClusterCommandLauncher	A `IRemoteTest` class to launch a command from TFC via a subprocess TF.
CodeCoverageTest	A Test that runs an instrumentation test package on a given device and generates the code coverage report.
CompanionAwareTest	Base test class that encapsulates boilerpate of getting and checking companion device Subclass may call `getCompanion()` to retrieve the allocated companion.
CoverageMeasurementForwarder	A placeholder test that forwards coverage measurements from the build provider to the logger.
CtsTestLauncher	A `IRemoteTest` for running tests against a separate CTS installation.
DeviceBatteryLevelChecker	An `IRemoteTest` that checks for a minimum battery charge, and waits for the battery to reach a second charging threshold if the minimum charge isn't present.
DeviceTestCase	Helper JUnit test case that provides the `IRemoteTest` and `IDeviceTest` services.
DeviceTestSuite	Helper JUnit test suite that provides the `IRemoteTest` and `IDeviceTest` services.
DynamicFileStubTest	This is a tradefed test to test tradefed can resolve dynamic file correctly.
ExecutableBaseTest	Base class for executable style of tests.
ExecutableHostTest	Test runner for executable running on the host.
ExecutableTargetTest	Test runner for executable running on the target.
ExecutionPlanSuiteRunner	Implementation of `BaseTestSuite` to run tests based on specified execution plans in the build.
FakeTest	A fake test whose purpose is to make it easy to generate repeatable test results.
GTest	A Test that runs a native test package on given device.
GTestBase	The base class of gTest
GoogleBenchmarkTest	A Test that runs a Google benchmark test package on given device.
GranularRetriableTestWrapper	A wrapper class works on the `IRemoteTest` to granulate the IRemoteTest in testcase level.
HostGTest	A Test that runs a native test package.
HostTest	A test runner for JUnit host based tests.
IAutoRetriableTest	Interface for an `IRemoteTest` that doesn't implement `ITestFilterReceiver` but still wishes to support auto-retry.
IResumableTest	This interface is deprecated. No need for this anymore
IShardableTest	A `IRemoteTest` that can be split into separately executable sub-tests.
ITestSuite	Abstract class used to run Test Suite.
ITokenRequest	Interface a `IRemoteTest` can implement to expose the fact that it requires a device with a special token.
InstalledInstrumentationsTest	Runs all instrumentation found on current device.
InstrumentationTest	A Test that runs an instrumentation test package on given device.
IsolatedHostTest	Implements a TradeFed runner that uses a subprocess to execute the tests in a low-dependency environment instead of executing them on the main process.
JarHostTest	Test runner for host-side JUnit tests.
KUnitModuleTest	Test runner for running KUnit test modules on device.
KernelTargetTest	Test runner for executable running on the target and parsing tesult of kernel test.
MoblyBinaryHostTest	Host test meant to run a mobly python binary file from the Android Build system (Soong)
NativeBenchmarkTest	A Test that runs a native benchmark test executable on given device.
NativeStressTest	A Test that runs a native stress test executable on given device.
NoisyDryRunTest	Run noisy dry run on a command file.
PtsBotTest	Run PTS-bot tests.
PythonBinaryHostTest	Host test meant to run a python binary file from the Android Build system (Soong) The test runner supports include-filter and exclude-filter.
PythonUnitTestRunner	This class is deprecated. Use `PythonBinaryHostTest` instead.
ResultsPlayer	Special runner that replays the results given to it.
RetryRescheduler	A special runner that allows to reschedule a previous run tests that failed or where not executed.
RustBinaryHostTest	Host test meant to run a rust binary file from the Android Build system (Soong)
RustBinaryTest	A Test that runs a rust binary on given device.
RustTestBase	Base class of RustBinaryHostTest and RustBinaryTest
StubTest	No-op empty test implementation.
SubprocessTfLauncher	A `IRemoteTest` for running tests against a separate TF installation.
TestMappingSuiteRunner	Implementation of `BaseTestSuite` to run tests specified by option include-filter, or TEST_MAPPING files from build, as a suite.
TestsPoolPoller	Tests wrapper that allow to execute all the tests of a pool of tests.
TfSuiteRunner	Implementation of `ITestSuite` which will load tests from TF jars res/config/suite/ folder.
TfTestLauncher	A `IRemoteTest` for running unit or functional tests against a separate TF installation.
UiAutomatorTest
UsbResetTest	An `IRemoteTest` that reset the device USB and checks whether the device comes back online afterwards.

A test that reports results directly to a ITestInvocationListener.

This has the following benefits over a JUnit.

easier to report the results of a test that has been run remotely on an Android device, as the results of a remote test don't need to be unnecessarily marshalled and unmarshalled from JUnit Test objects.
supports reporting test metrics

Summary

Public methods
`default void`	`run(ITestInvocationListener listener)` This method is deprecated. Use `run(TestInformation,ITestInvocationListener)` instead.
`default void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Runs the tests, and reports result to the listener.
`default void`	`setRetryAttemptNumber(int attemptNumber)` Sets the retry attempt number for the test.

Public methods

run

public void run (ITestInvocationListener listener)

This method is deprecated.
Use run(TestInformation,ITestInvocationListener) instead.

Runs the tests, and reports result to the listener.

Parameters
`listener`	`ITestInvocationListener`: the `ITestInvocationListener` of test results

Throws
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Runs the tests, and reports result to the listener.

Parameters
`testInfo`	`TestInformation`: The `TestInformation` object containing useful information to run tests.
`listener`	`ITestInvocationListener`: the `ITestInvocationListener` of test results

Throws
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRetryAttemptNumber

public void setRetryAttemptNumber (int attemptNumber)

Sets the retry attempt number for the test. Default does nothing.

Parameters
`attemptNumber`	`int`