Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

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, der ein natives Testpaket ausführt.

Bekannte indirekte Unterklassen

ArtGTest

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( filters)` Fügt die `ERROR(/Set)` der Filter hinzu, für die Tests ausgeschlossen werden sollen.
`void`	`addAllIncludeFilters( filters)` Fügt die `ERROR(/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()` Löschen Sie alle derzeit erfassten Ausschlussfilter.
`void`	`clearIncludeFilters()` Löschen Sie alle derzeit erfassten Einschlussfilter.
`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 aktuelle `ERROR(/Set)` der Ausschlussfilter zurück.
	`getFileExclusionFilterRegex()` Ruft den regulären Ausdruck ab, 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 sollen.
	`getIncludeFilters()` Gibt die aktuelle `ERROR(/Set)` der Einschlussfilter zurück.
`long`	`getMaxTestTimeMs()` Ruft die maximale Ausführungszeit für einen gtest ab.
`String`	`getModuleName()` Rufen Sie das native Android-Testmodul auf, das ausgeführt werden soll.
`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 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()` Ruft nur die Test-Binärdatei auf, um die 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, failedTests)` Elternbenachrichtigung über die Ausführung des Tests, damit Ein- und Ausschlussfilter für die Wiederholungsversuche richtig verarbeitet 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 das auszuführende native Android-Testmodul fest.
`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.
	`split(int shardCountHint)` Alternative Version von `split()`, die auch die Anzahl der Shards angibt, 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 Betriebssystembeschränkungen bei der Größe von Argumenten zu vermeiden.
`void`	`erasePrependedFileName( 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 `Exception` abzurufen.
`String`	`getGTestCmdLine(String fullPath, String flags)` Helper-Methode zum Erstellen des auszuführenden gtest-Befehls.
`String`	`getGTestCmdLineWrapper(String fullPath, String flags)` Helferklasse, 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. Erkennung und Meldung von doppelten Tests, 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 ( filters)

Fügt die ERROR(/Set) der Filter hinzu, für die Tests ausgeschlossen werden sollen.

Parameter
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Parameter
`filters`

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`

Returns
`String`

clearExcludeFilters

public void clearExcludeFilters ()

Löschen Sie alle derzeit erfassten Ausschlussfilter.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

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

getExcludeFilters

public  getExcludeFilters ()

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

Returns

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Ruft den regulären Ausdruck ab, 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 sollen.

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

Rufen Sie das native Android-Testmodul auf, das ausgeführt werden soll.

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

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 verwendet, um die Ausführung von Shards auszugleichen.

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

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

Returns
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

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

Returns
`boolean`

isSharded

public boolean isSharded ()

Ruft das Flag „isSharded“ ab.

Returns
`boolean`

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Elternbenachrichtigung über die Ausführung des Tests, damit Ein- und Ausschlussfilter für die Wiederholungsversuche richtig gehandhabt 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 Testsammlungsmodus

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

Parameter
`configuration`	`IConfiguration`

setModuleName

public void setModuleName (String moduleName)

Legen Sie das auszuführende native Android-Testmodul fest.

Parameter
`moduleName`	`String`: Der Name des nativen Testmoduls, das ausgeführt werden soll.

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`

aufteilen

public  split (int shardCountHint)

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

Parameter
`shardCountHint`	`int`: Die Anzahl der versuchten Shards.

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

Returns
`String`

createFlagFile

protected String createFlagFile (String filter)

Erstellen Sie eine Datei mit den Filtern, die über „--gtest_flagfile“ verwendet werden, um Betriebssystembeschrä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)

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.

Returns
`String`	die `String` aller GTest-Flags, die an den 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)

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

Parameter
`e`	`Exception`: die `Exception`

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

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

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

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

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

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

Returns
`String`	Das vollständige Filter-Flag, das an den G-Test übergeben werden soll, oder ein leerer String, wenn keines angegeben wurde

Ausgabe
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Gibt den GTestListener zurück, der zusätzliche Debugging-Informationen bereitstellt, z. B. Erkennung und Meldung von doppelten 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 von Filtern.

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

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

Returns
`String`	Filterstring.

Ausgabe
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

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

Parameter
`runDisabled`	`boolean`