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.

MoblyBinaryHostTest

public class MoblyBinaryHostTest
extends Object implements IBuildReceiver, IDeviceTest, IRemoteTest, IShardableTest, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.mobly.MoblyBinaryHostTest

Host test meant to run a mobly python binary file from the Android Build system (Soong)

Summary

Public constructors
`MoblyBinaryHostTest()`

Public methods
`void`	`addAllExcludeFilters(Set<String> filters)` Adds the `Set` of filters of which tests to exclude.
`void`	`addAllIncludeFilters(Set<String> filters)` Adds the `Set` of filters of which tests to include.
`void`	`addExcludeFilter(String filter)` Adds a filter of which tests to exclude.
`void`	`addIncludeFilter(String filter)` Adds a filter of which tests to include.
`void`	`clearExcludeFilters()` Delete all the exclude filters currently tracked.
`void`	`clearIncludeFilters()` Delete all the include filters currently tracked.
`ITestDevice`	`getDevice()` Get the device under test.
`Set<String>`	`getExcludeFilters()` Returns the current `Set` of exclude filters.
`Set<String>`	`getIncludeFilters()` Returns the current `Set` of include filters.
`final void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Runs the tests, and reports result to the listener.
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setDevice(ITestDevice device)` Inject the device under test.
`Collection<IRemoteTest>`	`split(int shardCountHint)` Alternative version of `split()` which also provides the shardCount that is attempted to be run.

Protected methods
`String[]`	`buildCommandLineArray(String filePath, String configPath, List<String> tests)`
`String[]`	`buildCommandLineArray(String filePath, String configPath)`
`String[]`	`buildCommandLineForListTests(String filePath)`
`Optional<Pair<List<String>, List<String>>>`	`filterTests(String[] testListLines, String runName, ITestInvocationListener listener)`
`MoblyArtifactReporter`	`getArtifactReporter()`
`String`	`getLogDirAbsolutePath()`
`File`	`getLogDirFile()`
`boolean`	`processYamlTestResults(InputStream inputStream, MoblyYamlResultParser parser, ITestInvocationListener listener, String runName)` Parses Mobly test results and does result reporting.
`void`	`updateConfigFile(InputStream configInputStream, Writer writer)`

Public constructors

MoblyBinaryHostTest

public MoblyBinaryHostTest ()

Public methods

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Adds the Set of filters of which tests to exclude.

Parameters
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Adds the Set of filters of which tests to include.

Parameters
`filters`	`Set`

addExcludeFilter

public void addExcludeFilter (String filter)

Adds a filter of which tests to exclude.

Parameters
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Adds a filter of which tests to include.

Parameters
`filter`	`String`

clearExcludeFilters

public void clearExcludeFilters ()

Delete all the exclude filters currently tracked.

clearIncludeFilters

public void clearIncludeFilters ()

Delete all the include filters currently tracked.

getDevice

public ITestDevice getDevice ()

Get the device under test.

Returns
`ITestDevice`	the `ITestDevice`

getExcludeFilters

public Set<String> getExcludeFilters ()

Returns the current Set of exclude filters.

Returns
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Returns the current Set of include filters.

Returns
`Set<String>`

run

public final 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

setBuild

public void setBuild (IBuildInfo buildInfo)

Parameters
`buildInfo`	`IBuildInfo`

setDevice

public void setDevice (ITestDevice device)

Inject the device under test.

Parameters
`device`	`ITestDevice`: the `ITestDevice` to use

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

Protected methods

buildCommandLineArray

protected String[] buildCommandLineArray (String filePath, 
                String configPath, 
                List<String> tests)

Parameters
`filePath`	`String`
`configPath`	`String`
`tests`	`List`

Returns
`String[]`

buildCommandLineArray

protected String[] buildCommandLineArray (String filePath, 
                String configPath)

Parameters
`filePath`	`String`
`configPath`	`String`

Returns
`String[]`

buildCommandLineForListTests

protected String[] buildCommandLineForListTests (String filePath)

Parameters
`filePath`	`String`

Returns
`String[]`

filterTests

protected Optional<Pair<List<String>, List<String>>> filterTests (String[] testListLines, 
                String runName, 
                ITestInvocationListener listener)

Parameters
`testListLines`	`String`
`runName`	`String`
`listener`	`ITestInvocationListener`

Returns
`Optional<Pair<List<String>, List<String>>>`

getArtifactReporter

protected MoblyArtifactReporter getArtifactReporter ()

Returns
`MoblyArtifactReporter`

getLogDirAbsolutePath

protected String getLogDirAbsolutePath ()

Returns
`String`

getLogDirFile

protected File getLogDirFile ()

Returns
`File`

processYamlTestResults

protected boolean processYamlTestResults (InputStream inputStream, 
                MoblyYamlResultParser parser, 
                ITestInvocationListener listener, 
                String runName)

Parses Mobly test results and does result reporting.

Parameters
`inputStream`	`InputStream`: An InputStream object reading in Mobly test result file.
`parser`	`MoblyYamlResultParser`: An MoblyYamlResultParser object that processes Mobly test results.
`listener`	`ITestInvocationListener`: An ITestInvocationListener instance that does various reporting.
`runName`	`String`: str, the name of the Mobly test binary run.

Returns
`boolean`

updateConfigFile

protected void updateConfigFile (InputStream configInputStream, 
                Writer writer)

Parameters
`configInputStream`	`InputStream`
`writer`	`Writer`

Throws
`HarnessRuntimeException`