Usando o verificador CTS

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.
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.

Figura 1. Ícone do verificador CTS

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

Figura 2. Menu de testes do CTS Verifier

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

Verificador de qualidade de streaming de vídeo

Figura 3. Elementos de teste

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

Teste de acessório usb do verificador CTS

Figura 4. Procedimento de teste de acessório USB para 8.0 e superior

Figura 5. Testando o modo 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:
1. Imprima o arquivo de destino calibração-pattern.pdf em papel de tamanho 11 ”x 17” ou A3.
2. Monte o padrão impresso em um suporte rígido.
3. Oriente o dispositivo da câmera e o alvo impresso conforme mostrado abaixo.
  Figura 7. Alvo impresso da câmera
Defina a largura alvo:
1. 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).
2. Inicie o aplicativo de calibração.
3. Pressione o botão de configuração e selecione Distância do marcador .
4. Meça e insira a distância para o padrão alvo (~ 100 cm).
5. 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:
1. 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.
2. 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.
3. 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
Nota: Android 7.0 e superior não incluem o recurso de visualização.
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 ou adb 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.zip
```
  Nota: Use adb shell am get-current-user para obter o CURRENT_USER ID.
  Para listar todos os relatórios disponíveis no dispositivo conectado:
```
adb shell content query --user CURRENT_USER --uri

content://com.android.cts.verifier.testresultsprovider/reports
```
  Para 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 limpar os resultados de aprovação / reprovação, selecione os resultados no aplicativo CTS Verifier e selecione Menu> Limpar .