Console dei comandi CTS v2

Utilizzare la console CTS v2

Per Android 7.0 o versioni successive, utilizza CTS v2.

Seleziona piani

I piani di test disponibili includono:

  • cts: esegue CTS da un'installazione CTS preesistente.
  • cts-camera: esegue una videocamera CTS da un'installazione CTS preesistente.
  • cts-java: esegue i test Java di base da un'installazione CTS preesistente.
  • cts-pdk: esegue test utili per convalidare una build di fusion PDK.
  • tutto: configurazione comune per le suite di compatibilità.

Altre configurazioni disponibili includono:

  • basic-reporter: configurazione con i reporter CTS di base.
  • collect-tests-only: esegue CTS da un'installazione CTS preesistente.
  • common-compatibility-config: la configurazione comune per le suite con compatibilità.
  • cts-filter-sample: configurazione comune per le suite di compatibilità.
  • cts-known-failures: configurazione con errori noti CTS.
  • cts-preconditions: configurazioni di precondizione CTS.
  • host: esegue un singolo test basato su host su un dispositivo esistente.
  • instrument: viene eseguito un singolo test di strumentazione Android su un dispositivo esistente.
  • native-benchmark: esegue un test di stress nativo su un dispositivo esistente.
  • native-stress: consente di eseguire un test di stress nativo su un dispositivo esistente.
  • recharge: un test fittizio che attende i dispositivi quasi scaricati e li trattiene per la ricarica.
  • testdef: esegue i test contenuti nei file test_def.xml su un dispositivo esistente.
  • util/wifi: utilità di configurazione per configurare il Wi-Fi sul dispositivo.
  • util/write: cancella i dati utente sul dispositivo.

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

Riferimento per i comandi della console CTS v2

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

Moderatore Descrizione
help Visualizza un riepilogo dei comandi di uso più comune
help all Visualizza l'elenco completo dei comandi disponibili
version Mostra la versione.
exit Esci normalmente dalla console CTS. La console si chiude quando tutti i test attualmente in esecuzione sono terminati.
extdir

Il file dei download compresso viene decompresso in extdir. Se vuoi elimina l'output gonfiato, utilizza l'opzione -q:

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

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

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

Esegui Descrizione
run cts

In Android 10, esegui il piano CTS predefinito e CTS- Instant insieme (ovvero la chiamata CTS completa). Per Android 9 o versioni precedenti, esegui l'impostazione predefinita Solo per piano CTS. 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 durante l'esecuzione dei test.

Se non ci sono dispositivi connessi, il computer desktop (o l'host) CTS attenderà per connettere un dispositivo prima di iniziare i test. Se più di uno dispositivo è connesso, l'host CTS sceglierà un dispositivo automaticamente.

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 di test CTS- Instant specificato o moduli.

run retry

Solo per Android 9 o versioni successive. Riprova tutti i test non riusciti o non eseguiti delle sessioni precedenti. Ad esempio, run retry --retry -s o run retry --retry --shard-count con partizionamento orizzontale TF.

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

run cts-sim

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

--device-token

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

--enable-token-sharding

Solo per Android 10 o versioni successive. Automaticamente corrisponde al test richiede il rispettivo tipo di SIM. Non è necessario fornire un numero di serie del dispositivo per l'esecuzione Scenari di test relativi alla SIM. SIM supportate: SIM_CARD, UICC_SIM_CARD, e SECURE_ELEMENT_SIM_CARD.

run cts-dev

Eseguire il piano CTS predefinito (ovvero la chiamata CTS completa), ma ignora le condizioni preliminari per risparmiare tempo di esecuzione per lo sviluppo iterativo di un nuovo test. In questo modo eviterai la verifica e la configurazione del configurazione, ad esempio il push di file multimediali o il controllo della connessione Wi-Fi come avviene quando viene usata l'opzione --skip-preconditions. Questo ignora inoltre la raccolta di informazioni sul dispositivo e tutti i controlli dello stato del sistema. Inoltre, esegue i test su una sola ABI. Per la convalida del dispositivo, evita questa ottimizzazione e includere tutte le precondizioni e i controlli. Consulta cts-dev.xml per le esclusioni.

La console CTS può accettare altri comandi durante l'esecuzione dei test.

Se non ci sono dispositivi connessi, il computer desktop (o l'host) CTS attenderà per connettere un dispositivo prima di iniziare i test. Se più di uno dispositivo è connesso, l'host CTS sceglierà un dispositivo automaticamente.

--subplan subplan_name Esegui il sottopiano specificato.
--module/-m test_module_name --test/-t test_name  Esegui il modulo specificato e verificalo. Ad esempio: run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes esegue il pacchetto, la classe o il test specifici.
--retry Riprova tutti i test non riusciti o non eseguiti dalle sessioni precedenti. Usa list results per ottenere l'ID sessione.
--retry-type NOT_EXECUTED Riprova solo i test non eseguiti dalle sessioni precedenti. Usa list results per ottenere l'ID sessione.
--shards number_of_shards Per Android 8.1 o versioni precedenti. Esegui lo sharding di un CTS di rilevare un determinato numero di blocchi indipendenti, per l'esecuzione su più dispositivi in parallelo.
--shard-count number_of_shards Per Android 9. Lo sharding di un CTS incontra un determinato numero di indipendenti, da eseguire su più dispositivi in parallelo.
--serial/-s deviceID Eseguire CTS sul dispositivo specifico.
--include-filter "test_module_name test_name" Esegui con i moduli o i pacchetti di test, le classi e le richieste specificati. Ad esempio: run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" include il modulo specificato.

Questa opzione del comando non è supportata se si esegue un nuovo tentativo.

--exclude-filter "test_module_name test_name" Escludi dall'esecuzione i moduli o i pacchetti di test, le classi e i casi specificati. 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 log minimo specificato visualizzato su STDOUT. Valori validi: [VERBOSE, DEBUG, INFO, WARN ERROR e ASSERT].
--abi abi_name Forza l'esecuzione del test sull'ABI, 32 o 64 specificati. Per impostazione predefinita, CTS esegue un test una volta per ogni ABI supportata dal dispositivo.
--logcat-on-failure,
--bugreport-on-failure,
--screenshoot-on-failure
Offrono maggiore visibilità sugli errori e possono aiutare con la diagnostica.
--device-token Specifica che un determinato dispositivo dispone del token, ad esempio --device-token 1a2b3c4d:sim-card.
--skip-device-info Salta la raccolta di informazioni sul dispositivo.
--skip-preconditions Salta le condizioni preliminari per risparmiare tempo di esecuzione per lo sviluppo iterativo di un nuovo test. In questo modo eviterai la verifica e la configurazione del configurazione, ad esempio il push di file multimediali o il controllo della connessione Wi-Fi connessione.
Elenco Descrizione
list modules Elenca tutti i moduli di test disponibili nel repository.
list plans o list configs Elenca tutti i piani di test (configurazioni) disponibili nel repository.
list subplans Elenca tutti i sottopiani disponibili nel repository.
list invocations Elenca i comandi run attualmente in esecuzione sui dispositivi.
list commands Elenca tutti i comandi run 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 relativo stato.

I dispositivi disponibili sono dispositivi funzionanti e inattivi, disponibili per l'esecuzione di test.

I dispositivi non disponibili sono dispositivi visibili tramite ADB, ma non rispondono ad ADB e non verranno allocate per i test.

I dispositivi allocati sono dispositivi che attualmente eseguono test.

Dump Descrizione
dump logs Esegui il dump dei log trasferiti per tutte le chiamate in esecuzione.
Aggiungi Descrizione
add subplan --name/-n subplan_name
--result-type
[passed | failed | not_executed]
[--session session_id]
Creare un sottopiano derivato dalla sessione precedente. questa opzione genera un sottopiano che può essere usato per eseguire un sottoinsieme di test.

L'unico l'opzione obbligatoria è --session. Altri sono facoltativi, ma quando incluso, deve essere seguito da un valore. La L'opzione --result-type è ripetibile; Ad esempio, Il campo add subplan --session 0 --result-type passed --result-type failed è valido.