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( filters)

Agrega el ERROR(/Set) de filtros de las pruebas que se deben excluir.

void addAllIncludeFilters( filters)

Agrega el ERROR(/Set) de filtros de las pruebas que se incluirán.

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 ERROR(/Set) actual de los filtros de exclusión.

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 ERROR(/Set) actual de los filtros de inclusión.

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, failedTests)

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 IConfiguration en uso.

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 split() que también proporciona el shardCount que se intenta ejecutar.

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( filters, String filename)
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 Exception determinado.

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.

GetAbi

public IAbi getAbi ()

Muestra
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

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

Muestra

getBeforeTestCmd

public  getBeforeTestCmd ()

Obtiene los comandos de shell para ejecutar antes de GTest.

Muestra

getExcludeFilters

public  getExcludeFilters ()

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

Muestra

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Obtiene la regex para excluir la ejecución de ciertos archivos.

Muestra

getGTestFlags.

public  getGTestFlags ()

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

Muestra

getIncludeFilters

public  getIncludeFilters ()

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

SetAbi

public void setAbi (IAbi abi)

Parámetros
abi IAbi

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

public  split (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