ArtRunTest

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

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


Ein Test-Runner zum Ausführen von ART-Lauftests.

Zusammenfassung

Verschachtelte Klassen

class ArtRunTest.AdbShellCommandException

Eine Ausnahmeklasse zum Melden eines Fehlers, der bei der Ausführung eines ADB-Shell-Befehls aufgetreten ist. 

Konstanten

String CHECKER_PAR_FILENAME

Felder

public static final Boolean RUN_CHECKER

Öffentliche Konstruktoren

ArtRunTest()

Öffentliche Methoden

void addAllExcludeFilters( filters)

Fügt die ERROR(/Set) der Filter hinzu, für die Tests ausgeschlossen werden sollen.

void addAllIncludeFilters( filters)

Fügt die ERROR(/Set) der Filter hinzu, für die Tests einbezogen werden sollen.

void addExcludeFilter(String filter)

Fügt einen Filter hinzu, mit dem festgelegt wird, welche Tests ausgeschlossen werden sollen.

void addIncludeFilter(String filter)

Fügt einen Filter hinzu, der angibt, welche Tests einbezogen werden sollen.

void clearExcludeFilters()

Löschen Sie alle derzeit erfassten Ausschlussfilter.

void clearIncludeFilters()

Löschen Sie alle derzeit erfassten Einschlussfilter.

IAbi getAbi()
getExcludeFilters()

Gibt die aktuelle ERROR(/Set) der Ausschlussfilter zurück.

getIncludeFilters()

Gibt die aktuelle ERROR(/Set) der Einschlussfilter zurück.

void run(TestInformation testInfo, ITestInvocationListener listener)

Führt die Tests aus und meldet das Ergebnis an den Listener.

void setAbi(IAbi abi)

void setCollectTestsOnly(boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testsammlungsmodus

void setConfiguration(IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

Geschützte Methoden

checkExitCode(Integer exitCode)

Exit-Code eines Testbefehls prüfen

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

Ausgabe eines Testbefehls prüfen

File createTestLocalTempDirectory(TestInformation testInfo)

Erstellen Sie ein lokales temporäres Verzeichnis im Abhängigkeitsordner des Tests, um Testausgaben zu erfassen, die vom zu testenden Gerät abgerufen werden.

executeCheckerTest(TestInformation testInfo, ITestInvocationListener listener)

Führen Sie einen Checker-Test aus und prüfen Sie die Ausgabe.

void extractSourcesFromJar(File tmpCheckerLocalDir, File jar)

Extrahieren Sie das Quellverzeichnis aus der angegebenen JAR-Datei in das angegebene Verzeichnis.

File getCheckerBinaryPath(TestInformation testInfo)

Suchen Sie die Checker-Binärdatei (Python-Archiv).

runChecker(String[] checkerCommandLine)

Führen Sie einen Checker-Befehl aus und prüfen Sie das Ergebnis.

Konstanten

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

Konstanter Wert: "art-run-test-checker"

Felder

RUN_CHECKER

public static final Boolean RUN_CHECKER

Öffentliche Konstruktoren

ArtRunTest

public ArtRunTest ()

Öffentliche Methoden

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Fügt die ERROR(/Set) der Filter hinzu, für die Tests ausgeschlossen werden sollen.

Parameter
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Fügt die ERROR(/Set) der Filter hinzu, für die Tests einbezogen werden sollen.

Parameter
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Fügt einen Filter hinzu, mit dem festgelegt wird, welche Tests ausgeschlossen werden sollen.

Parameter
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

Fügt einen Filter hinzu, der angibt, welche Tests einbezogen werden sollen.

Parameter
filter String

clearExcludeFilters

public void clearExcludeFilters ()

Löschen Sie alle derzeit erfassten Ausschlussfilter.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

getAbi

public IAbi getAbi ()

Returns
IAbi

getExcludeFilters

public  getExcludeFilters ()

Gibt die aktuelle ERROR(/Set) der Ausschlussfilter zurück.

Returns

getIncludeFilters

public  getIncludeFilters ()

Gibt die aktuelle ERROR(/Set) der Einschlussfilter zurück.

Returns

Homerun

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Führt die Tests aus und meldet das Ergebnis an den Listener.

Parameter
testInfo TestInformation: Das TestInformation-Objekt mit nützlichen Informationen zum Ausführen von Tests.

listener ITestInvocationListener: die ITestInvocationListener der Testergebnisse

Ausgabe
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parameter
abi IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testsammlungsmodus

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

Parameter
configuration IConfiguration

Geschützte Methoden

checkExitCode

protected  checkExitCode (Integer exitCode)

Prüfen Sie den Exit-Code, der von einem Testbefehl zurückgegeben wird.

Parameter
exitCode Integer: Der vom Testbefehl zurückgegebene Exit-Code

Returns
Eine optionale Fehlermeldung, die leer ist, wenn der Test-Exit-Code auf Erfolg hinweist

checkTestOutput

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

Ausgabe eines Testbefehls prüfen

Wird verwendet, um die Standardausgabe und den Standardfehler eines Tests zu prüfen.

Parameter
testInfo TestInformation: Das TestInformation-Objekt, das dem ausgeführten Test zugeordnet ist.

actualOutputText String: Die vom Test erstellte Ausgabe

outputShortName String: Der Kurzname des Ausgabekanals

outputPrettyName String: Ein besser lesbarer Name für den Ausgabekanal, der in Fehlermeldungen verwendet wird

Returns
Eine optionale Fehlermeldung, die leer ist, wenn die geprüfte Ausgabe gültig ist

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

Erstellen Sie ein lokales temporäres Verzeichnis im Abhängigkeitsordner des Tests, um Testausgaben zu erfassen, die vom zu testenden Gerät abgerufen werden.

Parameter
testInfo TestInformation: Das TestInformation-Objekt, das dem ausgeführten Test zugeordnet ist.

Returns
File Das ERROR(/File)-Objekt, das auf das erstellte temporäre Verzeichnis verweist.

Ausgabe
Wenn das temporäre Verzeichnis nicht erstellt werden konnte.

executeCheckerTest

protected  executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

Führen Sie einen Checker-Test aus und prüfen Sie die Ausgabe.

Checker-Tests sind zusätzliche Tests, die in einigen ART-Lauftests enthalten sind. Sie werden als Anmerkungen in den Kommentaren der Quelldateien eines Tests geschrieben und dienen zur Überprüfung des ART-Compilers.

Parameter
testInfo TestInformation: Das TestInformation-Objekt, das dem ausgeführten Test zugeordnet ist.

listener ITestInvocationListener: Das ITestInvocationListener-Objekt, das dem ausgeführten Test zugeordnet ist.

Returns
Eine optionale Fehlermeldung, die leer ist, wenn der Checker-Test erfolgreich war

Ausgabe
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException

extractSourcesFromJar

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

Extrahieren Sie das Quellverzeichnis aus der angegebenen JAR-Datei in das angegebene Verzeichnis.

Parameter
tmpCheckerLocalDir File

jar File

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

Suchen Sie die Checker-Binärdatei (Python-Archiv).

Parameter
testInfo TestInformation

Returns
File

runChecker

protected  runChecker (String[] checkerCommandLine)

Führen Sie einen Checker-Befehl aus und prüfen Sie das Ergebnis.

Parameter
checkerCommandLine String: Die auszuführende Checker-Befehlszeile

Returns
Eine optionale Fehlermeldung, leer, wenn der Checker-Aufruf erfolgreich war