O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

GTestBase

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	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 (em inglês)

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)` Adiciona o `ERROR(/Set)` de filtros de quais testes serão excluídos.
`void`	`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 devem ser incluídos.
`String`	`cleanFilter(String filter)`
`void`	`clearExcludeFilters()` Excluir todos os filtros de exclusão que estão sendo monitorados.
`void`	`clearIncludeFilters()` Exclua todos os filtros de inclusão rastreados no momento.
`IAbi`	`getAbi()`
	`getAfterTestCmd()` Recebe comandos do shell para execução após o GTest.
	`getBeforeTestCmd()` Recebe comandos do shell para execução antes do GTest.
	`getExcludeFilters()` Retorna o `ERROR(/Set)` atual dos filtros de exclusão.
	`getFileExclusionFilterRegex()` Recebe regex para excluir a execução de determinados arquivos.
	`getGTestFlags()` Recebe valores de flag 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()` Baixe o módulo de teste nativo do Android para executá-lo.
`boolean`	`getRunDisabledTests()` Saiba se o GTest deve executar testes desativados.
`long`	`getRuntimeHint()` Retorna o tempo de execução esperado do teste em milissegundos.
`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()` Chama apenas o binário de teste para coletar a lista de casos de teste aplicáveis ou não.
`boolean`	`isEnableXmlOutput()` Recebe a saída XML do gtest para resultados de teste ou não.
`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 processados corretamente nas tentativas de nova tentativa.
`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)` Configure 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 fragmentos desse teste.
	`split(int shardCountHint)` Versão alternativa de `split()`, que também fornece o shardCount que é tentado ser executado.

Métodos protegidos
`String`	`createFlagFile(String filter)` Crie um arquivo com os filtros que serão usados com --gtest_flagfile para evitar qualquer limitação do SO no tamanho de argumentos.
`void`	`erasePrependedFileName( filters, String filename)`
`String`	`getAllGTestFlags(String path)` Ajudante para receber todas as flags do GTest para transmitir ao comando adb shell.
`IConfiguration`	`getConfiguration()` Retorna a configuração do teste.
`String`	`getExceptionMessage(Exception e)` Tente recuperar uma mensagem descritiva curta e significativa para um determinado `Exception` da melhor forma possível
`String`	`getGTestCmdLine(String fullPath, String flags)` Método auxiliar para criar o comando gtest a ser executado.
`String`	`getGTestCmdLineWrapper(String fullPath, String flags)` Ajudante que permite que classes derivadas envolvam o comando gtest em outra ferramenta (chroot, strace, gdb e similares).
`String`	`getGTestFilters(String path)` Ajudante para receber o filtro do teste G do teste a ser executado.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` 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 de filtro "get".
`void`	`setRunDisabled(boolean runDisabled)` Define se o GTest precisa executar testes desativados.

Campos

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

ARQUIVO_DO_GTEST

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

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 serão excluídos.

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 serão excluídos.

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`

Retorna
`String`

clearExcludeFilters

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 execução após o GTest.

Retorna

getBeforeTestCmd

public  getBeforeTestCmd ()

Recebe comandos do shell para execução 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 flag 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 módulo de teste nativo do Android funcionar.

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

getRunDisabledTests

public boolean getRunDisabledTests ()

Recebe se o GTest precisa executar testes desativados.

Retorna
`boolean`	Verdadeiro se os testes desativados precisam ser executados. Caso contrário, é falso.

getRuntimeHint

public long getRuntimeHint ()

Retorna o tempo de execução esperado do teste em milissegundos. 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 ()

Chama 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 a saída XML do gtest para resultados de teste ou não.

Retorna
`boolean`

isSharded

public boolean isSharded ()

Recebe a flag isSharded.

Retorna
`boolean`

notifyTestExecution

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 processados corretamente nas tentativas de nova tentativa.

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)

Configure 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 desse 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 ser executado. Isso é útil para alguns executores de teste que às vezes não podem decidir arbitrariamente.

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

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

Métodos protegidos

createFlagFile

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 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`

erasePrependedFileName

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 flags do GTest que precisam ser transmitidas para o GTest

Gera
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Retorna a configuração do teste.

Retorna
`IConfiguration`	uma IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Fazer o possível para recuperar uma mensagem descritiva curta e significativa para o 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`: flags de execução do gtest

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

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

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

Parâmetros
`fullPath`	`String`
`flags`	`String`

Retorna
`String`

getGTestFilters

protected String getGTestFilters (String path)

Auxiliar para executar o filtro g-test.

Os filtros são aplicados apenas ao nome da função (por exemplo, "Teste" do Google Teste). Todos os "Test Cases" do Google Teste serão considerados.

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

Retorna
`String`	A flag de filtro completa a ser transmitida para o teste g ou uma string vazia, se nenhuma tiver sido especificada

Gera
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

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

Parâmetros
`listeners`	`ITestInvocationListener`

Retorna
`ITestInvocationListener`

loadFilter

protected abstract String loadFilter (String path)

Defina o método de filtro "get".

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`