GTestBase

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

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


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