La Trade Federation è un framework di test continuo per eseguire test su Android dispositivi mobili. Per eseguire la Compatibility Test Suite (CTS), devi prima leggere le Panoramica di Trade Federation per un spiegazione del framework dei test Tradefed.
Per eseguire un piano di test:
- Configura i dispositivi in fase di test (DUT) in base alle Configurazione del dispositivo Android.
- Assicurati di aver installato le versioni recenti di entrambi Android Debug Bridge (adb) e Strumento di presentazione di asset per Android (AAPT) e hai aggiunto la posizione di questi strumenti al percorso di sistema della tua macchina. Per informazioni sull'installazione di questi strumenti, consulta Configurazione di CTS: ADB e AAPT.
- Scarica le build CTS rilasciate sul tuo Macchina host Linux e decomprimi la build nel percorso dell'host.
- Collega almeno un dispositivo. Per preparare il DUT:
- Premi il pulsante home per impostare il dispositivo sulla schermata Home.
- Non utilizzare il DUT per altre attività.
- Mantenere il dispositivo DUT in posizione stazionaria per evitare l'attivazione del sensore attività.
- Inquadra con la fotocamera del dispositivo un oggetto che può essere messo a fuoco.
- Non premere alcun tasto sul dispositivo mentre il CTS è in esecuzione. Pressa tasti o il tocco dello schermo di un DUT interferisce con i test in esecuzione e potrebbero causare errori nei test.
Avvia lo script cts-tradefed della console CTS dalla cartella in cui si trova è stato decompresso. Nella shell della riga di comando dell'host, esegui:
./android-cts/tools/cts-tradefed
Esegui il piano di test predefinito (contiene tutti i pacchetti di test):
cts-tradefed > run cts
Se vuoi migliorare i tempi di esecuzione del test, difficilmente i test su più dispositivi. Lo sharding richiede che l'host si connetta almeno due dispositivi, ma per una maggiore efficienza sono consigliati sei o più dispositivi. Quando esegui lo sharding di più di un dispositivo:
Per Android 9 e versioni successive, utilizza l'opzione del comando
--shard-count number_of_shards
Per Android 8.1 e versioni precedenti, utilizza l'opzione del comando
--shards number_of_shards
Se non vuoi eseguire l'intera suite di test, puoi eseguire Piano CTS a scelta tra la riga di comando:
run cts --plan test_plan_name
Per trovare il nome del piano di test:
Per Android 7.0 e versioni successive, per visualizzare un elenco dei moduli di test, inserisci
list modules
Per Android 6.0 e versioni precedenti, per visualizzare un elenco dei piani di test nel repository, inserisci
list plans
Per Android 6.0 e versioni precedenti, per visualizzare un elenco di pacchetti di test nella repository, inserisci
list packages
Per ulteriori opzioni dei comandi a seconda delle versioni CTS, fai riferimento alle riferimento per i comandi della console, o nella sezione "Aiutami a tutti" nella console Tradefed.
Eseguire più sessioni "Riprova" fino al completamento di tutti i moduli di test e il numero di errori di test è uguale nelle ultime due sessioni di nuovo tentativo.
Per Android 9 e versioni successive, utilizza
run retry --retry session_number --shard-count number_of_shards
Per Android 7.0-8.1, utilizza
run cts --retry session_number --shards number_of_shards
Per ulteriori opzioni del comando Riprova in base alla versione di CTS, consulta Console di comando CTS v2.
Per comprendere i dettagli di implementazione per un nuovo tentativo CTS, consulta Nuovo tentativo di Trade Federation Suite.
Esegui una nuova sessione di nuovo solo per i test con parametri non riusciti. Superato con i test con parametri non vengono rieseguiti.
Per Android 11 e versioni successive, è abilitata la seguente opzione del comando per riprovare per impostazione predefinita nel comando
run cts:run retry --retry
--new-parameterized-handling
Visualizza l'avanzamento e i risultati del test riportati sulla console.
Esegui CTS utilizzando Android Test Station
Android Test Station è uno strumento di automazione dei test che gli sviluppatori Android testano gli ingegneri possono utilizzare un'interfaccia utente per eseguire test standard suite. Funziona con la Test Suite di compatibilità Android (CTS).
Lo strumento è disponibile pubblicamente tramite
Guida dell'utente di ATS,
e il suo codice è open source in AOSP
(multitest_transport,
tradefed_cluster).
Esegui CTS per modalità alternative
La release CTS 10 R4 aggiunge un piano di test per dispositivi con modalità alternative, o per
dispositivi con più schermi. Esegui il piano di test delle modalità alternative utilizzando
run cts-foldable.
Gli scenari di test superati o non riusciti per la modalità schermo alternativo vengono aggiunti con il
valore da display_mode, ad esempio testcase1[display_mode=0].
In CTS 13, l'API DeviceStateManager consente moduli di test con i seguenti
che l'opzione di configurazione venga eseguita su diversi stati di un dispositivo pieghevole.
L'esecuzione del test è automatica in CTS in base agli stati di piegatura del display
definiti nel dispositivo senza la necessità di eseguire il piano di test cts-foldable.
<option name="config-descriptor:metadata" key="parameter" value="all_foldable_states" />
Test multi-dispositivo in CTS
Android 13 e versioni successive supportano i test multi-dispositivo.
I test che richiedono più dispositivi vengono eseguiti automaticamente durante l'esecuzione di CTS.
CTS 13 include alcuni test multi-dispositivo che si attivano automaticamente durante lo sharding
. Sebbene i test non richiedano ulteriori modifiche alla configurazione fisica,
virtualenv deve essere installata
per la corretta esecuzione dei test. Per maggiori dettagli,
consulta la sezione Più dispositivi.
Suite.
Esegui test multi-dispositivo
Per eseguire i test multi-dispositivo in modo indipendente, utilizza il seguente codice:
cts-tradefed > run cts-multidevice
Sono supportate tutte le normali opzioni. Per scegliere come target dispositivi specifici, aggiungi
--serial <serial1> --serial <serial2> e così via per il numero di dispositivi
scelto come target.
Per attivare automaticamente i test multi-dispositivo, utilizza lo sharding, come in --shard-count 2.