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

GTestBase

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

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

Sous-classes directes connues

GTest , HôteGTest

Test GT	Un test qui exécute un package de test natif sur un appareil donné.
HôteGTest	Un test qui exécute un package de test natif.

Sous-classes indirectes connues

ArtGTest

La classe de base de gTest

Résumé

Des 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)` `addAllExcludeFilters ( filters)` Ajoute l' `ERROR(/Set)` des filtres dont les tests doivent être exclus.
`void`	`addAllIncludeFilters ( filters)` `addAllIncludeFilters ( filters)` Ajoute l' `ERROR(/Set)` des filtres dont les tests doivent être inclus.
`void`	`addExcludeFilter (String filter)` Ajoute un filtre indiquant les tests à exclure.
`void`	`addIncludeFilter (String filter)` Ajoute un filtre indiquant les 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 ()` Obtient les commandes shell à exécuter après GTest.
	`getBeforeTestCmd ()` Obtient les commandes shell à exécuter avant GTest.
	`getExcludeFilters ()` Renvoie l' `ERROR(/Set)` actuelle des filtres d'exclusion.
	`getFileExclusionFilterRegex ()` Obtient une expression régulière pour exclure certains fichiers de l'exécution.
	`getGTestFlags ()` Obtient 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 ()` Obtient la durée maximale d'exécution d'un gtest.
`String`	`getModuleName ()` Exécutez le module de test natif Android.
`boolean`	`getRunDisabledTests ()` Déterminez si GTest doit exécuter des tests désactivés.
`long`	`getRuntimeHint ()` Renvoie la durée d'exécution attendue du test en millisecondes.
`int`	`getShardCount ()` Renvoie le nombre de fragments actuel.
`int`	`getShardIndex ()` Obtient l'index de partition de ce test.
`String`	`getTestFilterKey ()` Obtient la clé du filtre de test.
`String`	`getTestModule ()` Obtient le nom du module.
`boolean`	`isCollectTestsOnly ()` Gets appelle uniquement le binaire de test pour collecter ou non la liste des cas de test applicables.
`boolean`	`isEnableXmlOutput ()` Obtient ou non la sortie XML de gtest pour les résultats des tests.
`boolean`	`isSharded ()` Obtient l’indicateur isSharded.
`void`	`notifyTestExecution (boolean incompleteTestFound, failedTests)` `notifyTestExecution (boolean incompleteTestFound, failedTests)` Informez le parent de l'exécution du test, afin que les filtres d'inclusion/exclusion puissent être gérés correctement pour les nouvelles tentatives.
`void`	`setAbi ( IAbi abi)`
`void`	`setCollectTestsOnly (boolean shouldCollectTest)` Active ou désactive le mode de collecte de tests
`void`	`setConfiguration ( IConfiguration configuration)` Injecte la `IConfiguration` utilisée.
`void`	`setModuleName (String moduleName)` Configurez le module de test natif Android pour qu'il s'exécute.
`void`	`setShardCount (int shardCount)` Définit le nombre de fragments de ce test.
`void`	`setShardIndex (int shardIndex)` Définit l'index de partition de ce test.
	`split (int shardCountHint)` Version alternative de `split()` qui fournit également le shardCount que l'on tente d'exécuter.

Méthodes protégées
`String`	`createFlagFile (String filter)` Créez un fichier contenant les filtres qui seront utilisés via --gtest_flagfile pour éviter toute limitation du système d'exploitation dans la taille des arguments.
`void`	`erasePrependedFileName ( filters, String filename)` `erasePrependedFileName ( filters, String filename)`
`String`	`getAllGTestFlags (String path)` Aide pour que tous les indicateurs GTest soient transmis à la commande adb shell.
`IConfiguration`	`getConfiguration ()` Renvoie la configuration de test.
`String`	`getExceptionMessage (Exception e)` Faites de votre mieux pour tenter de récupérer un court message descriptif significatif pour `Exception` donnée.
`String`	`getGTestCmdLine (String fullPath, String flags)` Méthode d'assistance pour créer la commande gtest à exécuter.
`String`	`getGTestCmdLineWrapper (String fullPath, String flags)` Helper qui permet aux classes dérivées d'encapsuler la commande gtest sous un autre outil (chroot, strace, gdb et similaire).
`String`	`getGTestFilters (String path)` Aide pour exécuter le filtre g-test du test.
`ITestInvocationListener`	`getGTestListener ( ITestInvocationListener listener)` Renvoie le GTestListener qui fournit des informations de débogage supplémentaires, comme détecte et signale les tests en double si mDisabledDuplicateCheck est faux.
`abstract String`	`loadFilter (String path)` Définissez la méthode de filtre get.
`void`	`setRunDisabled (boolean runDisabled)` Définissez si GTest doit exécuter des tests désactivés.

Des 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 l' ERROR(/Set) des filtres dont les tests doivent être exclus.

Paramètres
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Ajoute l' ERROR(/Set) des filtres dont les tests doivent être inclus.

Paramètres
`filters`

ajouterExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre indiquant les tests à exclure.

Paramètres
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre indiquant les tests à inclure.

Paramètres
`filter`	`String`

nettoyerFiltre

public String cleanFilter (String filter)

Paramètres
`filter`	`String`

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

obtenirAbi

public IAbi getAbi ()

Retour
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

Obtient les commandes shell à exécuter après GTest.

Retour

getBeforeTestCmd

public  getBeforeTestCmd ()

Obtient les commandes shell à exécuter avant GTest.

Retour

getExcludeFilters

public  getExcludeFilters ()

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

Retour

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

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

Retour

getGTestFlags

public  getGTestFlags ()

Obtient des valeurs d'indicateur supplémentaires à transmettre à la commande shell du test natif.

Retour

getIncludeFilters

public  getIncludeFilters ()

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

Retour

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Obtient la durée maximale d'exécution d'un gtest.

Retour
`long`

getModuleName

public String getModuleName ()

Exécutez le module de test natif Android.

Retour
`String`	le nom du module de test natif à exécuter, ou null s'il n'est pas défini

getRunDisabledTests

public boolean getRunDisabledTests ()

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

Retour
`boolean`	Vrai si des tests désactivés doivent être exécutés, faux sinon

getRuntimeHint

public long getRuntimeHint ()

Renvoie la durée d'exécution attendue du test en millisecondes. Le temps est utilisé pour équilibrer la charge de l'exécution fragmentée

Retour
`long`

getShardCount

public int getShardCount ()

Renvoie le nombre de fragments actuel.

Retour
`int`

getShardIndex

public int getShardIndex ()

Obtient l'index de partition de ce test.

Retour
`int`

getTestFilterKey

public String getTestFilterKey ()

Obtient la clé du filtre de test.

Retour
`String`

getTestModule

public String getTestModule ()

Obtient le nom du module.

Retour
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Gets appelle uniquement le binaire de test pour collecter ou non la liste des cas de test applicables.

Retour
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Obtient ou non la sortie XML de gtest pour les résultats des tests.

Retour
`boolean`

estShaded

public boolean isSharded ()

Obtient l’indicateur isSharded.

Retour
`boolean`

notifierTestExécution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

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

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 de tests

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injecte la IConfiguration utilisée.

Paramètres
`configuration`	`IConfiguration`

setModuleName

public void setModuleName (String moduleName)

Configurez le module de test natif Android pour qu'il s'exécute.

Paramètres
`moduleName`	`String` : Le 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 partition de ce test.

Paramètres
`shardIndex`	`int`

diviser

public  split (int shardCountHint)

Version alternative de split() qui fournit également le shardCount que l'on tente d'exécuter. Ceci est utile pour certains testeurs qui ne peuvent parfois pas décider arbitrairement.

Paramètres
`shardCountHint`	`int` : le nombre de fragments tentés.

Retour
	une collection de sous-tests à exécuter séparément ou `null` si le test n'est pas actuellement fragmentable

Méthodes protégées

créer un fichier drapeau

protected String createFlagFile (String filter)

Créez un fichier contenant les filtres qui seront utilisés via --gtest_flagfile pour éviter toute limitation du système d'exploitation dans la taille des arguments.

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

Retour
`String`	Le chemin d'accès au fichier contenant le filtre.

Jetés
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

effacerPrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

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

getAllGTestFlags

protected String getAllGTestFlags (String path)

Aide pour que tous les indicateurs GTest soient transmis à la commande adb shell.

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

Retour
`String`	la `String` de tous les drapeaux GTest qui doivent être transmis au GTest

Jetés
`DeviceNotAvailableException`

obtenirConfiguration

protected IConfiguration getConfiguration ()

Renvoie la configuration de test.

Retour
`IConfiguration`	une configuration I

getExceptionMessage

protected String getExceptionMessage (Exception e)

Faites de votre mieux pour tenter de récupérer un court message descriptif significatif pour Exception donnée.

Paramètres
`e`	`Exception` : l' `Exception`

Retour
`String`	un court message

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

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

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

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

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

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

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

Retour
`String`

getGTestFilters

protected String getGTestFilters (String path)

Aide pour exécuter le filtre g-test du test.

Notez que les filtres filtrent sur le nom de la fonction uniquement (ex : Google Test "Test") ; tous les « cas de test » de Google Test seront pris en compte.

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

Retour
`String`	l'indicateur de filtre complet à passer au g-test, ou une chaîne vide si aucune n'a été spécifiée

Jetés
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

Renvoie le GTestListener qui fournit des informations de débogage supplémentaires, comme détecte et signale les tests en double si mDisabledDuplicateCheck est faux. Sinon, renvoie l'écouteur transmis.

Paramètres
`listener`	`ITestInvocationListener`

Retour
`ITestInvocationListener`

chargerFilter

protected abstract String loadFilter (String path)

Définissez la méthode de filtre get.

La sous-classe doit implémenter comment obtenir son propre filtre.

Paramètres
`path`	`String` : le chemin complet du fichier filtre.

Retour
`String`	chaîne de filtre.

Jetés
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

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

Paramètres
`runDisabled`	`boolean`