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

Konstanten

String FILTER_EXTENSION

String GTEST_FLAG_FILE

String GTEST_FLAG_FILTER

String GTEST_FLAG_LIST_TESTS

String GTEST_FLAG_PRINT_TIME

String GTEST_FLAG_RUN_DISABLED_TESTS

String GTEST_XML_OUTPUT

Öffentliche Konstruktoren

GTestBase()

Öffentliche Methoden

void addAllExcludeFilters(Set<String> filters)

Fügt die Set der Filter hinzu, anhand derer Tests ausgeschlossen werden sollen.

void addAllIncludeFilters(Set<String> filters)

Fügt die Set der Filter hinzu, für die Tests einbezogen werden sollen.

void addExcludeFilter(String filter)

Fügt einen Filter hinzu, mit dem festgelegt wird, welche Tests ausgeschlossen werden sollen.

void addIncludeFilter(String filter)

Fügt einen Filter hinzu, der angibt, welche Tests einbezogen werden sollen.

String cleanFilter(String filter)
void clearExcludeFilters()

Alle derzeit erfassten Ausschlussfilter löschen.

void clearIncludeFilters()

Löschen Sie alle derzeit erfassten Einschlussfilter.

IAbi getAbi()
List<String> getAfterTestCmd()

Ruft Shell-Befehle ab, die nach GTest ausgeführt werden sollen.

List<String> getBeforeTestCmd()

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

Set<String> getExcludeFilters()

Gibt die aktuelle Set der Ausschlussfilter zurück.

Set<String> getFileExclusionFilterRegex()

Ruft den regulären Ausdruck ab, um bestimmte Dateien von der Ausführung auszuschließen.

List<String> getGTestFlags()

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

Set<String> getIncludeFilters()

Gibt die aktuelle Set der Einschlussfilter zurück.

long getMaxTestTimeMs()

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

String getModuleName()

Android-Testmodul zum Ausführen abrufen

boolean getRunDisabledTests()

Gibt an, ob GTest deaktivierte Tests ausführen soll.

long getRuntimeHint()

Gibt die erwartete Laufzeit des Tests in Millisekunden zurück.

int getShardCount()

Gibt die aktuelle Anzahl der Shards 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()

Ruft nur die Test-Binärdatei auf, um eine Liste der anwendbaren Testläufe zu erfassen.

boolean isEnableXmlOutput()

Gibt an, ob für Testergebnisse die XML-Ausgabe von gtest verwendet wird.

boolean isSharded()

Ruft das Flag „isSharded“ ab.

void notifyTestExecution(boolean incompleteTestFound, Set<String> failedTests)

Benachrichtigung des übergeordneten Elements über die Testausführung, damit Ein- und Ausschlussfilter für die Wiederholungsversuche richtig gehandhabt werden können.

void setAbi(IAbi abi)
void setCollectTestsOnly(boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testsammlungsmodus

void setConfiguration(IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

void setModuleName(String moduleName)

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

void setShardCount(int shardCount)

Legt die Anzahl der Shards für diesen Test fest.

void setShardIndex(int shardIndex)

Legt den Shard-Index dieses Tests fest.

Collection<IRemoteTest> split(int shardCountHint)

Alternative Version von split(), die auch die Anzahl der Shards enthält, die ausgeführt werden sollen.

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 Einschränkungen des Betriebssystems hinsichtlich der Argumentgröße zu vermeiden.

void erasePrependedFileName(Set<String> filters, String filename)
String getAllGTestFlags(String path)

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

Helper-Methode zum Erstellen des auszuführenden gtest-Befehls.

String getGTestCmdLineWrapper(String fullPath, String flags)

Hilfsklasse, mit der abgeleitete Klassen den gtest-Befehl in ein anderes Tool (chroot, strace, gdb usw.) einbetten können.

String getGTestFilters(String path)

Hilfsfunktion zum Abrufen des g-test-Filters für den auszuführenden Test.

ITestInvocationListener getGTestListener(ITestInvocationListener... listeners)

Gibt den GTestListener zurück, der zusätzliche Debugging-Informationen bereitstellt, z. B. werden doppelte Tests erkannt und gemeldet, wenn mDisabledDuplicateCheck „false“ ist.

abstract String loadFilter(String path)

Definieren Sie die Methode zum Abrufen von Filtern.

void setRunDisabled(boolean runDisabled)

Legt fest, ob GTest deaktivierte Tests ausführen soll.

Konstanten

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

Konstanter Wert: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Constant Value: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

Constant Value: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Konstanter Wert: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Konstanter Wert: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Konstanter Wert: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Konstanter Wert: "--gtest_output=xml:%s"

Öffentliche Konstruktoren

GTestBase

public GTestBase ()

Öffentliche Methoden

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Fügt die Set der Filter hinzu, anhand derer Tests ausgeschlossen werden sollen.

Parameter
filters Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Fügt die Set der Filter hinzu, für die Tests einbezogen werden sollen.

Parameter
filters Set

addExcludeFilter

public void addExcludeFilter (String filter)

Fügt einen Filter hinzu, mit dem festgelegt wird, welche Tests ausgeschlossen werden sollen.

Parameter
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

Fügt einen Filter hinzu, der angibt, welche Tests einbezogen werden sollen.

Parameter
filter String

cleanFilter

public String cleanFilter (String filter)

Parameter
filter String

Gibt Folgendes zurück:
String

clearExcludeFilters

public void clearExcludeFilters ()

Alle derzeit erfassten Ausschlussfilter löschen.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

getAbi

public IAbi getAbi ()

Gibt Folgendes zurück:
IAbi

getAfterTestCmd

public List<String> getAfterTestCmd ()

Ruft Shell-Befehle ab, die nach GTest ausgeführt werden sollen.

Gibt Folgendes zurück:
List<String>

getBeforeTestCmd

public List<String> getBeforeTestCmd ()

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

Gibt Folgendes zurück:
List<String>

getExcludeFilters

public Set<String> getExcludeFilters ()

Gibt die aktuelle Set der Ausschlussfilter zurück.

Gibt Folgendes zurück:
Set<String>

getFileExclusionFilterRegex

public Set<String> getFileExclusionFilterRegex ()

Ruft den regulären Ausdruck ab, um bestimmte Dateien von der Ausführung auszuschließen.

Gibt Folgendes zurück:
Set<String>

getGTestFlags

public List<String> getGTestFlags ()

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

Gibt Folgendes zurück:
List<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

Gibt die aktuelle Set der Einschlussfilter zurück.

Gibt Folgendes zurück:
Set<String>

getMaxTestTimeMs

public long getMaxTestTimeMs ()

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

Gibt Folgendes zurück:
long

getModuleName

public String getModuleName ()

Android-Testmodul zum Ausführen abrufen

Gibt Folgendes zurück:
String Der Name des nativen Testmoduls, das ausgeführt werden soll, oder „null“, wenn es nicht festgelegt ist.

getRunDisabledTests

public boolean getRunDisabledTests ()

Gibt an, ob GTest deaktivierte Tests ausführen soll.

Gibt Folgendes zurück:
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 verwendet, um die Ausführung von Shards auszugleichen.

Gibt Folgendes zurück:
long

getShardCount

public int getShardCount ()

Gibt die aktuelle Anzahl der Shards zurück.

Gibt Folgendes zurück:
int

getShardIndex

public int getShardIndex ()

Ruft den Shard-Index dieses Tests ab.

Gibt Folgendes zurück:
int

getTestFilterKey

public String getTestFilterKey ()

Ruft den Testfilterschlüssel ab.

Gibt Folgendes zurück:
String

getTestModule

public String getTestModule ()

Ruft den Modulnamen ab.

Gibt Folgendes zurück:
String

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Ruft nur die Testbinärdatei auf, um eine Liste der anwendbaren Testläufe zu erfassen.

Gibt Folgendes zurück:
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Gibt an, ob für Testergebnisse die XML-Ausgabe von gtest verwendet wird.

Gibt Folgendes zurück:
boolean

isSharded

public boolean isSharded ()

Ruft das Flag „isSharded“ ab.

Gibt Folgendes zurück:
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                Set<String> failedTests)

Benachrichtigung des übergeordneten Elements über die Testausführung, damit Ein- und Ausschlussfilter für die Wiederholungsversuche richtig gehandhabt werden können.

Parameter
incompleteTestFound boolean

failedTests Set

setAbi

public void setAbi (IAbi abi)

Parameter
abi IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testsammlungsmodus

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

Parameter
configuration IConfiguration

setModuleName

public void setModuleName (String moduleName)

Legen Sie fest, welches 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 Anzahl der Shards für diesen Test fest.

Parameter
shardCount int

setShardIndex

public void setShardIndex (int shardIndex)

Legt den Shard-Index dieses Tests fest.

Parameter
shardIndex int

teilen

public Collection<IRemoteTest> split (int shardCountHint)

Alternative Version von split(), die auch die Anzahl der Shards enthält, die ausgeführt werden sollen. Dies ist für einige Testrunner nützlich, die nicht immer willkürlich entscheiden können.

Parameter
shardCountHint int: Die Anzahl der versuchten Shards.
Gibt Folgendes zurück:
Collection<IRemoteTest> eine Sammlung von Untertests, die separat ausgeführt werden sollen, oder null, wenn der Test derzeit nicht aufgeteilt werden kann.

Geschützte Methoden

convertName

protected String convertName (String gtestFlagName)

Parameter
gtestFlagName String

Gibt Folgendes zurück:
String

createFlagFile

protected String createFlagFile (String filter)

Erstellen Sie eine Datei mit den Filtern, die über „--gtest_flagfile“ verwendet werden, um Einschränkungen des Betriebssystems hinsichtlich der Argumentgröße zu vermeiden.

Parameter
filter String: Der Filterstring
Gibt Folgendes zurück:
String Der Pfad zur Datei, die den Filter enthält.
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

erasePrependedFileName

protected void erasePrependedFileName (Set<String> filters, 
                String filename)

Parameter
filters Set

filename String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Helfer 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.
Gibt Folgendes zurück:
String die String aller GTest-Flags, die an den GTest übergeben werden sollen
Löst aus
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

Gibt die Testkonfiguration zurück.

Gibt Folgendes zurück:
IConfiguration eine IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

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

Parameter
e Exception: Der Exception
Gibt Folgendes zurück:
String eine kurze Nachricht

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Helper-Methode zum Erstellen des auszuführenden gtest-Befehls.

Parameter
fullPath String: absoluter Dateisystempfad zur gtest-Binärdatei auf dem Gerät
flags String: Flags für die Ausführung von gtest
Gibt Folgendes zurück:
String die Shell-Befehlszeile, die für den gtest ausgeführt werden soll

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Hilfsklasse, mit der abgeleitete Klassen den gtest-Befehl in ein anderes Tool (chroot, strace, gdb usw.) einbetten können.

Parameter
fullPath String

flags String

Gibt Folgendes zurück:
String

getGTestFilters

protected String getGTestFilters (String path)

Hilfsfunktion zum Abrufen des g-test-Filters für den auszuführenden Test.

Filter werden nur auf den Funktionsnamen angewendet (z. B. Google Test „Test“). Alle Google Test-Testläufe werden berücksichtigt.

Parameter
path String: der vollständige Pfad der Binärdatei auf dem Gerät.
Gibt Folgendes zurück:
String Das vollständige Filter-Flag, das an den G-Test übergeben werden soll, oder ein leerer String, wenn keines angegeben wurde
Löst aus
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Gibt den GTestListener zurück, der zusätzliche Debugging-Informationen bereitstellt, z. B. werden doppelte Tests erkannt und gemeldet, wenn mDisabledDuplicateCheck „false“ ist. Andernfalls wird der übergebene Listener zurückgegeben.

Parameter
listeners ITestInvocationListener

Gibt Folgendes zurück:
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

Definieren Sie die Methode zum Abrufen von Filtern.

Die untergeordnete Klasse muss implementieren, wie ihr eigener Filter abgerufen wird.

Parameter
path String: Der vollständige Pfad der Filterdatei.
Gibt Folgendes zurück:
String Filterstring.
Löst aus
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Legt fest, ob GTest deaktivierte Tests ausführen soll.

Parameter
runDisabled boolean