Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.

ExecutableTargetTest

public class ExecutableTargetTest
extends ExecutableBaseTest implements IDeviceTest

java.lang.Object
↳	com.android.tradefed.testtype.binary.ExecutableBaseTest
	↳	com.android.tradefed.testtype.binary.ExecutableTargetTest

Known direct subclasses

KUnitModuleTest, KernelTargetTest

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.

Test runner for executable running on the target. The runner implements IDeviceTest since the binary run on a device.

Summary

Fields
`public static final String`	`DEVICE_LOST_ERROR`
`public static final String`	`ROOT_LOST_ERROR`

Public constructors
`ExecutableTargetTest()`

Public methods
`String`	`findBinary(String binary)` Search for the binary to be able to run it.
`boolean`	`getCollectTestsOnly()`
`ITestDevice`	`getDevice()` Get the device under test.
`void`	`runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)` Actually run the binary at the given path.
`void`	`setDevice(ITestDevice device)` Inject the device under test.
`FailureDescription`	`shouldAbortRun(TestDescription description)` Check if the testRun should end early.

Protected methods
`void`	`checkCommandResult(CommandResult result, ITestInvocationListener listener, TestDescription description)` Check the result of the test command.
`boolean`	`doesRunBinaryGenerateTestResults()`
`boolean`	`doesRunBinaryGenerateTestRuns()`
`boolean`	`getSkipBinaryCheck()`

Fields

DEVICE_LOST_ERROR

public static final String DEVICE_LOST_ERROR

ROOT_LOST_ERROR

public static final String ROOT_LOST_ERROR

Public constructors

ExecutableTargetTest

public ExecutableTargetTest ()

Public methods

findBinary

public String findBinary (String binary)

Search for the binary to be able to run it.

Parameters
`binary`	`String`: the path of the binary or simply the binary name.

Returns
`String`	The path to the binary, or null if not found.

Throws
`DeviceNotAvailableException`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

Returns
`boolean`

getDevice

public ITestDevice getDevice ()

Get the device under test.

Returns
`ITestDevice`	the `ITestDevice`

runBinary

public void runBinary (String binaryPath, 
                ITestInvocationListener listener, 
                TestDescription description)

Actually run the binary at the given path.

Parameters
`binaryPath`	`String`: The path of the binary.
`listener`	`ITestInvocationListener`: The listener where to report the results.
`description`	`TestDescription`: The test in progress.

Throws
`DeviceNotAvailableException`

setDevice

public void setDevice (ITestDevice device)

Inject the device under test.

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

shouldAbortRun

public FailureDescription shouldAbortRun (TestDescription description)

Check if the testRun should end early.

Parameters
`description`	`TestDescription`: The test in progress.

Returns
`FailureDescription`	FailureDescription if the run loop should terminate.

Protected methods

checkCommandResult

protected void checkCommandResult (CommandResult result, 
                ITestInvocationListener listener, 
                TestDescription description)

Check the result of the test command.

Parameters
`result`	`CommandResult`: test result of the command `CommandResult`
`listener`	`ITestInvocationListener`: the `ITestInvocationListener`
`description`	`TestDescription`: The test in progress.

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

Returns
`boolean`

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

Returns
`boolean`

getSkipBinaryCheck

protected boolean getSkipBinaryCheck ()

Returns
`boolean`