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

Base de test G

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

Test G	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

Test ArtG

La 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 le `ERROR(/Set)` des filtres des tests à exclure.
`void`	`addAllIncludeFilters( filters)` Ajoute le `ERROR(/Set)` des filtres des tests à inclure.
`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()` Supprimer tous les filtres d'exclusion actuellement suivis
`void`	`clearIncludeFilters()` Supprimer tous les filtres "Inclure" actuellement suivis
`IAbi`	`getAbi()`
	`getAfterTestCmd()` Récupère les commandes shell à exécuter après GTest.
	`getBeforeTestCmd()` Récupère les commandes shell à exécuter avant GTest.
	`getExcludeFilters()` Renvoie la valeur `ERROR(/Set)` actuelle des filtres d'exclusion.
	`getFileExclusionFilterRegex()` Récupère une expression régulière pour exclure l'exécution de certains fichiers.
	`getGTestFlags()` Récupère des valeurs d'indicateurs supplémentaires à transmettre à la commande shell du test natif.
	`getIncludeFilters()` Renvoie la valeur `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()` Détermine si GTest doit exécuter des tests désactivés.
`long`	`getRuntimeHint()` Renvoyez l'environnement d'exécution attendu du test dans millisecondes.
`int`	`getShardCount()` Renvoie le nombre de segments actuel.
`int`	`getShardIndex()` Récupère l'index de partition 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()` Récupère uniquement le binaire de test pour collecter ou non la liste des scénarios de test applicables.
`boolean`	`isEnableXmlOutput()` Les GET utilisent ou non la sortie XML gtest pour afficher les résultats des tests.
`boolean`	`isSharded()` Récupère l'indicateur isSharded.
`void`	`notifyTestExecution(boolean incompleteTestFound, failedTests)` Avertir le parent de l'exécution du test, afin que les filtres d'inclusion/exclusion soient gérés correctement pour les nouvelles tentatives.
`void`	`setAbi(IAbi abi)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Active ou désactive le mode de collecte test
`void`	`setConfiguration(IConfiguration configuration)` Il injecte les `IConfiguration` en cours d'utilisation.
`void`	`setModuleName(String moduleName)` Définissez le module de test natif Android à exécuter.
`void`	`setShardCount(int shardCount)` Définit le nombre de segments de ce test.
`void`	`setShardIndex(int shardIndex)` Définit l'index de segmentation de ce test.
	`split(int shardCountHint)` Autre version de `split()`, qui fournit également le nombre de segments tentés à 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 tout système d'exploitation la taille des arguments est limitée.
`void`	`erasePrependedFileName( filters, String filename)`
`String`	`getAllGTestFlags(String path)` Aide permettant d'obtenir tous les indicateurs GTest à transmettre à la commande shell adb.
`IConfiguration`	`getConfiguration()` Renvoie la configuration de test.
`String`	`getExceptionMessage(Exception e)` Faites de votre mieux pour essayer de récupérer un message descriptif court pertinent pour `Exception`
`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)` Outil d'aide qui permet aux classes dérivées d'encapsuler la commande gtest dans un autre outil (chroot, strace, gdb et autres).
`String`	`getGTestFilters(String path)` Outil d'aide permettant d'obtenir le filtre g-test du test à exécuter.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener listener)` Renvoie le GTestListener qui fournit des informations de débogage supplémentaires, telles que les détections et signale les tests en double si la valeur de mDisabledDuplicateCheck est "false".
`abstract String`	`loadFilter(String path)` Définissez la méthode get filter.
`void`	`setRunDisabled(boolean runDisabled)` Indiquez si GTest doit exécuter des tests désactivés.

Champs

EXTENSION_FILTRE

protected static final String FILTER_EXTENSION

TEST_FICHIER_FLAG

protected static final String GTEST_FLAG_FILE

FILTRE_FLAG_TEST_G

protected static final String GTEST_FLAG_FILTER

TESTS_LISTE_FLAG_GTEST

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

TEST_DE_SORTIE_XML_GTEST

protected static final String GTEST_XML_OUTPUT

Constructeurs publics

Base de test G

public GTestBase ()

Méthodes publiques

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

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

Paramètres
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Paramètres
`filters`

addExclureFiltre

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`

cleanFilter

public String cleanFilter (String filter)

Paramètres
`filter`	`String`

Renvoie
`String`

ClearExcludeFilters

public void clearExcludeFilters ()

Supprimer tous les filtres d'exclusion actuellement suivis

ClearIncludeFilters

public void clearIncludeFilters ()

Supprimer tous les filtres "Inclure" actuellement suivis

getAbi

public IAbi getAbi ()

Renvoie
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

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

Renvoie

getBeforeTestCmd

public  getBeforeTestCmd ()

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

Renvoie

getExcludeFilters

public  getExcludeFilters ()

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

Renvoie

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

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

Renvoie

GetGTestFlags

public  getGTestFlags ()

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

Renvoie

getIncludeFilters

public  getIncludeFilters ()

Renvoie la valeur 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 "null" si cette valeur n'est pas définie

getRunDisabledTests

public boolean getRunDisabledTests ()

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

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

getRuntimeHint

public long getRuntimeHint ()

Renvoyez l'environnement d'exécution attendu du test dans millisecondes. Le temps est utilisé pour équilibrer la charge de l'exécution segmentée

Renvoie
`long`

getShardCount

public int getShardCount ()

Renvoie le nombre de segments actuel.

Renvoie
`int`

getShardIndex

public int getShardIndex ()

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

Renvoie
`int`

getTestFilterKey

public String getTestFilterKey ()

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

Renvoie
`String`

GetTestModule (getTestModule)

public String getTestModule ()

Récupère le nom du module.

Renvoie
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Récupère uniquement le binaire de test pour collecter ou non la liste des scénarios de test applicables.

Renvoie
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Les GET utilisent ou non la sortie XML gtest pour afficher les résultats des tests.

Renvoie
`boolean`

Partition

public boolean isSharded ()

Récupère l'indicateur isSharded.

Renvoie
`boolean`

notifierTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Avertir 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 test

Définir une configuration

public void setConfiguration (IConfiguration configuration)

Il injecte les IConfiguration en cours d'utilisation.

Paramètres
`configuration`	`IConfiguration`

DéfinirNomModule

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 segments de ce test.

Paramètres
`shardCount`	`int`

setShardIndex

public void setShardIndex (int shardIndex)

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

Paramètres
`shardIndex`	`int`

split

public  split (int shardCountHint)

Autre version de split(), qui fournit également le nombre de segments tentés à exécuter. Cela est utile pour certains exécuteurs de test qui ne peuvent pas toujours décider arbitrairement.

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

Renvoie
	Une collection de sous-tests à exécuter séparément ou `null` si le test est actuellement non segmentable

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 tout système d'exploitation la taille des arguments est limitée.

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`

deletePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

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

GetAllGTestFlags

protected String getAllGTestFlags (String path)

Aide 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`	Le paramètre `String` de tous les indicateurs GTest à transmettre à l'outil

Génère
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Renvoie la configuration de test.

Renvoie
`IConfiguration`	une iConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Faites de votre mieux pour essayer de récupérer un message descriptif court pertinent pour Exception

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 au système de fichiers vers le binaire gtest sur l'appareil
`flags`	`String`: options d'exécution gtest

Renvoie
`String`	la ligne de commande shell pour qu'elle s'exécute pour le gtest

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Outil d'aide qui permet aux classes dérivées d'encapsuler la commande gtest dans un autre outil (chroot, strace, gdb et autres).

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

Renvoie
`String`

getGTestFilters

protected String getGTestFilters (String path)

Outil d'aide permettant d'obtenir le filtre g-test du test à exécuter.

Notez que les filtres filtrent uniquement sur le nom de la fonction (par exemple, Google Test "Test"). tout Google Tester les "scénarios de test" seront prises en compte.

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

Renvoie
`String`	l'indicateur de filtre complet à transmettre au test g, ou une chaîne vide si aucun n'a été spécifié

Génère
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

Renvoie le GTestListener qui fournit des informations de débogage supplémentaires, telles que les détections et signale les tests en double si la valeur de mDisabledDuplicateCheck est "false". Dans le cas contraire, elle renvoie la valeur l'écouteur.

Paramètres
`listener`	`ITestInvocationListener`

Renvoie
`ITestInvocationListener`

loadFilter

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`: chemin d'accès complet au fichier de filtre.

Renvoie
`String`	chaîne de filtre.

Génère
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

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

Paramètres
`runDisabled`	`boolean`