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