Base de teste do Google

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

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

Subclasses diretas conhecidas GTest e HostGTest GTest (link em inglês) Um teste que executa um pacote de teste nativo em um determinado dispositivo.  HostGTest (em inglês) Um teste que executa um pacote de teste nativo.

Subclasses indiretas conhecidas ArtGTest (link em inglês) ArtGTest (link em inglês)

---

A classe base de 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) Adiciona o ERROR(/Set) de filtros de quais testes excluir.
void	addAllIncludeFilters( filters) Adiciona o ERROR(/Set) de filtros de quais testes serão incluídos.
void	addExcludeFilter(String filter) Adiciona um filtro de quais testes excluir.
void	addIncludeFilter(String filter) Adiciona um filtro de quais testes devem ser incluídos.
String	cleanFilter(String filter)
void	clearExcludeFilters() Exclua todos os filtros de exclusão rastreados no momento.
void	clearIncludeFilters() Exclua todos os filtros de inclusão rastreados no momento.
IAbi	getAbi()
	getAfterTestCmd() Recebe comandos do shell para serem executados depois do GTest.
	getBeforeTestCmd() Recebe comandos do shell a serem executados antes do GTest.
	getExcludeFilters() Retorna o ERROR(/Set) atual dos filtros de exclusão.
	getFileExclusionFilterRegex() Recebe o regex para excluir a execução de determinados arquivos.
	getGTestFlags() Recebe valores de sinalização adicionais para transmitir ao comando shell do teste nativo.
	getIncludeFilters() Retorna o ERROR(/Set) atual dos filtros de inclusão.
long	getMaxTestTimeMs() Recebe o tempo máximo para a execução de um gtest.
String	getModuleName() Faça o download do módulo de teste nativo do Android para executar.
boolean	getRunDisabledTests() Saiba se o GTest deve executar testes desativados.
long	getRuntimeHint() Retornar o ambiente de execução esperado do teste em milésimos de segundo.
int	getShardCount() Retorna a contagem de fragmentos atual.
int	getShardIndex() Recebe o índice de fragmento deste teste.
String	getTestFilterKey() Recebe a chave do filtro de teste.
String	getTestModule() Recebe o nome do módulo.
boolean	isCollectTestsOnly() Recebe apenas o binário de teste para coletar a lista de casos de teste aplicáveis ou não.
boolean	isEnableXmlOutput() Recebe ou não a saída XML do gtest para resultados de teste.
boolean	isSharded() Recebe a flag isSharded.
void	notifyTestExecution(boolean incompleteTestFound, failedTests) Notificar o pai da execução do teste para que os filtros de inclusão/exclusão possam ser tratados adequadamente para as novas tentativas.
void	setAbi(IAbi abi)
void	setCollectTestsOnly(boolean shouldCollectTest) Ativa ou desativa o modo de coleta de testes
void	setConfiguration(IConfiguration configuration) Injeta o IConfiguration em uso.
void	setModuleName(String moduleName) Configura o módulo de teste nativo do Android para execução.
void	setShardCount(int shardCount) Define a contagem de fragmentos deste teste.
void	setShardIndex(int shardIndex) Define o índice de fragmento deste teste.
	split(int shardCountHint) Versão alternativa de split(), que também fornece o shardCount que é tentado para ser executado.

Métodos protegidos
String	createFlagFile(String filter) Crie um arquivo com os filtros que serão usados via --gtest_flagfile para evitar erros no SO limitação no tamanho de args.
void	erasePrependedFileName( filters, String filename)
String	getAllGTestFlags(String path) Auxiliar para que todas as flags do GTest sejam transmitidas ao comando do shell do adb.
IConfiguration	getConfiguration() Retorna a configuração do teste.
String	getExceptionMessage(Exception e) Tente recuperar uma mensagem descritiva breve e significativa para um determinado Exception
String	getGTestCmdLine(String fullPath, String flags) Método auxiliar para criar o comando gtest a ser executado.
String	getGTestCmdLineWrapper(String fullPath, String flags) O assistente que permite que as classes derivadas envolvam o comando gtest com alguma outra ferramenta (chroot, strace, gdb e semelhantes).
String	getGTestFilters(String path) Auxiliar para executar o filtro g-test.
ITestInvocationListener	getGTestListener(ITestInvocationListener listener) Retorna o GTestListener que fornece informações extras de depuração, como detecta e relata testes duplicados se mDisabledDuplicateCheck for falso.
abstract String	loadFilter(String path) Defina o método get do filtro.
void	setRunDisabled(boolean runDisabled) Defina se o GTest deve executar testes desativados.

Campos

EXTENSÃO_FILTRO

protected static final String FILTER_EXTENSION

ARQUIVO_DO_GTEST

protected static final String GTEST_FLAG_FILE

FILTRO DE FLAG_GENT

protected static final String GTEST_FLAG_FILTER

TESTE__FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

TESTE_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

TESTE_FLAG_EXECUTAR_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

SAÍDA_GTEST_XML_

protected static final String GTEST_XML_OUTPUT

Construtores públicos

Base de teste do Google

public GTestBase ()

Métodos públicos

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

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

Parâmetros
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Adiciona o ERROR(/Set) de filtros de quais testes serão incluídos.

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 devem ser incluídos.

Parâmetros
filter	String

filtro de limpeza

public String cleanFilter (String filter)

Parâmetros
filter	String

Retorna
String

limparExcluirFiltros

public void clearExcludeFilters ()

Exclua todos os filtros de exclusão rastreados no momento.

ClearIncludeFilters

public void clearIncludeFilters ()

Exclua todos os filtros de inclusão rastreados no momento.

GetAbi

public IAbi getAbi ()

Retorna
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

Recebe comandos do shell para serem executados depois do GTest.

Retorna

getBeforeTestCmd

public  getBeforeTestCmd ()

Recebe comandos do shell a serem executados antes do GTest.

Retorna

getExcludeFilters

public  getExcludeFilters ()

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

Retorna

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Recebe o regex para excluir a execução de determinados arquivos.

Retorna

getGTestFlags

public  getGTestFlags ()

Recebe valores de sinalização adicionais para transmitir ao comando shell do teste nativo.

Retorna

getIncludeFilters

public  getIncludeFilters ()

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

Retorna

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Recebe o tempo máximo para a execução de um gtest.

Retorna
long

getModuleName

public String getModuleName ()

Faça o download do módulo de teste nativo do Android para executar.

Retorna
String	o nome do módulo de teste nativo a ser executado, ou nulo, se não estiver definido

getRunDisabledTests

public boolean getRunDisabledTests ()

Saiba se o GTest deve executar testes desativados.

Retorna
boolean	"True", se for necessário executar testes desativados; caso contrário, "false".

getRuntimeHint

public long getRuntimeHint ()

Retornar o ambiente de execução esperado do teste em milésimos de segundo. O tempo é usado para balancear a carga da execução fragmentada

Retorna
long

getShardCount

public int getShardCount ()

Retorna a contagem de fragmentos atual.

Retorna
int

getShardIndex

public int getShardIndex ()

Recebe o índice de fragmento deste teste.

Retorna
int

getTestFilterKey

public String getTestFilterKey ()

Recebe a chave do filtro de teste.

Retorna
String

getTestModule

public String getTestModule ()

Recebe o nome do módulo.

Retorna
String

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Recebe apenas o binário de teste para coletar a lista de casos de teste aplicáveis ou não.

Retorna
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Recebe ou não a saída XML do gtest para resultados de teste.

Retorna
boolean

isSharded

public boolean isSharded ()

Recebe a flag isSharded.

Retorna
boolean

notificationTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Notificar o pai da execução do teste para que os filtros de inclusão/exclusão possam ser tratados adequadamente para as novas tentativas.

Parâmetros
incompleteTestFound	boolean
failedTests

SetAbi

public void setAbi (IAbi abi)

Parâmetros
abi	IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Ativa ou desativa o modo de coleta de testes

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injeta o IConfiguration em uso.

Parâmetros
configuration	IConfiguration

setModuleName

public void setModuleName (String moduleName)

Configura o módulo de teste nativo do Android para execução.

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

setShardCount

public void setShardCount (int shardCount)

Define a contagem de fragmentos deste teste.

Parâmetros
shardCount	int

setShardIndex

public void setShardIndex (int shardIndex)

Define o índice de fragmento deste teste.

Parâmetros
shardIndex	int

dividir

public  split (int shardCountHint)

Versão alternativa de split(), que também fornece o shardCount que é tentado para ser executado. Isso é útil para alguns executores de testes que não podem decidir arbitrariamente algumas vezes.

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

Retorna
	uma coleção de subtestes a serem executados separadamente ou null se o teste for não fragmentado no momento

Métodos protegidos

createFlagFile

protected String createFlagFile (String filter)

Crie um arquivo com os filtros que serão usados via --gtest_flagfile para evitar erros no SO limitação no tamanho de args.

Parâmetros
filter	String: a string de filtro

Retorna
String	O caminho para o arquivo que contém o filtro.

Gera
	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 que todas as flags do GTest sejam transmitidas ao comando do shell do adb.

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

Retorna
String	o String de todas as sinalizações do GTest que precisam ser transmitidas para o GTest.

Gera
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

Retorna a configuração do teste.

Retorna
IConfiguration	um IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Tente recuperar uma mensagem descritiva breve e significativa para um determinado Exception

Parâmetros
e	Exception: o Exception

Retorna
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 o binário gtest no dispositivo
flags	String: sinalizações de execução de gtest

Retorna
String	a linha de comando do shell a ser executada para o gtest

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

O assistente que permite que as classes derivadas envolvam o comando gtest com alguma outra ferramenta (chroot, strace, gdb e semelhantes).

Parâmetros
fullPath	String
flags	String

Retorna
String

getGTestFilters

protected String getGTestFilters (String path)

Auxiliar para executar o filtro g-test.

Os filtros filtram somente o nome da função (por exemplo, Google Test "Test"); todo o Google Teste "Casos de teste" serão consideradas.

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

Retorna
String	a sinalização de filtro completa para passar ao g-test, ou uma string vazia se nenhuma tiver sido especificado

Gera
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

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

Parâmetros
listener	ITestInvocationListener

Retorna
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

Defina o método get do filtro.

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

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

Retorna
String	string de filtro.

Gera
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Defina se o GTest deve executar testes desativados.

Parâmetros
runDisabled	boolean