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( filters)

Fügt ERROR(/Set) von Filtern hinzu, von denen 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)

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 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 "Einschließen"-Filter zurück.

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, failedTests)

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 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 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)

Versuchen Sie, 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

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.

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 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

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. 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