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, use android-latest-release. The android-latest-release manifest branch will always reference the most recent release pushed to AOSP. For more information, see Changes to AOSP.

IShardableTest

public interface IShardableTest
implements IRemoteTest

com.android.tradefed.testtype.IShardableTest

Known indirect subclasses

AndroidJUnitTest, ArtGTest, ArtTest, AtestExecutionPlanSuiteRunner, AtestRunner, BaseTestSuite, CtsTestLauncher, ExecutableBaseTest, ExecutableHostTest, ExecutableTargetTest, ExecutionPlanSuiteRunner, GTest, GTestBase, HostGTest, HostTest, and 11 others.

AndroidJUnitTest	A Test that runs an instrumentation test package on given device using the android.support.test.runner.AndroidJUnitRunner.
ArtGTest
ArtTest
AtestExecutionPlanSuiteRunner	Implementation of `ITestSuite`
AtestRunner	Implementation of `ITestSuite`
BaseTestSuite	A Test for running Compatibility Test Suite with new suite system.
CtsTestLauncher	A `IRemoteTest` for running tests against a separate CTS installation.
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.
GTest	A Test that runs a native test package on given device.
GTestBase	The base class of gTest
HostGTest	A Test that runs a native test package.
HostTest	A test runner for JUnit host based tests.
ITestSuite	Abstract class used to run Test Suite.
InstalledInstrumentationsTest	Runs all instrumentation found on current 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)
PtsBotTest	Run PTS-bot tests.
StubTest	No-op empty test implementation.
TestMappingSuiteRunner	Implementation of `BaseTestSuite` to run tests specified by option include-filter, or TEST_MAPPING files from build, as a suite.
TfSuiteRunner	Implementation of `ITestSuite` which will load tests from TF jars res/config/suite/ folder.

A IRemoteTest that can be split into separately executable sub-tests. The splitting into sub-tests is expected to be deterministic and each sub-test should be independent in order to allow for execution of different shards on different hosts.

Summary

Public methods
`default Collection<IRemoteTest>`	`split(Integer shardCountHint, TestInformation testInfo)` Alternative version of `split(int)` which also provides a `TestInformation` which contains early info from the parent creating the shards.
`default Collection<IRemoteTest>`	`split()` Shard the test into separately runnable chunks.
`default Collection<IRemoteTest>`	`split(int shardCountHint)` Alternative version of `split()` which also provides the shardCount that is attempted to be run.

Public methods

split

public Collection<IRemoteTest> split (Integer shardCountHint, 
                TestInformation testInfo)

Alternative version of split(int) which also provides a TestInformation which contains early info from the parent creating the shards. It is useful if things like device or build information need to be accessed during sharding.

Parameters
`shardCountHint`	`Integer`: the attempted shard count.
`testInfo`	`TestInformation`: The parent `TestInformation`

Returns
`Collection<IRemoteTest>`	a collection of subtests to be executed separately or `null` if test is not currently shardable

split

public Collection<IRemoteTest> split ()

Shard the test into separately runnable chunks.

This must be deterministic and always return the same list of IRemoteTests for the same input.

This will be called before test execution, so injected dependencies (such as the ITestDevice for IDeviceTests) may be null.

Returns
`Collection<IRemoteTest>`	a collection of subtests to be executed separately or `null` if test is not currently shardable

split

public Collection<IRemoteTest> split (int shardCountHint)

Alternative version of split() which also provides the shardCount that is attempted to be run. This is useful for some test runner that cannot arbitrarily decide sometimes.

Parameters
`shardCountHint`	`int`: the attempted shard count.

Returns
`Collection<IRemoteTest>`	a collection of subtests to be executed separately or `null` if test is not currently shardable