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(Set<String> filters)

Fügt die Set der Filter hinzu, anhand derer Tests ausgeschlossen werden sollen.

void addAllIncludeFilters(Set<String> filters)

Fügt die 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()

Alle derzeit erfassten Ausschlussfilter löschen.

void clearIncludeFilters()

Löschen Sie alle derzeit erfassten Einschlussfilter.

IAbi getAbi()
Set<String> getExcludeFilters()

Gibt die aktuelle Set der Ausschlussfilter zurück.

Set<String> getIncludeFilters()

Gibt die aktuelle 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

Optional<String> checkExitCode(Integer exitCode)

Exit-Code eines Testbefehls prüfen

Optional<String> 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 Ordner mit den Testabhängigkeiten, um Testausgaben zu erfassen, die vom zu testenden Gerät abgerufen werden.

Optional<String> 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).

Optional<String> 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 (Set<String> filters)

Fügt die Set der Filter hinzu, anhand derer Tests ausgeschlossen werden sollen.

Parameter
filters Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

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

Parameter
filters Set

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

Alle derzeit erfassten Ausschlussfilter löschen.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

getAbi

public IAbi getAbi ()

Gibt Folgendes zurück:
IAbi

getExcludeFilters

public Set<String> getExcludeFilters ()

Gibt die aktuelle Set der Ausschlussfilter zurück.

Gibt Folgendes zurück:
Set<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

Gibt die aktuelle Set der Einschlussfilter zurück.

Gibt Folgendes zurück:
Set<String>

run

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
Löst aus
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 Optional<String> checkExitCode (Integer exitCode)

Exit-Code eines Testbefehls prüfen

Parameter
exitCode Integer: Der vom Testbefehl zurückgegebene Exit-Code
Gibt Folgendes zurück:
Optional<String> Eine optionale Fehlermeldung, die leer ist, wenn der Test-Exit-Code auf Erfolg hinweist

checkTestOutput

protected Optional<String> 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.
Gibt Folgendes zurück:
Optional<String> 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.
Gibt Folgendes zurück:
File Das File-Objekt, das auf das erstellte temporäre Verzeichnis verweist.
Löst aus
IOException Wenn das temporäre Verzeichnis nicht erstellt werden konnte.

executeCheckerTest

protected Optional<String> 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.
Gibt Folgendes zurück:
Optional<String> Eine optionale Fehlermeldung, die leer ist, wenn der Checker-Test erfolgreich war
Löst aus
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException
IOException

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

Löst aus
IOException

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

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

Parameter
testInfo TestInformation

Gibt Folgendes zurück:
File

runChecker

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

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

Parameter
checkerCommandLine String: Die auszuführende Checker-Befehlszeile
Gibt Folgendes zurück:
Optional<String> Eine optionale Fehlermeldung, leer, wenn der Checker-Aufruf erfolgreich war