Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

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 prueba 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

Campos
`protected static final String`	`FILTER_EXTENSION`
`protected static final String`	`GTEST_FLAG_FILE`
`protected static final String`	`GTEST_FLAG_FILTER`
`protected static final String`	`GTEST_FLAG_LIST_TESTS`
`protected static final String`	`GTEST_FLAG_PRINT_TIME`
`protected static final String`	`GTEST_FLAG_RUN_DISABLED_TESTS`
`protected static final String`	`GTEST_XML_OUTPUT`

Constructores públicos
`GTestBase()`

Métodos públicos
`void`	`addAllExcludeFilters( filters)` Agrega el `ERROR(/Set)` de filtros de las pruebas que se deben excluir.
`void`	`addAllIncludeFilters( filters)` Agrega el `ERROR(/Set)` de 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 de los que se realiza un seguimiento actualmente.
`void`	`clearIncludeFilters()` Borra todos los filtros de inclusión de los que se realiza un seguimiento actualmente.
`IAbi`	`getAbi()`
	`getAfterTestCmd()` Obtiene los comandos de shell para ejecutar después de GTest.
	`getBeforeTestCmd()` Obtiene los comandos de shell para ejecutar 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 marca adicionales para pasarlos 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 un gtest.
`String`	`getModuleName()` Ejecuta el módulo de prueba nativo de Android.
`boolean`	`getRunDisabledTests()` Obtén si GTest debe ejecutar pruebas inhabilitadas.
`long`	`getRuntimeHint()` Muestra el tiempo de ejecución esperado de la prueba en milisegundos.
`int`	`getShardCount()` Muestra el recuento de fragmentos actual.
`int`	`getShardIndex()` Obtiene el índice del fragmento de esta prueba.
`String`	`getTestFilterKey()` Obtiene la clave de filtro de prueba.
`String`	`getTestModule()` Obtiene el nombre del módulo.
`boolean`	`isCollectTestsOnly()` Solo invoca el objeto binario de prueba para recopilar la lista de casos de prueba aplicables o no.
`boolean`	`isEnableXmlOutput()` Obtiene el resultado XML de gtest para los resultados de la prueba o no.
`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 para 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)` Inyecta el `IConfiguration` en uso.
`void`	`setModuleName(String moduleName)` Configura 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)` Es una 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()` Muestra la configuración de la prueba.
`String`	`getExceptionMessage(Exception e)` Haz todo lo posible para recuperar un mensaje descriptivo breve y significativo para un `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 ayudante que permite que las clases derivadas unan el comando gtest en alguna otra herramienta (chroot, strace, gdb y similares).
`String`	`getGTestFilters(String path)` Es un auxiliar para obtener el filtro de prueba g-test que se ejecutará.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` Muestra el GTestListener que proporciona información de depuración adicional, como detectar y informar pruebas duplicadas si mDisabledDuplicateCheck es falso.
`abstract String`	`loadFilter(String path)` Define el método de filtro de obtención.
`void`	`setRunDisabled(boolean runDisabled)` Establece si GTest debe ejecutar pruebas inhabilitadas.

Campos

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Constructores públicos

GTestBase

public GTestBase ()

Métodos públicos

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Agrega el ERROR(/Set) de filtros de las pruebas que se deben excluir.

Parámetros
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Agrega el ERROR(/Set) de 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 ()

Borrar todos los filtros de exclusión de los que se realiza un seguimiento actualmente

clearIncludeFilters

public void clearIncludeFilters ()

Borra todos los filtros de inclusión de los que se realiza un seguimiento actualmente.

getAbi

public IAbi getAbi ()

Muestra
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

Obtiene los comandos de shell para ejecutar después de GTest.

Muestra

getBeforeTestCmd

public  getBeforeTestCmd ()

Obtiene los comandos de shell para ejecutar 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 marca adicionales para pasarlos 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 un gtest.

Muestra
`long`

getModuleName

public String getModuleName ()

Ejecuta el módulo de prueba nativo de Android.

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

getRunDisabledTests

public boolean getRunDisabledTests ()

Obtén si GTest debe ejecutar pruebas inhabilitadas.

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

getRuntimeHint

public long getRuntimeHint ()

Muestra el tiempo de ejecución esperado de la prueba en milisegundos. El tiempo se usa para balancear la carga de la ejecución fragmentada.

Muestra
`long`

getShardCount

public int getShardCount ()

Muestra el recuento de fragmentos actual.

Muestra
`int`

getShardIndex

public int getShardIndex ()

Obtiene el índice del fragmento de esta prueba.

Muestra
`int`

getTestFilterKey

public String getTestFilterKey ()

Obtiene la clave de filtro de prueba.

Muestra
`String`

getTestModule

public String getTestModule ()

Obtiene el nombre del módulo.

Muestra
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Solo invoca el objeto binario de prueba para recopilar la lista de casos de prueba aplicables o no.

Muestra
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Obtiene el resultado XML de gtest para los resultados de la prueba o no.

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 para 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)

Inyecta el IConfiguration en uso.

Parámetros
`configuration`	`IConfiguration`

setModuleName

public void setModuleName (String moduleName)

Configura 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)

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

Parámetros
`shardCountHint`	`int`: Es el recuento de fragmentos que se intentó.

Muestra
	una colección de pruebas secundarias que se ejecutarán por separado o `null` si la prueba no se puede particionar en este momento

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 ()

Muestra la configuración de la prueba.

Muestra
`IConfiguration`	un IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Haz todo lo posible para recuperar un mensaje descriptivo breve y significativo para un Exception determinado.

Parámetros
`e`	`Exception`: el `Exception`

Muestra
`String`	un mensaje breve

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Es un método auxiliar para compilar el comando gtest que se ejecutará.

Parámetros
`fullPath`	`String`: Es la 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 de shell para ejecutar gtest

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Es un asistente que permite que las clases derivadas unan 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 auxiliar para obtener el filtro de prueba g-test que se ejecutará.

Ten en cuenta que los filtros solo filtran el nombre de la función (p. ej., Google Test "Test"). Se considerarán 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`	La marca de filtro completa que se pasará a la prueba G o una cadena vacía si no se especifica ninguna

Arroja
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Muestra el GTestListener que proporciona información de depuración adicional, como detectar y informar pruebas duplicadas si mDisabledDuplicateCheck es falso. De lo contrario, muestra el objeto de escucha que se pasó.

Parámetros
`listeners`	`ITestInvocationListener`

Muestra
`ITestInvocationListener`

loadFilter

protected abstract String loadFilter (String path)

Define el método de filtro de obtención.

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`