GTestBase

public abstract class GTestBase
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

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

Bekannte direkte Unterklassen GTest, HostGTest GTest Ein Test, bei dem ein natives Testpaket auf einem bestimmten Gerät ausgeführt wird.  HostGTest Ein Test, bei dem ein natives Testpaket ausgeführt wird.

Bekannte indirekte Unterklassen ArtGTest ArtGTest

---

Die Basisklasse von gTest

Zusammenfassung

Felder
protected static final String	FILTER_EXTENSION
protected static final String	GTEST_FLAG_FILE
protected static final String	GTEST_FLAG_FILTER
protected static final String	GTEST_FLAG_LIST_TESTS
protected static final String	GTEST_FLAG_PRINT_TIME
protected static final String	GTEST_FLAG_RUN_DISABLED_TESTS
protected static final String	GTEST_XML_OUTPUT

Öffentliche Konstruktoren
GTestBase()

Öffentliche Methoden
void	addAllExcludeFilters( filters) Fügen Sie die ERROR(/Set) der Filter hinzu, deren Tests ausgeschlossen werden sollen.
void	addAllIncludeFilters( filters) Fügen Sie die ERROR(/Set) der Filter hinzu, deren Tests eingeschlossen werden sollen.
void	addExcludeFilter(String filter) Hiermit wird ein Filter für die Tests hinzugefügt, die ausgeschlossen werden sollen.
void	addIncludeFilter(String filter) Hier können Sie festlegen, welche Tests eingeschlossen werden sollen.
String	cleanFilter(String filter)
void	clearExcludeFilters() Löschen Sie alle derzeit erfassten Ausschlüsse.
void	clearIncludeFilters() Löschen Sie alle derzeit erfassten Einschlussfilter.
IAbi	getAbi()
	getAfterTestCmd() Shell-Befehle abrufen, die nach GTest ausgeführt werden sollen
	getBeforeTestCmd() Shell-Befehle abrufen, die vor GTest ausgeführt werden sollen
	getExcludeFilters() Gibt die aktuelle ERROR(/Set) der Ausschlüsse zurück.
	getFileExclusionFilterRegex() Ermittelt den regulären Ausdruck, mit dem bestimmte Dateien von der Ausführung ausgeschlossen werden.
	getGTestFlags() Ruft zusätzliche Flag-Werte ab, die an den Shell-Befehl des nativen Tests übergeben werden.
	getIncludeFilters() Gibt die aktuelle ERROR(/Set) der Einschlussfilter zurück.
long	getMaxTestTimeMs() Ruft die maximale Ausführungszeit für einen gtest ab.
String	getModuleName() Das native Android-Testmodul ausführen
boolean	getRunDisabledTests() Prüfen, ob GTest deaktivierte Tests ausführen soll
long	getRuntimeHint() Gibt die voraussichtliche Laufzeit des Tests in Millisekunden zurück.
int	getShardCount() Gibt die aktuelle Shard-Anzahl zurück.
int	getShardIndex() Ruft den Shard-Index dieses Tests ab.
String	getTestFilterKey() Ruft den Testfilterschlüssel ab.
String	getTestModule() Ruft den Modulnamen ab.
boolean	isCollectTestsOnly() Wird die Test-Binärdatei nur aufgerufen, um eine Liste der anwendbaren Testfälle zu erfassen?
boolean	isEnableXmlOutput() Gibt an, ob die gtest-XML-Ausgabe für Testergebnisse verwendet werden soll oder nicht.
boolean	isSharded() Das Flag „isSharded“ wird abgerufen.
void	notifyTestExecution(boolean incompleteTestFound, failedTests) Benachrichtigen Sie das übergeordnete Element über die Testausführung, damit Einschluss-/Ausschlussfilter für die Wiederholungsversuche richtig verarbeitet werden können.
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.
void	setModuleName(String moduleName) Legen Sie fest, dass das native Android-Testmodul ausgeführt werden soll.
void	setShardCount(int shardCount) Legt die Shard-Anzahl für diesen Test fest.
void	setShardIndex(int shardIndex) Legt den Shard-Index dieses Tests fest.
	split(int shardCountHint) Alternative Version von split(), die auch die Shard-Anzahl angibt, die ausgeführt werden soll.

Geschützte Methoden
String	convertName(String gtestFlagName)
String	createFlagFile(String filter) Erstellen Sie eine Datei mit den Filtern, die über „--gtest_flagfile“ verwendet werden, um Betriebssystemeinschränkungen bei der Größe von Argumenten zu vermeiden.
void	erasePrependedFileName( filters, String filename)
String	getAllGTestFlags(String path) Hilfsprogramm zum Abrufen aller GTest-Flags, die an den adb-Shell-Befehl übergeben werden sollen.
IConfiguration	getConfiguration() Gibt die Testkonfiguration zurück.
String	getExceptionMessage(Exception e) Versuche, eine aussagekräftige, kurze Beschreibung für die angegebene Exception abzurufen.
String	getGTestCmdLine(String fullPath, String flags) Hilfsmethode zum Erstellen des ausführbaren gtest-Befehls.
String	getGTestCmdLineWrapper(String fullPath, String flags) Helfer, mit dem abgeleitete Klassen den gtest-Befehl in einem anderen Tool (z. B. chroot, strace oder gdb) einschließen können.
String	getGTestFilters(String path) Hilfsfunktion zum Abrufen des G‑Test-Filters des zu ausführenden Tests.
ITestInvocationListener	getGTestListener(ITestInvocationListener... listeners) Gibt den GTestListener zurück, der zusätzliche Informationen zur Fehlerbehebung liefert, z. B. erkennt und meldet doppelte Tests, wenn mDisabledDuplicateCheck falsch ist.
abstract String	loadFilter(String path) Filtermethode „get“ definieren
void	setRunDisabled(boolean runDisabled) Legen Sie fest, ob GTest deaktivierte Tests ausführen soll.

Felder

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Öffentliche Konstruktoren

GTestBase

public GTestBase ()

Öffentliche Methoden

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Fügen Sie die ERROR(/Set) der Filter hinzu, deren 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

cleanFilter

public String cleanFilter (String filter)

Parameter
filter	String

Returns
String

clearExcludeFilters

public void clearExcludeFilters ()

Löschen Sie alle derzeit erfassten Ausschlüsse.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

getAbi

public IAbi getAbi ()

Returns
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

Shell-Befehle abrufen, die nach GTest ausgeführt werden sollen

Returns

getBeforeTestCmd

public  getBeforeTestCmd ()

Shell-Befehle abrufen, die vor GTest ausgeführt werden sollen.

Returns

getExcludeFilters

public  getExcludeFilters ()

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

Returns

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Ermittelt den regulären Ausdruck, mit dem bestimmte Dateien von der Ausführung ausgeschlossen werden.

Returns

getGTestFlags

public  getGTestFlags ()

Ruft zusätzliche Flag-Werte ab, die an den Shell-Befehl des nativen Tests übergeben werden.

Returns

getIncludeFilters

public  getIncludeFilters ()

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

Returns

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Ruft die maximale Ausführungszeit für einen gtest ab.

Returns
long

getModuleName

public String getModuleName ()

Das native Android-Testmodul ausführen

Returns
String	Der Name des auszuführenden nativen Testmoduls oder „null“, wenn nicht festgelegt

getRunDisabledTests

public boolean getRunDisabledTests ()

Prüfen, ob GTest deaktivierte Tests ausführen soll

Returns
boolean	„True“, wenn deaktivierte Tests ausgeführt werden sollen, andernfalls „false“

getRuntimeHint

public long getRuntimeHint ()

Gibt die voraussichtliche Laufzeit des Tests in Millisekunden zurück. Die Zeit wird für das Load Balancing der ge shardeten Ausführung verwendet.

Returns
long

getShardCount

public int getShardCount ()

Gibt die aktuelle Shard-Anzahl zurück.

Returns
int

getShardIndex

public int getShardIndex ()

Ruft den Shard-Index dieses Tests ab.

Returns
int

getTestFilterKey

public String getTestFilterKey ()

Ruft den Testfilterschlüssel ab.

Returns
String

getTestModule

public String getTestModule ()

Ruft den Modulnamen ab.

Returns
String

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Wird die Test-Binärdatei nur aufgerufen, um eine Liste der anwendbaren Testfälle zu erfassen?

Returns
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Gibt an, ob die gtest-XML-Ausgabe für Testergebnisse verwendet werden soll oder nicht.

Returns
boolean

isSharded

public boolean isSharded ()

Das Flag „isSharded“ wird abgerufen.

Returns
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Benachrichtigen Sie das übergeordnete Element über die Testausführung, damit Einschluss-/Ausschlussfilter für die Wiederholungsversuche richtig verarbeitet werden können.

Parameter
incompleteTestFound	boolean
failedTests

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

setModuleName

public void setModuleName (String moduleName)

Legen Sie fest, dass das native Android-Testmodul ausgeführt werden soll.

Parameter
moduleName	String: Der Name des auszuführenden nativen Testmoduls

setShardCount

public void setShardCount (int shardCount)

Legt die Shard-Anzahl für diesen Test fest.

Parameter
shardCount	int

setShardIndex

public void setShardIndex (int shardIndex)

Legt den Shard-Index dieses Tests fest.

Parameter
shardIndex	int

aufteilen

public  split (int shardCountHint)

Alternative Version von split(), die auch die Shard-Anzahl angibt, die ausgeführt werden soll. Dies ist nützlich für einige Testläufer, die manchmal nicht willkürlich entscheiden können.

Parameter
shardCountHint	int: die Anzahl der Shards, die versucht wurden.

Returns
	eine Sammlung von Teiltests, die separat ausgeführt werden sollen, oder null, wenn der Test derzeit nicht geShardet werden kann

Geschützte Methoden

convertName

protected String convertName (String gtestFlagName)

Parameter
gtestFlagName	String

Returns
String

createFlagFile

protected String createFlagFile (String filter)

Erstellen Sie eine Datei mit den Filtern, die über „--gtest_flagfile“ verwendet werden, um Betriebssystemeinschränkungen bei der Größe von Argumenten zu vermeiden.

Parameter
filter	String: Der Filterstring

Returns
String	Der Pfad zur Datei, die den Filter enthält.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parameter
filters
filename	String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Hilfsprogramm zum Abrufen aller GTest-Flags, die an den adb-Shell-Befehl übergeben werden sollen.

Parameter
path	String: der vollständige Pfad der Binärdatei auf dem Gerät.

Returns
String	die String aller GTest-Flags, die an GTest übergeben werden sollen

Ausgabe
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

Gibt die Testkonfiguration zurück.

Returns
IConfiguration	IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Versuchen Sie, eine aussagekräftige, kurze Beschreibung für die angegebene Exception abzurufen.

Parameter
e	Exception: die Exception

Returns
String	eine kurze Nachricht

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Hilfsmethode zum Erstellen des ausführbaren gtest-Befehls.

Parameter
fullPath	String: absoluter Dateisystempfad zur gtest-Binärdatei auf dem Gerät
flags	String: gtest-Ausführungsflags

Returns
String	die Shell-Befehlszeile, die für gtest ausgeführt werden soll

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Helfer, mit dem abgeleitete Klassen den gtest-Befehl in einem anderen Tool (z. B. chroot, strace oder gdb) einschließen können.

Parameter
fullPath	String
flags	String

Returns
String

getGTestFilters

protected String getGTestFilters (String path)

Hilfsfunktion zum Abrufen des G‑Test-Filters des zu ausführenden Tests.

Hinweis: Filter werden nur nach dem Funktionsnamen gefiltert (z. B. Google Test „Test“). Alle Google Test-Testfälle werden berücksichtigt.

Parameter
path	String: der vollständige Pfad der Binärdatei auf dem Gerät.

Returns
String	Das vollständige Filterflag, das an den G‑Test übergeben werden soll, oder ein leerer String, wenn kein Flag angegeben wurde

Ausgabe
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Gibt den GTestListener zurück, der zusätzliche Informationen zur Fehlerbehebung liefert, z. B. erkennt und meldet doppelte Tests, wenn mDisabledDuplicateCheck falsch ist. Andernfalls wird der übergebene Listener zurückgegeben.

Parameter
listeners	ITestInvocationListener

Returns
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

Filtermethode „get“ definieren

Die Unterklasse muss implementieren, wie der eigene Filter abgerufen wird.

Parameter
path	String: der vollständige Pfad zur Filterdatei.

Returns
String	Filterstring.

Ausgabe
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Legen Sie fest, ob GTest deaktivierte Tests ausführen soll.

Parameter
runDisabled	boolean