A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

GTestBase

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

java.lang.Object
↳	com.android.tradefed.testtype.GTestBase

Subclases directas conocidas

GTest, HostGTest

GTest	Es una prueba que ejecuta un paquete de pruebas nativo en un dispositivo determinado.
HostGTest	Es una prueba que ejecuta un paquete de prueba nativo.

Subcategorías indirectas conocidas

ArtGTest

La clase base de gTest

Resumen

Constantes
`String`	`FILTER_EXTENSION`
`String`	`GTEST_FLAG_FILE`
`String`	`GTEST_FLAG_FILTER`
`String`	`GTEST_FLAG_LIST_TESTS`
`String`	`GTEST_FLAG_PRINT_TIME`
`String`	`GTEST_FLAG_RUN_DISABLED_TESTS`
`String`	`GTEST_XML_OUTPUT`

Constructores públicos
`GTestBase()`

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.
`String`	`cleanFilter(String filter)`
`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.
`IAbi`	`getAbi()`
	`getAfterTestCmd()` Obtiene los comandos de shell que se ejecutarán después de GTest.
	`getBeforeTestCmd()` Obtiene los comandos de shell que se ejecutarán antes de GTest.
	`getExcludeFilters()` Devuelve el `ERROR(/Set)` actual de los filtros de exclusión.
	`getFileExclusionFilterRegex()` Obtiene la regex para excluir la ejecución de ciertos archivos.
	`getGTestFlags()` Obtiene valores de marcas adicionales para pasar al comando de shell de la prueba nativa.
	`getIncludeFilters()` Devuelve el `ERROR(/Set)` actual de los filtros de inclusión.
`long`	`getMaxTestTimeMs()` Obtiene el tiempo máximo para que se ejecute una prueba de gtest.
`String`	`getModuleName()` Obtén el módulo de prueba nativo de Android para ejecutarlo.
`boolean`	`getRunDisabledTests()` Obtiene si GTest debe ejecutar pruebas inhabilitadas.
`long`	`getRuntimeHint()` Devuelve el tiempo de ejecución esperado de la prueba en milisegundos.
`int`	`getShardCount()` Devuelve el recuento de fragmentos actual.
`int`	`getShardIndex()` Obtiene el índice de fragmento de esta prueba.
`String`	`getTestFilterKey()` Obtiene la clave del filtro de prueba.
`String`	`getTestModule()` Obtiene el nombre del módulo.
`boolean`	`isCollectTestsOnly()` Indica si las invocaciones de "get" solo invocan el objeto binario de prueba para recopilar la lista de casos de prueba aplicables.
`boolean`	`isEnableXmlOutput()` Indica si se obtiene o no el resultado de la prueba en formato XML de gtest.
`boolean`	`isSharded()` Obtiene la marca isSharded.
`void`	`notifyTestExecution(boolean incompleteTestFound, failedTests)` Notifica al elemento superior sobre la ejecución de la prueba para que los filtros de inclusión o exclusión se puedan controlar correctamente en los intentos de reintento.
`void`	`setAbi(IAbi abi)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Habilita o inhabilita el modo de recopilación de pruebas.
`void`	`setConfiguration(IConfiguration configuration)` Inserta el `IConfiguration` en uso.
`void`	`setModuleName(String moduleName)` Establece el módulo de prueba nativo de Android para que se ejecute.
`void`	`setShardCount(int shardCount)` Establece el recuento de fragmentos de esta prueba.
`void`	`setShardIndex(int shardIndex)` Establece el índice de fragmento de esta prueba.
	`split(int shardCountHint)` Versión alternativa de `split()` que también proporciona el shardCount que se intenta ejecutar.

Métodos protegidos
`String`	`convertName(String gtestFlagName)`
`String`	`createFlagFile(String filter)` Crea un archivo que contenga los filtros que se usarán a través de --gtest_flagfile para evitar cualquier limitación del SO en el tamaño de los argumentos.
`void`	`erasePrependedFileName( filters, String filename)`
`String`	`getAllGTestFlags(String path)` Es un asistente para obtener todas las marcas de GTest que se pasarán al comando de shell de adb.
`IConfiguration`	`getConfiguration()` Devuelve la configuración de la prueba.
`String`	`getExceptionMessage(Exception e)` Haz el mejor intento posible para recuperar un mensaje descriptivo corto y significativo para el `Exception` determinado.
`String`	`getGTestCmdLine(String fullPath, String flags)` Método auxiliar para compilar el comando gtest que se ejecutará.
`String`	`getGTestCmdLineWrapper(String fullPath, String flags)` Es un asistente que permite que las clases derivadas encapsulen el comando gtest en alguna otra herramienta (chroot, strace, gdb y similares).
`String`	`getGTestFilters(String path)` Es un asistente para obtener el filtro de pruebas de g-test que se ejecutará.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` Devuelve el GTestListener que proporciona información de depuración adicional, como la detección y el informe de pruebas duplicadas si mDisabledDuplicateCheck es falso.
`abstract String`	`loadFilter(String path)` Define el método get filter.
`void`	`setRunDisabled(boolean runDisabled)` Establece si GTest debe ejecutar pruebas inhabilitadas.

Constantes

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

Valor de la constante: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Valor de la constante: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

Valor de la constante: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Valor de la constante: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Valor de la constante: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Valor constante: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Valor de la constante: "--gtest_output=xml:%s"

Constructores públicos

GTestBase

public GTestBase ()

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`

cleanFilter

public String cleanFilter (String filter)

Parámetros
`filter`	`String`

Muestra
`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.

getAbi

public IAbi getAbi ()

Muestra
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

Obtiene los comandos de shell que se ejecutarán después de GTest.

Muestra

getBeforeTestCmd

public  getBeforeTestCmd ()

Obtiene los comandos de shell que se ejecutarán antes de GTest.

Muestra

getExcludeFilters

public  getExcludeFilters ()

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

Muestra

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Obtiene la regex para excluir la ejecución de ciertos archivos.

Muestra

getGTestFlags

public  getGTestFlags ()

Obtiene valores de marcas adicionales para pasar al comando de shell de la prueba nativa.

Muestra

getIncludeFilters

public  getIncludeFilters ()

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

Muestra

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Obtiene el tiempo máximo para que se ejecute una prueba de gtest.

Muestra
`long`

getModuleName

public String getModuleName ()

Obtén el módulo de prueba nativo de Android para ejecutarlo.

Muestra
`String`	Nombre del módulo de prueba nativo que se ejecutará, o bien nulo si no se configuró

getRunDisabledTests

public boolean getRunDisabledTests ()

Obtiene si GTest debe ejecutar pruebas inhabilitadas.

Muestra
`boolean`	Es verdadero si se deben ejecutar las pruebas inhabilitadas; de lo contrario, es falso.

getRuntimeHint

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

getShardCount

public int getShardCount ()

Devuelve el recuento de fragmentos actual.

Muestra
`int`

getShardIndex

public int getShardIndex ()

Obtiene el índice de fragmento de esta prueba.

Muestra
`int`

getTestFilterKey

public String getTestFilterKey ()

Obtiene la clave del filtro de prueba.

Muestra
`String`

getTestModule

public String getTestModule ()

Obtiene el nombre del módulo.

Muestra
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Indica si solo se invoca el objeto binario de prueba para recopilar la lista de casos de prueba aplicables.

Muestra
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Indica si se obtiene o no el resultado de la prueba en formato XML de gtest.

Muestra
`boolean`

isSharded

public boolean isSharded ()

Obtiene la marca isSharded.

Muestra
`boolean`

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Notifica al elemento superior sobre la ejecución de la prueba para que los filtros de inclusión o exclusión se puedan controlar correctamente en los intentos de reintento.

Parámetros
`incompleteTestFound`	`boolean`
`failedTests`

setAbi

public void setAbi (IAbi abi)

Parámetros
`abi`	`IAbi`

setCollectTestsOnly

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

setModuleName

public void setModuleName (String moduleName)

Establece el módulo de prueba nativo de Android para que se ejecute.

Parámetros
`moduleName`	`String`: Es el nombre del módulo de prueba nativo que se ejecutará.

setShardCount

public void setShardCount (int shardCount)

Establece el recuento de fragmentos de esta prueba.

Parámetros
`shardCount`	`int`

setShardIndex

public void setShardIndex (int shardIndex)

Establece el índice de fragmento de esta prueba.

Parámetros
`shardIndex`	`int`

división

public  split (int shardCountHint)

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
`shardCountHint`	`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

convertName

protected String convertName (String gtestFlagName)

Parámetros
`gtestFlagName`	`String`

Muestra
`String`

createFlagFile

protected String createFlagFile (String filter)

Crea un archivo que contenga los filtros que se usarán a través de --gtest_flagfile para evitar cualquier limitación del SO en el tamaño de los argumentos.

Parámetros
`filter`	`String`: Es la cadena de filtro.

Muestra
`String`	Es la ruta de acceso al archivo que contiene el filtro.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parámetros
`filters`
`filename`	`String`

getAllGTestFlags

protected String getAllGTestFlags (String path)

Es un asistente para obtener todas las marcas de GTest que se pasarán al comando de shell de adb.

Parámetros
`path`	`String`: Es la ruta de acceso completa del objeto binario en el dispositivo.

Muestra
`String`	El `String` de todas las marcas de GTest que se deben pasar a GTest

Arroja
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Devuelve la configuración de la prueba.

Muestra
`IConfiguration`	Un IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Haz el mejor intento posible para recuperar un mensaje descriptivo corto y significativo para el Exception determinado.

Parámetros
`e`	`Exception`: El `Exception`

Muestra
`String`	un mensaje corto

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Método auxiliar para compilar el comando gtest que se ejecutará.

Parámetros
`fullPath`	`String`: Ruta de acceso absoluta del sistema de archivos al objeto binario de gtest en el dispositivo
`flags`	`String`: Marcas de ejecución de gtest

Muestra
`String`	la línea de comandos del shell para ejecutar gtest

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Es un asistente que permite que las clases derivadas encapsulen el comando gtest en alguna otra herramienta (chroot, strace, gdb y similares).

Parámetros
`fullPath`	`String`
`flags`	`String`

Muestra
`String`

getGTestFilters

protected String getGTestFilters (String path)

Es un asistente para obtener el filtro de pruebas de g-test que se ejecutará.

Ten en cuenta que los filtros solo se aplican al nombre de la función (p. ej., "Prueba" de Google Test); se tendrán en cuenta todos los "Casos de prueba" de Google Test.

Parámetros
`path`	`String`: Es la ruta de acceso completa del objeto binario en el dispositivo.

Muestra
`String`	Es la marca de filtro completa que se pasará a la prueba G, o una cadena vacía si no se especificó ninguna.

Arroja
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Devuelve el GTestListener que proporciona información de depuración adicional, como la detección y el informe de pruebas duplicadas si mDisabledDuplicateCheck es falso. De lo contrario, devuelve el objeto de escucha pasado.

Parámetros
`listeners`	`ITestInvocationListener`

Muestra
`ITestInvocationListener`

loadFilter

protected abstract String loadFilter (String path)

Define el método get filter.

La subclase debe implementar cómo obtener su propio filtro.

Parámetros
`path`	`String`: Es la ruta de acceso completa del archivo de filtro.

Muestra
`String`	cadena de filtro.

Arroja
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Establece si GTest debe ejecutar pruebas inhabilitadas.

Parámetros
`runDisabled`	`boolean`