ArtRun-Test

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, um einen Fehler zu melden, der bei der Ausführung eines ADB-Shell-Befehls aufgetreten ist. 

Felder

public static final String CHECKER_PAR_FILENAME

Öffentliche Konstruktoren

ArtRunTest()

Öffentliche Methoden

void addAllExcludeFilters( filters)

Fügen Sie die ERROR(/Set) der Filter hinzu, deren Tests ausgeschlossen werden sollen.

void addAllIncludeFilters( filters)

Fügt ERROR(/Set) der Filter hinzu, von denen Tests eingeschlossen werden sollen.

void addExcludeFilter(String filter)

Hier können Sie einen Filter hinzufügen, um Tests auszuschließen.

void addIncludeFilter(String filter)

Hier können Sie festlegen, welche Tests eingeschlossen werden sollen.

void clearExcludeFilters()

Löschen Sie alle derzeit erfassten Ausschlüsse.

void clearIncludeFilters()

Löschen Sie alle derzeit erfassten Einschlussfilter.

IAbi getAbi()
getExcludeFilters()

Gibt die aktuelle ERROR(/Set) der Ausschlüsse 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 Modus für die Testerhebung

void setConfiguration(IConfiguration configuration)

Fügt den verwendeten IConfiguration ein.

Geschützte Methoden

checkExitCode(Integer exitCode)

Prüfen Sie den vom Testbefehl zurückgegebenen Beendigungscode.

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

Ausgabe eines Testbefehls prüfen

File createTestLocalTempDirectory(TestInformation testInfo)

Erstellen Sie im Abhängigkeitsordner des Tests ein lokales temporäres Verzeichnis, um Testergebnisse zu erfassen, die vom Testgerä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)

Extrahiert das Verzeichnis „src“ 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.

Felder

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

Öffentliche Konstruktoren

ArtRunTest

public ArtRunTest ()

Öffentliche Methoden

addAllAusschließenFilters

public void addAllExcludeFilters ( filters)

Fügt ERROR(/Set) von Filtern hinzu, von denen Tests ausgeschlossen werden sollen.

Parameter
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Fügen Sie die ERROR(/Set) der Filter hinzu, deren Tests eingeschlossen werden sollen.

Parameter
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Hier können Sie einen Filter hinzufügen, um Tests auszuschließen.

Parameter
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

Hier können Sie festlegen, welche Tests eingeschlossen 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 Ausschlüsse zurück.

Returns

getIncludeFilters

public  getIncludeFilters ()

Gibt die aktuelle ERROR(/Set) der "Einschließen"-Filter 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 Modus für die Testerhebung

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt den verwendeten IConfiguration ein.

Parameter
configuration IConfiguration

Geschützte Methoden

checkExitCode

protected  checkExitCode (Integer exitCode)

Prüfen Sie den vom Testbefehl zurückgegebenen Beendigungscode.

Parameter
exitCode Integer: Der vom Testbefehl zurückgegebene Exit-Code
Returns
Eine optionale Fehlermeldung, die leer ist, wenn der Test-Exit-Code erfolgreich war

checkTestOutput

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

Prüfen Sie eine Ausgabe, die von einem Testbefehl erzeugt wurde.

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

Parameter
testInfo TestInformation: Das TestInformation-Objekt, das mit dem ausgeführten Test verknüpft ist
actualOutputText String: Die vom Test generierte Ausgabe
outputShortName String: Der Kurzname des Ausgabekanals
outputPrettyName String: Ein prägnanterer Name für den Ausgabekanal, der in Fehlermeldungen verwendet wird
Returns
Optionale Fehlermeldung, leer, wenn die geprüfte Ausgabe gültig ist

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

Erstellen Sie im Ordner „Dependencies“ des Tests ein lokales temporäres Verzeichnis, um Testergebnisse zu erfassen, die vom Testgerät abgerufen werden.

Parameter
testInfo TestInformation: Das TestInformation-Objekt, das mit dem ausgeführten Test verknüpft ist
Returns
File Das ERROR(/File)-Objekt, das auf das erstellte temporäre Verzeichnis verweist.
Ausgabe
Wenn das Erstellen des temporären Verzeichnisses fehlgeschlagen ist.

Ausführen-Checker-Test

protected  executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

Führen Sie einen Checker-Test aus und prüfen Sie seine 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 zum Überprüfen des ART-Compilers.

Parameter
testInfo TestInformation: Das TestInformation-Objekt, das mit dem ausgeführten Test verknüpft ist
listener ITestInvocationListener: Das ITestInvocationListener-Objekt, das mit dem ausgeführten Test verknüpft ist
Returns
Optionale Fehlermeldung, leer, wenn der Checker-Test erfolgreich war
Ausgabe
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException

extractSourcesFromJar

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

Extrahiert das Verzeichnis „src“ 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 Befehlszeilenoption für den Checker
Returns
Optionale Fehlermeldung, leer, wenn die Aufrufe des Checkers erfolgreich waren