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
- Deaktivieren
- Erfassung von Testläufen im Vergleich zu Testläufen
Sie folgen dem Modell eines Ergebnisberichts, da sie mit der Testausführung auf dem Host synchronisiert werden. Anders ausgedrückt: Wenn Tests hostgesteuert sind, werden Collectors ausgeführt, bevor der Test mit dem nächsten Ausführungsschritt fortfährt.
Wenn der Collector beispielsweise für testEnded ausgeführt wird, werden die Collectors ausgeführt, bevor die Ausführung mit dem nächsten Test mit testStart fortgesetzt wird.
Hostbasierten Messwert-Collector implementieren
Bei der Implementierung zusätzlich zur Basisklasse BaseDeviceMetricCollector können Sie entscheiden, wann Sie Ihre Messwerte während des Lebenszyklus erfassen möchten:
- Wenn ein Testlauf beginnt:
onTestRunStart - Zu Beginn eines Testfalls:
onTestStart - Wenn ein Testfall endet:
onTestEnd - Wenn ein Testlauf endet:
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 mithilfe der 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, maximale Wiederverwendbarkeit zu gewährleisten. Wenn jeder Collector einen einzigen Sammlungstyp ausführt, können die verschiedenen Collectors während der Testausführung leichter gemischt und abgeglichen werden.