GTestBase

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

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


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 indiquant les 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 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 est 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 de test

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)

Autre version de split(), qui fournit également le nombre de segments demandés pour l'exécution.

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 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)

Faites de votre mieux pour récupérer un message descriptif court et pertinent pour le 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)

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

ITestInvocationListener getGTestListener(ITestInvocationListener... listeners)

Renvoie le GTestListener qui fournit des informations de débogage supplémentaires, telles que 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)

Indiquez si GTest doit exécuter des 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 la 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 les tests désactivés doivent être exécutés, "false" dans le cas contraire

getRuntimeHint

public long getRuntimeHint ()

Renvoyez l'environnement d'exécution attendu 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 ()

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 ()

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

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 segments 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
un ensemble de sous-tests à exécuter séparément ou null si le test n'est pas actuellement partitionnable

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 limite du système d'exploitation en termes de taille d'argument.

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)

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)

Outil d'aide permettant aux classes dérivées d'encapsuler la commande gtest dans 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