Una suite tende a includere diversi moduli di test e può raggiungere dimensioni del corpus di test piuttosto grandi. Ad esempio, Android Compatibility Test Suite (CTS) include centinaia di moduli e centinaia di migliaia di casi di test.
Diventa possibile che un gran numero di test falliscano a causa di uno scarso isolamento o di dispositivi in cattivo stato.
La funzionalità di ripetizione dei tentativi della suite è pensata per risolvere questi casi: consente di riprovare solo gli errori anziché le suite complete per escludere instabilità e scarso isolamento. Se un test fallisce costantemente, anche il nuovo tentativo fallisce; e ottieni un segnale molto più forte che c'è un vero problema.
Implementare il nuovo tentativo della suite
Il nuovo tentativo di risultati implica la lettura dei risultati precedenti e la riesecuzione della chiamata precedente.
L'interfaccia principale che guida il nuovo tentativo è ITestSuiteResultLoader
, che consente di caricare un risultato precedente e la riga di comando precedente.
RetryRescheduler
utilizza quindi queste informazioni per ricreare il comando precedente e popolare alcuni filtri per rieseguire solo gli errori precedenti o i test non eseguiti.
Nuovo tentativo della suite di esempio: CTS
La configurazione dei tentativi in CTS è:
<configuration description="Runs a retry of a previous CTS session.">
<object type="previous_loader" class="com.android.compatibility.common.tradefed.result.suite.PreviousResultLoader" />
<test class="com.android.tradefed.testtype.suite.retry.RetryRescheduler" />
<logger class="com.android.tradefed.log.FileLogger">
<option name="log-level-display" value="WARN" />
</logger>
</configuration>
Questo è applicabile alla maggior parte delle suite che lo estendono, ad esempio VTS .
Verrebbe invocato con:
cts-tradefed run retry --retry <session>
La sessione verrebbe trovata elencando i risultati precedenti nella console CTS:
cts-tf > l r
Session Pass Fail Modules Complete Result Directory Test Plan Device serial(s) Build ID Product
0 2092 30 148 of 999 2018.10.29_14.12.57 cts [serial] P Pixel
L'esatto comando originale verrà ricaricato e rieseguito con filtri aggiuntivi. Ciò significa che se il comando originale includeva alcune opzioni, anche queste faranno parte del nuovo tentativo.
Per esempio:
cts-tradefed run cts-dev -m CtsGestureTestCases
Il nuovo tentativo di cui sopra è sempre vincolato a CtsGestureTestCases
perché stiamo riprovando un comando che coinvolgeva solo lui.
Configura il nuovo tentativo per la suite in stile CTS
Affinché il nuovo tentativo funzioni, i risultati precedenti devono essere esportati in formato proto. È necessario aggiungere quanto segue:
<result_reporter class="com.android.compatibility.common.tradefed.result.suite.CompatibilityProtoResultReporter" />
Questo deve essere aggiunto alla configurazione XML del comando principale e risulta nella creazione di un file test-record.pb
nella cartella dei risultati.
Il nuovo tentativo CTS carica quindi i dati da una combinazione di test-record.pb
e test_result.xml
esistente per preparare la chiamata al nuovo tentativo.