Hostbasierte Messwert-Erfassungen werden auf dem Host und nicht auf Geräteseite ausgeführt. Sie interagieren von der Hostseite aus mit dem Gerät, um die Messwerte zu erfassen, auf die sie ausgerichtet sind.
Design des Messwert-Collectors
Die Basisklasse, die alle Collector erweitern, ist BaseDeviceMetricCollector
. Sie bietet dieselben gemeinsamen grundlegenden Funktionen:
- Filtern
- Deaktivierung
- Sammlung von Testfällen im Vergleich zu Testläufen
Sie folgen dem Modell eines Ergebnisberichters, da sie mit der Testausführung auf dem Host synchronisiert werden. Mit anderen Worten: Wenn Tests hostbasiert sind, werden die Collectors ausgeführt, bevor der Test mit dem nächsten Ausführungsschritt fortfährt.
Wenn der Collector beispielsweise bei testEnded
ausgeführt wird, werden die entsprechenden Daten erfasst, bevor mit testStart
der nächste Test ausgeführt wird.
Hostbasierten Messwert-Collector implementieren
Wenn Sie die Basisklasse BaseDeviceMetricCollector
implementieren, können Sie festlegen, wann die Messwerte während des Lebenszyklus erfasst werden sollen:
- Wenn ein Testlauf beginnt:
onTestRunStart
- Zu Beginn eines Testfalls:
onTestStart
- Wenn ein Testfall endet:
onTestEnd
- Wenn ein Test abgeschlossen ist:
onTestRunEnd
Asynchrone Datenerhebung durchführen
Zusätzlich zu den synchronen Methoden bietet TF eine Basisklasse zur Implementierung, die eine regelmäßige asynchrone Erhebung durchführt, ScheduledDeviceMetricCollector
, die eine zu implementierende collect
-Methode bietet, die regelmäßig ausgeführt wird.
Der Zeitraum kann über Optionen angepasst werden.
XML-Konfiguration
Das Objekt-Tag ist metrics_collector
, z. B.:
<metrics_collector class="com.android.tradefed.device.metric.AtraceCollector">
<option name="categories" value="freq"/>
</metrics_collector>
Empfehlungen
Sehen Sie sich die Liste der vorhandenen Messwerte an, um zu vermeiden, dass Sie Arbeit duplizieren. Wir versuchen, die Wiederverwendbarkeit zu maximieren. Wenn jeder Collector nur eine Art von Datenerhebung durchführt, können verschiedene Collector während der Testausführung besser kombiniert und abgeglichen werden.