Console de comando do CTS v2

Usar o console do CTS v2

Para o Android 7.0 ou mais recente, use o CTS v2.

Selecionar planos

Os planos de teste disponíveis incluem o seguinte:

  • cts: executa o CTS em uma instalação preexistente do CTS.
  • cts-camera: executa a câmera CTS em uma instalação pré-existente do CTS.
  • cts-java: executa testes essenciais em Java de uma instalação do CTS existente.
  • cts-pdk: executa testes úteis para validar um build de fusão do PDK.
  • tudo: configuração comum para pacotes de compatibilidade.

Outras configurações disponíveis incluem:

  • basic-reporters: configuração com relatórios básicos do CTS.
  • collect-tests-only: executa o CTS de uma instalação pré-existente do CTS.
  • common-compatibility-config: configuração comum dos pacotes de compatibilidade.
  • cts-filtered-sample: configuração comum para pacotes de compatibilidade.
  • cts-known-failures: configuração com falhas conhecidas do CTS.
  • cts-preconditions: configurações de pré-condição do CTS.
  • host: executa um único teste baseado em host em um dispositivo atual.
  • instrument: executa um único teste de instrumentação Android em um dispositivo existente.
  • native-benchmark: executa um teste de estresse nativo em um dispositivo atual.
  • native-stress: executa um teste de estresse nativo em um dispositivo existente.
  • recarga: um teste falso que aguarda dispositivos quase descarregados e os mantém para carregar.
  • testdef: executa testes contidos em arquivos test_def.xml em um dispositivo existente.
  • util/wifi: configuração do utilitário para configurar o Wi-Fi no dispositivo.
  • util/wipe: exclui permanentemente os dados do usuário no dispositivo.

Todos esses planos e configurações podem ser executados com o comando run cts.

Referência de comandos do console CTS v2

Esta tabela resume os comandos do console do CTS v2 para diversos usos.

Host Descrição
help Mostrar um resumo dos comandos mais usados
help all Mostrar a lista completa de comandos disponíveis
version Mostre a versão.
exit Saia sem dificuldades do console do CTS. O console fecha quando todos que os testes em execução no momento tenham sido concluídos.
extdir

O arquivo de downloads compactado é descompactado para o extdir. Se você quiser elimine a saída inflada, use a opção -q:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip -d extdir

Se você quiser descompactar no diretório atual, não use a opção -d. basta executar:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip
Executar Descrição
run cts

No Android 10, execute o plano CTS padrão e o CTS-Instant ou seja, a invocação completa do CTS. No Android 9 ou versões anteriores, execute o Apenas para o plano CTS. Use essa opção abrangente (incluindo as pré-condições) para validar o dispositivo. Consulte cts.xml para inclusões.

O console do CTS pode aceitar outros comandos enquanto os testes estão em andamento.

Se nenhum dispositivo estiver conectado, a máquina (ou host) do CTS vai aguardar conecte um dispositivo antes de iniciar os testes. Se mais de um dispositivo estiver conectado, o host do CTS escolherá um dispositivo automaticamente.

run cts-instant

No 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 de teste CTS-Instant especificado ou módulos.
run retry

Apenas para o Android 9 ou versões mais recentes. Repetir todos os testes que falharam ou não foram executados das sessões anteriores. Por exemplo, run retry --retry -s ou run retry --retry --shard-count com fragmentação do TF.

run cts --retry não está permitido para o Android 9 ou versões mais recentes.
run cts-sim

Para o Android 11 ou versões mais recentes. Executa o subconjunto de testes em um dispositivo com chip.
--device-token

Para o Android 8.1 ou versões anteriores. Especifica que um determinado dispositivo tem a com base no token correto anterior. Por exemplo, --device-token 1a2b3c4d:sim-card.
--enable-token-sharding

Apenas para o Android 10 ou mais recente. Automaticamente corresponde ao teste que exige o respectivo tipo de chip. Não é necessário fornecer um número de série do dispositivo para executar Casos de teste relacionados a chips. Chips compatíveis: SIM_CARD, UICC_SIM_CARD, e SECURE_ELEMENT_SIM_CARD.

run cts-dev

Execute o plano CTS padrão (ou seja, a invocação completa do CTS), mas pular as condições prévias para economizar tempo de execução para o desenvolvimento iterativo de uma nova teste. Isso ignora a verificação e a configuração do configuração, como enviar arquivos de mídia por push ou verificar se há Wi-Fi conexão, como é feito quando a opção --skip-preconditions é usada. Isso também ignora a coleta de informações do dispositivo e todos os verificadores de status do sistema. Ela também executa os testes em apenas uma ABI. Para validar o dispositivo, evite essa otimização e inclua todas as pré-condições e verificações. Consulte cts-dev.xml para exclusões.

O console do CTS pode aceitar outros comandos enquanto os testes estão em andamento.

Se nenhum dispositivo estiver conectado, a máquina (ou host) do CTS vai aguardar conecte um dispositivo antes de iniciar os testes. Se mais de um dispositivo estiver conectado, o host do CTS escolherá um dispositivo automaticamente.
--subplan subplan_name Executar o subplano especificado.
--module/-m test_module_name --test/-t test_name  Execute o módulo especificado e o teste. Por exemplo: run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes executa o pacote, a classe ou o teste específico.
--retry Repita todos os testes que falharam ou não foram executados nas sessões anteriores. Use list results para conseguir o ID da sessão.
--retry-type NOT_EXECUTED Tentar novamente apenas os testes que não foram executados nas sessões anteriores. Use list results para conseguir o ID da sessão.
--shards number_of_shards Para o Android 8.1 ou versões anteriores. Fragmentar um CTS são executados em um determinado número de partes independentes, para execução em vários dispositivos em paralelo.
--shard-count number_of_shards Para Android 9. Fragmentar uma execução do CTS em um número determinado de blocos independentes, para serem executados 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 uma nova tentativa.
--exclude-filter "test_module_name test_name" Exclui da execução os módulos, pacotes de teste, classes e casos de teste especificados. Por exemplo: run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" exclui o módulo especificado.
--log-level-display/-l log_level Executar com o nível mínimo de registro especificado exibido para STDOUT: Valores válidos: [VERBOSE, DEBUG, INFO e WARN. ERROR, ASSERT].
--abi abi_name Forçar a execução do teste na ABI especificada, 32 ou 64. Por padrão, o CTS executa um teste uma vez para cada ABI compatível com o dispositivo.
--logcat-on-failure,
--bugreport-on-failure,
--screenshoot-on-failure		 dão mais visibilidade às falhas e podem ajudar com diagnósticos.
--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 Ignorar condições prévias para economizar tempo de execução para desenvolvimento iterativo de um um novo teste. Isso ignora a verificação e a configuração do configuração, como enviar arquivos de mídia por push ou verificar se há Wi-Fi uma conexão com a Internet.
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 (configurações) disponíveis no repositório.
list subplans Liste todos os subplanos disponíveis no repositório.
list invocations Lista os comandos run que estão sendo executados nos dispositivos no momento.
list commands Lista todos os comandos run na fila que aguardam atribuição a dispositivos.
list results Lista os resultados do CTS atualmente armazenados no repositório.
list devices Lista os dispositivos conectados no momento e o estado deles.

Os dispositivos disponíveis estão funcionando, ociosos e disponíveis para executar testes.

Dispositivos indisponíveis são aqueles visíveis pelo adb, mas que não respondem ao adb. e não terá alocação para testes.

Dispositivos alocados são aqueles que executam testes no momento.
Dump Descrição
dump logs Despeja os registros comercializados para todas as invocações em execução.
Adicionar Descrição
add subplan --name/-n subplan_name
--result-type
[passed | failed | not_executed]
[--session session_id]		 Criar um subplano derivado da sessão anterior essa opção gera um subplano que pode ser usado para executar um subconjunto de testes.

O único a opção necessária é --session. Outros são opcionais, mas, quando incluído, deve ser seguido de um valor. O A opção --result-type é repetível. por exemplo add subplan --session 0 --result-type passed --result-type failed é válido.