À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

GTestBase

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

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

Sous-classes directes connues

GTest, HostGTest

GTest	Test qui exécute un package de test natif sur un appareil donné.
HostGTest	Test qui exécute un package de test natif.

Sous-classes indirectes connues

ArtGTest

Classe de base de gTest

Résumé

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

Constructeurs publics
`GTestBase()`

Méthodes publiques
`void`	`addAllExcludeFilters( filters)` Ajoute les `ERROR(/Set)` des filtres des tests à exclure.
`void`	`addAllIncludeFilters( filters)` Ajoute les `ERROR(/Set)` des filtres des tests à inclure.
`void`	`addExcludeFilter(String filter)` Ajoute un filtre des tests à exclure.
`void`	`addIncludeFilter(String filter)` Ajoute un filtre des tests à inclure.
`String`	`cleanFilter(String filter)`
`void`	`clearExcludeFilters()` Supprimez tous les filtres d'exclusion actuellement suivis.
`void`	`clearIncludeFilters()` Supprimez tous les filtres d'inclusion actuellement suivis.
`IAbi`	`getAbi()`
	`getAfterTestCmd()` Récupère la ou les commandes shell à exécuter après GTest.
	`getBeforeTestCmd()` Récupère la ou les commandes shell à exécuter avant GTest.
	`getExcludeFilters()` Renvoie l'`ERROR(/Set)` actuelle des filtres d'exclusion.
	`getFileExclusionFilterRegex()` Récupère l'expression régulière pour exclure l'exécution de certains fichiers.
	`getGTestFlags()` Récupère des valeurs d'indicateur supplémentaires à transmettre à la commande shell du test natif.
	`getIncludeFilters()` Renvoie l'`ERROR(/Set)` actuelle des filtres d'inclusion.
`long`	`getMaxTestTimeMs()` Récupère la durée maximale d'exécution d'un gtest.
`String`	`getModuleName()` Exécutez le module de test natif Android.
`boolean`	`getRunDisabledTests()` Indique si GTest doit exécuter des tests désactivés.
`long`	`getRuntimeHint()` Renvoie la durée d'exécution prévue du test en millisecondes.
`int`	`getShardCount()` Renvoie le nombre de fragments actuel.
`int`	`getShardIndex()` Récupère l'index de shard de ce test.
`String`	`getTestFilterKey()` Récupère la clé de filtre de test.
`String`	`getTestModule()` Récupère le nom du module.
`boolean`	`isCollectTestsOnly()` N'appelle que le binaire de test pour collecter la liste des scénarios de test applicables ou non.
`boolean`	`isEnableXmlOutput()` Indique si la sortie XML gtest doit être utilisée pour les résultats des tests ou non.
`boolean`	`isSharded()` Récupère l'indicateur "isSharded".
`void`	`notifyTestExecution(boolean incompleteTestFound, failedTests)` Informe le parent de l'exécution du test afin que les filtres d'inclusion/d'exclusion puissent être correctement gérés pour les tentatives de nouvelle tentative.
`void`	`setAbi(IAbi abi)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Active ou désactive le mode de collecte des tests
`void`	`setConfiguration(IConfiguration configuration)` Injecte le `IConfiguration` utilisé.
`void`	`setModuleName(String moduleName)` Définissez le module de test natif Android à exécuter.
`void`	`setShardCount(int shardCount)` Définit le nombre de fragments de ce test.
`void`	`setShardIndex(int shardIndex)` Définit l'indice de fragment de ce test.
	`split(int shardCountHint)` Version alternative de `split()` qui fournit également le shardCount que vous essayez d'exécuter.

Méthodes protégées
`String`	`convertName(String gtestFlagName)`
`String`	`createFlagFile(String filter)` Créez un fichier contenant les filtres qui seront utilisés via --gtest_flagfile pour éviter toute limitation de l'OS sur la taille des arguments.
`void`	`erasePrependedFileName( filters, String filename)`
`String`	`getAllGTestFlags(String path)` Outil d'assistance permettant d'obtenir tous les indicateurs GTest à transmettre à la commande shell adb.
`IConfiguration`	`getConfiguration()` Renvoie la configuration de test.
`String`	`getExceptionMessage(Exception e)` Essayez de récupérer un message descriptif court et pertinent pour un `Exception` donné.
`String`	`getGTestCmdLine(String fullPath, String flags)` Méthode d'assistance permettant de créer la commande gtest à exécuter.
`String`	`getGTestCmdLineWrapper(String fullPath, String flags)` Assistant qui permet aux classes dérivées d'encapsuler la commande gtest sous un autre outil (chroot, strace, gdb, etc.).
`String`	`getGTestFilters(String path)` Assistant permettant d'obtenir le filtre de test g-test à exécuter.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` Renvoie le GTestListener qui fournit des informations de débogage supplémentaires, comme la détection et le signalement des tests en double si mDisabledDuplicateCheck est défini sur "false".
`abstract String`	`loadFilter(String path)` Définissez la méthode de filtrage get.
`void`	`setRunDisabled(boolean runDisabled)` Définissez si GTest doit exécuter les tests désactivés.

Champs

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

Constructeurs publics

GTestBase

public GTestBase ()

Méthodes publiques

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Ajoute les ERROR(/Set) des filtres des tests à exclure.

Paramètres
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Ajoute les ERROR(/Set) des filtres des tests à inclure.

Paramètres
`filters`

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre des tests à exclure.

Paramètres
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre des tests à inclure.

Paramètres
`filter`	`String`

cleanFilter

public String cleanFilter (String filter)

Paramètres
`filter`	`String`

Renvoie
`String`

clearExcludeFilters

public void clearExcludeFilters ()

Supprimez tous les filtres d'exclusion actuellement suivis.

clearIncludeFilters

public void clearIncludeFilters ()

Supprimez tous les filtres d'inclusion actuellement suivis.

getAbi

public IAbi getAbi ()

Renvoie
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

Récupère la ou les commandes shell à exécuter après GTest.

Renvoie

getBeforeTestCmd

public  getBeforeTestCmd ()

Récupère la ou les commandes shell à exécuter avant GTest.

Renvoie

getExcludeFilters

public  getExcludeFilters ()

Renvoie l'ERROR(/Set) actuelle des filtres d'exclusion.

Renvoie

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Récupère l'expression régulière pour exclure l'exécution de certains fichiers.

Renvoie

getGTestFlags

public  getGTestFlags ()

Récupère des valeurs d'indicateur supplémentaires à transmettre à la commande shell du test natif.

Renvoie

getIncludeFilters

public  getIncludeFilters ()

Renvoie l'ERROR(/Set) actuelle des filtres d'inclusion.

Renvoie

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Récupère la durée maximale d'exécution d'un gtest.

Renvoie
`long`

getModuleName

public String getModuleName ()

Exécutez le module de test natif Android.

Renvoie
`String`	Nom du module de test natif à exécuter, ou valeur nulle si elle n'est pas définie

getRunDisabledTests

public boolean getRunDisabledTests ()

Indique si GTest doit exécuter des tests désactivés.

Renvoie
`boolean`	"True" si les tests désactivés doivent être exécutés, "false" dans le cas contraire

getRuntimeHint

public long getRuntimeHint ()

Renvoie la durée d'exécution prévue du test en millisecondes. L'heure est utilisée pour équilibrer la charge de l'exécution fractionnée.

Renvoie
`long`

getShardCount

public int getShardCount ()

Renvoie le nombre de fragments actuel.

Renvoie
`int`

getShardIndex

public int getShardIndex ()

Récupère l'index de shard de ce test.

Renvoie
`int`

getTestFilterKey

public String getTestFilterKey ()

Récupère la clé de filtre de test.

Renvoie
`String`

getTestModule

public String getTestModule ()

Récupère le nom du module.

Renvoie
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

N'appelle que le binaire de test pour collecter la liste des scénarios de test applicables ou non.

Renvoie
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Indique si la sortie XML gtest est utilisée pour les résultats des tests ou non.

Renvoie
`boolean`

isSharded

public boolean isSharded ()

Récupère l'indicateur "isSharded".

Renvoie
`boolean`

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Informe le parent de l'exécution du test afin que les filtres d'inclusion/d'exclusion puissent être correctement gérés pour les tentatives de nouvelle tentative.

Paramètres
`incompleteTestFound`	`boolean`
`failedTests`

setAbi

public void setAbi (IAbi abi)

Paramètres
`abi`	`IAbi`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Active ou désactive le mode de collecte des tests

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injecte le IConfiguration utilisé.

Paramètres
`configuration`	`IConfiguration`

setModuleName

public void setModuleName (String moduleName)

Définissez le module de test natif Android à exécuter.

Paramètres
`moduleName`	`String`: nom du module de test natif à exécuter

setShardCount

public void setShardCount (int shardCount)

Définit le nombre de fragments de ce test.

Paramètres
`shardCount`	`int`

setShardIndex

public void setShardIndex (int shardIndex)

Définit l'index de shard de ce test.

Paramètres
`shardIndex`	`int`

split

public  split (int shardCountHint)

Version alternative de split() qui fournit également le shardCount que vous essayez d'exécuter. Cela est utile pour certains outils d'exécution de tests qui ne peuvent pas toujours prendre une décision arbitraire.

Paramètres
`shardCountHint`	`int`: nombre de partitions tentées.

Renvoie
	Ensemble de sous-tests à exécuter séparément ou `null` si le test n'est pas actuellement partitionnable

Méthodes protégées

convertName

protected String convertName (String gtestFlagName)

Paramètres
`gtestFlagName`	`String`

Renvoie
`String`

createFlagFile

protected String createFlagFile (String filter)

Créez un fichier contenant les filtres qui seront utilisés via --gtest_flagfile pour éviter toute limitation de l'OS sur la taille des arguments.

Paramètres
`filter`	`String`: chaîne de filtre

Renvoie
`String`	Chemin d'accès au fichier contenant le filtre.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Paramètres
`filters`
`filename`	`String`

getAllGTestFlags

protected String getAllGTestFlags (String path)

Outil d'assistance permettant d'obtenir tous les indicateurs GTest à transmettre à la commande shell adb.

Paramètres
`path`	`String`: chemin d'accès complet du binaire sur l'appareil.

Renvoie
`String`	`String` de tous les indicateurs GTest à transmettre à GTest

Génère
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Renvoie la configuration de test.

Renvoie
`IConfiguration`	un IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Essayez de récupérer un message descriptif court et pertinent pour un Exception donné.

Paramètres
`e`	`Exception`: `Exception`

Renvoie
`String`	un court message

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Méthode d'assistance permettant de créer la commande gtest à exécuter.

Paramètres
`fullPath`	`String`: chemin d'accès absolu du système de fichiers au binaire gtest sur l'appareil
`flags`	`String`: indicateurs d'exécution gtest

Renvoie
`String`	la ligne de commande shell à exécuter pour gtest

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Assistant qui permet aux classes dérivées d'encapsuler la commande gtest sous un autre outil (chroot, strace, gdb, etc.).

Paramètres
`fullPath`	`String`
`flags`	`String`

Renvoie
`String`

getGTestFilters

protected String getGTestFilters (String path)

Assistant permettant d'obtenir le filtre de test g-test à exécuter.

Notez que les filtres ne s'appliquent qu'au nom de la fonction (par exemple, Google Test "Test"). Tous les "cas de test" Google Test seront pris en compte.

Paramètres
`path`	`String`: chemin d'accès complet du binaire sur l'appareil.

Renvoie
`String`	Option de filtre complète à transmettre au g-test, ou chaîne vide si aucune n'a été spécifiée

Génère
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Renvoie le GTestListener qui fournit des informations de débogage supplémentaires, comme la détection et le signalement des tests en double si mDisabledDuplicateCheck est défini sur "false". Sinon, renvoie l'écouteur transmis.

Paramètres
`listeners`	`ITestInvocationListener`

Renvoie
`ITestInvocationListener`

loadFilter

protected abstract String loadFilter (String path)

Définissez la méthode de filtrage get.

La sous-classe doit implémenter la méthode permettant d'obtenir son propre filtre.

Paramètres
`path`	`String`: chemin d'accès complet du fichier de filtre.

Renvoie
`String`	chaîne de filtre.

Génère
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Définissez si GTest doit exécuter les tests désactivés.

Paramètres
`runDisabled`	`boolean`