Esta página se ha traducido con Cloud Translation API.

GTestBase

public abstract class GTestBase
extends Object implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver

java.lang.Objeto
↳	com.android.tradefed.testtype.GTestBase

Subclases directas conocidas

GTest , HostGTest

Prueba GT	Una prueba que ejecuta un paquete de prueba nativo en un dispositivo determinado.
AnfitriónGTest	Una prueba que ejecuta un paquete de prueba nativo.

Subclases indirectas conocidas

ArteGTest

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`