ArtRunTest

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

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

Exécuteur de test pour exécuter les tests d'exécution ART.

Résumé

Classes imbriquées

class ArtRunTest.AdbShellCommandException

Classe d'exception permettant de signaler une erreur survenue lors de l'exécution d'une commande shell ADB. 

Constantes

String CHECKER_PAR_FILENAME

Champs

public static final Boolean RUN_CHECKER

Constructeurs publics

ArtRunTest()

Méthodes publiques

void addAllExcludeFilters(Set<String> filters)

Ajoute le Set des filtres des tests à exclure.

void addAllIncludeFilters(Set<String> filters)

Ajoute le Set de filtres pour les tests à inclure.

void addExcludeFilter(String filter)

Ajoute un filtre pour exclure certains tests.

void addIncludeFilter(String filter)

Ajoute un filtre pour inclure certains tests.

void clearExcludeFilters()

Supprimez tous les filtres d'exclusion actuellement suivis.

void clearIncludeFilters()

Supprimez tous les filtres d'inclusion actuellement suivis.

IAbi getAbi()
Set<String> getExcludeFilters()

Renvoie le Set actuel des filtres d'exclusion.

Set<String> getIncludeFilters()

Renvoie le Set actuel des filtres d'inclusion.

void run(TestInformation testInfo, ITestInvocationListener listener)

Exécute les tests et signale le résultat à l'écouteur.

void setAbi(IAbi abi)

void setCollectTestsOnly(boolean shouldCollectTest)

Active ou désactive le mode de collecte des tests

void setConfiguration(IConfiguration configuration)

Injecte le IConfiguration en cours d'utilisation.

Méthodes protégées

Optional<String> checkExitCode(Integer exitCode)

Vérifiez le code de sortie renvoyé par une commande de test.

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

Vérifiez un résultat produit par une commande de test.

File createTestLocalTempDirectory(TestInformation testInfo)

Créez un répertoire temporaire local dans le dossier des dépendances du test pour collecter les résultats des tests extraits de l'appareil testé.

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

Exécutez un test Checker et vérifiez son résultat.

void extractSourcesFromJar(File tmpCheckerLocalDir, File jar)

Extrayez le répertoire src du fichier jar donné vers le répertoire donné.

File getCheckerBinaryPath(TestInformation testInfo)

Recherchez le binaire Checker (archive Python).

Optional<String> runChecker(String[] checkerCommandLine)

Exécutez une commande Checker et vérifiez son résultat.

Constantes

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

Constant Value: "art-run-test-checker"

Champs

RUN_CHECKER

public static final Boolean RUN_CHECKER

Constructeurs publics

ArtRunTest

public ArtRunTest ()

Méthodes publiques

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Ajoute le Set des filtres des tests à exclure.

Paramètres
filters Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Ajoute le Set de filtres pour les tests à inclure.

Paramètres
filters Set

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre pour exclure certains tests.

Paramètres
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre pour inclure certains tests.

Paramètres
filter String

clearExcludeFilters

public void clearExcludeFilters ()

Supprimez tous les filtres d'exclusion actuellement suivis.

clearIncludeFilters

public void clearIncludeFilters ()

Supprimez tous les filtres d'inclusion actuellement suivis.

getAbi

public IAbi getAbi ()

Renvoie
IAbi

getExcludeFilters

public Set<String> getExcludeFilters ()

Renvoie le Set actuel des filtres d'exclusion.

Renvoie
Set<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

Renvoie le Set actuel des filtres d'inclusion.

Renvoie
Set<String>

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et signale le résultat à l'écouteur.

Paramètres
testInfo TestInformation : objet TestInformation contenant des informations utiles pour exécuter des tests.
listener ITestInvocationListener : ITestInvocationListener des résultats du test
Génère
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Paramètres
abi IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Active ou désactive le mode de collecte des tests

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injecte le IConfiguration en cours d'utilisation.

Paramètres
configuration IConfiguration

Méthodes protégées

checkExitCode

protected Optional<String> checkExitCode (Integer exitCode)

Vérifiez le code de sortie renvoyé par une commande de test.

Paramètres
exitCode Integer : code de sortie renvoyé par la commande de test.
Renvoie
Optional<String> Message d'erreur facultatif, vide si le code de sortie du test indique une réussite

checkTestOutput

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

Vérifiez un résultat produit par une commande de test.

Permet de vérifier la sortie standard et l'erreur standard d'un test.

Paramètres
testInfo TestInformation : objet TestInformation associé au test exécuté.
actualOutputText String : résultat produit par le test.
outputShortName String : nom abrégé du canal de sortie
outputPrettyName String : nom plus esthétique du canal de sortie, utilisé dans les messages d'erreur
Renvoie
Optional<String> Message d'erreur facultatif, vide si le résultat vérifié est valide

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

Créez un répertoire temporaire local dans le dossier des dépendances du test pour collecter les résultats des tests extraits de l'appareil testé.

Paramètres
testInfo TestInformation : objet TestInformation associé au test exécuté.
Renvoie
File Objet File pointant vers le répertoire temporaire créé.
Génère
IOException Si la création du répertoire temporaire a échoué.

executeCheckerTest

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

Exécutez un test Checker et vérifiez son résultat.

Les tests de vérification sont des tests supplémentaires inclus dans certains tests d'exécution ART. Ils sont écrits sous forme d'annotations dans les commentaires des fichiers sources d'un test et sont utilisés pour vérifier le compilateur ART.

Paramètres
testInfo TestInformation : objet TestInformation associé au test exécuté.
listener ITestInvocationListener : objet ITestInvocationListener associé au test exécuté.
Renvoie
Optional<String> Message d'erreur facultatif, vide si le test du vérificateur a réussi
Génère
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException
IOException

extractSourcesFromJar

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

Extrayez le répertoire src du fichier jar donné vers le répertoire donné.

Paramètres
tmpCheckerLocalDir File

jar File

Génère
IOException

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

Recherchez le binaire Checker (archive Python).

Paramètres
testInfo TestInformation

Renvoie
File

runChecker

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

Exécutez une commande Checker et vérifiez son résultat.

Paramètres
checkerCommandLine String : ligne de commande du vérificateur à exécuter
Renvoie
Optional<String> Message d'erreur facultatif, vide si l'appel du vérificateur a réussi