Console de comando do CTS v2

Observação:para o Android 6.0 ou versões anteriores, consulte Console de comando do CTS v1.

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. Cuidado: não use essa opção ao usar a opção --include-filter.
--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. Cuidado: não use essa opção ao usar a opção --module/-m.
--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. Cuidado: não use essa opção ao executar o CTS para aprovação.
--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.