ArtRunTest

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

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

---

Un lanceur de test pour exécuter des tests d'exécution ART.

Résumé

Classes imbriquées
class	ArtRunTest.AdbShellCommandException Classe d'exception pour signaler une erreur survenue lors de l'exécution d'une commande shell ADB.

Champs
public static final String	CHECKER_PAR_FILENAME

Constructeurs publics
ArtRunTest()

Méthodes publiques
void	addAllExcludeFilters( filters) Ajoute les ERROR(/Set) des filtres des tests à exclure.
void	addAllIncludeFilters( filters) Ajoute les ERROR(/Set) des filtres des tests à inclure.
void	addExcludeFilter(String filter) Ajoute un filtre des tests à exclure.
void	addIncludeFilter(String filter) Ajoute un filtre des tests à inclure.
void	clearExcludeFilters() Supprimez tous les filtres d'exclusion actuellement suivis.
void	clearIncludeFilters() Supprimez tous les filtres d'inclusion actuellement suivis.
IAbi	getAbi()
	getExcludeFilters() Renvoie l'ERROR(/Set) actuelle des filtres d'exclusion.
	getIncludeFilters() Renvoie l'ERROR(/Set) actuelle des filtres d'inclusion.
void	run(TestInformation testInfo, ITestInvocationListener listener) Exécute les tests et transmet les résultats à 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 utilisé.

Méthodes protégées
	checkExitCode(Integer exitCode) Vérifier le code de sortie renvoyé par une commande de test
	checkTestOutput(TestInformation testInfo, String actualOutputText, String outputShortName, String outputPrettyName) Vérifier une sortie générée par une commande de test
File	createTestLocalTempDirectory(TestInformation testInfo) Créez un répertoire temporaire local dans le dossier de dépendances du test pour collecter les sorties de test extraites de l'appareil testé.
	executeCheckerTest(TestInformation testInfo, ITestInvocationListener listener) Exécutez un test du vérificateur et vérifiez sa sortie.
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 du vérificateur (archive Python).
	runChecker(String[] checkerCommandLine) Exécutez une commande du vérificateur et vérifiez son résultat.

Champs

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

Constructeurs publics

ArtRunTest

public ArtRunTest ()

Méthodes publiques

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Ajoute les ERROR(/Set) des filtres des tests à exclure.

Paramètres
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Ajoute les ERROR(/Set) des filtres des tests à inclure.

Paramètres
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre des tests à exclure.

Paramètres
filter	String

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre des tests à inclure.

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

Renvoie l'ERROR(/Set) actuelle des filtres d'exclusion.

Renvoie

getIncludeFilters

public  getIncludeFilters ()

Renvoie l'ERROR(/Set) actuelle des filtres d'inclusion.

Renvoie

Exécuter

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et transmet les résultats à l'écouteur.

Paramètres
testInfo	TestInformation: objet TestInformation contenant des informations utiles pour exécuter des tests.
listener	ITestInvocationListener: ITestInvocationListener des résultats des tests

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 utilisé.

Paramètres
configuration	IConfiguration

Méthodes protégées

checkExitCode

protected  checkExitCode (Integer exitCode)

Vérifier le code de sortie renvoyé par une commande de test

Paramètres
exitCode	Integer: code de sortie renvoyé par la commande de test

Renvoie
	Message d'erreur facultatif, vide si le code de sortie du test indique une réussite

checkTestOutput

protected  checkTestOutput (TestInformation testInfo, 
                String actualOutputText, 
                String outputShortName, 
                String outputPrettyName)

Vérifier une sortie générée 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: sortie générée par le test
outputShortName	String: nom abrégé du canal de sortie
outputPrettyName	String: nom plus joli du canal de sortie, utilisé dans les messages d'erreur

Renvoie
	Message d'erreur facultatif, vide si la sortie vérifiée est valide

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

Créez un répertoire temporaire local dans le dossier de dépendances du test pour collecter les sorties de test extraites de l'appareil testé.

Paramètres
testInfo	TestInformation: objet TestInformation associé au test exécuté

Renvoie
File	Objet ERROR(/File) pointant vers le répertoire temporaire créé.

Génère
	Si la création du répertoire temporaire a échoué.

executeCheckerTest

protected  executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécutez un test du vérificateur et vérifiez sa sortie.

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

Paramètres
testInfo	TestInformation: objet TestInformation associé au test exécuté
listener	ITestInvocationListener: objet ITestInvocationListener associé au test exécuté

Renvoie
	Message d'erreur facultatif, vide si le test du vérificateur a réussi

Génère
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException

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

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

Recherchez le binaire du vérificateur (archive Python).

Paramètres
testInfo	TestInformation

Renvoie
File

runChecker

protected  runChecker (String[] checkerCommandLine)

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

Paramètres
checkerCommandLine	String: ligne de commande du vérificateur à exécuter

Renvoie
	Message d'erreur facultatif, vide si l'appel du vérificateur a réussi