Utilizzo del verificatore CTS

Android Compatibility Test Suite Verifier (CTS Verifier) ​​integra Compatibility Test Suite (CTS). Mentre CTS controlla API e funzioni che possono essere automatizzate, CTS Verifier fornisce test per API e funzioni che non possono essere testate su un dispositivo fisso senza input manuale, come qualità audio, touchscreen, accelerometro e fotocamera.

Requisiti

Prima di eseguire CTS Verifier, assicurarsi di disporre delle seguenti apparecchiature:

  • Dispositivo Android che ha verificato la compatibilità dell'API Android superando correttamente il CTS. Questo è il dispositivo in prova (DUT).
  • Computer Linux con porta compatibile USB 2.0. Tutte le connessioni al DUT passano attraverso questa porta.
  • Secondo dispositivo Android con un'implementazione HCE (Host Card Emulation) compatibile con Bluetooth, Wi-Fi Direct e NFC nota.
  • Un router Wi-Fi configurato con il nome e la password del punto di accesso. Il router dovrebbe avere la possibilità di disconnettersi da Internet, ma non essere spento.

Requisiti UICC per i test NFC

CTS Verifier ha i seguenti casi di test NFC:

  • Field-off (utilizza i dati della transazione da 0x54)
  • Deseleziona (utilizza i dati della transazione da 0x52)
  • Comando HCI (0025000000) (utilizza i dati della transazione da 0x02)

I test degli eventi di transazione richiedono due dispositivi, uno dei quali deve disporre di SecureElement UICC con le seguenti regole di accesso:

  • CtsVerifier APK hash: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
  • Identificatore di applicazione autorizzato (AID) per l'accesso agli eventi NFC: 0xA000000476416E64726F696443545341

Dal lato dell'emulatore, ci aspettiamo che l'evento di transazione metta in primo piano l'attività corrispondente.

Impostare

Modificare la modalità di navigazione del sistema del dispositivo di test in modalità a tre pulsanti come segue:

  1. Apri Impostazioni.
  2. Passare a Sistema > Gesto > Navigazione del sistema .
  3. Selezionare qualsiasi modalità di navigazione basata su pulsanti, preferibilmente la modalità a tre pulsanti, se disponibile.

Per impostare l'ambiente di test di CTS Verifier:

  1. Sul computer Linux:

    • Eseguire il seguente comando prima di installare CTS Verifier per consentire l'accesso alle interfacce non SDK.

      adb shell settings put global hidden_api_policy 1
      
    • Installa Android Studio .

    • Scarica l' APK di CTS Verifier per la versione di Android da testare.

  2. Collegare il DUT al computer Linux.

  3. Da un terminale sul computer Linux, installa CtsVerifier.apk sul DUT.

    adb install -r -g CtsVerifier.apk
    
  4. Per Android 10 e versioni successive, esegui il comando seguente per autorizzare l'app a creare il rapporto.

    adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
    
  5. Per Android 11 e versioni successive, esegui il comando seguente per consentire il salvataggio dei report in una directory definita da te nella directory di primo livello esterna del dispositivo.

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
    

    Per concedere l'autorizzazione corretta a un profilo di lavoro generato, includi il flag --user profileID , come segue:

    adb shell appops set --user profileID com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
    
  6. Per Android 13 e versioni successive, eseguire il comando seguente per consentire l'accesso all'API di test per CTS Verifier.

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
    
  7. Assicurarsi che il DUT abbia i dati di sistema e l'ora impostati correttamente.

Eseguire il verificatore CTS

Avviare l'applicazione CTS Verifier toccando l'icona CTS Verifier sul DUT.

Icona di CTS Verifier nel programma di avvio

Figura 1. Icona del verificatore CTS

L'app mostra diversi set di test disponibili per la verifica manuale.

Menu dei test di CTS Verifier

Figura 2. Menu dei test di CTS Verifier

Ogni test contiene una serie di elementi comuni nella parte inferiore dello schermo.

Verificatore di qualità video in streaming

Figura 3. Schermata del test con elementi di test comuni evidenziati

  • Passa (✓). Tocca se il DUT soddisfa i requisiti del test secondo le istruzioni Info.
  • Informazioni (?). Toccare per visualizzare le istruzioni del test. Inoltre appare automaticamente la prima volta che si apre un test.
  • Fallire (!). Tocca se il DUT non soddisfa i requisiti del test secondo le istruzioni Info.

Alcuni test, come la modalità accessorio USB e il test di calibrazione della fotocamera, richiedono ulteriori impostazioni e istruzioni del test, come descritto in dettaglio nelle sezioni seguenti.

Prova la modalità accessorio USB per 8.0 e versioni successive

Test accessorio USB CTS Verifier

Figura 4. Procedura di test dell'accessorio USB per 8.0 e versioni successive

Test accessorio USB CTS Verifier

Figura 5. Test della modalità accessorio USB per 8.0 e versioni successive

Prova la modalità accessorio USB per 7.x e versioni precedenti

Il test dell'accessorio USB richiede un computer Linux per eseguire il programma della macchina desktop USB (host).

  1. Collegare il DUT al computer Linux.
  2. Sul computer, esegui il programma cts-usb-accessory dal pacchetto CTS Verifier:

    ./cts-usb-accessory
  3. Attendere che venga visualizzato un messaggio popup sul DUT, quindi selezionare OK .
    Test accessorio USB CTS Verifier

    Figura 6. Test dell'accessorio USB

  4. Vai al test degli accessori USB nell'applicazione CTS Verifier su DUT.

  5. Sul computer, rivedere l'output dalla console. Esempio di output:

    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
    

Calibra il campo visivo della telecamera

Utilizzare la procedura di calibrazione del campo visivo per determinare rapidamente il campo visivo del dispositivo con una precisione moderata.

  1. Configurare l'ambiente di test:

    1. Stampare il file target di calibrazione-pattern.pdf su carta di formato 11" x 17" o A3.
    2. Montare il motivo stampato su un supporto rigido.
    3. Orientare il dispositivo della fotocamera e il target stampato come mostrato nel diagramma seguente.
      Bersaglio stampato dalla fotocamera

      Figura 7. Obiettivo stampato dalla fotocamera

  2. Imposta la larghezza del bersaglio:

    1. Misurare la distanza (in centimetri) tra le linee continue sul modello di destinazione per tenere conto delle imprecisioni di stampa (~38 cm).
    2. Avviare l'applicazione di calibrazione.
    3. Premere il pulsante di impostazione e selezionare Distanza marker .
    4. Misurare e immettere la distanza dal modello di destinazione (~ 100 cm).
    5. Premere il pulsante Indietro per tornare all'anteprima della calibrazione.
  3. Verificare che il dispositivo e il target siano posizionati come mostrato nella figura e che siano state immesse le distanze corrette nella finestra di dialogo di impostazione. L'anteprima mostra l'immagine con una linea verticale sovrapposta; questa linea dovrebbe allinearsi con la linea centrale del modello di destinazione. La griglia trasparente può essere utilizzata con le altre linee verticali per garantire che l'asse ottico sia ortogonale al bersaglio.

  4. Eseguire il test di calibrazione:

    1. Seleziona una risoluzione dell'immagine (utilizzando il selettore in basso a sinistra), quindi tocca lo schermo per scattare una foto. Il test entra in modalità di calibrazione e visualizza la foto con due linee verticali sovrapposte all'immagine.
    2. Determina la precisione:
      • Se le linee si allineano con le linee verticali sul modello target entro pochi centimetri, il campo visivo riportato per la risoluzione selezionata è accurato.
      • Se le linee non sono allineate, il campo visivo riportato non è accurato. Per correggere questo problema, regola il dispositivo di scorrimento nella parte inferiore dello schermo fino a quando la sovrapposizione non si allinea il più possibile al modello di destinazione. Quando la sovrapposizione e l'immagine del modello target sono allineate, il campo visivo visualizzato è molto vicino al valore corretto. Il campo visivo riportato deve essere compreso tra +/-2 gradi rispetto al valore di calibrazione.
    3. Premere il pulsante Indietro e ripetere il test di calibrazione per tutte le risoluzioni immagine supportate dal DUT.

Eseguire CTS Verifier per modalità alternative

A partire dalle versioni CTS 10 R6 e CTS 11 R2, CTS Verifier supporta i test richiesti per dispositivi con modalità alternative o per dispositivi con più di una modalità schermo.

Nella parte superiore della visualizzazione dell'elenco principale in CTS Verifier viene visualizzato un pulsante che consente agli utenti di alternare tra la modalità di visualizzazione aperta e piegata. CTS Verifier mostrerà i test necessari per la modalità di visualizzazione selezionata. Per eseguire le modalità alternative in CTS Verifier, è necessario impostare il pulsante sulla modalità di visualizzazione appropriata ed eseguire l'elenco dei test visualizzati.

Interruttore a levetta CTS-V

I risultati dei test ripiegati verranno registrati nello stesso rapporto con i test aperti. Per identificare ogni risultato del test da cui proviene il set di test, viene aggiunto un suffisso a ciascun nome di test sotto la modalità ripiegata.

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

Esporta i risultati

Al termine di tutti i test, è possibile salvare i risultati come report e scaricarli su un computer. I nomi dei rapporti sono contrassegnati automaticamente dall'ora in base all'ora del sistema DUT.

  1. Per salvare i risultati del test, tocca l'icona di salvataggio (disco) in cima all'elenco delle categorie di test.

  2. Attendi un messaggio popup che visualizzi il percorso del file del report salvato (ad esempio, /sdcard/verifierReports/ctsVerifierReport-date-time.zip ), quindi registra il percorso.

  3. Collegare il DUT al computer Linux.

  4. Dall'installazione di Android SDK sul computer Linux, scarica i report dal dispositivo connesso utilizzando adb shell content read o adb pull CTSVerifierReportPath .

    • Per Android 7.x e versioni successive, scarica tutti i report utilizzando il seguente comando:

      adb pull /sdcard/verifierReports
      
    • Per Android 6.0 e versioni precedenti, scarica tutti i rapporti utilizzando il seguente comando:

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • Per Android 10 e versioni successive, implementando Automotive e dispositivi in ​​esecuzione come utente secondario , scarica il report più recente utilizzando il seguente comando:

      adb shell content read --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
      

      Per elencare tutti i report disponibili nel dispositivo connesso:

      adb shell content query --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports
      

      Per scaricare un rapporto dall'elenco, è possibile specificare l'ID riga o il nome file. Per esempio:

      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. Per cancellare i risultati superati/non superati, seleziona i risultati nell'app CTS Verifier e seleziona Menu > Cancella .