Esta página foi traduzida pela API Cloud Translation.

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

Teste GT	Um teste que executa um pacote de teste nativo em determinado dispositivo.
HostGTest	Um teste que executa um pacote de testes nativo.

Subclasses indiretas conhecidas

ArteGTest

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)` de filtros dos quais testes serão excluídos.
`void`	`addAllIncludeFilters ( filters)` `addAllIncludeFilters ( filters)` Adiciona o `ERROR(/Set)` de filtros dos 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 rastreados atualmente.
`void`	`clearIncludeFilters ()` Exclua todos os filtros de inclusão atualmente rastreados.
`IAbi`	`getAbi ()`
	`getAfterTestCmd ()` Obtém comandos shell para serem executados após o GTest.
	`getBeforeTestCmd ()` Faz com que os comandos do shell sejam executados antes do GTest.
	`getExcludeFilters ()` Retorna o `ERROR(/Set)` atual dos filtros de exclusão.
	`getFileExclusionFilterRegex ()` Obtém regex para excluir a execução de determinados arquivos.
	`getGTestFlags ()` Obtém valores de sinalização 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 para a execução de um gtest.
`String`	`getModuleName ()` Faça com que o módulo de teste nativo do Android seja executado.
`boolean`	`getRunDisabledTests ()` Descubra 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 fragmentos 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 invocar o binário de teste para coletar uma lista de casos de teste aplicáveis ou não.
`boolean`	`isEnableXmlOutput ()` Obtém a saída xml do gtest para resultados de teste ou não.
`boolean`	`isSharded ()` Obtém o sinalizador isSharded.
`void`	`notifyTestExecution (boolean incompleteTestFound, failedTests)` `notifyTestExecution (boolean incompleteTestFound, failedTests)` Notificar o pai sobre a execução do teste, para que os filtros de inclusão/exclusão possam ser manipulados 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)` 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 deste teste.
	`split (int shardCountHint)` Versão alternativa de `split()` que também fornece o shardCount que tenta 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 sistema operacional no tamanho dos argumentos.
`void`	`erasePrependedFileName ( filters, String filename)` `erasePrependedFileName ( filters, String filename)`
`String`	`getAllGTestFlags (String path)` Auxiliar para fazer com que todos os sinalizadores GTest passem para o comando adb shell.
`IConfiguration`	`getConfiguration ()` Retorna a configuração de teste.
`String`	`getExceptionMessage (Exception e)` Faça o melhor esforço possível para recuperar uma mensagem descritiva curta e significativa para determinada `Exception`
`String`	`getGTestCmdLine (String fullPath, String flags)` Método auxiliar para construir o comando gtest a ser executado.
`String`	`getGTestCmdLineWrapper (String fullPath, String flags)` Auxiliar 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 detecta e relata testes duplicados se mDisabledDuplicateCheck for falso.
`abstract String`	`loadFilter (String path)` Defina o método get filter.
`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) de filtros dos quais testes serão excluídos.

Parâmetros
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Adiciona o ERROR(/Set) de filtros dos 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`

limparFiltro

public String cleanFilter (String filter)

Parâmetros
`filter`	`String`

Devoluções
`String`

limparExcludeFilters

public void clearExcludeFilters ()

Exclua todos os filtros de exclusão rastreados atualmente.

limparIncludeFilters

public void clearIncludeFilters ()

Exclua todos os filtros de inclusão atualmente rastreados.

getAbi

public IAbi getAbi ()

Devoluções
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

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

Devoluções

getBeforeTestCmd

public  getBeforeTestCmd ()

Faz com que os comandos do shell sejam executados antes do GTest.

Devoluções

getExcludeFilters

public  getExcludeFilters ()

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

Devoluções

getFileExclusãoFilterRegex

public  getFileExclusionFilterRegex ()

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

Devoluções

getGTestFlags

public  getGTestFlags ()

Obtém valores de sinalização 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 para a execução de um gtest.

Devoluções
`long`

getModuleName

public String getModuleName ()

Faça com que o módulo de teste nativo do Android seja executado.

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

getRunDisabledTests

public boolean getRunDisabledTests ()

Descubra se o GTest deve executar testes desabilitados.

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

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 fragmentos 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 invocar o binário de teste para coletar uma lista de casos de teste aplicáveis ou não.

Devoluções
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

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

Devoluções
`boolean`

é fragmentado

public boolean isSharded ()

Obtém o sinalizador isSharded.

Devoluções
`boolean`

notificarTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Notificar o pai sobre a execução do teste, para que os filtros de inclusão/exclusão possam ser manipulados 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

setConfiguração

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 deste teste.

Parâmetros
`shardCount`	`int`

setShardIndex

public void setShardIndex (int shardIndex)

Define o índice de fragmentos deste teste.

Parâmetros
`shardIndex`	`int`

dividir

public  split (int shardCountHint)

Versão alternativa de split() que também fornece o shardCount que tenta ser executado. Isso é útil para alguns executores de teste que às vezes não conseguem 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 puder ser fragmentado 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 sistema operacional 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.

Lança
	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 fazer com que todos os sinalizadores GTest passem 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 flags GTest que devem ser passados para o GTest

Lança
`DeviceNotAvailableException`

getConfiguração

protected IConfiguration getConfiguration ()

Retorna a configuração de teste.

Devoluções
`IConfiguration`	um IConfiguração

getExceptionMessage

protected String getExceptionMessage (Exception e)

Faça o melhor esforço possível para recuperar uma mensagem descritiva curta e significativa para determinada Exception

Parâmetros
`e`	`Exception` : a `Exception`

Devoluções
`String`	uma mensagem curta

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Método auxiliar para construir 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` : sinalizadores de execução gtest

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

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Auxiliar 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 a ser passado para o teste g ou uma string vazia se nenhuma tiver sido especificada

Lança
`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 ouvinte transmitido.

Parâmetros
`listener`	`ITestInvocationListener`

Devoluções
`ITestInvocationListener`

carregarFiltro

protected abstract String loadFilter (String path)

Defina o método get filter.

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 filtro.

Lança
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Defina se o GTest deve executar testes desabilitados.

Parâmetros
`runDisabled`	`boolean`