Alcuni moduli di test potrebbero richiedere passaggi di configurazione e rimozione personalizzati che non possono essere eseguiti all'interno dello scenario di test stesso. Ecco alcuni esempi tipici:
- Installare altri APK (oltre all'APK di test)
- Trasferire alcuni file sul dispositivo
- Eseguire comandi (ad es. adb shell pm ...)
In passato, i team dei componenti di solito ricorrevano alla scrittura di un test lato host per eseguire queste attività, il che richiede la comprensione dell'ambiente di test di Trade Federation e in genere aumenta la complessità di un modulo di test .
Prendendo spunto da CTS, abbiamo introdotto il concetto di configurazione del modulo di test per supportare queste attività. L'elenco delle attività comuni riportato sopra può essere eseguito con poche righe di configurazione. Per la massima flessibilità, puoi persino implementare il tuo preparatore di destinazione, come definito da ITargetPreparer o ITargetCleaner, e configurarli per l'utilizzo nella configurazione del tuo modulo di test.
Una configurazione del modulo di test per un modulo di test è un file XML obbligatorio aggiunto alla cartella di origine del modulo di primo livello, denominato "AndroidTest.xml". L'XML segue il formato di un file di configurazione utilizzato dall'ambiente di test di automazione di Trade Federation. Attualmente, i tag principali gestiti tramite le configurazioni dei moduli di test sono i tag "target_preparer" e "test".
Preparatori di destinazione
Un tag "target_preparer", come suggerisce il nome, definisce un preparatore di destinazione (vedi ITargetPreparer) che offre un metodo di configurazione, che viene chiamato prima dell'esecuzione del modulo di test per il test. Se la classe a cui fa riferimento il tag "target_preparer" anche implementa ITargetCleaner, il relativo metodo di rimozione verrà richiamato al termine del modulo di test.
Per utilizzare la configurazione del modulo comune integrato, aggiungi un nuovo file "AndroidTest.xml" nella cartella di primo livello del modulo di test e inserisci i seguenti contenuti:
<?xml version="1.0" encoding="utf-8"?>
<!-- [insert standard AOSP copyright here] -->
<configuration description="Test module config for Foo">
<!-- insert options here -->
</configuration>
Ad esempio, possiamo aggiungere i seguenti tag di opzione (nel commento "insert" sopra):
<target_preparer class="com.android.tradefed.targetprep.RunCommandTargetPreparer">
<option name="run-command" value="settings put secure accessibility_enabled 1" />
<option name="teardown-command" value="settings put secure accessibility_enabled 0" />
</target_preparer>
Le opzioni configureranno l'ambiente di test in modo da:
- Prima di richiamare il modulo di test, esegui il comando shell "settings put secure accessibility_enabled 1" sul dispositivo
- Al termine del modulo di test, esegui il comando shell "settings put secure accessibility_enabled 0"
In questo esempio specifico, l'accessibilità viene attivata/disattivata rispettivamente prima/dopo l'esecuzione del modulo di test. Dopo aver mostrato un semplice esempio, è necessario approfondire i dettagli sull'utilizzo del tag "option". Come mostrato sopra, il tag può avere due attributi: name e value. L'attributo name deve fare riferimento a una delle opzioni offerte dal preparatore.
Lo scopo esatto del campo value dipende da come il preparatore ha definito l'opzione: può essere una stringa, un numero, un valore booleano o persino un percorso di file. Ecco un riepilogo dei tre preparatori di destinazione comuni:
Nome classe: PushFilePreparer
- Nome breve: push-file
- Funzione: trasferisce file arbitrari nella cartella dello scenario di test nella destinazione sul dispositivo
- Note:
- Questo preparatore può trasferire da cartella a cartella o da file a file. Ciò significa che non puoi trasferire un file in una cartella sul dispositivo: devi specificare anche il nome del file di destinazione nella cartella.
- Opzioni:
- push-file: una specifica di trasferimento che indica il file locale e il percorso in cui deve essere trasferito sul dispositivo. Può essere ripetuto. Se sono configurati più file da trasferire nello stesso percorso remoto, verrà trasferito l'ultimo.
- push: (deprecato) una specifica di trasferimento, formattata come
'
/path/to/srcfile.txt->/path/to/destfile.txt' o '/path/to/srcfile.txt->/path/to/destdir/'. Può essere ripetuto. Questo percorso può essere relativo alla directory del modulo di test o alla directory di output stessa. - post-push: un comando da eseguire sul dispositivo (con `
adb shell <your command>`) dopo aver tentato tutti i trasferimenti. Un caso d'uso tipico è l'utilizzo di chmod per le autorizzazioni
Nome classe: InstallApkSetup
- Nome breve:install-apk
- Funzione: trasferisce file APK arbitrari nella destinazione sul dispositivo
- Opzioni:
- test-file-name: il nome dell'APK da installare sul dispositivo.
- install-arg: argomenti aggiuntivi da passare al comando pm install, incluso il trattino iniziale, ad es. "-d". Può essere ripetuto
Nome classe: RunCommandTargetPreparer
- Nome breve: run-command
- Funzione: esegue comandi shell arbitrari prima o dopo l'esecuzione del modulo di test
- Opzioni:
- run-command: comando adb shell da eseguire. Può essere ripetuto
- teardown-command: comando adb shell da eseguire durante la fase di rimozione. Può essere ripetuto
Classe di test
Una classe di test è la classe di Trade Federation da utilizzare per eseguire il test.
<test class="com.android.tradefed.testtype.AndroidJUnitTest">
<option name="package" value="android.test.example.helloworld"/>
<option name="runner" value="android.support.test.runner.AndroidJUnitRunner"/>
</test>
Ecco tre classi di test comuni:
Nome classe: GTest
- Nome breve: gtest
- Funzione: un test che esegue un pacchetto di test nativo sul dispositivo specificato.
- Opzioni:
- native-test-device-path:il percorso sul dispositivo in cui si trovano i test nativi.
Nome classe: InstrumentationTest
- Nome breve: instrumentation
- Funzione: un test che esegue un pacchetto di test di strumentazione sul dispositivo specificato.
- Opzioni:
- package: il nome del pacchetto manifest dell'applicazione di test Android da eseguire.
- class: il nome della classe di test da eseguire.
- method: il nome del metodo di test da eseguire.
Nome classe: AndroidJUnitTest
- Funzione: un test che esegue un pacchetto di test di strumentazione sul dispositivo specificato utilizzando android.support.test.runner.AndroidJUnitRunner. Questo è il modo principale per eseguire un test di strumentazione.