GTestBase

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

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

Subclasses diretas conhecidas GTest , HostGTest GTest Um teste que executa um pacote de teste nativo em determinado dispositivo. HostGTest Um teste que executa um pacote de teste nativo.

Subclasses indiretas conhecidas ArtGTest ArtGTest

---

A classe base do gTest

Resumo

Campos
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

Construtores públicos
GTestBase ()

Métodos públicos
void	addAllExcludeFilters ( filters) addAllExcludeFilters ( filters) Adiciona o ERROR(/Set) dos filtros de quais testes excluir.
void	addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Adiciona o ERROR(/Set) de filtros de quais testes incluir.
void	addExcludeFilter (String filter) Adiciona um filtro de quais testes excluir.
void	addIncludeFilter (String filter) Adiciona um filtro de quais testes incluir.
String	cleanFilter (String filter)
void	clearExcludeFilters () Exclua todos os filtros de exclusão atualmente rastreados.
void	clearIncludeFilters () Exclua todos os filtros incluídos atualmente rastreados.
IAbi	getAbi ()
	getAfterTestCmd () Obtém os comandos do shell para serem executados após o GTest.
	getBeforeTestCmd () Obtém os comandos do shell para serem executados antes do GTest.
	getExcludeFilters () Retorna o ERROR(/Set) atual dos filtros de exclusão.
	getFileExclusionFilterRegex () Obtém regex para excluir determinados arquivos da execução.
	getGTestFlags () Obtém valores de sinalizador adicionais para passar para o comando shell do teste nativo.
	getIncludeFilters () Retorna o ERROR(/Set) atual dos filtros de inclusão.
long	getMaxTestTimeMs () Obtém o tempo máximo de execução de um gtest.
String	getModuleName () Obtenha o módulo de teste nativo do Android para executar.
boolean	getRunDisabledTests () Obtenha se o GTest deve executar testes desabilitados.
long	getRuntimeHint () Retorne o tempo de execução esperado do teste em milissegundos.
int	getShardCount () Retorna a contagem de fragmentos atual.
int	getShardIndex () Obtém o índice de estilhaços deste teste.
String	getTestFilterKey () Obtém a chave do filtro de teste.
String	getTestModule () Obtém o nome do módulo.
boolean	isCollectTestsOnly () Obtém apenas invoca o binário de teste para coletar a lista de casos de teste aplicáveis ​​ou não.
boolean	isEnableXmlOutput () Obtém o uso da saída gtest xml para resultados de teste ou não.
boolean	isSharded () Obtém o sinalizador isSharded.
void	setAbi ( IAbi abi)
void	setCollectTestsOnly (boolean shouldCollectTest) Ativa ou desativa o modo de coleta de teste
void	setConfiguration ( IConfiguration configuration) Injeta o IConfiguration em uso.
void	setModuleName (String moduleName) Defina o módulo de teste nativo do Android para ser executado.
void	setShardCount (int shardCount) Define a contagem de estilhaços deste teste.
void	setShardIndex (int shardIndex) Define o índice de estilhaço deste teste.
	split (int shardCountHint) Versão alternativa de split() que também fornece o shardCount que está tentando ser executado.

Métodos protegidos
String	createFlagFile (String filter) Crie um arquivo contendo os filtros que serão usados ​​via --gtest_flagfile para evitar qualquer limitação do SO no tamanho dos argumentos.
void	erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename)
String	getAllGTestFlags (String path) Auxiliar para obter todos os sinalizadores GTest para passar para o comando adb shell.
IConfiguration	getConfiguration () Retorna a configuração de teste.
String	getExceptionMessage (Exception e) Faça o melhor esforço para recuperar uma mensagem descritiva curta e significativa para Exception fornecida
String	getGTestCmdLine (String fullPath, String flags) Método auxiliar para criar o comando gtest a ser executado.
String	getGTestCmdLineWrapper (String fullPath, String flags) Helper que permite que classes derivadas envolvam o comando gtest em alguma outra ferramenta (chroot, strace, gdb e similares).
String	getGTestFilters (String path) Auxiliar para executar o filtro g-test do teste.
ITestInvocationListener	getGTestListener ( ITestInvocationListener listener) Retorna o GTestListener que fornece informações extras de depuração, como detectar e relatar testes duplicados se mDisabledDuplicateCheck for falso.
abstract String	loadFilter (String path) Defina obter método de filtro.
void	setRunDisabled (boolean runDisabled) Defina se o GTest deve executar testes desabilitados.

Campos

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

Construtores públicos

GTestBase

public GTestBase ()

Métodos públicos

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Adiciona o ERROR(/Set) dos filtros de quais testes excluir.

Parâmetros
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Adiciona o ERROR(/Set) de filtros de quais testes incluir.

Parâmetros
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Adiciona um filtro de quais testes excluir.

Parâmetros
filter	String

addIncludeFilter

public void addIncludeFilter (String filter)

Adiciona um filtro de quais testes incluir.

Parâmetros
filter	String

cleanFilter

public String cleanFilter (String filter)

Parâmetros
filter	String

devoluções
String

limparExcluirFiltros

public void clearExcludeFilters ()

Exclua todos os filtros de exclusão atualmente rastreados.

clearIncludeFilters

public void clearIncludeFilters ()

Exclua todos os filtros incluídos atualmente rastreados.

getAbi

public IAbi getAbi ()

devoluções
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

Obtém os comandos do shell para serem executados após o GTest.

devoluções

getBeforeTestCmd

public  getBeforeTestCmd ()

Obtém os comandos do shell para serem executados antes do GTest.

devoluções

getExcludeFilters

public  getExcludeFilters ()

Retorna o ERROR(/Set) atual dos filtros de exclusão.

devoluções

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Obtém regex para excluir determinados arquivos da execução.

devoluções

getGTestFlags

public  getGTestFlags ()

Obtém valores de sinalizador adicionais para passar para o comando shell do teste nativo.

devoluções

getIncludeFilters

public  getIncludeFilters ()

Retorna o ERROR(/Set) atual dos filtros de inclusão.

devoluções

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Obtém o tempo máximo de execução de um gtest.

devoluções
long

getModuleName

public String getModuleName ()

Obtenha o módulo de teste nativo do Android para executar.

devoluções
String	o nome do módulo de teste nativo a ser executado ou nulo se não for definido

getRunDisabledTests

public boolean getRunDisabledTests ()

Obtenha se o GTest deve executar testes desabilitados.

devoluções
boolean	Verdadeiro se testes desabilitados devem ser executados, falso caso contrário

getRuntimeHint

public long getRuntimeHint ()

Retorne o tempo de execução esperado do teste em milissegundos. O tempo é usado para balancear a carga da execução fragmentada

devoluções
long

getShardCount

public int getShardCount ()

Retorna a contagem de fragmentos atual.

devoluções
int

getShardIndex

public int getShardIndex ()

Obtém o índice de estilhaços deste teste.

devoluções
int

getTestFilterKey

public String getTestFilterKey ()

Obtém a chave do filtro de teste.

devoluções
String

getTestModule

public String getTestModule ()

Obtém o nome do módulo.

devoluções
String

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Obtém apenas invoca o binário de teste para coletar a lista de casos de teste aplicáveis ​​ou não.

devoluções
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Obtém o uso da saída gtest xml para resultados de teste ou não.

devoluções
boolean

está fragmentado

public boolean isSharded ()

Obtém o sinalizador isSharded.

devoluções
boolean

setAbi

public void setAbi (IAbi abi)

Parâmetros
abi	IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Ativa ou desativa o modo de coleta de teste

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injeta o IConfiguration em uso.

Parâmetros
configuration	IConfiguration

setModuleName

public void setModuleName (String moduleName)

Defina o módulo de teste nativo do Android para ser executado.

Parâmetros
moduleName	String : O nome do módulo de teste nativo a ser executado

definirShardCount

public void setShardCount (int shardCount)

Define a contagem de estilhaços deste teste.

Parâmetros
shardCount	int

setShardIndex

public void setShardIndex (int shardIndex)

Define o índice de estilhaço deste teste.

Parâmetros
shardIndex	int

dividir

public  split (int shardCountHint)

Versão alternativa de split() que também fornece o shardCount que está tentando ser executado. Isso é útil para alguns executores de teste que às vezes não podem decidir arbitrariamente.

Parâmetros
shardCountHint	int : a tentativa de contagem de fragmentos.

devoluções
	uma coleção de subtestes a serem executados separadamente ou null se o teste não for fragmentável no momento

Métodos protegidos

criarFlagFile

protected String createFlagFile (String filter)

Crie um arquivo contendo os filtros que serão usados ​​via --gtest_flagfile para evitar qualquer limitação do SO no tamanho dos argumentos.

Parâmetros
filter	String : A string do filtro

devoluções
String	O caminho para o arquivo que contém o filtro.

lances
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

apagarPrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parâmetros
filters
filename	String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Auxiliar para obter todos os sinalizadores GTest para passar para o comando adb shell.

Parâmetros
path	String : o caminho completo do binário no dispositivo.

devoluções
String	a String de todos os sinalizadores GTest que devem ser passados ​​para o GTest

lances
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

Retorna a configuração de teste.

devoluções
IConfiguration	um IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Faça o melhor esforço para recuperar uma mensagem descritiva curta e significativa para Exception fornecida

Parâmetros
e	Exception : a Exception

devoluções
String	uma mensagem curta

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Método auxiliar para criar o comando gtest a ser executado.

Parâmetros
fullPath	String : caminho absoluto do sistema de arquivos para gtest binário no dispositivo
flags	String : gtest sinalizadores de execução

devoluções
String	a linha de comando do shell para executar o gtest

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Helper que permite que classes derivadas envolvam o comando gtest em alguma outra ferramenta (chroot, strace, gdb e similares).

Parâmetros
fullPath	String
flags	String

devoluções
String

getGTestFilters

protected String getGTestFilters (String path)

Auxiliar para executar o filtro g-test do teste.

Observe que os filtros filtram apenas o nome da função (por exemplo: Google Test "Test"); todos os "casos de teste" do Google Test serão considerados.

Parâmetros
path	String : o caminho completo do binário no dispositivo.

devoluções
String	o sinalizador de filtro completo para passar para o teste g ou uma string vazia se nenhuma tiver sido especificada

lances
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

Retorna o GTestListener que fornece informações extras de depuração, como detectar e relatar testes duplicados se mDisabledDuplicateCheck for falso. Caso contrário, retorna o ouvinte passado.

Parâmetros
listener	ITestInvocationListener

devoluções
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

Defina obter método de filtro.

A subclasse deve implementar como obter seu próprio filtro.

Parâmetros
path	String : o caminho completo do arquivo de filtro.

devoluções
String	cadeia de filtros.

lances
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Defina se o GTest deve executar testes desabilitados.

Parâmetros
runDisabled	boolean