GTestBase
public abstract class GTestBase
extends Object
implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver
java.lang.Objeto | |
↳ | com.android.tradefed.testtype.GTestBase |
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 |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Agrega el |
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 | |
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 | |
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 |
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 |
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 |
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 |
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.
getAfterTestCmd
publicgetAfterTestCmd ()
Obtiene los comandos de shell para ejecutar después de GTest.
Devoluciones | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Obtiene los comandos de shell para ejecutar antes de GTest.
Devoluciones | |
---|---|
obtenerExcluirFiltros
publicgetExcludeFilters ()
Devuelve el ERROR(/Set)
actual de los filtros de exclusión.
Devoluciones | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Obtiene expresiones regulares para excluir ciertos archivos de la ejecución.
Devoluciones | |
---|---|
getGTestFlags
publicgetGTestFlags ()
Obtiene valores de marca adicionales para pasar al comando de shell de la prueba nativa.
Devoluciones | |
---|---|
obtenerIncluirFiltros
publicgetIncludeFilters ()
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 |
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
publicsplit (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 |