GTestBase
public
abstract
class
GTestBase
extends Object
implements
IAbiReceiver,
IConfigurationReceiver,
IRemoteTest,
IRuntimeHintProvider,
IShardableTest,
ITestCollector,
ITestFilterReceiver
java.lang.Object | |
↳ | com.android.tradefed.testtype.GTestBase |
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(
Fügt |
void
|
addAllIncludeFilters(
Fügen Sie die |
void
|
addExcludeFilter(String filter)
Hier können Sie einen Filter hinzufügen, um Tests auszuschließen. |
void
|
addIncludeFilter(String filter)
Fügt einen Filter der einzuschließenden Tests hinzu. |
String
|
cleanFilter(String filter)
|
void
|
clearExcludeFilters()
Löschen Sie alle derzeit erfassten Ausschlussfilter. |
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 |
|
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 |
long
|
getMaxTestTimeMs()
Ruft die maximale Ausführungszeit für einen gtest ab. |
String
|
getModuleName()
Das native Android-Testmodul ausführen |
boolean
|
getRunDisabledTests()
Rufen Sie ab, 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()
Ruft die gtest-XML-Ausgabe für Testergebnisse ab oder nicht. |
boolean
|
isSharded()
Das Flag „isSharded“ wird abgerufen. |
void
|
notifyTestExecution(boolean incompleteTestFound,
Benachrichtigen Sie das übergeordnete Element über die Testausführung, damit Einschluss-/Ausschlussfilter für die Wiederholungsversuche ordnungsgemäß verarbeitet werden können. |
void
|
setAbi(IAbi abi)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
Aktiviert oder deaktiviert den Testerfassungsmodus |
void
|
setConfiguration(IConfiguration configuration)
Fügt den verwendeten |
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 |
Geschützte Methoden | |
---|---|
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(
|
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)
Versuchen Sie, eine aussagekräftige, kurze Beschreibung für die angegebene |
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
addAllAusschließenFilters
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)
Hiermit wird ein Filter für die Tests hinzugefügt, die ausgeschlossen werden sollen.
Parameter | |
---|---|
filter |
String |
addIncludeFilter
public void addIncludeFilter (String filter)
Fügt einen Filter der einzuschließenden Tests hinzu.
Parameter | |
---|---|
filter |
String |
cleanFilter
public String cleanFilter (String filter)
Parameter | |
---|---|
filter |
String |
Returns | |
---|---|
String |
ClearAusschließenFilters
public void clearExcludeFilters ()
Löschen Sie alle derzeit erfassten Ausschlüsse.
clearIncludeFilters
public void clearIncludeFilters ()
Löschen Sie alle derzeit erfassten Einschließen-Filter.
getAfterTestCmd
publicgetAfterTestCmd ()
Shell-Befehle abrufen, die nach GTest ausgeführt werden sollen.
Returns | |
---|---|
|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Shell-Befehle abrufen, die vor GTest ausgeführt werden sollen.
Returns | |
---|---|
|
getExcludeFilters
publicgetExcludeFilters ()
Gibt die aktuelle ERROR(/Set)
der Ausschlüsse zurück.
Returns | |
---|---|
|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Ermittelt den regulären Ausdruck, mit dem bestimmte Dateien von der Ausführung ausgeschlossen werden.
Returns | |
---|---|
|
getGTestFlags
publicgetGTestFlags ()
Ruft zusätzliche Flag-Werte ab, die an den Shell-Befehl des nativen Tests übergeben werden.
Returns | |
---|---|
|
getIncludeFilters
publicgetIncludeFilters ()
Gibt die aktuelle ERROR(/Set)
der Einschlussfilter zurück.
Returns | |
---|---|
|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
Ruft die maximale Dauer für die Ausführung eines gtest ab.
Returns | |
---|---|
long |
getModuleName
public String getModuleName ()
Laden Sie das native Android-Testmodul herunter.
Returns | |
---|---|
String |
Der Name des auszuführenden nativen Testmoduls oder „null“, wenn nicht festgelegt |
getRunDisabledTests
public boolean getRunDisabledTests ()
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 erwartete Laufzeit des Tests in Millisekunden zurück. Die Zeit wird für das Load-Balancing der fragmentierten 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 ()
Ruft das Flag "isSharded" ab.
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 |
|
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
publicsplit (int shardCountHint)
Alternative Version von split()
, die auch die Shard-Anzahl angibt, die ausgeführt werden soll. Das ist nützlich für einige Testläufer, die manchmal nicht willkürlich entscheiden können.
Parameter | |
---|---|
shardCountHint |
int : Anzahl der versuchten Shards. |
Returns | |
---|---|
|
Eine Sammlung von Subtests, die separat ausgeführt werden sollen, oder null , wenn der Test derzeit nicht fragmentierbar ist |
Geschützte Methoden
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 |
Den 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 nach Möglichkeit, eine aussagekräftige kurze Beschreibung für einen bestimmten 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ührungs-Flags |
Returns | |
---|---|
String |
die Shell-Befehlszeile, die für gtest ausgeführt werden soll |
getGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
Hilfsprogramm, mit dem abgeleitete Klassen den gtest-Befehl unter einem anderen Tool (chroot, strace, gdb usw.) zusammenfassen können.
Parameter | |
---|---|
fullPath |
String |
flags |
String |
Returns | |
---|---|
String |
getGTestFilters
protected String getGTestFilters (String path)
Hilfsfunktion zum Abrufen des g-test-Filters für die Ausführung des 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 Debugging-Informationen bereitstellt, wie z. B. das Erkennen und Melden doppelter Tests, wenn mDisabledDuplicateCheck "false" ist. Andernfalls wird der übergebene Listener zurückgegeben.
Parameter | |
---|---|
listeners |
ITestInvocationListener |
Returns | |
---|---|
ITestInvocationListener |
loadFilter
protected abstract String loadFilter (String path)
Definieren Sie die Methode zum Abrufen der Filter.
Die untergeordnete Klasse muss implementieren, wie der eigene Filter abgerufen wird.
Parameter | |
---|---|
path |
String : der vollständige Pfad der Filterdatei. |
Returns | |
---|---|
String |
Filterzeichenfolge. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
Legen Sie fest, ob GTest deaktivierte Tests ausführen soll.
Parameter | |
---|---|
runDisabled |
boolean |