GTestBase
public
abstract
class
GTestBase
extends Object
implements
IAbiReceiver,
IConfigurationReceiver,
IRemoteTest,
IRuntimeHintProvider,
IShardableTest,
ITestCollector,
ITestFilterReceiver
Objeto java.lang. | |
↳ | 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(
Agrega el |
void
|
addAllIncludeFilters(
Agrega el |
void
|
addExcludeFilter(String filter)
Agrega un filtro de las pruebas que se excluirán. |
void
|
addIncludeFilter(String filter)
Agrega un filtro de qué pruebas se incluirán. |
String
|
cleanFilter(String filter)
|
void
|
clearExcludeFilters()
Borra todos los filtros de exclusión que se estén supervisando actualmente. |
void
|
clearIncludeFilters()
Borra todos los filtros de inclusión que se estén supervisando 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()
Muestra el |
|
getFileExclusionFilterRegex()
Obtiene la regex para excluir la ejecución de ciertos archivos. |
|
getGTestFlags()
Obtiene valores de marcas adicionales para pasar al comando shell de la prueba nativa. |
|
getIncludeFilters()
Muestra el |
long
|
getMaxTestTimeMs()
Obtiene el tiempo máximo de ejecución de gtest. |
String
|
getModuleName()
Obtén el módulo de prueba nativo de Android para ejecutarlo. |
boolean
|
getRunDisabledTests()
Averigua 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 de fragmentos de esta prueba. |
String
|
getTestFilterKey()
Obtiene la clave de filtro de prueba. |
String
|
getTestModule()
Obtiene el nombre del módulo. |
boolean
|
isCollectTestsOnly()
El método get solo invoca el objeto binario de prueba para recopilar una lista de los casos de prueba aplicables o no. |
boolean
|
isEnableXmlOutput()
Obtiene o no el resultado de usar gtest en formato XML para los resultados de las pruebas. |
boolean
|
isSharded()
Obtiene la marca isSharded. |
void
|
notifyTestExecution(boolean incompleteTestFound,
Notificar al elemento superior sobre la ejecución de prueba para que los filtros de inclusión y exclusión puedan controlarse correctamente para los reintentos. |
void
|
setAbi(IAbi abi)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
Habilita o inhabilita el modo de recopilación de pruebas |
void
|
setConfiguration(IConfiguration configuration)
Inserta el |
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 fragmentos de esta prueba. |
|
split(int shardCountHint)
Versión alternativa de |
Métodos protegidos | |
---|---|
String
|
createFlagFile(String filter)
Crea un archivo que contenga los filtros que se usarán a través de --gtest_flagfile para evitar cualquier SO. limitación de tamaño en argumentos. |
void
|
erasePrependedFileName(
|
String
|
getAllGTestFlags(String path)
Es una herramienta de ayuda para obtener todas las marcas GTest para pasar al comando shell adb. |
IConfiguration
|
getConfiguration()
Muestra la configuración de prueba. |
String
|
getExceptionMessage(Exception e)
Haz todo lo posible por recuperar un mensaje descriptivo corto y significativo para
|
String
|
getGTestCmdLine(String fullPath, String flags)
Es un método de ayuda para compilar el comando de gtest que se ejecutará. |
String
|
getGTestCmdLineWrapper(String fullPath, String flags)
Asistente que permite que las clases derivadas unan el comando gtest con alguna otra herramienta (chroot, strace, gdb y similares). |
String
|
getGTestFilters(String path)
Es una herramienta de ayuda para obtener el filtro g-test de la prueba que se ejecutará. |
ITestInvocationListener
|
getGTestListener(ITestInvocationListener listener)
Devuelve el GTestListener que proporciona información de depuración adicional, como detecta y informa pruebas duplicadas si mDisabledDuplicateCheck es falso. |
abstract
String
|
loadFilter(String path)
Define el método get de filtro. |
void
|
setRunDisabled(boolean runDisabled)
Establece si GTest debe ejecutar pruebas inhabilitadas. |
Campos
EXTENSIÓN_DE_FILTRO
protected static final String FILTER_EXTENSION
GTEST_FLAG_FILE
protected static final String GTEST_FLAG_FILE
FILTRO_DE_MARCA_GTEST
protected static final String GTEST_FLAG_FILTER
PRUEBAS_GTEST_FLAG_LIST_TESTS
protected static final String GTEST_FLAG_LIST_TESTS
GTEST_FLAG_PRINT_TIME
protected static final String GTEST_FLAG_PRINT_TIME
PRUEBAS_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 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 excluirán.
Parámetros | |
---|---|
filter |
String |
addIncludeFilter
public void addIncludeFilter (String filter)
Agrega un filtro de qué pruebas 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 estén supervisando actualmente.
ClearIncludeFilters
public void clearIncludeFilters ()
Borra todos los filtros de inclusión que se estén supervisando actualmente.
getAfterTestCmd
publicgetAfterTestCmd ()
Obtiene los comandos de shell que se ejecutarán después de GTest.
Muestra | |
---|---|
|
getAntesTestCmd
publicgetBeforeTestCmd ()
Obtiene los comandos de shell que se ejecutarán antes de GTest.
Muestra | |
---|---|
|
getExcludeFilters.
publicgetExcludeFilters ()
Muestra el ERROR(/Set)
actual de los filtros de exclusión.
Muestra | |
---|---|
|
getFileExclusiónRegex
publicgetFileExclusionFilterRegex ()
Obtiene la regex para excluir la ejecución de ciertos archivos.
Muestra | |
---|---|
|
getGTestFlags.
publicgetGTestFlags ()
Obtiene valores de marcas adicionales para pasar al comando shell de la prueba nativa.
Muestra | |
---|---|
|
getIncludeFilters
publicgetIncludeFilters ()
Muestra el ERROR(/Set)
actual de los filtros de inclusión.
Muestra | |
---|---|
|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
Obtiene el tiempo máximo de ejecución de gtest.
Muestra | |
---|---|
long |
getModuleName
public String getModuleName ()
Obtén el módulo de prueba nativo de Android para ejecutarlo.
Muestra | |
---|---|
String |
el nombre del módulo de prueba nativo que se ejecutará o un valor nulo si no está configurado |
getRunDisabledTests
public boolean getRunDisabledTests ()
Averigua si GTest debe ejecutar pruebas inhabilitadas.
Muestra | |
---|---|
boolean |
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 las cargas 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 de fragmentos 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 |
Solo RecopilarPruebas
public boolean isCollectTestsOnly ()
El método get solo invoca el objeto binario de prueba para recopilar una lista de los casos de prueba aplicables o no.
Muestra | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
Obtiene o no el resultado de usar gtest en formato XML para los resultados de las pruebas.
Muestra | |
---|---|
boolean |
isSharded
public boolean isSharded ()
Obtiene la marca isSharded.
Muestra | |
---|---|
boolean |
notificarTestExecution
public void notifyTestExecution (boolean incompleteTestFound,failedTests)
Notificar al elemento superior sobre la ejecución de prueba para que los filtros de inclusión y exclusión puedan manejarse correctamente para los reintentos.
Parámetros | |
---|---|
incompleteTestFound |
boolean |
failedTests |
|
Solo RecopilarTests
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 |
nombredeMódulodesetm
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 fragmentos de esta prueba.
Parámetros | |
---|---|
shardIndex |
int |
división
publicsplit (int shardCountHint)
Versión alternativa de split()
, que también proporciona el shardCount que se intenta
que se ejecutará. Esto es útil para algunos ejecutores de pruebas que a veces no pueden decidir de manera arbitraria.
Parámetros | |
---|---|
shardCountHint |
int : Es el recuento de intentos de fragmentos. |
Muestra | |
---|---|
|
una colección de subpruebas que se ejecutarán por separado o null si la prueba es
no es fragmentable actualmente |
Métodos protegidos
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 SO. limitación de tamaño en argumentos.
Parámetros | |
---|---|
filter |
String : Es la cadena de filtro. |
Muestra | |
---|---|
String |
La ruta de acceso al archivo que contiene el filtro. |
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
borrarNombreArchivoPrependido
protected void erasePrependedFileName (filters, String filename)
Parámetros | |
---|---|
filters |
|
filename |
String |
getAllGTestFlags.
protected String getAllGTestFlags (String path)
Es una herramienta de ayuda para obtener todas las marcas GTest para pasar al comando shell 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 prueba.
Muestra | |
---|---|
IConfiguration |
un objeto IConfiguration |
getExceptionMessage
protected String getExceptionMessage (Exception e)
Haz todo lo posible por recuperar un mensaje descriptivo corto y significativo para
Exception
Parámetros | |
---|---|
e |
Exception : el Exception |
Muestra | |
---|---|
String |
un mensaje corto |
getGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
Es un método de ayuda para compilar el comando de 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 ejecutarla para gtest |
getGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
Asistente que permite que las clases derivadas unan el comando gtest con alguna otra herramienta (chroot, strace, gdb y similares).
Parámetros | |
---|---|
fullPath |
String |
flags |
String |
Muestra | |
---|---|
String |
getGTestFilters
protected String getGTestFilters (String path)
Es una herramienta de ayuda para obtener el filtro g-test de la prueba que se ejecutará.
Ten en cuenta que los filtros solo filtran el nombre de la función (p. ej., Prueba de Google “Prueba”). todo Google Prueba “casos de prueba” .
Parámetros | |
---|---|
path |
String : Es la ruta de acceso completa del objeto binario en el dispositivo. |
Muestra | |
---|---|
String |
la marca de filtro completo para pasar a la prueba g, o una cadena vacía si no se ha especificado |
Arroja | |
---|---|
DeviceNotAvailableException |
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
Devuelve el GTestListener que proporciona información de depuración adicional, como detecta y informa pruebas duplicadas si mDisabledDuplicateCheck es falso. De lo contrario, devuelve el archivo objeto de escucha.
Parámetros | |
---|---|
listener |
ITestInvocationListener |
Muestra | |
---|---|
ITestInvocationListener |
Filtro de carga
protected abstract String loadFilter (String path)
Define el método get de filtro.
La subclase debe implementar la manera de obtener su propio filtro.
Parámetros | |
---|---|
path |
String : Es la ruta de acceso completa del archivo de filtro. |
Muestra | |
---|---|
String |
la cadena de filtro. |
Arroja | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
Establece si GTest debe ejecutar pruebas inhabilitadas.
Parámetros | |
---|---|
runDisabled |
boolean |