Eseguire i test multidispositivo di CTS Verifier

Questa pagina contiene le istruzioni per l'utilizzo dei test multidispositivo di CTS Verifier (CTS-V) per Android 16 e versioni successive.

Configurare i test multidispositivo lato host

Questa sezione spiega come configurare i test multidispositivo.

  1. Assicurati che il computer soddisfi i requisiti del sistema operativo per CTS.
  2. Segui i passaggi 2 e 5 della sezione Installare il software per computer per assicurarti che adb, AAPT2 e Python siano installati correttamente sul computer.

  3. Prepara due dispositivi in test (DUT) corrispondenti, ciascuno con CTS-V configurato.

  4. Se stai testando un modulo diverso dall'NFC, segui la procedura per la configurazione dei test standard con due dispositivi.

  5. Se stai testando il modulo CDM, segui la sezione Configurare i test CDM oltre alla configurazione standard di due dispositivi.

Configurare test standard con due dispositivi

Per la configurazione predefinita con due dispositivi:

  1. Posiziona due DUT Android corrispondenti a circa 20 cm di distanza.

  2. Per garantire un ambiente pulito, inserisci entrambi i dispositivi in una scatola protettiva.

  3. (Facoltativo) Configura uno sniffer OTA per il debug del Wi-Fi.

Configurare i test NFC

I test NFC utilizzano un DUT e un chip NFC PN532.

Per configurare i test NFC:

  1. Acquista un chip NFC PN532. Ti consigliamo il modulo All-In-One PN532.

  2. Sul DUT, vai all'app Impostazioni.

  3. Attiva NFC.

  4. Posiziona il chip NFC:

    • Per gli smartphone, posiziona il lettore NFC del DUT come mostrato nella figura 1:

      Posizionamento del chip NFC

      Figura 1. Posizionamento del chip NFC.

    • Per altri tipi di dispositivi, posiziona il chip accanto all'antenna NFC del dispositivo.

  5. Collega il chip NFC PN532 alla stazione di lavoro di test utilizzando un cavo USB.

Configurare i test CDM

Il caso di test test_permissions_sync() ha un comportamento diverso a seconda del tipo di build dei dispositivi su cui viene eseguito il test. È fondamentale che entrambe le build diggibili (userdebug o eng) e non diggibili (user) vengano testate dagli OEM e che i test vengano superati per entrambe.

Esenzione

La clausola CDD per l'implementazione dell'API di sincronizzazione delle autorizzazioni richiede solo di essere in grado di trasferire correttamente i dati tra i dispositivi tramite un canale sicuro. Poiché l'implementazione del canale sicuro non è un requisito di conformità al CDD, questo test può essere ignorato nelle build non debbugabili (utente), ma solo se vuoi disattivare il supporto della funzionalità di sincronizzazione delle autorizzazioni CDM.

I test devono essere superati nelle build di debug senza eccezioni.

Prerequisiti per i test su build non debbugabili

Se non rientri nelle clausole di esenzione precedenti, assicurati che siano soddisfatti i seguenti prerequisiti.

Il canale sicuro utilizza AVF (AttestationVerificationFramework) per verificare l'affidabilità dell'hardware. Le attestazioni generate da entrambe le parti contengono diverse informazioni su di loro per garantire che non siano state apportate alterazioni non autorizzate al loro sistema. Durante la procedura di verifica, AVF controlla i seguenti stati:

  • Il dispositivo ha accesso a internet
  • Il dispositivo utilizza l'avvio verificato e la build deve essere firmata con una release-key, non con una dev-key
  • Il bootloader del dispositivo è bloccato. Per istruzioni dettagliate, consulta la sezione su come bloccare il bootloader.
  • I livelli delle patch del sistema operativo, del boot e dei fornitori principali non devono risalire a più di 12 mesi fa. Non utilizzare una compilazione precedente a un anno

  • L'attestazione del dispositivo è supportata da uno dei certificati di primo livello approvati dal fornitore. Specifica i certificati radice attendibili nell'overlay delle risorse vendor_required_attestation_certificates.xml.

Eseguire test multidispositivo lato host (AOSP 16 o versioni successive)

CTS Verifier 16 introduce il supporto per i test multidispositivo lato host. Questi test possono essere eseguiti utilizzando script automatici sull'host anziché l'operazione di test manuale sul dispositivo. Al termine di ogni test, i risultati vengono caricati automaticamente sul DUT e visualizzati nell'app CTS Verifier.

Questa sezione spiega come eseguire i test multipiattaforma lato host.

Esegui test su più dispositivi

Per eseguire un test su più dispositivi:

  1. Nella workstation di test, avvia la console cts-v-host dalla directory in cui è stato decompresso il pacchetto ZIP CTS-V:

    ./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed

  2. Nell'app CTS Verifier sul DUT, fai clic su Test lato host. La Figura 2 mostra i test lato host nell'app CTS Verifier:

    Test multi-dispositivo lato host nell'app CTS Verifier

    Figura 2. Test multi-dispositivo lato host nell'app CTS Verifier.

    Viene visualizzato un elenco di moduli di test multidispositivo lato host.

  3. Identifica il nome del modulo di test che vuoi eseguire. Ad esempio, il modulo CompanionDeviceManager è indicato come CtsCompanionDeviceManagerMultiDeviceTestCases.

  4. Nella console cts-v-host, esegui il seguente comando: Nota: se tocchi un modulo lato host nell'app CTS Verifier, non vedrai un elenco di singoli casi di test. L'interfaccia utente viene invece compilata automaticamente con i risultati del test case dopo l'esecuzione del modulo sull'host.

  5. Nella console xTS, esegui il seguente comando:

    run cts-v-host -m test_module_name

    Ad esempio:

    run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCases

    Al termine dell'esecuzione dei test da parte della console xTS, i risultati vengono visualizzati nell'app CTS Verifier. I test contrassegnati in verde sono stati superati. I test contrassegnati in rosso non sono riusciti. La Figura 3 mostra risultati di esempio per i test di CtsCompanionDeviceManager:

    Risultati del test multidispositivo lato host nell'app CTS Verifier

    Figura 3. Risultati del test multi-dispositivo lato host nell'app Verificatore CTS.

Risolvere i problemi relativi ai test multidispositivo

Questa sezione fornisce assistenza per la risoluzione di eventuali problemi.

Correzione di Nessuna risposta per GetFirmwareVersion durante i test NFC

Se ricevi il messaggio verify_firmware_version RuntimeError: No response for GetFirmwareVersion durante l'esecuzione dei test multidispositivo, i test non possono accedere alla scheda NFC PN532.

Per risolvere il problema, identifica il percorso seriale utilizzato dalla scheda NFC PN532 sul tuo host, ad esempio dev/ttyUSB1, quindi specificalo manualmente utilizzando l'argomento --module-arg nella console:

run cts-v-host -m CtsNfcHceMultiDeviceTestCases --module-arg CtsNfcHceMultiDeviceTestCases:pn532_serial_path:/dev/ttyUSB1

Correggere il messaggio di errore Transazione non riuscita durante i test NFC

Se ricevi il messaggio Transaction failed, check device logs for more information. per tutti i casi di test NFC, è probabile che il chip NFC del DUT non riesca a rilevare il PN532.

Se hai più dispositivi collegati all'host e alcuni di questi non hanno un PN532 sopra, è possibile che sia stato selezionato il DUT sbagliato. Per ulteriori informazioni, vedi Configurare i test NFC.

Per risolvere il problema, esegui una delle seguenti operazioni:

  • Imposta il numero di serie corretto del DUT nel comando di test lato host utilizzando il -s flag.

  • Scollega tutti i dispositivi diversi dal DUT dall'host.

Lo scenario di test CDM test_permissions_sync viene ignorato

Se il test viene eseguito su dispositivi non descrivibili, controlla se hai diritto all'esenzione. In caso contrario, assicurati che entrambi i dispositivi soddisfino i prerequisiti.