A partir de 2026, para alinearnos con nuestro modelo de desarrollo estable de la rama principal y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en AOSP en el segundo y cuarto trimestre. Para compilar AOSP y contribuir a él, te recomendamos que utilices android-latest-release en lugar de aosp-main. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en AOSP.

ExecutableBaseTest

public abstract class ExecutableBaseTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDiscoverDependencies, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

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

Subclases directas conocidas

ExecutableHostTest, ExecutableTargetTest

ExecutableHostTest	Es el ejecutor de pruebas para el ejecutable que se ejecuta en el host.
ExecutableTargetTest	Es el ejecutor de pruebas para el ejecutable que se ejecuta en el destino.

Subcategorías indirectas conocidas

KUnitModuleTest, KernelTargetTest

KUnitModuleTest	Es un ejecutor de pruebas para ejecutar módulos de pruebas de KUnit en el dispositivo.
KernelTargetTest	Es el ejecutor de pruebas para el ejecutable que se ejecuta en el destino y analiza el resultado de la prueba del kernel.

Clase base para el estilo ejecutable de las pruebas. Por ejemplo, archivos binarios y secuencias de comandos de shell.

Resumen

Constantes
`String`	`NO_BINARY_ERROR`

Constructores públicos
`ExecutableBaseTest()`

Métodos públicos
`void`	`addAllExcludeFilters( filters)` Agrega el `ERROR(/Set)` de los filtros de las pruebas que se excluirán.
`void`	`addAllIncludeFilters( filters)` Agrega el `ERROR(/Set)` de los filtros de las pruebas que se incluirán.
`void`	`addExcludeFilter(String filter)` Agrega un filtro de las pruebas que se deben excluir.
`void`	`addIncludeFilter(String filter)` Agrega un filtro de las pruebas que se incluirán.
`void`	`clearExcludeFilters()` Borra todos los filtros de exclusión que se rastrean actualmente.
`void`	`clearIncludeFilters()` Borra todos los filtros de inclusión que se rastrean actualmente.
`abstract String`	`findBinary(String binary)` Busca el objeto binario para poder ejecutarlo.
`IAbi`	`getAbi()`
`boolean`	`getCollectTestsOnly()`
	`getExcludeFilters()` Devuelve el `ERROR(/Set)` actual de los filtros de exclusión.
	`getIncludeFilters()` Devuelve el `ERROR(/Set)` actual de los filtros de inclusión.
`final long`	`getRuntimeHint()` Devuelve el tiempo de ejecución esperado de la prueba en milisegundos.
	`reportDependencies()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Ejecuta las pruebas y le informa el resultado al objeto de escucha.
`abstract void`	`runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)` Ejecuta el objeto binario en la ruta de acceso especificada.
`final void`	`setAbi(IAbi abi)`
`final void`	`setCollectTestsOnly(boolean shouldCollectTest)` Habilita o inhabilita el modo de recopilación de pruebas.
`void`	`setConfiguration(IConfiguration configuration)` Inserta el `IConfiguration` en uso.
`FailureDescription`	`shouldAbortRun(TestDescription description)` Verifica si el testRun debe finalizar antes de tiempo.
`final`	`split(int shardHint)` Versión alternativa de `split()` que también proporciona el shardCount que se intenta ejecutar.

Métodos protegidos
`boolean`	`doesRunBinaryGenerateTestResults()`
`boolean`	`doesRunBinaryGenerateTestRuns()`
	`getAllTestCommands()` Se convirtieron mBinaryPaths en mTestCommands para mantener la coherencia.
`IConfiguration`	`getConfiguration()` Devuelve la configuración de la prueba.
`TestDescription[]`	`getFilterDescriptions( testCommands)`
`String`	`getModuleId(IInvocationContext context)`
`long`	`getTimeoutPerBinaryMs()`
`boolean`	`isTestFailed(String testName)`

Constantes

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

Valor constante: "El objeto binario %s no existe".

Constructores públicos

ExecutableBaseTest

public ExecutableBaseTest ()

Métodos públicos

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Agrega el ERROR(/Set) de los filtros de las pruebas que se excluirán.

Parámetros
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Agrega el ERROR(/Set) de los filtros de las pruebas que se incluirán.

Parámetros
`filters`

addExcludeFilter

public void addExcludeFilter (String filter)

Agrega un filtro de las pruebas que se deben excluir.

Parámetros
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Agrega un filtro de las pruebas que se incluirán.

Parámetros
`filter`	`String`

clearExcludeFilters

public void clearExcludeFilters ()

Borra todos los filtros de exclusión que se rastrean actualmente.

clearIncludeFilters

public void clearIncludeFilters ()

Borra todos los filtros de inclusión que se rastrean actualmente.

findBinary

public abstract String findBinary (String binary)

Busca el objeto binario para poder ejecutarlo.

Parámetros
`binary`	`String`: Es la ruta de acceso del objeto binario o simplemente el nombre del objeto binario.

Muestra
`String`	Ruta de acceso al archivo binario o nulo si no se encuentra.

Arroja
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

Muestra
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

Muestra
`boolean`

getExcludeFilters

public  getExcludeFilters ()

Devuelve el ERROR(/Set) actual de los filtros de exclusión.

Muestra

getIncludeFilters

public  getIncludeFilters ()

Devuelve el ERROR(/Set) actual de los filtros de inclusión.

Muestra

getRuntimeHint

public final long getRuntimeHint ()

Devuelve el tiempo de ejecución esperado de la prueba en milisegundos. La hora se usa para balancear la carga de la ejecución fragmentada.

Muestra
`long`

reportDependencies

public  reportDependencies ()

Muestra

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Ejecuta las pruebas y le informa el resultado al objeto de escucha.

Parámetros
`testInfo`	`TestInformation`: Es el objeto `TestInformation` que contiene información útil para ejecutar pruebas.
`listener`	`ITestInvocationListener`: El `ITestInvocationListener` de los resultados de la prueba

Arroja
`DeviceNotAvailableException`

runBinary

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

Ejecuta el objeto binario en la ruta de acceso especificada.

Parámetros
`binaryPath`	`String`: Es la ruta de acceso del objeto binario.
`listener`	`ITestInvocationListener`: Es el objeto de escucha en el que se informan los resultados.
`description`	`TestDescription`: Es la prueba en curso.

Arroja
`DeviceNotAvailableException`

setAbi

public final void setAbi (IAbi abi)

Parámetros
`abi`	`IAbi`

setCollectTestsOnly

public final void setCollectTestsOnly (boolean shouldCollectTest)

Habilita o inhabilita el modo de recopilación de pruebas.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserta el IConfiguration en uso.

Parámetros
`configuration`	`IConfiguration`

shouldAbortRun

public FailureDescription shouldAbortRun (TestDescription description)

Verifica si el testRun debe finalizar antes de tiempo.

Parámetros
`description`	`TestDescription`: Es la prueba en curso.

Muestra
`FailureDescription`	Es FailureDescription si el bucle de ejecución debe finalizar.

división

public final  split (int shardHint)

Versión alternativa de split() que también proporciona el shardCount que se intenta ejecutar. Esto es útil para algunos ejecutores de pruebas que no pueden decidir de forma arbitraria a veces.

Parámetros
`shardHint`	`int`: Es el recuento de fragmentos intentado.

Muestra
	Colección de subpruebas que se ejecutarán por separado o `null` si la prueba no se puede fragmentar actualmente

Métodos protegidos

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

Muestra
`boolean`

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

Muestra
`boolean`

getAllTestCommands

protected  getAllTestCommands ()

Se convirtieron mBinaryPaths en mTestCommands para mantener la coherencia.

Muestra
	Un mapa`ERROR(/LinkedHashMap)`<string, string=""> de testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

Devuelve la configuración de la prueba.

Muestra
`IConfiguration`	Un IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions ( testCommands)

Parámetros
`testCommands`

Muestra
`TestDescription[]`

getModuleId

protected String getModuleId (IInvocationContext context)

Parámetros
`context`	`IInvocationContext`

Muestra
`String`

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

Muestra
`long`	Es el tiempo de espera aplicado a cada archivo binario para su ejecución.

isTestFailed

protected boolean isTestFailed (String testName)

Parámetros
`testName`	`String`

Devuelve
`boolean`