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 deben excluir. |
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 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()
Muestra el |
|
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 |
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()
Devuelve 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 el resultado XML de gtest para los resultados de la prueba o no. |
boolean
|
isSharded()
Obtiene la marca isSharded. |
void
|
notifyTestExecution(boolean incompleteTestFound,
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)
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)
Es una 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 limitación del SO en el tamaño de los argumentos. |
void
|
erasePrependedFileName(
|
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 |
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 asistente que permite que las clases derivadas unan el comando gtest en 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... 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 get. |
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
FILTRO_DE_MARCA_GTEST
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
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 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 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 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.
getAfterTestCmd
publicgetAfterTestCmd ()
Obtiene los comandos de shell para ejecutar después de GTest.
Muestra | |
---|---|
|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Obtiene los comandos de shell para ejecutar antes de GTest.
Muestra | |
---|---|
|
getExcludeFilters
publicgetExcludeFilters ()
Muestra el ERROR(/Set)
actual de los filtros de exclusión.
Muestra | |
---|---|
|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Obtiene la regex para excluir la ejecución de ciertos archivos.
Muestra | |
---|---|
|
getGTestFlags.
publicgetGTestFlags ()
Obtiene valores de marca adicionales para pasarlos al comando de 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 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 ()
Devuelve 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 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 |
notifyTestExecution
public void notifyTestExecution (boolean incompleteTestFound,failedTests)
Notificar al elemento superior sobre la ejecución de prueba, de modo que los filtros de inclusión o exclusión puedan controlarse correctamente en los reintentos.
Parámetros | |
---|---|
incompleteTestFound |
boolean |
failedTests |
|
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
publicsplit (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 intentados. |
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
createFlagFile
protected String createFlagFile (String filter)
Crea un archivo que contenga los filtros que se usarán con --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 |
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 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 corto |
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)
Asistente que permite que las clases derivadas unan el comando gtest a 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., 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 la manera de 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 |