Android Compatibility Test Suite Verifier (CTS Verifier) integra le suite di test di compatibilità (Compatibility Test Suite, CTS). Mentre il CTS controlla le API e le funzioni che possono automatico, CTS Verifier fornisce test per API e funzioni che non possono Testati su un dispositivo fisso senza input o posizionamento manuale, ad esempio audio qualità, touchscreen, accelerometro e fotocamera.
Requisiti
Prima di eseguire CTS Verifier, assicurati di disporre della seguente attrezzatura:
- Dispositivo Android che ha verificato la compatibilità API Android con successo superare il CTS. Questo è il dispositivo in corso di test (DUT).
- Computer Linux con porta compatibile USB 2.0. Tutte le connessioni al DUT vanno attraverso questa porta.
- Secondo dispositivo Android con Bluetooth, Wi-Fi Direct e Wi-Fi compatibile noto Aware, UWB (se il DUT supporta la tecnologia UWB) e NFC (HCE) Host Card Emulation (HCE) implementazione.
- Un router Wi-Fi configurato con nome e password del punto di accesso. Il router dovrebbe potersi disconnettere da internet, ma il dispositivo non sarà alimentato disattivata.
Assicurati di preparare anche i treppiedi, i supporti per dispositivi e i distanze richieste per i test di misurazione della distanza (proximity) per UWB, Wi-Fi NAN e Bluetooth RSSI. Per maggiori dettagli, vedi Calibrazione della presenza.
Requisiti UICC per i test NFC
CTS Verifier dispone dei seguenti scenari di test NFC:
- Field-off (utilizza dati di transazione da 0x54)
- Deseleziona (utilizza dati delle transazioni da 0x52)
- Comando HCI (0025000000) (utilizza dati di transazione da 0x02)
I test degli eventi di transazione richiedono due dispositivi, uno dei quali deve disporre SecureElement UICC con le seguenti regole di accesso:
- Hash APK CtsVerifier: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
- Identificativo applicazione (AID) autorizzato per l'accesso agli eventi NFC: 0xA000000476416E64726F696443545341
Per quanto riguarda l'emulatore, prevediamo che l'evento Transaction esegua il push del l'attività in primo piano.
Configura
Cambia la modalità di navigazione del sistema del dispositivo di test in modalità con tre pulsanti come che segue:
- quindi apri Impostazioni.
- Vai a Sistema > Gesto > Navigazione del sistema.
- Seleziona una modalità di navigazione basata su pulsanti qualsiasi, se preferisci la modalità con tre pulsanti. disponibili.
Per configurare l'ambiente di test di CTS Verifier:
Sul computer Linux:
Esegui questo comando prima di installare CTS Verifier per consentire l'accesso a interfacce non SDK.
adb shell settings put global hidden_api_policy 1
Installa Android Studio.
Scarica l'APK CTS Verifier per la versione di Android da testare.
Collega il DUT al computer Linux.
Da un terminale sul computer Linux, installa
CtsVerifier.apksul DUT.adb install -r -g CtsVerifier.apk
Per Android 10 e versioni successive, esegui questo comando: per concedere all'app l'autorizzazione a creare il report.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
Per Android 11 e versioni successive, esegui questo comando: per consentire il salvataggio dei report in una directory definita autonomamente nel nella directory esterna di primo livello del dispositivo.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
Per Android 13 e versioni successive, esegui questo comando per consentire l'accesso all'API di test per CTS Verifier.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
Per Android 14 e versioni successive, esegui questo comando: per autorizzare l'app ad attivare lo schermo.
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
Assicurati che la data e l'ora di sistema del DUT siano impostate correttamente.
Esegui lo strumento di verifica CTS
Avvia l'applicazione CTS Verifier toccando l'icona CTS Verifier sul DUT.
Figura 1. Icona di CTS Verifier
L'app mostra diversi set di test disponibili per la verifica manuale.
Figura 2. Menu dei test dello strumento di verifica CTS
Ogni test contiene un insieme di elementi comuni nella parte inferiore dello schermo.
Figura 3. Schermata di test con gli elementi di test comuni evidenziati
- Superato (✓). Tocca se il DUT soddisfa i requisiti del test in base alle informazioni istruzioni.
- Informazioni (?). Tocca per visualizzare le istruzioni per il test. Appare automaticamente anche alla prima apertura di un test.
- Non superato (!). Tocca se il DUT non soddisfa i requisiti del test in base alle informazioni istruzioni.
Alcuni test, come la modalità accessoria USB e il test di calibrazione della fotocamera, richiedono configurazione e istruzioni di test aggiuntive, come descritto nelle sezioni seguenti.
Testa la modalità accessorio USB per versione 8.0 e successive
Figura 4. Procedura di test degli accessori USB per 8.0 e superiori a
Figura 5. Test della modalità accessorio USB per 8.0 e superiori a
Testa la modalità accessorio USB per 7.x e versioni precedenti
Il test degli accessori USB richiede un computer Linux per eseguire il computer desktop USB programma (organizzatore).
- Collega il DUT al computer Linux.
Sul computer, esegui il programma
cts-usb-accessorydal CTS Pacchetto di verifica:./cts-usb-accessory
Attendi la visualizzazione di un messaggio popup sul DUT, quindi seleziona OK.
Figura 6. Test accessorio USB
Vai al test degli accessori USB nell'applicazione CTS Verifier su DUT.
Sul computer, rivedi l'output dalla console. Output di esempio:
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 videocamera
Usa la procedura di calibrazione del campo visivo per determinare rapidamente il dispositivo un campo visivo con una precisione moderata.
Configura l'ambiente di test:
- Stampa Target calibration-pattern.pdf su carta in formato A3 o 28 x 43 cm.
- Monta il motivo stampato su un supporto rigido.
Orienta la fotocamera e il target stampato come mostrato di seguito in un diagramma.
Figura 7. Target stampato della fotocamera
Imposta la larghezza di destinazione:
- Misura la distanza (in centimetri) tra le linee continue sulla motivo target per tenere conto delle imprecisioni di stampa (circa 38 cm).
- Avvia l'applicazione di calibrazione.
- Premi il pulsante di configurazione e seleziona Distanza indicatore.
- Misura e inserisci la distanza dal motivo del bersaglio (~100 cm).
- Premi il pulsante indietro per tornare all'anteprima della calibrazione.
Verifica che il dispositivo e il target siano posizionati come mostrato nella figura e nella le distanze corrette siano state inserite nella finestra di dialogo di configurazione. Anteprima visualizza l'immagine con una linea verticale sovrapposta; questa riga dovrebbe allinealo alla linea centrale del pattern target. La griglia trasparente può da utilizzare con le altre linee verticali per garantire che l'asse ottico ortogonale al target.
Esegui il test di calibrazione:
- Seleziona una risoluzione dell'immagine (utilizzando il selettore in basso a sinistra), quindi tocca sullo schermo per scattare una foto. Il test entra in modalità di calibrazione e mostra la foto con due linee verticali sovrapposte all'immagine.
- Determinare la precisione:
- Se le linee si allineano con le linee verticali sul pattern target entro pochi centimetri, il campo visivo riportato per la la risoluzione selezionata sia accurata.
- Se le linee non sono allineate, il campo visivo segnalato non è preciso. Per risolvere il problema, regola il cursore nella parte inferiore dello schermo fino a quando l'overlay si allinea il più possibile al pattern target. Quando l'overlay e l'immagine del pattern target sono allineati, il il campo visivo visualizzato è un'approssimazione molto simile al campo visivo corretto valore. Il campo visivo riportato deve essere compreso tra +/-2 gradi di il valore di calibrazione.
- Premi il pulsante Indietro e ripeti il test di calibrazione per tutte le immagini risoluzioni supportate dal DUT.
Esegui CTS Verifier per alternare le modalità
A partire dalle release CTS 10 R6 e CTS 11 R2, CTS Verifier supporta i test richiesti per i dispositivi con modalità alternative o per i dispositivi con più di una modalità schermo.
Nella parte superiore della visualizzazione elenco principale in CTS Verifier viene mostrato un pulsante per attivare agli utenti di passare dalla modalità di visualizzazione aperta a quella chiusa e viceversa. CTS Verifier mostrerà i test necessari per la modalità di visualizzazione selezionata. Per eseguire l'alternativa in CTS Verifier, è necessario impostare il pulsante sul display appropriato ed eseguire l'elenco dei test mostrato.
I risultati dei test chiusi verranno registrati nello stesso report test. Per identificare ogni risultato del test da cui proviene il set di test, una viene aggiunto a ogni nome di test sotto la modalità chiusa.
<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, puoi salvare i risultati sotto forma di report e scaricarli. a un computer. I nomi dei report vengono indicati automaticamente con timestamp in base al DUT l'ora di sistema.
Per salvare i risultati del test, tocca l'icona di salvataggio (disco) nella parte superiore dell'elenco. delle categorie di test.
Attendi la visualizzazione di un messaggio popup che mostra il percorso del file per il report salvato (ad esempio,
/sdcard/verifierReports/ctsVerifierReport-date-time.zip), quindi registrare il percorso.Collega il DUT al computer Linux.
Scarica i report dall'installazione dell'SDK Android sul computer Linux dal dispositivo connesso tramite
adb shell content readoadb 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 report utilizzando il seguente comando:
adb pull /mnt/sdcard/ctsVerifierReports/
Per Android 10 e versioni successive, l'implementazione Auto e motori e dispositivi che funzionano 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 sul dispositivo connesso:
adb shell content query --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports
Per scaricare un report dall'elenco, puoi specificare l'ID riga o nome file. Ad 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
Per cancellare i risultati superati o non superati, selezionali nell'app CTS Verifier e seleziona Menu > Cancella.