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 , HostGTest

GTest	Un test qui exécute un package de test natif sur un appareil donné.
HostGTest	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 sont à exclure.
`void`	`addAllIncludeFilters ( filters)` `addAllIncludeFilters ( filters)` Ajoute l' `ERROR(/Set)` des filtres dont les 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 ()` Obtient la ou les commandes shell à exécuter après GTest.
	`getBeforeTestCmd ()` Obtient la ou les commandes shell à exécuter avant GTest.
	`getExcludeFilters ()` Renvoie l' `ERROR(/Set)` actuelle des filtres d'exclusion.
	`getFileExclusionFilterRegex ()` Obtient regex 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)` des filtres d'inclusion.
`long`	`getMaxTestTimeMs ()` Obtient le temps maximum 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 le temps d'exécution attendu 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é de filtre de test.
`String`	`getTestModule ()` Obtient le nom du module.
`boolean`	`isCollectTestsOnly ()` Gets invoque uniquement le binaire de test pour collecter ou non la liste des cas de test applicables.
`boolean`	`isEnableXmlOutput ()` Obtient ou non l'utilisation de la sortie gtest xml pour les résultats des tests.
`boolean`	`isSharded ()` Obtient l'indicateur isSharded.
`void`	`setAbi ( IAbi abi)`
`void`	`setCollectTestsOnly (boolean shouldCollectTest)` Active ou désactive le mode de collecte des tests
`void`	`setConfiguration ( IConfiguration configuration)` Injecte la `IConfiguration` en cours d'utilisation.
`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 qui tente d'être exécuté.

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 obtenir tous les indicateurs GTest à transmettre à la commande adb shell.
`IConfiguration`	`getConfiguration ()` Renvoie la configuration de test.
`String`	`getExceptionMessage (Exception e)` Faites de votre mieux pour récupérer un court message descriptif significatif pour une `ERROR(/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, etc.).
`String`	`getGTestFilters (String path)` Aide pour que le filtre g-test du test s'exécute.
`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 get filter.
`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 sont à exclure.

Paramètres
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Ajoute l' ERROR(/Set) des filtres dont les 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`

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`

getAfterTestCmdgetAfterTestCmd

public  getAfterTestCmd ()

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

Retour

getBeforeTestCmd

public  getBeforeTestCmd ()

Obtient la ou 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 regex 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) des filtres d'inclusion.

Retour

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Obtient le temps maximum 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 les tests désactivés doivent être exécutés, faux sinon

getRuntimeHintgetRuntimeHint

public long getRuntimeHint ()

Renvoie le temps d'exécution attendu du test en millisecondes. Le temps est utilisé pour équilibrer la charge de l'exécution partitionné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é de filtre de test.

Retour
`String`

getTestModule

public String getTestModule ()

Obtient le nom du module.

Retour
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Gets invoque 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 l'utilisation de la sortie gtest xml pour les résultats des tests.

Retour
`boolean`

isSharded

public boolean isSharded ()

Obtient l'indicateur isSharded.

Retour
`boolean`

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 la IConfiguration en cours d'utilisation.

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 qui tente d'être exécuté. 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 partageable

Méthodes protégées

createFlagFile

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`	Chemin d'accès au fichier contenant le filtre.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

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

getAllGTestFlags

protected String getAllGTestFlags (String path)

Aide pour obtenir tous les indicateurs GTest à transmettre à la commande adb shell.

Paramètres
`path`	`String` : le chemin complet du binaire sur le périphérique.

Retour
`String`	l' `ERROR(/String)` de tous les flags GTest qui doivent être passés au GTest

Lance
`DeviceNotAvailableException`

obtenirConfiguration

protected IConfiguration getConfiguration ()

Renvoie la configuration de test.

Retour
`IConfiguration`	une IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Faites de votre mieux pour récupérer un court message descriptif significatif pour une ERROR(/Exception) donnée

Paramètres
`e`	`Exception` : l' `ERROR(/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 fichier binaire gtest sur l'appareil
`flags`	`String` : flags 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, etc.).

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

Retour
`String`

getGTestFiltersgetGTestFilters

protected String getGTestFilters (String path)

Aide pour que le filtre g-test du test s'exécute.

Notez que les filtres filtrent uniquement sur le nom de la fonction (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 le périphérique.

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

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

chargerFiltre

protected abstract String loadFilter (String path)

Définissez la méthode get filter.

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

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

Retour
`String`	chaîne de filtre.

Lance
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

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

Paramètres
`runDisabled`	`boolean`