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' |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Ajoute l' |
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' | |
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' | |
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 |
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 |
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 |
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.
getAfterTestCmd
publicgetAfterTestCmd ()
Obtient les commandes shell à exécuter après GTest.
Retour | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Obtient les commandes shell à exécuter avant GTest.
Retour | |
---|---|
getExcludeFilters
publicgetExcludeFilters ()
Renvoie l' ERROR(/Set)
actuelle des filtres d'exclusion.
Retour | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Obtient une expression régulière pour exclure certains fichiers de l'exécution.
Retour | |
---|---|
getGTestFlags
publicgetGTestFlags ()
Obtient des valeurs d'indicateur supplémentaires à transmettre à la commande shell du test natif.
Retour | |
---|---|
getIncludeFilters
publicgetIncludeFilters ()
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 |
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
publicsplit (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 |