O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

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:

  1. Abrir configurações.
  2. Navegue até Sistema > Gesto > Navegação do sistema .
  3. 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:

  1. 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.
  2. Conecte o DUT ao computador Linux.
  3. De um terminal no computador Linux, instale CtsVerifier.apk no DUT.
    adb install -r -g CtsVerifier.apk
    
  4. 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
    
  5. 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
    
  6. 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.

Ícone do verificador CTS no iniciador
Figura 1. Ícone do verificador CTS

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

Menu de testes do verificador CTS
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
Teste de acessório usb do verificador CTS
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).

  1. Conecte o DUT ao computador Linux.
  2. No computador, execute o programa cts-usb-accessory do pacote CTS Verifier:
    ./cts-usb-accessory
  3. Aguarde até que uma mensagem pop-up apareça no DUT e selecione OK .
    Teste de acessório usb do verificador CTS
    Figura 6. Teste de acessório USB
  4. Vá para o Teste de acessório USB no aplicativo CTS Verifier no DUT.
  5. 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.

  1. 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.
      Alvo impresso da câmera
      Figura 7. Alvo impresso da câmera
  2. 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.
  3. 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.
  4. 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.

  1. Toque no ícone Salvar (disco) .
    Ícone de salvar do CTS Verifier
    Figura 8. Ícone Salvar do CTS Verifier
  2. 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.
    Caminho do verificador CTS para o relatório salvo
    Figura 9. Caminho do verificador CTS para o relatório salvo
  3. Conecte o DUT ao computador Linux.
  4. 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

      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
  5. Para limpar os resultados de aprovação / reprovação, selecione os resultados no aplicativo CTS Verifier e selecione Menu> Limpar .