Console di comando CTS v2

Utilizza la console CTS v2

Per Android 7.0 o versioni successive, utilizzare CTS v2.

Seleziona i piani

I piani di test disponibili includono quanto segue:

  • cts: esegue CTS da un'installazione CTS preesistente.
  • cts-camera — Esegue CTS-camera da un'installazione CTS preesistente.
  • cts-java : esegue i test Core Java da un'installazione CTS preesistente.
  • cts-pdk : esegue test utili per la convalida di una build di fusione PDK.
  • everything : configurazione comune per le suite di compatibilità.

Altre configurazioni disponibili includono quanto segue:

  • basic-reporters — Configurazione con reporter CTS di base.
  • Collect-tests-only: esegue CTS da un'installazione CTS preesistente.
  • common-compatibility-config — Configurazione comune per le suite di compatibilità.
  • cts-filtered-sample — Configurazione comune per le suite di compatibilità.
  • cts-known-failures : configurazione con errori noti CTS.
  • cts-preconditions : configurazioni delle precondizioni CTS.
  • host : esegue un singolo test basato su host su un dispositivo esistente.
  • strumento : esegue un singolo test della strumentazione Android su un dispositivo esistente.
  • native-benchmark : esegue uno stress test nativo su un dispositivo esistente.
  • native-stress : esegue uno stress test nativo su un dispositivo esistente.
  • ricarica : un test falso che attende i dispositivi quasi scarichi e li mantiene in carica.
  • testdef : esegue i test contenuti nei file test_def.xml su un dispositivo esistente.
  • util/wifi : configurazione dell'utilità per configurare il Wi-Fi sul dispositivo.
  • util/wipe : cancella i dati utente sul dispositivo.

Tutti questi piani e configurazioni possono essere eseguiti con il comando run cts .

Riferimento ai comandi della console CTS v2

Questa tabella riepiloga i comandi della console CTS v2 per vari usi.

Ospite Descrizione
help Visualizza un riepilogo dei comandi più comunemente utilizzati
help all Visualizza l'elenco completo dei comandi disponibili
version Mostra la versione.
exit Esci con grazia dalla console CTS. La console si chiude al termine di tutti i test attualmente in esecuzione.
extdir

Il file di download compresso viene decompresso in extdir . Se vuoi eliminare l'output gonfiato, usa l'opzione -q :

unzip -q android-cts-9.0_r15-linux_x86-arm.zip -d extdir

Se vuoi decomprimere nella directory corrente, non utilizzare l'opzione -d , esegui semplicemente:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip

Correre Descrizione
run cts

In Android 10, esegui insieme il piano CTS predefinito e CTS-Instant (ovvero l'invocazione CTS completa). Per Android 9 o versioni precedenti, esegui solo il piano CTS predefinito. Utilizza questa opzione completa (incluse le precondizioni) per la convalida del dispositivo. Vedi cts.xml per le inclusioni.

La console CTS può accettare altri comandi mentre sono in corso i test.

Se non sono collegati dispositivi, il computer desktop CTS (o host) attenderà la connessione di un dispositivo prima di avviare i test. Se è collegato più di un dispositivo, l'host CTS sceglierà automaticamente un dispositivo.

run cts-instant

Per Android 9, esegui il piano CTS-Instant predefinito.

run cts --module-parameter INSTANT_APP

In Android 10, esegui il piano CTS-Instant predefinito.

run cts --module-parameter INSTANT_APP --module/-m test_module_name

In Android 10, esegui il modulo o i moduli di test CTS-Instant specificati.

run retry

Solo per Android 9 o versioni successive. Riprovare tutti i test falliti o non eseguiti nelle sessioni precedenti. Ad esempio, run retry --retry -s oppure run retry --retry --shard-count con lo sharding TF.

run cts --retry non è consentito per Android 9 o versioni successive.

run cts-sim

Per Android 11 o versioni successive. Esegue il sottoinsieme di test su un dispositivo con scheda SIM.

--device-token

Per Android 8.1 o versioni precedenti. Specifica che un determinato dispositivo ha il token specificato. Ad esempio, --device-token 1a2b3c4d:sim-card .

--enable-token-sharding

Solo per Android 10 o versioni successive . Corrisponde automaticamente al test che richiede il rispettivo tipo di SIM. Non è necessario fornire un numero di serie del dispositivo per eseguire casi di test relativi alla SIM. SIM supportate: SIM_CARD , UICC_SIM_CARD e SECURE_ELEMENT_SIM_CARD .

run cts-dev

Esegui il piano CTS predefinito (ovvero la chiamata CTS completa) ma ignora le precondizioni per risparmiare tempo di esecuzione per lo sviluppo iterativo di un nuovo test. Ciò ignora la verifica e l'impostazione della configurazione del dispositivo, come l'invio di file multimediali o il controllo della connessione Wi-Fi, come avviene quando viene utilizzata l'opzione --skip-preconditions . Questo comando ignora anche la raccolta delle informazioni sul dispositivo e tutti i controlli dello stato del sistema. Inoltre esegue i test su un solo ABI. Per la convalida del dispositivo, evitare questa ottimizzazione e includere tutte le precondizioni e i controlli. Vedi cts-dev.xml per le esclusioni.

La console CTS può accettare altri comandi mentre sono in corso i test.

Se non sono collegati dispositivi, il computer desktop CTS (o host) attenderà la connessione di un dispositivo prima di avviare i test. Se è collegato più di un dispositivo, l'host CTS sceglierà automaticamente un dispositivo.

--subplan subplan_name Esegui il sottopiano specificato.
--module/-m test_module_name --test/-t test_name Esegui il modulo specificato ed esegui il test. Ad esempio, run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes esegue il pacchetto, la classe o il test specifico.
--retry Riprovare tutti i test non riusciti o non eseguiti nelle sessioni precedenti. Utilizza list results per ottenere l'ID della sessione.
--retry-type NOT_EXECUTED Riprovare solo i test che non erano stati eseguiti nelle sessioni precedenti. Utilizza list results per ottenere l'ID della sessione.
--shards number_of_shards Per Android 8.1 o versioni precedenti . Suddividi un'esecuzione CTS in un determinato numero di blocchi indipendenti, da eseguire su più dispositivi in ​​parallelo.
--shard-count number_of_shards Per Android 9 . Suddividi un'esecuzione CTS in un determinato numero di blocchi indipendenti, da eseguire su più dispositivi in ​​parallelo.
--serial/-s deviceID Esegui CTS sul dispositivo specifico.
--include-filter "test_module_name test_name" Esegui con i moduli specificati o testa pacchetti, classi e casi. Ad esempio, run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" include il modulo specificato.

Questa opzione di comando non è supportata durante l'esecuzione del tentativo.

--exclude-filter "test_module_name test_name" Escludere i moduli specificati o testare pacchetti, classi e casi dall'esecuzione. Ad esempio, run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" esclude il modulo specificato.
--log-level-display/-l log_level Esegui con il livello di registro minimo specificato visualizzato su STDOUT . Valori validi: [ VERBOSE , DEBUG , INFO , WARN , ERROR , ASSERT ].
--abi abi_name Forza l'esecuzione del test sull'ABI specificato, 32 o 64. Per impostazione predefinita, CTS esegue un test una volta per ogni ABI supportato dal dispositivo.
--logcat-on-failure ,
--bugreport-on-failure ,
--screenshoot-on-failure
Fornisce maggiore visibilità sugli errori e può aiutare con la diagnostica.
--device-token Specifica che un determinato dispositivo ha il token specificato, ad esempio --device-token 1a2b3c4d:sim-card .
--skip-device-info Salta la raccolta di informazioni sul dispositivo.
--skip-preconditions Salta le precondizioni per risparmiare tempo di esecuzione per lo sviluppo iterativo di un nuovo test. Ciò ignora la verifica e l'impostazione della configurazione del dispositivo, come l'invio di file multimediali o il controllo della connessione Wi-Fi.
Elenco Descrizione
list modules Elenca tutti i moduli di test disponibili nel repository.
list plans o list configs Elenca tutti i piani di test disponibili (configurazioni) nel repository.
list subplans Elenca tutti i sottopiani disponibili nel repository.
list invocations Elenca i comandi "esegui" attualmente in esecuzione sui dispositivi.
list commands Elenca tutti i comandi "esegui" attualmente in coda in attesa di essere assegnati ai dispositivi.
list results Elenca i risultati CTS attualmente archiviati nel repository.
list devices Elenca i dispositivi attualmente connessi e il loro stato.

I dispositivi "disponibili" sono dispositivi funzionanti, inattivi, disponibili per l'esecuzione dei test.

I dispositivi "non disponibili" sono dispositivi visibili tramite adb, ma non rispondono ai comandi adb e non verranno assegnati per i test.

I dispositivi "assegnati" sono i dispositivi che attualmente eseguono test.

Scarico Descrizione
dump logs Scarica i log scambiati per tutte le invocazioni in esecuzione.
Aggiungere Descrizione
add subplan --name/-n subplan_name
--result-type
[pass | fail | timeout | notExecuted]
[--session session_id ]
Creare un sottopiano derivato dalla sessione precedente; questa opzione genera un sottopiano che può essere utilizzato per eseguire un sottoinsieme di test.

L'unica opzione richiesta è --session . Altri sono facoltativi ma, se inclusi, devono essere seguiti da un valore. L'opzione --result-type è ripetibile; ad esempio add subplan --session 0 --result-type passed --result-type failed è valido.