GTestBase

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 GTest 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 ArtGTest ArtGTest

---

Classe de base de gTest

Résumé

Constantes
String	FILTER_EXTENSION
String	GTEST_FLAG_FILE
String	GTEST_FLAG_FILTER
String	GTEST_FLAG_LIST_TESTS
String	GTEST_FLAG_PRINT_TIME
String	GTEST_FLAG_RUN_DISABLED_TESTS
String	GTEST_XML_OUTPUT

Constructeurs publics
GTestBase()

Méthodes publiques
void	addAllExcludeFilters(Set<String> filters) Ajoute le Set des filtres des tests à exclure.
void	addAllIncludeFilters(Set<String> filters) Ajoute le Set de filtres pour les tests à inclure.
void	addExcludeFilter(String filter) Ajoute un filtre pour exclure certains tests.
void	addIncludeFilter(String filter) Ajoute un filtre pour inclure certains tests.
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()
List<String>	getAfterTestCmd() Obtient la ou les commandes shell à exécuter après GTest.
List<String>	getBeforeTestCmd() Obtient les commandes shell à exécuter avant GTest.
Set<String>	getExcludeFilters() Renvoie le Set actuel des filtres d'exclusion.
Set<String>	getFileExclusionFilterRegex() Obtient l'expression régulière permettant d'empêcher l'exécution de certains fichiers.
List<String>	getGTestFlags() Obtient des valeurs d'indicateur supplémentaires à transmettre à la commande shell du test natif.
Set<String>	getIncludeFilters() Renvoie le Set actuel des filtres d'inclusion.
long	getMaxTestTimeMs() Obtient la durée maximale d'exécution d'un test gtest.
String	getModuleName() Obtenez le module de test natif Android à exécuter.
boolean	getRunDisabledTests() Indique si GTest doit exécuter les tests désactivés.
long	getRuntimeHint() Renvoie la durée d'exécution attendue du test en millisecondes.
int	getShardCount() Renvoie le nombre actuel de partitions.
int	getShardIndex() Récupère l'index du shard de ce test.
String	getTestFilterKey() Récupère la clé de filtre de test.
String	getTestModule() Obtient le nom du module.
boolean	isCollectTestsOnly() Les requêtes GET n'invoquent le binaire de test que 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.
boolean	isSharded() Récupère l'indicateur isSharded.
void	notifyTestExecution(boolean incompleteTestFound, Set<String> failedTests) Avertir le parent de l'exécution du test afin que les filtres d'inclusion/d'exclusion puissent être gérés correctement pour les tentatives de réessai.
void	setAbi(IAbi abi)
void	setCollectTestsOnly(boolean shouldCollectTest) Active ou désactive le mode de collecte des tests
void	setConfiguration(IConfiguration configuration) Injecte le 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 partitions de ce test.
void	setShardIndex(int shardIndex) Définit l'index du shard de ce test.
Collection<IRemoteTest>	split(int shardCountHint) Version alternative de split() qui fournit également le shardCount qui est tenté d'être exécuté.

Méthodes protégées
String	convertName(String gtestFlagName)
String	createFlagFile(String filter) Créez un fichier contenant les filtres qui seront utilisés via --gtest_flagfile pour éviter toute limitation de taille des arguments par l'OS.
void	erasePrependedFileName(Set<String> filters, String filename)
String	getAllGTestFlags(String path) Helper permettant d'obtenir tous les indicateurs GTest à transmettre à la commande adb shell.
IConfiguration	getConfiguration() Renvoie la configuration du 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 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) Assistant pour obtenir le filtre de test g-test à exécuter.
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".
abstract String	loadFilter(String path) Définissez la méthode de filtrage "get".
void	setRunDisabled(boolean runDisabled) Définissez si GTest doit exécuter les tests désactivés.

Constantes

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

Valeur constante : ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Constant Value: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

Constant Value: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Valeur de constante : "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Valeur de constante : "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Valeur de constante : "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Valeur de constante : "--gtest_output=xml:%s"

Constructeurs publics

GTestBase

public GTestBase ()

Méthodes publiques

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Ajoute le Set des filtres des tests à exclure.

Paramètres
filters	Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Ajoute le Set de filtres pour les tests à inclure.

Paramètres
filters	Set

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre pour exclure certains tests.

Paramètres
filter	String

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre pour inclure certains tests.

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 List<String> getAfterTestCmd ()

Obtient la ou les commandes shell à exécuter après GTest.

Renvoie
List<String>

getBeforeTestCmd

public List<String> getBeforeTestCmd ()

Obtient les commandes shell à exécuter avant GTest.

Renvoie
List<String>

getExcludeFilters

public Set<String> getExcludeFilters ()

Renvoie le Set actuel des filtres d'exclusion.

Renvoie
Set<String>

getFileExclusionFilterRegex

public Set<String> getFileExclusionFilterRegex ()

Obtient l'expression régulière permettant d'empêcher l'exécution de certains fichiers.

Renvoie
Set<String>

getGTestFlags

public List<String> getGTestFlags ()

Obtient des valeurs d'indicateur supplémentaires à transmettre à la commande shell du test natif.

Renvoie
List<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

Renvoie le Set actuel des filtres d'inclusion.

Renvoie
Set<String>

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Obtient la durée maximale d'exécution d'un test gtest.

Renvoie
long

getModuleName

public String getModuleName ()

Obtenez le module de test natif Android à exécuter.

Renvoie
String	Nom du module de test natif à exécuter ou valeur nulle si non défini

getRunDisabledTests

public boolean getRunDisabledTests ()

Indique si GTest doit exécuter les 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 ()

Renvoie la durée d'exécution attendue du test en millisecondes. Ce temps est utilisé pour équilibrer la charge de l'exécution fragmentée.

Renvoie
long

getShardCount

public int getShardCount ()

Renvoie le nombre actuel de partitions.

Renvoie
int

getShardIndex

public int getShardIndex ()

Récupère l'index du 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 ()

Obtient le nom du module.

Renvoie
String

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Les requêtes GET n'invoquent le binaire de test que pour collecter la liste des scénarios de test applicables ou non.

Renvoie
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Indique si la sortie XML gtest est utilisée pour les résultats des tests.

Renvoie
boolean

isSharded

public boolean isSharded ()

Récupère l'indicateur isSharded.

Renvoie
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                Set<String> failedTests)

Avertir le parent de l'exécution du test afin que les filtres d'inclusion/d'exclusion puissent être gérés correctement pour les tentatives de réessai.

Paramètres
incompleteTestFound	boolean
failedTests	Set

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 le IConfiguration en cours d'utilisation.

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

Paramètres
shardCount	int

setShardIndex

public void setShardIndex (int shardIndex)

Définit l'index du shard de ce test.

Paramètres
shardIndex	int

split

public Collection<IRemoteTest> split (int shardCountHint)

Version alternative de split() qui fournit également le shardCount qui est tenté d'être exécuté. Cela est utile pour certains lanceurs de tests qui ne peuvent pas décider arbitrairement parfois.

Paramètres
shardCountHint	int : nombre de partitions tentées.

Renvoie
Collection<IRemoteTest>	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

convertName

protected String convertName (String gtestFlagName)

Paramètres
gtestFlagName	String

Renvoie
String

createFlagFile

protected String createFlagFile (String filter)

Créez un fichier contenant les filtres qui seront utilisés via --gtest_flagfile pour éviter toute limitation de taille des arguments par l'OS.

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

erasePrependedFileName

protected void erasePrependedFileName (Set<String> filters, 
                String filename)

Paramètres
filters	Set
filename	String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Helper permettant d'obtenir tous les indicateurs GTest à transmettre à la commande adb shell.

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 du test.

Renvoie
IConfiguration	IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Faites de votre mieux pour récupérer un message descriptif court et pertinent pour le Exception donné.

Paramètres
e	Exception : Exception

Renvoie
String	un message court

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 d'accès absolu du système de fichiers au binaire gtest sur l'appareil
flags	String : indicateurs d'exécution gtest

Renvoie
String	Ligne de commande du shell à exécuter pour le test 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

Renvoie
String

getGTestFilters

protected String getGTestFilters (String path)

Assistant pour obtenir le filtre de test g-test à exécuter.

Notez que les filtres ne s'appliquent qu'au nom de la fonction (par exemple, "Test" de Google Test) ; tous les "cas de test" de Google Test seront pris en compte.

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

Renvoie
String	Indicateur de filtre complet à transmettre au test G, ou chaîne vide si aucun n'a été spécifié

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 le listener 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 façon d'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)

Définissez si GTest doit exécuter les tests désactivés.

Paramètres
runDisabled	boolean