Usar o console CTS v2
Para Android 7.0 ou superior, use CTS v2.
Selecione planos
Os planos de teste disponíveis incluem o seguinte:
- cts —Executa o CTS a partir de uma instalação CTS pré-existente.
- cts-camera — Executa a câmera CTS a partir de uma instalação CTS pré-existente.
- cts-java — Executa testes Java principais 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 pacotes 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 pré-existente.
- common-compatibility-config — Configuração comum para 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 CTS.
- host — Executa um único teste baseado em host em um dispositivo existente.
- instrumento — Executa um único teste de instrumentação Android em um dispositivo existente.
- benchmark nativo — Executa um teste de estresse nativo em um dispositivo existente.
- estresse nativo — Executa um teste de estresse nativo em um dispositivo existente.
- recarga — Um teste falso que espera por dispositivos quase descarregados e os mantém para carregamento.
- 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 — 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 do CTS v2 para vários usos.
| Hospedar | 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 normalmente do console CTS. O console fecha quando todos os testes em execução são concluídos. |
extdir | O arquivo de download compactado é descompactado para Se você deseja descompactar para o diretório atual, não use a opção |
| Correr | 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. Consulte 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á que um dispositivo seja conectado 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. Tente novamente 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 possui 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 suportados: |
run cts-dev | Execute o plano CTS padrão (ou seja, a invocação completa do CTS), 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 configuração do dispositivo, como envio de arquivos de mídia ou verificação de conexão Wi-Fi, como é feito quando a opção 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á que um dispositivo seja conectado 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 para executar 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 list results para obter o ID da sessão. |
--retry-type NOT_EXECUTED | Tente novamente apenas os testes que não foram executados nas sessões anteriores. Use list results para obter o ID da sessão. |
--shards number_of_shards | Para Android 8.1 ou versões inferiores . Fragmente uma execução CTS em um determinado número de blocos independentes, para execução em vários dispositivos em paralelo. |
--shard-count number_of_shards | Para Android 9 . Fragmente uma execução CTS em um determinado número de blocos independentes, para execução 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 teste pacotes, 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 nova tentativa. |
--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 de log mínimo especificado exibido em 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 suportada pelo dispositivo. |
--logcat-on-failure ,--bugreport-on-failure ,--screenshoot-on-failure | Dá mais visibilidade às falhas e pode ajudar nos diagnósticos. |
--device-token | Especifica que um determinado dispositivo possui 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 configuração do dispositivo, como envio de arquivos de mídia ou verificação de 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 (configurações) disponíveis no repositório. |
list subplans | Liste todos os subplanos disponíveis no repositório. |
list invocations | Lista os comandos 'run' atualmente sendo executados nos dispositivos. |
list commands | Lista todos os comandos de 'execução' atualmente na fila aguardando para serem atribuídos aos dispositivos. |
list results | Lista os resultados do CTS atualmente armazenados no repositório. |
list devices | Liste os dispositivos atualmente conectados e seu estado. Dispositivos 'disponíveis' são dispositivos em funcionamento, ociosos, disponíveis para execução de testes. Dispositivos 'indisponíveis' são dispositivos visíveis via adb, mas não respondem aos comandos do adb e não serão alocados para testes. Dispositivos 'alocados' são dispositivos atualmente executando testes. |
| Jogar fora | Descrição |
dump logs | Despeje os logs negociados 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 obrigató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. |