O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

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, tela sensível ao toque, 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 do 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 uma implementação compatível conhecida de Bluetooth, Wi-Fi direto e emulação de cartão host (HCE) NFC.
  • Um roteador Wi-Fi configurado com nome de ponto de acesso e senha. O roteador deve poder se desconectar da Internet, mas não desligado.

Requisitos UICC para testes NFC

O CTS Verifier tem os seguintes casos de teste NFC:

  • Field-off (usa dados de transação de 0x54)
  • Desmarcar (usa dados de transação de 0x52)
  • Comando HCI (0025000000) (usa dados de transação de 0x02)

Os testes de eventos de transação requerem dois dispositivos, um dos quais deve ter SecureElement UICC com as seguintes regras de acesso:

  • CtsVerifier APK hash: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
  • Identificador de aplicativo autorizado (AID) para acesso a eventos NFC: 0xA000000476416E64726F696443545341

No lado do emulador, esperamos que o evento de transação coloque a atividade correspondente em primeiro plano.

Configurar

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 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 da versão do Android para testar.

  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
    

    Para conceder a permissão correta a um perfil de trabalho gerado, inclua o sinalizador --user profileID , da seguinte forma:

    adb shell appops set --user profileID com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
    
  6. Para Android 13 e superior, execute o seguinte comando para permitir o acesso à API de teste para o CTS Verifier.

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
    
  7. Certifique-se de que o DUT tenha os dados do sistema e a hora definidos corretamente.

Executar Verificador CTS

Inicie o aplicativo CTS Verifier tocando no ícone CTS Verifier no DUT.

Ícone do CTS Verifier 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 CTS Verifier

Figura 2. Menu de testes do CTS Verifier

Cada teste contém um conjunto de elementos comuns na parte inferior da tela.

Verificador de qualidade de streaming de vídeo

Figura 3. Tela de teste com elementos de teste comuns destacados

  • Passe (✓). Toque se o DUT atender aos requisitos de teste de acordo com as instruções de informações.
  • Informações (?). Toque para exibir as instruções do teste. Também aparece automaticamente na primeira vez que um teste é aberto.
  • 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 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.

Teste o modo de acessório USB para 8.0 e superior

Teste de acessório usb CTS Verifier

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

Teste de acessório usb CTS Verifier

Figura 5. Testando o modo de acessório USB para 8.0 e superior

Teste o modo de acessório USB para 7.xe inferior

O teste de Acessório USB requer um computador Linux para executar o programa da máquina de desktop USB (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 CTS Verifier

    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, revise 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
    

Calibrar 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-padrão.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 no diagrama a seguir.
      Alvo impresso pela câmera

      Figura 7. Alvo impresso pela câmera

  2. Defina a largura do alvo:

    1. Meça a distância (em centímetros) entre as linhas sólidas no padrão de destino para contabilizar 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 até 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; esta linha deve 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. Determinar a precisão:
      • Se as linhas se alinharem com as linhas verticais no padrão de destino dentro de alguns centímetros, o campo de visão relatado para a resolução selecionada é preciso.
      • Se as linhas não se alinharem, 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 +/-2 graus 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.

Execute o verificador CTS para modos alternativos

A partir das versões CTS 10 R6 e CTS 11 R2, o CTS Verifier suporta os testes necessários para dispositivos com modos alternativos ou para dispositivos com mais de um modo de tela.

Na parte superior da exibição de lista principal no CTS Verifier, um botão é mostrado para permitir que os usuários alternem entre o modo de exibição desdobrado e dobrado. O CTS Verifier mostrará os testes necessários para o modo de exibição selecionado. Para executar os modos alternativos no CTS Verifier, deve-se mudar o botão para o modo de exibição apropriado e executar a lista de testes mostrada.

Interruptor CTS-V

Os resultados dos testes dobrados serão registrados no mesmo relatório dos testes desdobrados. Para identificar cada resultado de teste do qual o conjunto de teste é, um sufixo é adicionado a cada nome de teste no modo dobrado.

<Test result="fail" name="com.android.cts.verifier.deskclock.DeskClockTestsActivity[folded]">
  <RunHistory subtest="CREATE_ALARM[folded]">
    <Run start="1594176663973" end="1594176665841" isAutomated="false" />
  </RunHistory>
</Test>

Exportar 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 automaticamente com base na hora do sistema DUT.

  1. Para salvar os resultados do teste, toque no ícone salvar (disco) no topo da lista de categorias de teste.

  2. Aguarde uma mensagem pop-up que exiba o caminho do arquivo para o relatório salvo (por exemplo, /sdcard/verifierReports/ctsVerifierReport-date-time.zip ) e registre o caminho.

  3. Conecte o DUT ao computador Linux.

  4. Na instalação do Android SDK no computador Linux, baixe relatórios do dispositivo conectado usando adb shell content read ou adb pull CTSVerifierReportPath .

    • Para Android 7.xe superior, baixe todos os relatórios usando o seguinte comando:

      adb pull /sdcard/verifierReports
      
    • Para Android 6.0 e inferior, baixe todos os relatórios usando o seguinte comando:

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • Para Android 10 e superior, implementando dispositivos automotivos e executados como um usuário secundário , baixe o relatório mais recente usando o seguinte comando:

      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 .