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.

Console de comando CTS v2

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 `extdir` . Se você quiser se livrar da 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`
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 retry --retry -s` ou `run retry --retry --shard-count` com fragmentação do TF. `run cts --retry` não é permitido para Android 9 ou superior.
`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, `--device-token 1a2b3c4d:sim-card` .
`--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: `SIM_CARD` , `UICC_SIM_CARD` e `SECURE_ELEMENT_SIM_CARD` .
`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 `--skip-preconditions` é usada. Este comando também ignora a coleta de informações do dispositivo e todos os verificadores de status do sistema. Ele também executa os testes em apenas uma única ABI. Para validação do dispositivo, evite essa otimização e inclua todas as pré-condições e verificações. Consulte cts-dev.xml para exclusõ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.
`--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. Cuidado : Não use esta opção ao usar a opção `--include-filter` .
`--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. Cuidado : Não use esta opção ao usar a opção `--module/-m` .
`--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. Cuidado : Não use esta opção ao executar o CTS para aprovação.
`--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 --result-type [pass \| fail \| timeout \| notExecuted] [--session session_id ]`	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.