ArtRunTest

public class ArtRunTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, ITestCollector, ITestFilterReceiver

java.lang.Object
   ↳ com.android.tradefed.testtype.ArtRunTest

Es un ejecutor de pruebas para ejecutar pruebas de ART.

Resumen

Clases anidadas

class ArtRunTest.AdbShellCommandException

Es una clase de excepción para informar un error que se produjo durante la ejecución de un comando de shell de ADB. 

Constantes

String CHECKER_PAR_FILENAME

Campos

public static final Boolean RUN_CHECKER

Constructores públicos

ArtRunTest()

Métodos públicos

void addAllExcludeFilters(Set<String> filters)

Agrega el Set de los filtros de las pruebas que se excluirán.

void addAllIncludeFilters(Set<String> filters)

Agrega el Set de los filtros de las pruebas que se incluirán.

void addExcludeFilter(String filter)

Agrega un filtro de qué pruebas se deben excluir.

void addIncludeFilter(String filter)

Agrega un filtro de las pruebas que se incluirán.

void clearExcludeFilters()

Borra todos los filtros de exclusión que se rastrean actualmente.

void clearIncludeFilters()

Borra todos los filtros de inclusión que se rastrean actualmente.

IAbi getAbi()
Set<String> getExcludeFilters()

Devuelve el Set actual de los filtros de exclusión.

Set<String> getIncludeFilters()

Devuelve el Set actual de los filtros de inclusión.

void run(TestInformation testInfo, ITestInvocationListener listener)

Ejecuta las pruebas y le informa el resultado al objeto de escucha.

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.

Métodos protegidos

Optional<String> checkExitCode(Integer exitCode)

Verifica el código de salida que devuelve un comando de prueba.

Optional<String> checkTestOutput(TestInformation testInfo, String actualOutputText, String outputShortName, String outputPrettyName)

Verifica un resultado producido por un comando de prueba.

File createTestLocalTempDirectory(TestInformation testInfo)

Crea un directorio temporal local dentro de la carpeta de dependencias de la prueba para recopilar los resultados de la prueba extraídos del dispositivo en prueba.

Optional<String> executeCheckerTest(TestInformation testInfo, ITestInvocationListener listener)

Ejecuta una prueba de Checker y verifica su resultado.

void extractSourcesFromJar(File tmpCheckerLocalDir, File jar)

Extrae el directorio src del archivo jar determinado al directorio determinado.

File getCheckerBinaryPath(TestInformation testInfo)

Busca el archivo binario de Checker (archivo de Python).

Optional<String> runChecker(String[] checkerCommandLine)

Ejecuta un comando de Checker y verifica su resultado.

Constantes

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

Valor de la constante: "art-run-test-checker"

Campos

RUN_CHECKER

public static final Boolean RUN_CHECKER

Constructores públicos

ArtRunTest

public ArtRunTest ()

Métodos públicos

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Agrega el Set de los filtros de las pruebas que se excluirán.

Parámetros
filters Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Agrega el Set de los filtros de las pruebas que se incluirán.

Parámetros
filters Set

addExcludeFilter

public void addExcludeFilter (String filter)

Agrega un filtro de qué pruebas se deben excluir.

Parámetros
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

Agrega un filtro de las pruebas que se incluirán.

Parámetros
filter String

clearExcludeFilters

public void clearExcludeFilters ()

Borra todos los filtros de exclusión que se rastrean actualmente.

clearIncludeFilters

public void clearIncludeFilters ()

Borra todos los filtros de inclusión que se rastrean actualmente.

getAbi

public IAbi getAbi ()

Muestra
IAbi

getExcludeFilters

public Set<String> getExcludeFilters ()

Devuelve el Set actual de los filtros de exclusión.

Muestra
Set<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

Devuelve el Set actual de los filtros de inclusión.

Muestra
Set<String>

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Ejecuta las pruebas y le informa el resultado al objeto de escucha.

Parámetros
testInfo TestInformation: Es el objeto TestInformation que contiene información útil para ejecutar pruebas.
listener ITestInvocationListener: El ITestInvocationListener de los resultados de la prueba
Arroja
DeviceNotAvailableException

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)

Inserta el IConfiguration en uso.

Parámetros
configuration IConfiguration

Métodos protegidos

checkExitCode

protected Optional<String> checkExitCode (Integer exitCode)

Verifica el código de salida que devuelve un comando de prueba.

Parámetros
exitCode Integer: Es el código de salida que devuelve el comando de prueba.
Muestra
Optional<String> Un mensaje de error opcional, vacío si el código de salida de la prueba indicó éxito

checkTestOutput

protected Optional<String> checkTestOutput (TestInformation testInfo, 
                String actualOutputText, 
                String outputShortName, 
                String outputPrettyName)

Verifica un resultado producido por un comando de prueba.

Se usa para verificar la salida estándar y el error estándar de una prueba.

Parámetros
testInfo TestInformation: Es el objeto TestInformation asociado a la prueba ejecutada.
actualOutputText String: Es el resultado que produce la prueba.
outputShortName String: Nombre corto del canal de salida
outputPrettyName String: Es un nombre más descriptivo para el canal de salida, que se usa en los mensajes de error.
Muestra
Optional<String> Es un mensaje de error opcional, que está vacío si el resultado verificado es válido.

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

Crea un directorio temporal local dentro de la carpeta de dependencias de la prueba para recopilar los resultados de la prueba extraídos del dispositivo en prueba.

Parámetros
testInfo TestInformation: Es el objeto TestInformation asociado a la prueba ejecutada.
Muestra
File Objeto File que apunta al directorio temporal creado.
Arroja
IOException Si no se pudo crear el directorio temporal.

executeCheckerTest

protected Optional<String> executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

Ejecuta una prueba de Checker y verifica su resultado.

Las pruebas de verificación son pruebas adicionales que se incluyen en algunas pruebas de ejecución de ART, escritas como anotaciones en los comentarios de los archivos fuente de una prueba y que se usan para verificar el compilador de ART.

Parámetros
testInfo TestInformation: Es el objeto TestInformation asociado a la prueba ejecutada.
listener ITestInvocationListener: Es el objeto ITestInvocationListener asociado a la prueba ejecutada.
Muestra
Optional<String> Es un mensaje de error opcional, vacío si la prueba de Checker se realizó correctamente.
Arroja
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException
IOException

extractSourcesFromJar

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

Extrae el directorio src del archivo jar determinado al directorio determinado.

Parámetros
tmpCheckerLocalDir File

jar File

Arroja
IOException

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

Busca el archivo binario de Checker (archivo de Python).

Parámetros
testInfo TestInformation

Muestra
File

runChecker

protected Optional<String> runChecker (String[] checkerCommandLine)

Ejecuta un comando de Checker y verifica su resultado.

Parámetros
checkerCommandLine String: Línea de comandos del verificador que se ejecutará
Muestra
Optional<String> Es un mensaje de error opcional, vacío si la invocación del verificador se realizó correctamente.