Esegui test CTS automatici (Android 11 o versioni successive)

Esistono due opzioni per eseguire i test automatici CTS:

  • Trade Federation è un framework per app e test che ti consente di eseguire test dalla riga di comando. Fondamentalmente, il framework consente di annotare i test utilizzando l'annotazione @Test e l'app li trova ed esegue.

  • OmniLab Android Test Station è un'app che ti consente di eseguire test in una GUI.

Questa pagina spiega come eseguire test automatici utilizzando Trade Federation. Per istruzioni su come eseguire test utilizzando OmniLab Android Test Harness, consulta la sezione OmniLab Android Test Station.

Esegui tutti i test CTS automatici

Trade Federation contiene la console CTS, un'interfaccia a riga di comando per eseguire i test. Per eseguire l'intera suite di test CTS automatica:

  1. Assicurati di aver seguito le istruzioni riportate in Configurare i test automatici CTS.

  2. Nella workstation di test, avvia la console CTS eseguendo lo script cts-tradefed dalla cartella in cui è stato decompresso il pacchetto CTS:

    ./android-cts/tools/cts-tradefed

    La console CTS mostra un cursore per consentirti di digitare i comandi CTS (cts-tradefed >).

  3. Il piano di test cts contiene tutti i test CTS automatici. Esegui questo comando per eseguire il piano di test cts:

    run cts

    Vengono eseguiti i test CTS automatici. Nota:

    • Android 13 e versioni successive supportano i test su più dispositivi. Questi test vengono eseguiti automaticamente solo quando viene utilizzato lo sharding. Per ulteriori informazioni sullo sharding, consulta Migliorare il tempo di esecuzione del test. Se vuoi eseguire questi test manualmente, consulta Eseguire test multidispositivo.

    • Ogni volta che esegui CTS, premi Ctrl+C per interrompere la console CTS esistente e poi esegui di nuovo la console CTS.

    • Non puoi eseguire più versioni di CTS su un singolo host perché ciascuna si apre con un server di codice posizione aperto (OLC) esistente.

  4. Visualizza i risultati del test. Per saperne di più, consulta Interpreta i risultati del CTS.

  5. Se è la prima volta che esegui il test, alcuni test potrebbero non andare a buon fine a causa di problemi non risolvibili. Ad esempio, la connessione di rete potrebbe essere lenta o il segnale GPS potrebbe essere debole. Esegui di nuovo (riprova) i test finché non sono stati completati tutti i moduli di test e i numeri di errori di test sono gli stessi tra le ultime due sessioni di ripetizione:

    run retry --retry session_number`

  6. Una volta che gli errori dei test sono coerenti tra i vari tentativi, concentrati sul debug degli altri test non riusciti. Per informazioni sulla risoluzione dei problemi relativi ai risultati dei test, consulta Eseguire la triage degli errori di test e Risolvere i problemi dei test CTS.

Esegui CTS per i dispositivi multischermo

Se il tuo dispositivo è in esecuzione su Android 11 o 12 e ha più schermate, devi eseguire il piano di test cts-foldable separatamente:

run cts-foldable

I casi di test superati o non superati per la modalità schermo alternativa vengono aggiunti con il valore di display_mode, ad esempio testcase1[display_mode=0].

Esegui test su più dispositivi

Esegui il seguente comando per eseguire il piano di test cts-multidevice:

run cts-multidevice

Eseguire singoli piani di test

Anziché eseguire tutti i piani di test contemporaneamente, puoi eseguire singoli piani di test. Questa opzione è utile per risparmiare tempo e concentrarsi su un insieme specifico di test. Per eseguire un singolo piano di test:

  1. Identifica il nome del piano di test che vuoi eseguire eseguendo il comando list modules.

  2. Esegui il piano di test:

    run cts --plan test_module_or_plan_name

Migliorare il tempo di esecuzione del test

Se vuoi migliorare il tempo di esecuzione dei test, puoi suddividerli su più dispositivi. Lo sharding richiede che l'host colleghi almeno due dispositivi, ma per motivi di efficienza sono consigliati almeno sei dispositivi.

Per eseguire il suddivisione dei test su Android 11 o versioni successive, esegui:

run cts --shard-count number_of_shards

Inoltre, prima di eseguire i test per la convalida, puoi migliorare il tempo di esecuzione dei test utilizzando il comando CTS run cts-dev. Questo comando salta le pre condizioni, la raccolta delle informazioni del dispositivo e tutti i controlli dello stato del sistema. Inoltre, esegue i test su un'unica ABI.