O Android Compatibility Test Suite Verifier (CTS Verifier) complementa o Compatibility Test Suite (CTS). Enquanto o CTS verifica APIs e funções que podem ser automatizadas, o CTS Verifier fornece testes para APIs e funções que não podem ser testadas em um dispositivo estacionário sem entrada manual, como qualidade de áudio, touchscreen, acelerômetro e câmera.
Requisitos
Antes de executar o CTS Verifier, certifique-se de ter o seguinte equipamento:
- Dispositivo Android que verificou a compatibilidade da API Android passando com sucesso no CTS. Este é o dispositivo em teste (DUT).
- Computador Linux com porta compatível com USB 2.0. Todas as conexões com o DUT passam por esta porta.
- Segundo dispositivo Android com um Bluetooth compatível conhecido, Wi-Fi direto e implementação de emulação de cartão host NFC (HCE).
- Um roteador Wi-Fi configurado com nome de ponto de acesso e senha. O roteador deve ter a capacidade de se desconectar da Internet, mas não deve estar desligado.
Configurando
Altere o modo de navegação do sistema do dispositivo de teste para o modo de três botões da seguinte forma:
- Abrir configurações.
- Navegue até Sistema > Gesto > Navegação do sistema .
- Selecione qualquer modo de navegação baseado em botão, preferencialmente o modo de três botões, se disponível.
Para configurar o ambiente de teste do CTS Verifier:
- No computador Linux:
- Execute o seguinte comando antes de instalar o CTS Verifier para permitir o acesso a interfaces não SDK.
adb shell settings put global hidden_api_policy 1
- Instale o Android Studio .
- Baixe o APK do CTS Verifier para a versão do Android a ser testada.
- Execute o seguinte comando antes de instalar o CTS Verifier para permitir o acesso a interfaces não SDK.
- Conecte o DUT ao computador Linux.
- De um terminal no computador Linux, instale
CtsVerifier.apk
no DUT.adb install -r -g CtsVerifier.apk
- Para Android 10 e superior, execute o seguinte comando para dar permissão ao aplicativo para criar o relatório.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
Para Android 11 e superior, execute o seguinte comando para permitir que os relatórios sejam salvos em um diretório autodefinido no diretório externo de nível superior do dispositivo.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
- Certifique-se de que o DUT tenha os dados do sistema e a hora configurados corretamente.
Corrida
Inicie o aplicativo CTS Verifier tocando no ícone CTS Verifier no DUT.

O aplicativo exibe vários conjuntos de teste disponíveis para verificação manual.

Cada teste contém um conjunto de elementos comuns (Info, Pass, Fail) na parte inferior da tela.

- Informações (?). Toque para exibir as instruções do teste. Também aparece automaticamente na primeira vez que um teste é aberto.
- Passe (✓). Toque se o DUT atende aos requisitos de teste de acordo com as instruções de informações.
- Falha (!). Toque se o DUT não atender aos requisitos de teste de acordo com as instruções de informações.
Alguns testes, como o modo de acessório USB e o teste de calibração da câmera, requerem configuração de teste adicional e instruções detalhadas nas seções a seguir.
Testando o modo de acessório USB para 8.0 e superior


Testando o modo de acessório USB para 7.xe abaixo
O teste de acessório USB requer um computador Linux para executar o programa USB desktop machine (host).
- Conecte o DUT ao computador Linux.
- No computador, execute o programa
cts-usb-accessory
do pacote CTS Verifier:./cts-usb-accessory
- Aguarde até que uma mensagem pop-up apareça no DUT e selecione OK .
Figura 6. Teste de acessório USB - Vá para o Teste de acessório USB no aplicativo CTS Verifier no DUT.
- No computador, analise a saída do console. Saída de exemplo:
CTS USB Accessory Tester Found possible Android device (413c:2106) - attempting to switch to accessory mode... Failed to read protocol versionfigure3 Found Android device in accessory mode (18d1:2d01)... [RECV] Message from Android device #0 [SENT] Message from Android accessory #0 [RECV] Message from Android device #1 [SENT] Message from Android accessory #1 [RECV] Message from Android device #2 [SENT] Message from Android accessory #2 [RECV] Message from Android device #3 [SENT] Message from Android accessory #3 [RECV] Message from Android device #4 [SENT] Message from Android accessory #4 [RECV] Message from Android device #5 [SENT] Message from Android accessory #5 [RECV] Message from Android device #6 [SENT] Message from Android accessory #6 [RECV] Message from Android device #7 [SENT] Message from Android accessory #7 [RECV] Message from Android device #8 [SENT] Message from Android accessory #8 [RECV] Message from Android device #9 [SENT] Message from Android accessory #9 [RECV] Message from Android device #10 [SENT] Message from Android accessory #10
Calibrando o campo de visão da câmera
Use o procedimento de calibração do campo de visão para determinar rapidamente o campo de visão do dispositivo com precisão moderada.
- Configure o ambiente de teste:
- Imprima o arquivo de destino calibração-pattern.pdf em papel de tamanho 11 ”x 17” ou A3.
- Monte o padrão impresso em um suporte rígido.
- Oriente o dispositivo da câmera e o alvo impresso conforme mostrado abaixo.
Figura 7. Alvo impresso da câmera
- Defina a largura alvo:
- Meça a distância (em centímetros) entre as linhas sólidas no padrão de destino para compensar as imprecisões de impressão (~ 38 cm).
- Inicie o aplicativo de calibração.
- Pressione o botão de configuração e selecione Distância do marcador .
- Meça e insira a distância para o padrão alvo (~ 100 cm).
- Pressione o botão Voltar para retornar à visualização da calibração.
- Verifique se o dispositivo e o alvo estão posicionados conforme mostrado na figura e se as distâncias corretas foram inseridas na caixa de diálogo de configuração. A visualização exibe a imagem com uma linha vertical sobreposta a ela; esta linha deve se alinhar com a linha central do padrão de destino. A grade transparente pode ser usada com as outras linhas verticais para garantir que o eixo óptico seja ortogonal ao alvo.
- Execute o teste de calibração:
- Selecione uma resolução de imagem (usando o seletor no canto inferior esquerdo) e toque na tela para tirar uma foto. O teste entra no modo de calibração e exibe a foto com duas linhas verticais sobrepostas na imagem.
- Determine a precisão:
- Se as linhas se alinham com as linhas verticais no padrão alvo dentro de alguns centímetros, o campo de visão relatado para a resolução selecionada é preciso.
- Se as linhas não estiverem alinhadas, o campo de visão relatado é impreciso. Para corrigir isso, ajuste o controle deslizante na parte inferior da tela até que a sobreposição se alinhe com o padrão de destino o mais próximo possível. Quando a sobreposição e a imagem do padrão de destino estão alinhadas, o campo de visão exibido é uma aproximação do valor correto. O campo de visão relatado deve estar dentro de +/- 1 grau do valor de calibração.
- Pressione o botão Voltar e repita o teste de calibração para todas as resoluções de imagem suportadas pelo DUT.
Exportando resultados
Após a conclusão de todos os testes, você pode salvar os resultados como um relatório e baixá-los para um computador. Os nomes dos relatórios são marcados com data e hora automaticamente com base na hora do sistema DUT.
- Toque no ícone Salvar (disco) .
Figura 8. Ícone Salvar do CTS Verifier - Aguarde a mensagem pop-up exibir o caminho para o relatório salvo (por exemplo,
/sdcard/verifierReports/ctsVerifierReport-date-time.zip
) e registre o caminho.Figura 9. Caminho do verificador CTS para o relatório salvo - Conecte o DUT ao computador Linux.
- Na instalação do Android SDK no computador Linux, baixe relatórios do dispositivo conectado usando o
adb shell content read
ouadb pull CTSVerifierReportPath
.- Para Android 7.xe superior, baixe todos os relatórios usando:
adb pull /sdcard/verifierReports
- Para Android 6.0 e inferior, baixe todos os relatórios usando:
adb pull /mnt/sdcard/ctsVerifierReports/
Para Android 10 e superior, implementação automotiva e dispositivos executados como um usuário secundário , baixe o relatório mais recente usando:
adb shell content read --user CURRENT_USER --uri
content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zipPara listar todos os relatórios disponíveis no dispositivo conectado:
adb shell content query --user CURRENT_USER --uri
content://com.android.cts.verifier.testresultsprovider/reportsPara baixar um relatório da lista, você pode especificar o ID da linha ou o nome do arquivo. Por exemplo:
adb shell content read --user CURRENT_USER --uri
content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip
adb shell content read --user CURRENT_USER --uri
content://com.android.cts.verifier.testresultsprovider/reports/ctsVerifierReport-date-time.zip > report.zip
- Para Android 7.xe superior, baixe todos os relatórios usando:
- Para limpar os resultados de aprovação / reprovação, selecione os resultados no aplicativo CTS Verifier e selecione Menu> Limpar .