ArtRunTest

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

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

---

Un runner di test per eseguire i run test ART.

Riepilogo

Classi nidificate
class	ArtRunTest.AdbShellCommandException Una classe di eccezione per segnalare un errore che si è verificato durante l'esecuzione di un comando ADB shell.

Campi
public static final String	CHECKER_PAR_FILENAME

Costruttori pubblici
ArtRunTest()

Metodi pubblici
void	addAllExcludeFilters( filters) Aggiunge il ERROR(/Set) dei filtri di cui escludere i test.
void	addAllIncludeFilters( filters) Aggiunge il ERROR(/Set) dei filtri di cui includere i test.
void	addExcludeFilter(String filter) Aggiunge un filtro dei test da escludere.
void	addIncludeFilter(String filter) Aggiunge un filtro dei test da includere.
void	clearExcludeFilters() Elimina tutti i filtri di esclusione attualmente monitorati.
void	clearIncludeFilters() Elimina tutti i filtri di inclusione attualmente monitorati.
IAbi	getAbi()
	getExcludeFilters() Restituisce l'attuale ERROR(/Set) dei filtri di esclusione.
	getIncludeFilters() Restituisce l'ERROR(/Set) corrente dei filtri di inclusione.
void	run(TestInformation testInfo, ITestInvocationListener listener) Esegue i test e segnala il risultato all'ascoltatore.
void	setAbi(IAbi abi)
void	setCollectTestsOnly(boolean shouldCollectTest) Attiva o disattiva la modalità di raccolta dei test
void	setConfiguration(IConfiguration configuration) Invia il IConfiguration in uso.

Metodi protetti
	checkExitCode(Integer exitCode) Controlla il codice di uscita restituito da un comando di test.
	checkTestOutput(TestInformation testInfo, String actualOutputText, String outputShortName, String outputPrettyName) Controlla l'output prodotto da un comando di test.
File	createTestLocalTempDirectory(TestInformation testInfo) Crea una directory temporanea locale all'interno della cartella delle dipendenze del test per raccogliere gli output del test estratti dal dispositivo in test.
	executeCheckerTest(TestInformation testInfo, ITestInvocationListener listener) Esegui un test di controllo e controlla l'output.
void	extractSourcesFromJar(File tmpCheckerLocalDir, File jar) Estrai la directory src dal file jar specificato nella directory specificata.
File	getCheckerBinaryPath(TestInformation testInfo) Trova il file binario di Checker (archivio Python).
	runChecker(String[] checkerCommandLine) Esegui un comando di controllo e controllane il risultato.

Campi

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

Costruttori pubblici

ArtRunTest

public ArtRunTest ()

Metodi pubblici

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Aggiunge ERROR(/Set) di filtri di cui test escludere.

Parametri
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Aggiunge il ERROR(/Set) dei filtri di cui includere i test.

Parametri
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Aggiunge un filtro per i test da escludere.

Parametri
filter	String

addIncludeFilter

public void addIncludeFilter (String filter)

Aggiunge un filtro per i test da includere.

Parametri
filter	String

clearExcludeFilters

public void clearExcludeFilters ()

Elimina tutti i filtri di esclusione attualmente monitorati.

clearIncludeFilters

public void clearIncludeFilters ()

Elimina tutti i filtri di inclusione attualmente monitorati.

getAbi

public IAbi getAbi ()

Ritorni
IAbi

getExcludeFilters

public  getExcludeFilters ()

Restituisce l'attuale ERROR(/Set) dei filtri di esclusione.

Ritorni

getIncludeFilters

public  getIncludeFilters ()

Restituisce il valore ERROR(/Set) corrente dei filtri di inclusione.

Ritorni

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Esegue i test e segnala il risultato all'ascoltatore.

Parametri
testInfo	TestInformation: l'oggetto TestInformation contenente informazioni utili per eseguire i test.
listener	ITestInvocationListener: il ITestInvocationListener dei risultati del test

Lanci
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parametri
abi	IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Attiva o disattiva la modalità di raccolta dei test

setConfiguration

public void setConfiguration (IConfiguration configuration)

Invia il IConfiguration in uso.

Parametri
configuration	IConfiguration

Metodi protetti

checkExitCode

protected  checkExitCode (Integer exitCode)

Controlla il codice di uscita restituito da un comando di test.

Parametri
exitCode	Integer: il codice di uscita restituito dal comando di test

Ritorni
	Un messaggio di errore facoltativo, vuoto se il codice di uscita del test ha indicato il successo

checkTestOutput

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

Controllare un output generato da un comando di test.

Utilizzato per controllare l'output standard e l'errore standard di un test.

Parametri
testInfo	TestInformation: l'oggetto TestInformation associato al test eseguito
actualOutputText	String: l'output prodotto dal test
outputShortName	String: il nome breve del canale di output
outputPrettyName	String: un nome più accattivante per il canale di output, utilizzato nei messaggi di errore

Ritorni
	Un messaggio di errore facoltativo, vuoto se l'output controllato è valido

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

Crea una directory temporanea locale all'interno della cartella delle dipendenze del test per raccogliere gli output del test estratti dal dispositivo in test.

Parametri
testInfo	TestInformation: l'oggetto TestInformation associato al test eseguito

Ritorni
File	L'oggetto ERROR(/File) che punta alla directory temporanea creata.

Lanci
	Se la creazione della directory temporanea non è riuscita.

executeCheckerTest

protected  executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

Esegui un test di Checker e controllane l'output.

I test di controllo sono test aggiuntivi inclusi in alcuni test di esecuzione di ART, scritti come annotazioni nei commenti dei file di origine di un test e utilizzati per verificare il compilatore di ART.

Parametri
testInfo	TestInformation: l'oggetto TestInformation associato al test eseguito
listener	ITestInvocationListener: l'oggetto ITestInvocationListener associato al test eseguito

Ritorni
	Un messaggio di errore facoltativo, vuoto se il test dello strumento di controllo è andato a buon fine

Lanci
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException

extractSourcesFromJar

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

Estrai la directory src dal file jar specificato nella directory specificata.

Parametri
tmpCheckerLocalDir	File
jar	File

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

Trova il file binario di Checker (archivio Python).

Parametri
testInfo	TestInformation

Ritorni
File

runChecker

protected  runChecker (String[] checkerCommandLine)

Esegui un comando di controllo e controllane il risultato.

Parametri
checkerCommandLine	String: la riga di comando di Checker da eseguire

Ritorni
	Un messaggio di errore facoltativo, vuoto se l'invocazione del controllore è andata a buon fine