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ügt |
void
|
addExcludeFilter(String filter)
Fügt einen Filter für die auszuschließenden Tests hinzu. |
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 Einschließen-Filter. |
IAbi
|
getAbi()
|
|
getAfterTestCmd()
Ruft Shell-Befehle ab, die nach GTest ausgeführt werden sollen. |
|
getBeforeTestCmd()
Ruft Shell-Befehle ab, die vor GTest ausgeführt werden sollen. |
|
getExcludeFilters()
Gibt die aktuellen |
|
getFileExclusionFilterRegex()
Ruft den regulären Ausdruck ab, um die Ausführung bestimmter Dateien auszuschließen. |
|
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 Dauer für die Ausführung eines gtest ab. |
String
|
getModuleName()
Laden Sie das native Android-Testmodul herunter. |
boolean
|
getRunDisabledTests()
Rufen Sie ab, ob GTest deaktivierte Tests ausführen soll. |
long
|
getRuntimeHint()
Erwartete Laufzeit des Tests zurückgeben in Millisekunden. |
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()
Gets rufen nur die Testbinärdatei auf, um die Liste der anwendbaren Testfälle zu erfassen oder nicht. |
boolean
|
isEnableXmlOutput()
Ruft die gtest-XML-Ausgabe für Testergebnisse ab oder nicht. |
boolean
|
isSharded()
Ruft das Flag "isSharded" ab. |
void
|
notifyTestExecution(boolean incompleteTestFound,
Benachrichtigen Sie das übergeordnete Element über die Testausführung, damit Einschluss-/Ausschlussfilter ordnungsgemäß verarbeitet werden können. für die Wiederholungsversuche. |
void
|
setAbi(IAbi abi)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
Aktiviert oder deaktiviert den Testerfassungsmodus |
void
|
setConfiguration(IConfiguration configuration)
Injiziertes |
void
|
setModuleName(String moduleName)
Ausführung des nativen Android-Testmoduls festlegen |
void
|
setShardCount(int shardCount)
Legt die Shard-Anzahl dieses Tests 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 Betriebssystem zu vermeiden die Beschränkung der Argumentgröße. |
void
|
erasePrependedFileName(
|
String
|
getAllGTestFlags(String path)
Hilfsprogramm zum Abrufen aller GTest-Flags, die an den ADB-Shell-Befehl übergeben werden. |
IConfiguration
|
getConfiguration()
Gibt die Testkonfiguration zurück. |
String
|
getExceptionMessage(Exception e)
Versuchen Sie nach Möglichkeit, eine aussagekräftige kurze Beschreibung für einen bestimmten
|
String
|
getGTestCmdLine(String fullPath, String flags)
Hilfsmethode zum Erstellen des auszuführenden gtest-Befehls. |
String
|
getGTestCmdLineWrapper(String fullPath, String flags)
Hilfsprogramm, das es abgeleiteten Klassen ermöglicht, den gtest-Befehl unter einem anderen Tool (chroot, strace, gdb und Ähnliches). |
String
|
getGTestFilters(String path)
Hilfsfunktion zum Abrufen des g-test-Filters für die Ausführung des Tests. |
ITestInvocationListener
|
getGTestListener(ITestInvocationListener listener)
Gibt den GTestListener zurück, der zusätzliche Debugging-Informationen wie Erkennung und meldet Testduplikate, wenn mDisabledDuplicateCheck "false" ist. |
abstract
String
|
loadFilter(String path)
Definieren Sie die Methode zum Abrufen der Filter. |
void
|
setRunDisabled(boolean runDisabled)
Legen Sie fest, ob GTest deaktivierte Tests ausführen soll. |
Felder
FILTER_ERWEITERUNG
protected static final String FILTER_EXTENSION
GTEST_FLAG_DATEI
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_DRUCKZEIT
protected static final String GTEST_FLAG_PRINT_TIME
GTEST_FLAG_RUN_DISABLED_TESTS
protected static final String GTEST_FLAG_RUN_DISABLED_TESTS
GTEST_XML_AUSGABE
protected static final String GTEST_XML_OUTPUT
Öffentliche Konstruktoren
GTestBase
public GTestBase ()
Ö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ügt ERROR(/Set)
der Filter hinzu, von denen Tests eingeschlossen werden sollen.
Parameter | |
---|---|
filters |
|
addAusschließenFilter
public void addExcludeFilter (String filter)
Fügt einen Filter für die auszuschließenden Tests hinzu.
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 Ausschlussfilter.
ClearIncludeFilters
public void clearIncludeFilters ()
Löschen Sie alle derzeit erfassten Einschließen-Filter.
getAfterTestCmd
publicgetAfterTestCmd ()
Ruft Shell-Befehle ab, die nach GTest ausgeführt werden sollen.
Returns | |
---|---|
|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Ruft Shell-Befehle ab, die vor GTest ausgeführt werden sollen.
Returns | |
---|---|
|
getAusschließenFilters
publicgetExcludeFilters ()
Gibt die aktuellen ERROR(/Set)
der Ausschlussfilter zurück.
Returns | |
---|---|
|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Ruft den regulären Ausdruck ab, um die Ausführung bestimmter Dateien auszuschließen.
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 "Einschließen"-Filter 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 |
Name des auszuführenden nativen Testmoduls oder null, wenn nicht festgelegt |
getRunDisabledTests
public boolean getRunDisabledTests ()
Rufen Sie ab, ob GTest deaktivierte Tests ausführen soll.
Returns | |
---|---|
boolean |
„True“, wenn deaktivierte Tests ausgeführt werden sollen, andernfalls „False“ |
getRuntimeHint
public long getRuntimeHint ()
Erwartete Laufzeit des Tests zurückgeben in Millisekunden. 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 ()
Gets rufen nur die Testbinärdatei auf, um die Liste der anwendbaren Testfälle zu erfassen oder nicht.
Returns | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
Ruft die gtest-XML-Ausgabe für Testergebnisse ab oder nicht.
Returns | |
---|---|
boolean |
isSharded (IsSharded)
public boolean isSharded ()
Ruft das Flag "isSharded" ab.
Returns | |
---|---|
boolean |
benachrichtigungTestExecution
public void notifyTestExecution (boolean incompleteTestFound,failedTests)
Benachrichtigen Sie das übergeordnete Element über die Testausführung, damit Einschluss-/Ausschlussfilter ordnungsgemäß verarbeitet werden können. für die Wiederholungsversuche.
Parameter | |
---|---|
incompleteTestFound |
boolean |
failedTests |
|
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Aktiviert oder deaktiviert den Testerfassungsmodus
setConfiguration
public void setConfiguration (IConfiguration configuration)
Injiziertes IConfiguration
in Gebrauch.
Parameter | |
---|---|
configuration |
IConfiguration |
SetModuleName
public void setModuleName (String moduleName)
Ausführung des nativen Android-Testmoduls festlegen
Parameter | |
---|---|
moduleName |
String : der Name des auszuführenden nativen Testmoduls |
SetShardCount (setShardCount)
public void setShardCount (int shardCount)
Legt die Shard-Anzahl dieses Tests 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 den versuchten shardCount bereitstellt
ausgeführt werden soll. Dies ist für einige Testläufer nützlich, die manchmal nicht beliebig entscheiden können.
Parameter | |
---|---|
shardCountHint |
int : Anzahl der versuchten Shards. |
Returns | |
---|---|
|
eine Sammlung von Teiltests, die separat durchgeführt werden müssen, oder null , wenn der Test
Derzeit nicht fragmentierbar |
Geschützte Methoden
createFlagFile
protected String createFlagFile (String filter)
Erstellen Sie eine Datei mit den Filtern, die über --gtest_flagfile verwendet werden, um Betriebssystem zu vermeiden die Beschränkung der Argumentgröße.
Parameter | |
---|---|
filter |
String : der Filterstring |
Returns | |
---|---|
String |
Der Pfad zur Datei mit dem Filter. |
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
deletePrependedFileName
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.
Parameter | |
---|---|
path |
String : der vollständige Pfad des Binärprogramms 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 |
eine IConfiguration |
getExceptionMessage
protected String getExceptionMessage (Exception e)
Versuchen Sie nach Möglichkeit, eine aussagekräftige kurze, beschreibende Nachricht für eine bestimmte
Exception
Parameter | |
---|---|
e |
Exception : die Exception |
Returns | |
---|---|
String |
eine kurze Nachricht |
getGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
Hilfsmethode zum Erstellen des auszuführenden gtest-Befehls.
Parameter | |
---|---|
fullPath |
String : absoluter Dateisystempfad zur gtest-Binärdatei auf dem Gerät |
flags |
String : gtest-Ausführungs-Flags |
Returns | |
---|---|
String |
Shell-Befehlszeile für die Ausführung von gtest |
getGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
Hilfsprogramm, mit dem abgeleitete Klassen den gtest-Befehl unter einem anderen Tool (chroot, strace, gdb und Ähnliches).
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.
Beachten Sie, dass die Filter nur nach dem Funktionsnamen filtern (z. B. Google Test "Test"). alle Google Testläufe testen berücksichtigt werden.
Parameter | |
---|---|
path |
String : der vollständige Pfad des Binärprogramms auf dem Gerät. |
Returns | |
---|---|
String |
das vollständige Filter-Flag, das an den g-test übergeben wird, oder einen leeren String, wenn keine angegeben |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
Gibt den GTestListener zurück, der zusätzliche Debugging-Informationen wie Erkennung und meldet Testduplikate, wenn mDisabledDuplicateCheck "false" ist. Andernfalls wird die übergebene Listener.
Parameter | |
---|---|
listener |
ITestInvocationListener |
Returns | |
---|---|
ITestInvocationListener |
Filter laden
protected abstract String loadFilter (String path)
Definieren Sie die Methode zum Abrufen der Filter.
Die Unterklasse muss implementieren, wie ihr eigener 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 |