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

GTestBase

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

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

Subclases directas conocidas

GTest , HostGTest

Prueba	Una prueba que ejecuta un paquete de prueba nativo en un dispositivo determinado.
HostGTest	Una prueba que ejecuta un paquete de prueba nativo.

Subclases 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)` `addAllExcludeFilters ( filters)` Agrega el `ERROR(/Set)` de filtros de qué pruebas excluir.
`void`	`addAllIncludeFilters ( filters)` `addAllIncludeFilters ( filters)` Agrega el `ERROR(/Set)` de filtros de qué pruebas incluir.
`void`	`addExcludeFilter (String filter)` Agrega un filtro de qué pruebas excluir.
`void`	`addIncludeFilter (String filter)` Agrega un filtro de qué pruebas incluir.
`String`	`cleanFilter (String filter)`
`void`	`clearExcludeFilters ()` Elimine todos los filtros de exclusión rastreados actualmente.
`void`	`clearIncludeFilters ()` Elimine todos los filtros de inclusión rastreados 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 expresiones regulares para excluir ciertos archivos de la ejecución.
	`getGTestFlags ()` Obtiene valores de marca 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 de ejecución de una prueba g.
`String`	`getModuleName ()` Obtenga el módulo de prueba nativo de Android para ejecutar.
`boolean`	`getRunDisabledTests ()` Obtenga si GTest debe ejecutar pruebas deshabilitadas.
`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 fragmentos de esta prueba.
`String`	`getTestFilterKey ()` Obtiene la clave de filtro de prueba.
`String`	`getTestModule ()` Obtiene el nombre del módulo.
`boolean`	`isCollectTestsOnly ()` Obtiene solo invocar el binario de prueba para recopilar la lista de casos de prueba aplicables o no.
`boolean`	`isEnableXmlOutput ()` Obtiene el uso de la salida gtest xml para los resultados de la prueba o no.
`boolean`	`isSharded ()` Obtiene el indicador isSharded.
`void`	`setAbi ( IAbi abi)`
`void`	`setCollectTestsOnly (boolean shouldCollectTest)` Habilita o deshabilita el modo de recopilación de pruebas
`void`	`setConfiguration ( IConfiguration configuration)` Inyecta la `IConfiguration` en uso.
`void`	`setModuleName (String moduleName)` Configure 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 fragmentos 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`	`createFlagFile (String filter)` Cree un archivo que contenga los filtros que se usarán a través de --gtest_flagfile para evitar cualquier limitación del sistema operativo en el tamaño de los argumentos.
`void`	`erasePrependedFileName ( filters, String filename)` `erasePrependedFileName ( filters, String filename)`
`String`	`getAllGTestFlags (String path)` Ayudante para obtener todas las banderas de GTest para pasar al comando adb shell.
`IConfiguration`	`getConfiguration ()` Devuelve la configuración de prueba.
`String`	`getExceptionMessage (Exception e)` Haga un mejor esfuerzo para recuperar un mensaje descriptivo breve y significativo para `ERROR(/Exception)` dado
`String`	`getGTestCmdLine (String fullPath, String flags)` Método auxiliar para compilar el comando gtest para ejecutar.
`String`	`getGTestCmdLineWrapper (String fullPath, String flags)` Ayudante que permite que las clases derivadas envuelvan el comando gtest en alguna otra herramienta (chroot, strace, gdb y similares).
`String`	`getGTestFilters (String path)` Ayudante para ejecutar el filtro g-test de la prueba.
`ITestInvocationListener`	`getGTestListener ( ITestInvocationListener listener)` Devuelve el `GTestListener` que proporciona información de depuración adicional, como detecta e informa pruebas duplicadas si mDisabledDuplicateCheck es falso.
`abstract String`	`loadFilter (String path)` Defina obtener método de filtro.
`void`	`setRunDisabled (boolean runDisabled)` Establezca si GTest debe ejecutar pruebas deshabilitadas.

Campos

FILTRO_EXTENSIÓN

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_SALIDA

protected static final String GTEST_XML_OUTPUT

Constructores públicos

GTestBase

public GTestBase ()

Métodos públicos

agregarTodosExcluirFiltros

public void addAllExcludeFilters ( filters)

Agrega el ERROR(/Set) de filtros de qué pruebas excluir.

Parámetros
`filters`

agregarTodosIncluirFiltros

public void addAllIncludeFilters ( filters)

Agrega el ERROR(/Set) de filtros de qué pruebas incluir.

Parámetros
`filters`

agregarExcluirFiltro

public void addExcludeFilter (String filter)

Agrega un filtro de qué pruebas excluir.

Parámetros
`filter`	`String`

agregarIncluirFiltro

public void addIncludeFilter (String filter)

Agrega un filtro de qué pruebas incluir.

Parámetros
`filter`	`String`

LimpiarFiltro

public String cleanFilter (String filter)

Parámetros
`filter`	`String`

Devoluciones
`String`

borrarExcluirFiltros

public void clearExcludeFilters ()

Elimine todos los filtros de exclusión rastreados actualmente.

borrarIncluirFiltros

public void clearIncludeFilters ()

Elimine todos los filtros de inclusión rastreados actualmente.

conseguirAbi

public IAbi getAbi ()

Devoluciones
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

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

Devoluciones

getBeforeTestCmd

public  getBeforeTestCmd ()

Obtiene los comandos de shell para ejecutar antes de GTest.

Devoluciones

obtenerExcluirFiltros

public  getExcludeFilters ()

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

Devoluciones

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Obtiene expresiones regulares para excluir ciertos archivos de la ejecución.

Devoluciones

getGTestFlags

public  getGTestFlags ()

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

Devoluciones

obtenerIncluirFiltros

public  getIncludeFilters ()

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

Devoluciones

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Obtiene el tiempo máximo de ejecución de una prueba g.

Devoluciones
`long`

getModuleName

public String getModuleName ()

Obtenga el módulo de prueba nativo de Android para ejecutar.

Devoluciones
`String`	el nombre del módulo de prueba nativo para ejecutar, o nulo si no se establece

getRunDisabledTests

public boolean getRunDisabledTests ()

Obtenga si GTest debe ejecutar pruebas deshabilitadas.

Devoluciones
`boolean`	Verdadero si se deben ejecutar pruebas deshabilitadas, falso de lo contrario

getRuntimeHint

public long getRuntimeHint ()

Devuelve el tiempo de ejecución esperado de la prueba en milisegundos. El tiempo se utiliza para equilibrar la carga de la ejecución fragmentada.

Devoluciones
`long`

getShardCount

public int getShardCount ()

Devuelve el recuento de fragmentos actual.

Devoluciones
`int`

getShardIndex

public int getShardIndex ()

Obtiene el índice de fragmentos de esta prueba.

Devoluciones
`int`

getTestFilterKey

public String getTestFilterKey ()

Obtiene la clave de filtro de prueba.

Devoluciones
`String`

getTestModule

public String getTestModule ()

Obtiene el nombre del módulo.

Devoluciones
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Obtiene solo invocar el binario de prueba para recopilar la lista de casos de prueba aplicables o no.

Devoluciones
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Obtiene el uso de la salida gtest xml para los resultados de la prueba o no.

Devoluciones
`boolean`

estáfragmentado

public boolean isSharded ()

Obtiene el indicador isSharded.

Devoluciones
`boolean`

setAbi

public void setAbi (IAbi abi)

Parámetros
`abi`	`IAbi`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Habilita o deshabilita el modo de recopilación de pruebas

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inyecta la IConfiguration en uso.

Parámetros
`configuration`	`IConfiguration`

establecerNombreDeMódulo

public void setModuleName (String moduleName)

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

Parámetros
`moduleName`	`String` : el nombre del módulo de prueba nativo para ejecutar

setShardCount

public void setShardCount (int shardCount)

Establece el recuento de fragmentos de esta prueba.

Parámetros
`shardCount`	`int`

establecerShardIndex

public void setShardIndex (int shardIndex)

Establece el índice de fragmentos de esta prueba.

Parámetros
`shardIndex`	`int`

dividir

public  split (int shardCountHint)

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

Parámetros
`shardCountHint`	`int` : el número de fragmentos intentados.

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

Métodos protegidos

crear archivo de bandera

protected String createFlagFile (String filter)

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

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

Devoluciones
`String`	La ruta al archivo que contiene el filtro.

Lanza
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

borrarPrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

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

getAllGTestFlags

protected String getAllGTestFlags (String path)

Ayudante para obtener todas las banderas de GTest para pasar al comando adb shell.

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

Devoluciones
`String`	el `ERROR(/String)` de todas las marcas de GTest que deben pasarse a GTest

Lanza
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Devuelve la configuración de prueba.

Devoluciones
`IConfiguration`	una configuración de I

getExceptionMessage

protected String getExceptionMessage (Exception e)

Haga un mejor esfuerzo para recuperar un mensaje descriptivo breve y significativo para ERROR(/Exception) dado

Parámetros
`e`	`Exception` : el `ERROR(/Exception)`

Devoluciones
`String`	un mensaje corto

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Método auxiliar para compilar el comando gtest para ejecutar.

Parámetros
`fullPath`	`String` : ruta absoluta del sistema de archivos al binario gtest en el dispositivo
`flags`	`String` : banderas de ejecución gtest

Devoluciones
`String`	la línea de comando de shell para ejecutar el gtest

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Ayudante que permite que las clases derivadas envuelvan el comando gtest en alguna otra herramienta (chroot, strace, gdb y similares).

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

Devoluciones
`String`

obtenerGTestFilters

protected String getGTestFilters (String path)

Ayudante para ejecutar el filtro g-test de la prueba.

Tenga en cuenta que los filtros filtran solo por el nombre de la función (p. ej., Google Test "Test"); se tendrán en cuenta todos los "casos de prueba" de Google Test.

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

Devoluciones
`String`	el indicador de filtro completo para pasar a la prueba g, o una cadena vacía si no se ha especificado ninguno

Lanza
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

Devuelve el GTestListener que proporciona información de depuración adicional, como detecta e informa pruebas duplicadas si mDisabledDuplicateCheck es falso. De lo contrario, devuelve el agente de escucha pasado.

Parámetros
`listener`	`ITestInvocationListener`

Devoluciones
`ITestInvocationListener`

filtro de carga

protected abstract String loadFilter (String path)

Defina obtener método de filtro.

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

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

Devoluciones
`String`	cadena de filtro.

Lanza
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Establezca si GTest debe ejecutar pruebas deshabilitadas.

Parámetros
`runDisabled`	`boolean`