Executar testes de NFC em vários dispositivos (Android 15)

Este documento explica como executar testes de NFC em vários dispositivos.

Atender aos pré-requisitos

Antes de executar testes de NFC em vários dispositivos, faça o seguinte:

1. Prepare um dispositivo com sua implementação do Android 15.
2. Siga os requisitos do CTS-V.
3. Siga a configuração do CTS-V.

Prepare um DUT e um leitor NFC PN532 para o teste

Depois de concluir as etapas anteriores, siga estas instruções para executar prepare um DUT e um leitor NFC PN532 para o teste:

1. Conecte o DUT a uma máquina host por USB.
2. Conceda permissões para que o host acesse o DUT por ADB.

3. Instale o app CTS Verifier (CtsVerifier.apk) no DUT:

   extract root/out/host/linux-x86/cts-verifier/android-cts-verifier.zip
   
   cd android-cts-verifier
   
   adb install -r -g CtsVerifier.apk
   

4. Instale os APKs necessários para o teste de NFC:

   cd MultiDevice
   
   adb install -r -g NfcEmulatorTestApp.apk
   

Configurar a NFC para o DUT

Siga estas etapas para configurar a NFC no DUT:

1. No DUT, acesse o menu Configurações.
2. Procure a seção NFC ou Dispositivos conectados.
3. Verifique se a opção de ativação/desativação da NFC está ativada.

4. Posicione um chip NFC no leitor de NFC do smartphone:

   1. Adquira um chip NFC PN532. Recomendamos a opção All-In-One PN532, que não usa BLE.
   2. Conecte o chip NFC PN532 ao host Linux usando um cabo USB.
   3. Coloque o chip NFC PN532 sobre o leitor de NFC do smartphone, conforme mostrado na imagem a seguir:

   

   Figura 1. Posicionamento do chip NFC.

Configurar o ambiente de teste

Siga estas etapas para configurar o ambiente de teste:

1. Execute estes comandos para configurar o ambiente de teste:

   cd MultiDevice
   
   source build/envsetup.sh
   

   Esse comando verifica o Python e configura a variável de ambiente PYTHONPATH. Se nenhum erro for impresso no terminal, o ambiente estará pronto para executar os testes em vários dispositivos.

   Se a mensagem de erro libtinfo.so.6: no version information available (required by /bin/sh) aparecer durante a execução, execute o comando a seguir para renomear o arquivo libtinfo.so.6:

   mv $ENV_DIRECTORY/lib/libtinfo.so.6 $ENV_DIRECTORY/lib/libtinfo.so.6.bak
   

2. Configure o ambiente de teste definindo os IDs seriais do dispositivo em teste e do leitor NFC PN532 em MultiDevice/config.yml:

   TestBeds:
     - Name: CtsNfcHceMultiDeviceTestCases-py-ctsv
       Controllers:
         AndroidDevice:
           - serial: "<device-id>"
       TestParams:
         pn532_serial_path: "<pn532-serial-path>"
   

Executar os testes de NFC

Para executar os testes de NFC:

1. Abra o app CTS-V e toque em Testes de NFC:

   

   Figura 2. O app CTS-V.

   A janela de informações com a lista de casos de teste aparece:

   

   Figura 3. Casos de teste de apps do CTS-V.

2. Execute os testes no host:

   MultiDevice$ python3 tools/run_all_tests.py
   

   Quando os testes são concluídos, os resultados são atualizados no app CTS-V. Os testes bem-sucedidos ficam verdes:

   

   Figura 4. Resultados do teste CTS-V.

3. Se você encontrar falhas marcadas em vermelho, use o comando a seguir para executar novamente os testes com falha:

   python3 tools/run_all_tests.py --test_cases "`TestCaseA`" "`TestCaseB`" --test_files "`TestFileA`"
   

   Em que:

   • TestCaseA e TestCaseB são os nomes dos casos de teste conforme exibidos no CTS-V.
   • TestFileA é o arquivo de teste que contém os casos de teste.

   Exemplo:

   python3 tools/run_all_tests.py --test_cases "test_conflicting_non_payment" "test_conflicting_non_payment_prefix" --test_files "CtsNfcHceMultiDeviceTestCases-py-ctsv"