Struttura di alto livello della configurazione XML Tradefed

Le configurazioni di Tradefed seguono una struttura XML per descrivere il test da eseguire e i passaggi di preparazione/configurazione da eseguire.

In teoria, tutto può essere definito nel file XML per un singolo comando. Ma in è più pratico avere file XML di modello di base e personalizzare con parametri aggiuntivi della riga di comando.

Struttura

<configuration description="<description of the configuration>">
    <!-- A build provider that takes local device information -->
    <build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />

    <!-- Some target preparation, disabled by default -->
    <target_preparer class="com.android.tradefed.targetprep.PreloadedClassesPreparer">
        <option name="disable" value="true" />
    </target_preparer>

    <!-- One test running some unit tests -->
    <test class="com.android.tradefed.testtype.HostTest">
        <option name="class" value="com.android.tradefed.build.BuildInfoTest" />
    </test>

    <!-- [OPTIONAL] -->
    <logger class="com.android.tradefed.log.FileLogger">
        <option name="log-level" value="VERBOSE" />
        <option name="log-level-display" value="VERBOSE" />
    </logger>

    <!-- [OPTIONAL] -->
    <log_saver class="com.android.tradefed.result.FileSystemLogSaver" />

    <!-- As many reporters as we want -->
    <result_reporter class="com.android.tradefed.result.ConsoleResultReporter" />
    <result_reporter class="com.android.tradefed.result.suite.SuiteResultReporter" />
    <result_reporter class="com.android.tradefed.result.MetricsXMLResultReporter"/>
</configuration>

Il file XML Tradefed complessivo è delimitato da tag <configuration>. Tradefed objects sono definiti nei propri tag, ad esempio: build_provider, target_preparer, test e così via. Le finalità individuali sono descritte in più nel documento Architettura .

Ogni oggetto ha la classe Java associata all'oggetto definito in class= che viene risolto in fase di runtime, purché il file JAR contenente la classe sia nel classpath Java Tradefed durante l'esecuzione, verrà trovato e risolto.

Ordini di oggetti scambiati

L'ordine dei vari tag non è importante. Ad esempio, differenza se build_provider viene specificato dopo target_preparer. Il flusso di la chiamata di test viene applicata dal cablaggio stesso, quindi chiama sempre nel giusto ordine.

L'ordine degli oggetti con lo stesso tag è importante. Ad esempio, due target_preparer oggetti definiti verranno chiamati in ordine di definizione in il file XML. È importante comprenderlo perché può cambiare lo stato finale la configurazione del dispositivo. Ad esempio, lampeggiare e installare un APK non sarebbe è come installare un apk e lampeggiare, poiché il flashing cancellerebbe i dati del dispositivo.