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 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' | |
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' | |
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 |
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 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 |
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 |
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.
getAfterTestCmdgetAfterTestCmd
publicgetAfterTestCmd ()
Obtient la ou les commandes shell à exécuter après GTest.
Retour | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Obtient la ou les commandes shell à exécuter avant GTest.
Retour | |
---|---|
getExcludeFilters
publicgetExcludeFilters ()
Renvoie l' ERROR(/Set)
actuelle des filtres d'exclusion.
Retour | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Obtient regex 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)
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 |
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
publicsplit (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 |