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ügt ERROR(/Set) der Filter hinzu, von denen Tests eingeschlossen werden sollen.

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 ERROR(/Set) der Ausschlussfilter zurück.

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 ERROR(/Set) der "Einschließen"-Filter zurück.

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

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 IConfiguration in Gebrauch.

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 split(), die auch den versuchten shardCount bereitstellt 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 Betriebssystem zu vermeiden die Beschränkung der Argumentgröße.

void erasePrependedFileName( filters, String filename)
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 Exception

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.

getAbi

public IAbi getAbi ()

Returns
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

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

Returns

getBeforeTestCmd

public  getBeforeTestCmd ()

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

Returns

getAusschließenFilters

public  getExcludeFilters ()

Gibt die aktuellen ERROR(/Set) der Ausschlussfilter zurück.

Returns

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Ruft den regulären Ausdruck ab, um die Ausführung bestimmter Dateien auszuschließen.

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

SetAbi

public void setAbi (IAbi abi)

Parameter
abi IAbi

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

public  split (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