Diese Seite wurde von der Cloud Translation API übersetzt.

GTestBase

public abstract class GTestBase
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.GTestBase

Bekannte direkte Unterklassen

GTest, HostGTest

GTest	Ein Test, bei dem ein natives Testpaket auf einem bestimmten Gerät ausgeführt wird.
HostGTest	Ein Test, bei dem ein natives Testpaket ausgeführt wird.

Bekannte indirekte Unterklassen

ArtGTest

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ügen Sie die `ERROR(/Set)` der Filter hinzu, deren 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)` Hiermit wird ein Filter für die Tests hinzugefügt, die ausgeschlossen werden sollen.
`void`	`addIncludeFilter(String filter)` Hier können Sie festlegen, welche Tests eingeschlossen werden sollen.
`String`	`cleanFilter(String filter)`
`void`	`clearExcludeFilters()` Löschen Sie alle derzeit erfassten Ausschlüsse.
`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 Einschlussfilter zurück.
`long`	`getMaxTestTimeMs()` Ruft die maximale Ausführungszeit für einen gtest ab.
`String`	`getModuleName()` Das native Android-Testmodul ausführen
`boolean`	`getRunDisabledTests()` Prüfen, 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()` Gibt an, ob die gtest-XML-Ausgabe für Testergebnisse verwendet werden soll 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 richtig verarbeitet werden können.
`void`	`setAbi(IAbi abi)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Aktiviert oder deaktiviert den Modus für die Testerhebung
`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`	`convertName(String gtestFlagName)`
`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)` Versuche, 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

addAllExcludeFilters

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)

Hier können Sie einen Filter hinzufügen, um Tests auszuschließen.

Parameter
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Hier können Sie festlegen, welche Tests eingeschlossen werden sollen.

Parameter
`filter`	`String`

cleanFilter

public String cleanFilter (String filter)

Parameter
`filter`	`String`

Returns
`String`

clearExcludeFilters

public void clearExcludeFilters ()

Löschen Sie alle derzeit erfassten Ausschlüsse.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

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 Ausführungszeit für einen gtest ab.

Returns
`long`

getModuleName

public String getModuleName ()

Das native Android-Testmodul ausführen

Returns
`String`	Der Name des auszuführenden nativen Testmoduls oder „null“, wenn nicht festgelegt

getRunDisabledTests

public boolean getRunDisabledTests ()

Prüfen, 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 voraussichtliche Laufzeit des Tests in Millisekunden zurück. Die Zeit wird für das Load Balancing der ge shardeten 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 ()

Das Flag „isSharded“ wird abgerufen.

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. Dies ist nützlich für einige Testläufer, die manchmal nicht willkürlich entscheiden können.

Parameter
`shardCountHint`	`int`: die Anzahl der Shards, die versucht wurden.

Returns
	eine Sammlung von Teiltests, die separat ausgeführt werden sollen, oder `null`, wenn der Test derzeit nicht geShardet werden kann

Geschützte Methoden

convertName

protected String convertName (String gtestFlagName)

Parameter
`gtestFlagName`	`String`

Returns
`String`

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`	die `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, eine aussagekräftige, kurze Beschreibung für die angegebene 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ührungsflags

Returns
`String`	die Shell-Befehlszeile, die für gtest ausgeführt werden soll

getGTestCmdLineWrapper

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

Parameter
`fullPath`	`String`
`flags`	`String`

Returns
`String`

getGTestFilters

protected String getGTestFilters (String path)

Hilfsfunktion zum Abrufen des G‑Test-Filters des zu ausführenden 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 Informationen zur Fehlerbehebung liefert, z. B. erkennt und meldet doppelte Tests, wenn mDisabledDuplicateCheck falsch ist. Andernfalls wird der übergebene Listener zurückgegeben.

Parameter
`listeners`	`ITestInvocationListener`

Returns
`ITestInvocationListener`

loadFilter

protected abstract String loadFilter (String path)

Filtermethode „get“ definieren

Die Unterklasse muss implementieren, wie der eigene Filter abgerufen wird.

Parameter
`path`	`String`: der vollständige Pfad zur Filterdatei.

Returns
`String`	Filterstring.

Ausgabe
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Legen Sie fest, ob GTest deaktivierte Tests ausführen soll.

Parameter
`runDisabled`	`boolean`