A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

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, HostGTest

GTest	Um teste que executa um pacote de teste nativo em um determinado dispositivo.
HostGTest	Um teste que executa um pacote de teste nativo.

Subclasses indiretas conhecidas

ArtGTest

A classe base do gTest.

Resumo

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`

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 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()` Exclui todos os filtros de exclusão rastreados no momento.
`void`	`clearIncludeFilters()` Exclui todos os filtros de inclusão rastreados no momento.
`IAbi`	`getAbi()`
	`getAfterTestCmd()` Recebe comandos do shell para executar após o GTest.
	`getBeforeTestCmd()` Recebe comandos do shell para executar antes do GTest.
	`getExcludeFilters()` Retorna o `ERROR(/Set)` atual dos filtros de exclusão.
	`getFileExclusionFilterRegex()` Recebe regex para impedir a execução de determinados arquivos.
	`getGTestFlags()` Recebe valores de flags 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()` Execute o módulo de teste nativo do Android.
`boolean`	`getRunDisabledTests()` Recebe 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 atual de fragmentos.
`int`	`getShardIndex()` Recebe o índice de fragmento deste teste.
`String`	`getTestFilterKey()` Recebe a chave de filtro de teste.
`String`	`getTestModule()` Recebe o nome do módulo.
`boolean`	`isCollectTestsOnly()` Recebe apenas a invocação do binário de teste para coletar a lista de casos de teste aplicáveis ou não.
`boolean`	`isEnableXmlOutput()` Recebe ou não o uso da saída XML gtest para resultados de testes.
`boolean`	`isSharded()` Recebe a flag isSharded.
`void`	`notifyTestExecution(boolean incompleteTestFound, failedTests)` Notifique o pai da execução do teste para que os filtros de inclusão/exclusão possam ser processados corretamente para as 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)` Defina 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 está sendo tentado executar.

Métodos protegidos
`String`	`convertName(String gtestFlagName)`
`String`	`createFlagFile(String filter)` Crie um arquivo com os filtros que serão usados com --gtest_flagfile para evitar limitações do SO no tamanho dos argumentos.
`void`	`erasePrependedFileName( filters, String filename)`
`String`	`getAllGTestFlags(String path)` Auxiliar para receber todas as flags do GTest e transmitir para o comando adb shell.
`IConfiguration`	`getConfiguration()` Retorna a configuração do teste.
`String`	`getExceptionMessage(Exception e)` Faça o possível para recuperar uma mensagem descritiva curta e significativa para 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)` Auxiliar que permite que classes derivadas encapsulem o comando gtest em alguma outra ferramenta (chroot, strace, gdb e semelhantes).
`String`	`getGTestFilters(String path)` Assistente para receber o filtro de teste g do teste a ser executado.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` Retorna o GTestListener que fornece informações extras de depuração, como detecção e relatório de testes duplicados se mDisabledDuplicateCheck for falso.
`abstract String`	`loadFilter(String path)` Defina o método de filtro de recebimento.
`void`	`setRunDisabled(boolean runDisabled)` Define se o GTest deve executar testes desativados.

Constantes

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

Valor da constante: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Valor da constante: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

Valor da constante: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Valor da constante: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Valor da constante: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Valor da constante: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Valor da constante: "--gtest_output=xml:%s"

Construtores públicos

GTestBase

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

Retorna
`String`

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

getAbi

public IAbi getAbi ()

Retorna
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

Recebe comandos do shell para executar após o GTest.

Retorna

getBeforeTestCmd

public  getBeforeTestCmd ()

Recebe comandos do shell para executar antes do GTest.

Retorna

getExcludeFilters

public  getExcludeFilters ()

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

Retorna

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

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

Retorna

getGTestFlags

public  getGTestFlags ()

Recebe valores de flags 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 ()

Execute o módulo de teste nativo do Android.

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

getRunDisabledTests

public boolean getRunDisabledTests ()

Recebe se o GTest deve executar testes desativados.

Retorna
`boolean`	Verdadeiro se os testes desativados precisarem 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 atual de fragmentos.

Retorna
`int`

getShardIndex

public int getShardIndex ()

Recebe o índice de fragmento deste teste.

Retorna
`int`

getTestFilterKey

public String getTestFilterKey ()

Recebe a chave de filtro de teste.

Retorna
`String`

getTestModule

public String getTestModule ()

Recebe o nome do módulo.

Retorna
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Recebe apenas a invocação do 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 o uso da saída XML gtest para resultados de testes.

Retorna
`boolean`

isSharded

public boolean isSharded ()

Recebe a flag isSharded.

Retorna
`boolean`

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Notifique o pai da execução do teste para que os filtros de inclusão/exclusão possam ser processados corretamente para as 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)

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

dividido

public  split (int shardCountHint)

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

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

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

convertName

protected String convertName (String gtestFlagName)

Parâmetros
`gtestFlagName`	`String`

Retorna
`String`

createFlagFile

protected String createFlagFile (String filter)

Crie um arquivo com os filtros que serão usados com --gtest_flagfile para evitar limitações do SO no tamanho dos argumentos.

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 receber todas as flags do GTest e transmitir para o comando adb shell.

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

getExceptionMessage

protected String getExceptionMessage (Exception e)

Faça o possível para recuperar uma mensagem descritiva curta e significativa para 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`: 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)

Auxiliar que permite que classes derivadas encapsulem o comando gtest em alguma outra ferramenta (chroot, strace, gdb e semelhantes).

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

Retorna
`String`

getGTestFilters

protected String getGTestFilters (String path)

Assistente para receber o filtro de teste g do teste a ser executado.

Os filtros são aplicados apenas ao nome da função (por exemplo, "Test" do Google Test). Todos os "Casos de teste" do Google Test 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 g-test 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 detecção e relatório de 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 de recebimento.

A subclasse precisa implementar como receber o 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)

Define se o GTest deve executar testes desativados.

Parâmetros
`runDisabled`	`boolean`