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 ERROR(/Set) de los 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 actualmente rastreados.

void clearIncludeFilters ()

Elimine todos los filtros de inclusión actualmente rastreados.

IAbi getAbi ()
getAfterTestCmd ()

Obtiene comandos de shell para ejecutar 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 expresiones regulares para excluir la ejecución de ciertos archivos.

getGTestFlags ()

Obtiene valores de indicadores 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 un gtest.

String getModuleName ()

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

boolean getRunDisabledTests ()

Obtenga información sobre 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 del filtro de prueba.

String getTestModule ()

Obtiene el nombre del módulo.

boolean isCollectTestsOnly ()

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

boolean isEnableXmlOutput ()

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

boolean isSharded ()

Obtiene la bandera isSharded.

void notifyTestExecution (boolean incompleteTestFound, failedTests) notifyTestExecution (boolean incompleteTestFound, failedTests)

Notificar a los padres sobre la ejecución de la prueba, para que los filtros de inclusión/exclusión puedan manejarse adecuadamente en los reintentos.

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 utilizarán mediante --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 hacer que todos los indicadores de GTest pasen al comando adb shell.

IConfiguration getConfiguration ()

Devuelve la configuración de prueba.

String getExceptionMessage (Exception e)

Haga todo lo posible para recuperar un mensaje descriptivo breve y significativo para Exception determinada.

String getGTestCmdLine (String fullPath, String flags)

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

String getGTestCmdLineWrapper (String fullPath, String flags)

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

String getGTestFilters (String path)

Ayuda para ejecutar el filtro de prueba g.

ITestInvocationListener getGTestListener ( ITestInvocationListener listener)

Devuelve 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 el método de obtención 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_OUTPUT

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

agregar filtro de exclusión

public void addExcludeFilter (String filter)

Agrega un filtro de qué pruebas excluir.

Parámetros
filter String

agregarIncludeFilter

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 actualmente rastreados.

borrarIncluirfiltros

public void clearIncludeFilters ()

Elimine todos los filtros de inclusión actualmente rastreados.

obtenerAbi

public IAbi getAbi ()

Devoluciones
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

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

Devoluciones

getBeforeTestCmd

public  getBeforeTestCmd ()

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

Devoluciones

getExcludeFilters

public  getExcludeFilters ()

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

Devoluciones

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

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

Devoluciones

obtenerGTestFlags

public  getGTestFlags ()

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

Devoluciones

getIncludeFilters

public  getIncludeFilters ()

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

Devoluciones

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Obtiene el tiempo máximo para que se ejecute un gtest.

Devoluciones
long

obtener nombre del módulo

public String getModuleName ()

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

Devoluciones
String el nombre del módulo de prueba nativo que se ejecutará, o nulo si no está configurado

getRunDisabledPruebas

public boolean getRunDisabledTests ()

Obtenga información sobre si GTest debe ejecutar pruebas deshabilitadas.

Devoluciones
boolean Verdadero si se deben ejecutar pruebas deshabilitadas; falso en caso 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

obtenerShardCount

public int getShardCount ()

Devuelve el recuento de fragmentos actual.

Devoluciones
int

obtenerShardIndex

public int getShardIndex ()

Obtiene el índice de fragmentos de esta prueba.

Devoluciones
int

obtener clave de filtro de prueba

public String getTestFilterKey ()

Obtiene la clave del filtro de prueba.

Devoluciones
String

obtener módulo de prueba

public String getTestModule ()

Obtiene el nombre del módulo.

Devoluciones
String

esCollectTestsOnly

public boolean isCollectTestsOnly ()

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

Devoluciones
boolean

isEnableXmlSalida

public boolean isEnableXmlOutput ()

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

Devoluciones
boolean

está fragmentado

public boolean isSharded ()

Obtiene la bandera isSharded.

Devoluciones
boolean

notificarTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Notificar a los padres sobre la ejecución de la prueba, para que los filtros de inclusión/exclusión puedan manejarse adecuadamente en los reintentos.

Parámetros
incompleteTestFound boolean

failedTests

conjuntoAbi

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.

establecer configuración

public void setConfiguration (IConfiguration configuration)

Inyecta la IConfiguration en uso.

Parámetros
configuration IConfiguration

establecer nombre del mó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 que se 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 pruebas que a veces no pueden decidir arbitrariamente.

Parámetros
shardCountHint int : el recuento de fragmentos intentado.

Devoluciones
una colección de subpruebas que se ejecutarán por separado o serán 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 utilizarán mediante --gtest_flagfile para evitar cualquier limitación del sistema operativo en el tamaño de los argumentos.

Parámetros
filter String : la cadena del filtro.

Devoluciones
String La ruta al archivo que contiene el filtro.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

borrar nombre de archivo antepuesto

protected void erasePrependedFileName ( filters, 
                String filename)

Parámetros
filters

filename String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Ayudante para hacer que todos los indicadores de GTest pasen al comando adb shell.

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

Devoluciones
String la String de todas las banderas de GTest que deben pasarse a GTest

Lanza
DeviceNotAvailableException

obtener configuración

protected IConfiguration getConfiguration ()

Devuelve la configuración de prueba.

Devoluciones
IConfiguration una configuración I

obtener mensaje de excepción

protected String getExceptionMessage (Exception e)

Haga todo lo posible para recuperar un mensaje descriptivo breve y significativo para Exception determinada.

Parámetros
e Exception : la Exception

Devoluciones
String un mensaje corto

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

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

Parámetros
fullPath String : ruta absoluta del sistema de archivos para probar el binario en el dispositivo

flags String : indicadores de ejecución de gtest

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

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Ayudante que permite a las clases derivadas incluir 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)

Ayuda para ejecutar el filtro de prueba g.

Tenga en cuenta que los filtros filtran únicamente por el nombre de la función (por ejemplo: Prueba de Google "Prueba"); Se considerarán 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

obtenerGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

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

Parámetros
listener ITestInvocationListener

Devoluciones
ITestInvocationListener

cargarfiltro

protected abstract String loadFilter (String path)

Defina el método de obtención 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