Usando o console CTS v2
Para Android 7.0 ou superior, use CTS v2.
Selecionando planos
Os planos de teste disponíveis incluem o seguinte:
- cts —Executa o CTS a partir de uma instalação CTS preexistente.
- cts-camera — Executa a câmera CTS a partir de uma instalação CTS preexistente.
- cts-java — Executa os Core Java Tests a partir de uma instalação CTS pré-existente.
- cts-pdk — Executa testes úteis na validação de uma compilação de fusão PDK.
- tudo — Configuração comum para suítes de compatibilidade.
Outras configurações disponíveis incluem o seguinte:
- basic-reporters — Configuração com repórteres CTS básicos.
- collect-tests-only —Executa o CTS a partir de uma instalação CTS preexistente.
- common-compatibility-config — Configuração comum para suítes de compatibilidade.
- cts-filtered-sample — Configuração comum para suítes de compatibilidade.
- cts-known-failures — Configuração com falhas conhecidas do CTS.
- cts-preconditions — configs de pré-condição CTS.
- host — Executa um único teste baseado em host em um dispositivo existente.
- instrument — Executa um único teste de instrumentação Android em um dispositivo existente.
- native-benchmark — Executa um teste de estresse nativo em um dispositivo existente.
- native-stress — Executa um teste de estresse nativo em um dispositivo existente.
- recarga — Um teste falso que espera por dispositivos quase descarregados e os retém para carregamento.
- testdef — Executa os testes contidos nos arquivos test_def.xml em um dispositivo existente.
- util/wifi — Configuração do utilitário para configurar o Wi-Fi no dispositivo.
- util/wipe — Limpa os dados do usuário no dispositivo.
Todos esses planos e configurações podem ser executados com o comando run cts .
Referência de comando do console CTS v2
Esta tabela resume os comandos do console CTS v2 para vários usos.
| Hospedeiro | Descrição |
|---|---|
help | Exibir um resumo dos comandos mais usados |
help all | Exibir a lista completa de comandos disponíveis |
version | Mostre a versão. |
exit | Saia graciosamente do console CTS. O console fecha quando todos os testes em execução no momento são concluídos. |
extdir | O arquivo de downloads compactado é descompactado para Se você quiser descompactar no diretório atual, não use a opção |
| Corre | Descrição |
run cts | No Android 10, execute o plano CTS padrão e o CTS-Instant juntos (ou seja, a invocação completa do CTS). Para Android 9 ou inferior, execute apenas o plano CTS padrão. Use esta opção abrangente (incluindo pré-condições) para validação do dispositivo. Veja cts.xml para inclusões. O console CTS pode aceitar outros comandos enquanto os testes estão em andamento. Se nenhum dispositivo estiver conectado, a máquina desktop CTS (ou host) aguardará a conexão de um dispositivo antes de iniciar os testes. Se mais de um dispositivo estiver conectado, o host CTS escolherá um dispositivo automaticamente. |
run cts-instant | Para Android 9, execute o plano CTS-Instant padrão. |
run cts --module-parameter INSTANT_APP | No Android 10, execute o plano CTS-Instant padrão. |
run cts --module-parameter INSTANT_APP --module/-m test_module_name | No Android 10, execute o módulo ou módulos de teste CTS-Instant especificados. |
run retry | Apenas para Android 9 ou superior. Repita todos os testes que falharam ou não foram executados nas sessões anteriores. Por exemplo, |
run cts-sim | Para Android 11 ou versões superiores. Executa o subconjunto de testes em um dispositivo com cartão SIM. |
--device-token | Para Android 8.1 ou versões inferiores. Especifica que um determinado dispositivo tem o token fornecido. Por exemplo, |
--enable-token-sharding | Apenas para Android 10 ou superior . Corresponde automaticamente ao teste que requer o respectivo tipo de SIM. Não há necessidade de fornecer um número de série do dispositivo para executar casos de teste relacionados ao SIM. SIMs compatíveis: |
run cts-dev | Execute o plano CTS padrão (ou seja, a chamada CTS completa), mas ignore as pré-condições para economizar tempo de execução para o desenvolvimento iterativo de um novo teste. Isso ignora a verificação e a configuração da configuração do dispositivo, como enviar arquivos de mídia ou verificar a conexão Wi-Fi, como é feito quando a O console CTS pode aceitar outros comandos enquanto os testes estão em andamento. Se nenhum dispositivo estiver conectado, a máquina desktop CTS (ou host) aguardará a conexão de um dispositivo antes de iniciar os testes. Se mais de um dispositivo estiver conectado, o host CTS escolherá um dispositivo automaticamente. |
--subplan subplan_name | Execute o subplano especificado. |
--module/-m test_module_name --test/-t test_name | Execute o módulo especificado e teste. Por exemplo, run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes executa o pacote, classe ou teste específico. |
--retry | Tente novamente todos os testes que falharam ou não foram executados nas sessões anteriores. Use os list results para obter o ID da sessão. |
--retry-type NOT_EXECUTED | Repita apenas os testes que não foram executados nas sessões anteriores. Use os list results para obter o ID da sessão. |
--shards number_of_shards | Para Android 8.1 ou versões inferiores . Fragmente um CTS executado em um determinado número de blocos independentes, para executar em vários dispositivos em paralelo. |
--shard-count number_of_shards | Para Android9 . Fragmente um CTS executado em um determinado número de blocos independentes, para executar em vários dispositivos em paralelo. |
--serial/-s deviceID | Execute o CTS no dispositivo específico. |
--include-filter "test_module_name test_name" | Execute com os módulos especificados ou pacotes de teste, classes e casos. Por exemplo, run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" inclui o módulo especificado.Esta opção de comando não é suportada ao executar a repetição. |
--exclude-filter "test_module_name test_name" | Exclua os módulos especificados ou pacotes de teste, classes e casos da execução. Por exemplo, run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" exclui o módulo especificado. |
--log-level-display/-l log_level | Execute com o nível mínimo de log especificado exibido para STDOUT . Valores válidos: [ VERBOSE , DEBUG , INFO , WARN , ERROR , ASSERT ]. |
--abi abi_name | Força a execução do teste na ABI fornecida, 32 ou 64. Por padrão, o CTS executa um teste uma vez para cada ABI que o dispositivo suporta. |
--logcat-on-failure ,--bugreport-on-failure ,--screenshoot-on-failure | Dê mais visibilidade às falhas e pode ajudar no diagnóstico. |
--device-token | Especifica que um determinado dispositivo tem o token fornecido, como --device-token 1a2b3c4d:sim-card . |
--skip-device-info | Ignora a coleta de informações sobre o dispositivo. |
--skip-preconditions | Ignore as pré-condições para economizar tempo de execução para o desenvolvimento iterativo de um novo teste. Isso ignora a verificação e a configuração da configuração do dispositivo, como enviar arquivos de mídia ou verificar a conexão Wi-Fi. |
| Lista | Descrição |
list modules | Liste todos os módulos de teste disponíveis no repositório. |
list plans ou list configs | Liste todos os planos de teste disponíveis (configs) no repositório. |
list subplans | Liste todos os subplanos disponíveis no repositório. |
list invocations | Liste os comandos 'run' atualmente sendo executados nos dispositivos. |
list commands | Liste todos os comandos 'executar' atualmente na fila esperando para serem atribuídos aos dispositivos. |
list results | Liste os resultados do CTS atualmente armazenados no repositório. |
list devices | Liste os dispositivos atualmente conectados e seu estado. Dispositivos 'disponíveis' estão funcionando, dispositivos ociosos, disponíveis para execução de testes. Dispositivos 'indisponíveis' são dispositivos visíveis via adb, mas não estão respondendo a comandos adb e não serão alocados para testes. Dispositivos 'alocados' são dispositivos que estão executando testes no momento. |
| Jogar fora | Descrição |
dump logs | Despeje os logs de tradefed para todas as invocações em execução. |
| Adicionar | Descrição |
add subplan --name/-n subplan_name | Crie um subplano derivado da sessão anterior; esta opção gera um subplano que pode ser usado para executar um subconjunto de testes. A única opção necessária é --session . Outros são opcionais, mas, quando incluídos, devem ser seguidos de um valor. A opção --result-type é repetível; por exemplo add subplan --session 0 --result-type passed --result-type failed é válido. |