BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

คลาสย่อยโดยตรงที่ทราบ AtraceCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, GcovCodeCoverageCollector, GcovKernelCodeCoverageCollector, HostStatsdMetricCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, LogcatTimingMetricCollector, RebootReasonCollector, RuntimeRestartCollector, ScreenshotOnFailureCollector AtraceCollector IMetricCollector ที่เรียกใช้การติดตามระหว่างการทดสอบและรวบรวมผลลัพธ์และบันทึกลงในการเรียกใช้  BugreportzOnFailureCollector รวบรวมรายงานข้อบกพร่องเมื่อเฟรมทดสอบไม่ผ่าน  BugreportzOnTestCaseFailureCollector รวบรวมรายงานข้อบกพร่องเมื่อกรณีทดสอบในการเรียกใช้ไม่สําเร็จ  ClangCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุมของ Clang จากอุปกรณ์และบันทึกเป็นรายการทดสอบ  CountTestCasesCollector นับและรายงานจำนวนกรอบการทดสอบสำหรับ IRemoteTest ที่ระบุ  DebugHostLogOnFailureCollector ตัวรวบรวมที่จะรวบรวมและบันทึกบันทึกฝั่งโฮสต์เมื่อเกิดข้อผิดพลาดในชุดทดสอบ  DeviceTraceCollector เครื่องมือรวบรวมข้อมูลที่จะเริ่มการติดตามด้วย Perfetto เมื่อการทดสอบเริ่มขึ้นและบันทึกไฟล์การติดตามเมื่อสิ้นสุด  FilePullerDeviceMetricCollector BaseDeviceMetricCollector ที่คอยฟังคีย์เมตริกที่มาจากอุปกรณ์และดึงข้อมูลเหล่านั้นเป็นไฟล์จากอุปกรณ์  GcovCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุมของ GCP ออกจากอุปกรณ์และบันทึกการวัดดังกล่าวเป็นอาร์ติแฟกต์ทดสอบ  GcovKernelCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุมของเคอร์เนล gcov ออกจาก debugf และออกจากอุปกรณ์ จากนั้นจะบันทึกเป็นอาร์ติแฟกต์การทดสอบ  HostStatsdMetricCollector IMetricCollector ที่รวบรวมเมตริก statsd จากฝั่งโฮสต์โดยใช้คําสั่งยูทิลิตี statsd   JavaCodeCoverageCollector BaseDeviceMetricCollector ที่จะดึงการวัดการครอบคลุมของ Java จากอุปกรณ์และบันทึกเป็นรายการทดสอบ  LogcatOnFailureCollector ผู้รวบรวมที่จะรับและบันทึก Logcat เมื่อกรอบการทดสอบล้มเหลว  LogcatTimingMetricCollector ตัวรวบรวมเมตริกที่รวบรวมข้อมูลการกําหนดเวลา (เช่น เวลาสลับของผู้ใช้) จาก logcat ระหว่างการทดสอบซ้ำ 1 ครั้งหรือหลายครั้งโดยใช้รูปแบบนิพจน์ทั่วไปที่ระบุเพื่อแยกวิเคราะห์สัญญาณเริ่มต้นและสิ้นสุดของเหตุการณ์จากบรรทัด logcat  RebootReasonCollector ตัวรวบรวมที่รวบรวมการรีบูตอุปกรณ์ระหว่างการทดสอบและรายงานตามเหตุผลและจำนวน  RuntimeRestartCollector ตัวรวบรวมที่รวบรวมการประทับเวลาของการรีสตาร์ทรันไทม์ (เซิร์ฟเวอร์ของระบบขัดข้อง) ระหว่างการดำเนินการทดสอบ หากมี  ScreenshotOnFailureCollector ตัวรวบรวมที่จะจับภาพและบันทึกภาพหน้าจอเมื่อเฟรมทดสอบไม่ผ่าน

คลาสย่อยโดยอ้อมที่รู้จัก AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector AtraceRunMetricCollector รวบรวมการติดตามจากไดเรกทอรีทดสอบทั้งหมดภายใต้ไดเรกทอรีที่ระบุจากอุปกรณ์ทดสอบ บันทึกไดเรกทอรีทดสอบ และโพสต์ไฟล์การติดตามภายในไดเรกทอรีทดสอบ และรวบรวมเมตริก  BluetoothConnectionLatencyCollector ตัวรวบรวมจะพุชการกําหนดค่าเมตริกระยะเวลา statsd ที่กําหนดไว้ล่วงหน้าไปยังอุปกรณ์และรวบรวมระยะเวลาการเชื่อมต่อบลูทูธสําหรับแต่ละโปรไฟล์  BluetoothConnectionStateCollector เครื่องมือรวบรวมนี้จะรวบรวมเมตริก BluetoothConnectionStateChanged และบันทึกจํานวนสถานะการเชื่อมต่อสําหรับแต่ละโปรไฟล์  BluetoothHciSnoopLogCollector ตัวรวบรวมเพื่อเปิดใช้การบันทึกสอดแนมบลูทูธ HCI ใน DUT และรวบรวมบันทึกสําหรับการทดสอบแต่ละครั้ง  FilePullerLogCollector ตัวบันทึกไฟล์ที่ด้านอุปกรณ์รายงาน  ModuleLogcatCollector เวอร์ชันของเครื่องมือรวบรวม Logcat สำหรับโมดูล  PerfettoPullerMetricCollector การติดตั้งใช้งานพื้นฐานของ FilePullerDeviceMetricCollector ที่อนุญาตให้ดึงไฟล์ Perfetto จากอุปกรณ์และรวบรวมเมตริกจากไฟล์  ShowmapPullerMetricCollector การติดตั้งใช้งานพื้นฐานของ FilePullerDeviceMetricCollector ที่อนุญาตให้ดึงไฟล์ Showmap จากอุปกรณ์และรวบรวมเมตริกจากไฟล์  TraceCmdCollector IMetricCollector ที่รวบรวมร่องรอยระหว่างการทดสอบโดยใช้ trace-cmd และบันทึกร่องรอยเหล่านั้นลงในการเรียกใช้

---

การใช้งานพื้นฐานของ IMetricCollector ที่อนุญาตให้เริ่มและหยุดการเก็บรวบรวมใน onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) และ ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))

สรุป

ช่อง
public static final String	TEST_CASE_EXCLUDE_GROUP_OPTION
public static final String	TEST_CASE_INCLUDE_GROUP_OPTION

ตัวสร้างแบบสาธารณะ
BaseDeviceMetricCollector()

เมธอดสาธารณะ
void	extraInit(IInvocationContext context, ITestInvocationListener listener)
final	getBuildInfos() แสดงรายการข้อมูลบิลด์ที่มีอยู่ในการเรียกใช้
final	getDevices() แสดงรายการอุปกรณ์ที่ใช้ได้ในการเรียกใช้
File	getFileFromTestArtifacts(String fileName) เรียกข้อมูลไฟล์จากอาร์ติแฟกต์ทดสอบหรืออาร์ติแฟกต์ของโมดูล และแคชไฟล์ดังกล่าวในแผนที่สำหรับการเรียกครั้งต่อๆ มา
final ITestInvocationListener	getInvocationListener() แสดงผล ITestInvocationListener เดิมที่เราส่งต่อผลลัพธ์
String	getModuleName()
final	getRealDevices() แสดงผลอุปกรณ์ที่ไม่ใช่อุปกรณ์จำลองทั้งหมดจากรายการ getDevices()
String	getRunName() แสดงชื่อของการเรียกใช้การทดสอบ mRunName ที่ทริกเกอร์ตัวรวบรวม
final ITestInvocationListener	init(IInvocationContext context, ITestInvocationListener listener) เริ่มต้นใช้งานเครื่องมือรวบรวมข้อมูลด้วยบริบทปัจจุบันและปลายทางที่จะส่งต่อผลลัพธ์
final void	invocationEnded(long elapsedTime) รายงานว่าการเรียกใช้สิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือไม่สำเร็จเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
final void	invocationFailed(FailureDescription failure) รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากสภาพขณะเกิดข้อผิดพลาดบางอย่าง
final void	invocationFailed(Throwable cause) รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากสภาพขณะเกิดข้อผิดพลาดบางอย่าง
void	invocationSkipped(SkipReason reason) รายงานการเรียกใช้ว่าข้าม
final void	invocationStarted(IInvocationContext context) Listener การเรียกใช้สำหรับการส่งต่อ
final boolean	isDisabled() แสดงค่า "จริง" หากออบเจ็กต์ทั้งหมดปิดอยู่ (ข้ามทั้งการตั้งค่าและการเลิกใช้งาน)
boolean	isDisabledReceiver() IDeviceActionReceiver ปิดอยู่หรือไม่
final void	logAssociation(String dataName, LogFile logFile) อย่าใช้การติดตั้งใช้งานเครื่องมือรวบรวมเมตริกภายใน
void	onTestAssumptionFailure(DeviceMetricData testData, TestDescription test) เรียกกลับเมื่อกรอบการทดสอบไม่ผ่านเนื่องจากความคาดหวังไม่สำเร็จ
void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) การติดต่อกลับเมื่อเคสทดสอบสิ้นสุดลง
void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics) การติดต่อกลับเมื่อเคสทดสอบสิ้นสุดลง
void	onTestFail(DeviceMetricData testData, TestDescription test) ติดต่อกลับเมื่อกรอบการทดสอบไม่สำเร็จ
void	onTestModuleEnded() อนุญาตให้บันทึกเหตุการณ์ที่โมดูลสิ้นสุด
void	onTestModuleStarted() อนุญาตให้บันทึกเหตุการณ์ที่เริ่มโดยโมดูล
void	onTestRunEnd(DeviceMetricData runData, currentRunMetrics) การโทรกลับเมื่อการทดสอบสิ้นสุดลง
void	onTestRunFailed(DeviceMetricData testData, FailureDescription failure) ฟังก์ชันการเรียกกลับสําหรับเหตุการณ์ testRunFailed
void	onTestRunStart(DeviceMetricData runData) การเรียกกลับเมื่อเริ่มการทดสอบ
void	onTestStart(DeviceMetricData testData) การเรียกกลับเมื่อเริ่มการทดสอบเคส
void	rebootEnded(ITestDevice device) รับการแจ้งเตือนเมื่อการรีบูตในอุปกรณ์สิ้นสุดลง
void	rebootStarted(ITestDevice device) รับการแจ้งเตือนเมื่ออุปกรณ์เริ่มรีบูต
final void	setDisable(boolean isDisabled) ตั้งค่าว่าควรปิดใช้ออบเจ็กต์หรือไม่
void	setDisableReceiver(boolean isDisabled) ตั้งค่าว่าควรปิดใช้ IDeviceActionReceiver หรือไม่
final void	setLogSaver(ILogSaver logSaver) อย่าใช้การติดตั้งใช้งานเครื่องมือรวบรวมเมตริกภายใน
final void	testAssumptionFailure(TestDescription test, String trace) เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่าถือว่าเงื่อนไขเป็นเท็จ
final void	testAssumptionFailure(TestDescription test, FailureDescription failure) เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่าถือว่าเงื่อนไขเป็นเท็จ
final void	testEnded(TestDescription test, long endTime, testMetrics) ทางเลือกสำหรับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) ซึ่งเราสามารถระบุเวลาสิ้นสุดได้โดยตรง
final void	testEnded(TestDescription test, testMetrics) รายงานการสิ้นสุดการดําเนินการของ Test Case แต่ละรายการ
final void	testFailed(TestDescription test, FailureDescription failure) รายงานการทดสอบแต่ละรายการที่ล้มเหลว
final void	testFailed(TestDescription test, String trace) รายงานการทดสอบแต่ละรายการที่ล้มเหลว
final void	testIgnored(TestDescription test) เรียกใช้เมื่อระบบจะไม่เรียกใช้การทดสอบ ซึ่งโดยทั่วไปแล้วเป็นเพราะเมธอดทดสอบมีคำอธิบายประกอบด้วย annotate ของ org.junit.Ignore
final void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) ให้ข้อมูลบันทึกหรือข้อมูลการแก้ไขข้อบกพร่องที่เกี่ยวข้องจากการเรียกใช้ทดสอบ
final void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) อย่าใช้การติดตั้งใช้งานเครื่องมือรวบรวมเมตริกภายใน
final void	testModuleEnded() รายงานการสิ้นสุดการเรียกใช้ข้อบังคับ
final void	testModuleStarted(IInvocationContext moduleContext) รายงานการเริ่มต้นการทํางานของโมดูล
final void	testRunEnded(long elapsedTime, runMetrics) สิ้นสุดการทดสอบรายงาน
final void	testRunFailed(FailureDescription failure) การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription
final void	testRunFailed(String errorMessage) การดำเนินการทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากข้อผิดพลาดร้ายแรง
final void	testRunStarted(String runName, int testCount, int attemptNumber) รายงานการเริ่มต้นการทดสอบ
final void	testRunStarted(String runName, int testCount) การติดต่อกลับของการดำเนินการทดสอบ
final void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) รายงานการเริ่มต้นการทดสอบ
final void	testRunStopped(long elapsedTime) การทดสอบรายงานหยุดลงก่อนเสร็จสมบูรณ์ตามคําขอของผู้ใช้
final void	testSkipped(TestDescription test, SkipReason reason) เรียกใช้เมื่อมีการข้ามการทดสอบและไม่ทํางานด้วยเหตุผลที่ปกติแล้วไม่คาดคิด
final void	testStarted(TestDescription test, long startTime) ทางเลือกสำหรับ testStarted(com.android.tradefed.result.TestDescription) ซึ่งเราจะระบุเวลาที่เริ่มการทดสอบด้วย ร่วมกับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) เพื่อการวัดผลที่แม่นยำ
final void	testStarted(TestDescription test) การติดต่อกลับของเฟรมเวิร์กการทดสอบ

ช่อง

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

ตัวสร้างแบบสาธารณะ

ตัวรวบรวมเมตริกอุปกรณ์ฐาน

public BaseDeviceMetricCollector ()

วิธีการสาธารณะ

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

โยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildInfos

public final  getBuildInfos ()

แสดงรายการข้อมูลบิลด์ที่มีในการเรียกใช้

คิกรีเทิร์น

getDevices

public final  getDevices ()

แสดงรายการอุปกรณ์ที่มีในการเรียกใช้

คิกรีเทิร์น

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

ดึงไฟล์จากอาร์ติแฟกต์การทดสอบหรืออาร์ติแฟกต์โมดูล และแคชไว้ในแผนที่สําหรับการเรียกใช้ครั้งต่อๆ ไป

พารามิเตอร์
fileName	String: ชื่อไฟล์ที่จะค้นหาในอาร์ติแฟกต์

คิกรีเทิร์น
File	ไฟล์จากอาร์ติแฟกต์การทดสอบหรืออาร์ติแฟกต์โมดูล แสดงผล Null หากไม่พบไฟล์

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

แสดงผล ITestInvocationListener เดิมที่เราส่งต่อผลลัพธ์

คิกรีเทิร์น
ITestInvocationListener

getModuleName

public String getModuleName ()

คิกรีเทิร์น
String

getRealDevices

public final  getRealDevices ()

แสดงผลอุปกรณ์ที่ไม่ใช่อุปกรณ์จำลองทั้งหมดจากรายการ getDevices()

คิกรีเทิร์น

getRunName

public String getRunName ()

แสดงผลชื่อการทดสอบ mRunName ที่ทริกเกอร์เครื่องมือรวบรวม

คิกรีเทิร์น
String	mRunName ซึ่งเป็นชื่อการเรียกใช้การทดสอบปัจจุบัน

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

เริ่มต้นใช้งานเครื่องมือรวบรวมข้อมูลด้วยบริบทปัจจุบันและปลายทางที่จะส่งต่อผลลัพธ์ ระบบจะเรียกใช้เพียงครั้งเดียวต่ออินสแตนซ์ และคาดว่าตัวรวบรวมจะอัปเดตบริบทและตัวฟังภายใน ก่อนหน้านี้จะไม่มีการเปิดใช้งาน Init ในระหว่างการทดสอบ

อย่าลบล้างเว้นแต่คุณจะทราบว่าคุณกำลังทำอะไรอยู่

พารามิเตอร์
context	IInvocationContext: IInvocationContext สำหรับการเรียกใช้ที่อยู่ระหว่างดำเนินการ
listener	ITestInvocationListener: ITestInvocationListener สำหรับวางผลลัพธ์

คิกรีเทิร์น
ITestInvocationListener	โปรแกรมฟังเสียงใหม่จะรวมโปรแกรมฟังเสียงเดิม

โยน
DeviceNotAvailableException

invocationEnded

public final void invocationEnded (long elapsedTime)

รายงานว่าการเรียกใช้สิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือไม่สำเร็จเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ

พารามิเตอร์
elapsedTime	long: เวลาผ่านไปของคําเรียกเป็นมิลลิวินาที

invocationFailed

public final void invocationFailed (FailureDescription failure)

รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากสภาพขณะเกิดข้อผิดพลาดบางอย่าง

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ

พารามิเตอร์
failure	FailureDescription: FailureDescription ที่อธิบายสาเหตุของการไม่สําเร็จ

invocationFailed

public final void invocationFailed (Throwable cause)

รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากสภาพขณะเกิดข้อผิดพลาดบางอย่าง

จะถูกเรียกโดยอัตโนมัติโดยเฟรมเวิร์ก TradeFederation

พารามิเตอร์
cause	Throwable: Throwable สาเหตุของการไม่สําเร็จ

invocationSkipped

public void invocationSkipped (SkipReason reason)

รายงานการเรียกใช้ว่าข้าม

พารามิเตอร์
reason	SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

Listener การเรียกใช้สำหรับการส่งต่อ

พารามิเตอร์
context	IInvocationContext: ข้อมูลเกี่ยวกับการเรียกใช้

ปิดใช้

public final boolean isDisabled ()

แสดงค่า "จริง" หากออบเจ็กต์ทั้งหมดปิดอยู่ (ข้ามทั้งการตั้งค่าและการเลิกใช้งาน) จะเป็นเท็จหากไม่เป็นเช่นนั้น

คิกรีเทิร์น
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

มีการปิดใช้งาน IDeviceActionReceiver หรือไม่

คิกรีเทิร์น
boolean	แสดงผลเป็น "จริง" หากปิดใช้ หรือแสดงผลเป็น "เท็จ" หากเปิดใช้

การเชื่อมโยงบันทึก

public final void logAssociation (String dataName, 
                LogFile logFile)

อย่าใช้การติดตั้งใช้งานเครื่องมือรวบรวมเมตริกภายใน การดำเนินการนี้เป็นการส่งต่ออย่างแท้จริง

พารามิเตอร์
dataName	String: ชื่อของข้อมูล
logFile	LogFile: LogFile ที่บันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับกรณีทดสอบ

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

ติดต่อกลับเมื่อกรอบการทดสอบล้มเหลวเนื่องจากสันนิษฐานล้มเหลว

พารามิเตอร์
testData	DeviceMetricData: DeviceMetricData ที่มีข้อมูลสำหรับกรณีทดสอบ
test	TestDescription: TestDescription ของกรอบการทดสอบอยู่ระหว่างดำเนินการ

การขว้าง
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

ติดต่อกลับเมื่อกรอบการทดสอบสิ้นสุดลง ขั้นตอนนี้ควรเป็นขั้นตอนการล้าง

พารามิเตอร์
testData	DeviceMetricData: DeviceMetricData ที่มีข้อมูลสำหรับกรณีทดสอบ ซึ่งจะเป็นออบเจ็กต์เดียวกับระหว่าง onTestStart(com.android.tradefed.device.metric.DeviceMetricData)
currentTestCaseMetrics	: แผนที่ปัจจุบันของเมตริกที่ส่งไปยัง ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
test	TestDescription: TestDescription ของเฟรมทดสอบที่อยู่ระหว่างดำเนินการ

การขว้าง
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

ติดต่อกลับเมื่อกรอบการทดสอบสิ้นสุดลง ขั้นตอนนี้ควรเป็นขั้นตอนการล้าง

พารามิเตอร์
testData	DeviceMetricData: DeviceMetricData ที่มีข้อมูลสำหรับกรณีทดสอบ ซึ่งจะเป็นออบเจ็กต์เดียวกับระหว่าง onTestStart(com.android.tradefed.device.metric.DeviceMetricData)
currentTestCaseMetrics	: แผนที่เมตริกปัจจุบันที่ส่งไปยัง ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))

โยน
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

ติดต่อกลับเมื่อกรอบการทดสอบไม่สำเร็จ

พารามิเตอร์
testData	DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรอบการทดสอบ
test	TestDescription: TestDescription ของเฟรมทดสอบที่อยู่ระหว่างดำเนินการ

โยน
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

อนุญาตให้บันทึกเหตุการณ์ที่โมดูลสิ้นสุด

โยน
DeviceNotAvailableException

onTestModuleเริ่ม

public void onTestModuleStarted ()

อนุญาตให้บันทึกเหตุการณ์ที่เริ่มโดยโมดูล

โยน
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

การโทรกลับเมื่อการทดสอบสิ้นสุดลง ขั้นตอนนี้ควรเป็นขั้นตอนการล้าง

พารามิเตอร์
runData	DeviceMetricData: DeviceMetricData ที่มีข้อมูลสําหรับการเรียกใช้ จะเป็นออบเจ็กต์เดียวกันกับระหว่าง onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)
currentRunMetrics	: แผนที่เมตริกปัจจุบันที่ส่งไปยัง ERROR(/#testRunEnded(long,Map))

โยน
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

ฟังก์ชันการเรียกกลับสําหรับเหตุการณ์ testRunFailed

โยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

การเรียกกลับเมื่อเริ่มการทดสอบ

พารามิเตอร์
runData	DeviceMetricData: DeviceMetricData ที่มีข้อมูลสําหรับการเรียกใช้

โยน
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

การเรียกกลับเมื่อเริ่มการทดสอบเคส

พารามิเตอร์
testData	DeviceMetricData: DeviceMetricData ที่มีข้อมูลสำหรับกรณีทดสอบ

โยน
DeviceNotAvailableException

rebootEnded

public void rebootEnded (ITestDevice device)

รับการแจ้งเตือนเมื่อการรีบูตในอุปกรณ์สิ้นสุดลง

หมายเหตุ: ผู้รับควรหลีกเลี่ยงการรีบูตในระหว่าง Callback นี้ ระบบจะไม่สนใจการพยายามรีบูต

พารามิเตอร์
device	ITestDevice: ITestDevice ซึ่งเป็นจุดสิ้นสุดของการรีบูต

การขว้าง
DeviceNotAvailableException

rebootStarted

public void rebootStarted (ITestDevice device)

รับการแจ้งเตือนเมื่ออุปกรณ์เริ่มรีบูต

หมายเหตุ: ผู้รับควรหลีกเลี่ยงการรีบูตในระหว่าง Callback นี้ ระบบจะไม่สนใจการพยายามรีบูต

พารามิเตอร์
device	ITestDevice: ITestDevice ซึ่งเป็นจุดที่การรีบูตเริ่มต้น

โยน
DeviceNotAvailableException

ตั้งค่าปิดใช้

public final void setDisable (boolean isDisabled)

ตั้งค่าว่าควรปิดใช้ออบเจ็กต์หรือไม่ ปิดใช้หมายความว่าควรข้ามทั้งขั้นตอนการตั้งค่าและการรื้อถอน ใช้เพื่อทำให้ออบเจ็กต์ปิดใช้โดยค่าเริ่มต้นในตัวสร้างเริ่มต้นได้

พารามิเตอร์
isDisabled	boolean: สถานะที่ควรใส่ออบเจ็กต์

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

ตั้งค่าว่าควรปิดใช้ IDeviceActionReceiver หรือไม่ การปิดใช้หมายความว่าเหตุการณ์จะไม่ได้รับการลงทะเบียนในอุปกรณ์เพื่อรับเหตุการณ์การดำเนินการของอุปกรณ์

พารามิเตอร์
isDisabled	boolean

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

อย่าใช้ตัวรวบรวมเมตริกภายใน การดำเนินการนี้เป็นการส่งต่ออย่างแท้จริง

พารามิเตอร์
logSaver	ILogSaver: ILogSaver

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่าถือว่าเงื่อนไขเป็นเท็จ

พารามิเตอร์
test	TestDescription: ระบุการทดสอบ
trace	String: สแต็กเทรซของข้อผิดพลาด

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่าถือว่าเงื่อนไขเป็นเท็จ

พารามิเตอร์
test	TestDescription: ระบุการทดสอบ
failure	FailureDescription: FailureDescription อธิบายความล้มเหลวและบริบท

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

ทางเลือกสำหรับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) ซึ่งเราสามารถระบุเวลาสิ้นสุดได้โดยตรง ใช้ร่วมกับ testStarted(com.android.tradefed.result.TestDescription, long) เพื่อให้การวัดผลแม่นยำ

พารามิเตอร์
test	TestDescription: ระบุการทดสอบ
endTime	long: เวลาสิ้นสุดการทดสอบซึ่งวัดผ่าน System.currentTimeMillis()
testMetrics	: ERROR(/Map) ของเมตริกที่ส่งออก

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

รายงานการสิ้นสุดการดำเนินการของกรอบการทดสอบแต่ละรายการ

หากไม่มีการเรียกใช้ testFailed(TestDescription, FailureDescription) แสดงว่าทดสอบนี้ผ่าน และยังแสดงเมตริกคีย์/ค่าที่อาจแสดงระหว่างการเรียกใช้ชุดทดสอบด้วย

พารามิเตอร์
test	TestDescription: ระบุการทดสอบ
testMetrics	: ERROR(/Map) ของเมตริกที่ส่งออก

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

รายงานการทดสอบแต่ละรายการที่ล้มเหลว

ระบบจะเรียกใช้ระหว่าง testStarted และ testEnded

พารามิเตอร์
test	TestDescription: ระบุการทดสอบ
failure	FailureDescription: FailureDescription ที่อธิบายความล้มเหลวและบริบท

การทดสอบล้มเหลว

public final void testFailed (TestDescription test, 
                String trace)

รายงานการทดสอบแต่ละรายการที่ล้มเหลว

ระบบจะเรียกใช้ระหว่าง testStarted และ testEnded

พารามิเตอร์
test	TestDescription: ระบุการทดสอบ
trace	String: สแต็กเทรซของข้อผิดพลาด

testIgnored

public final void testIgnored (TestDescription test)

เรียกใช้เมื่อการทดสอบจะไม่ทำงาน โดยทั่วไปเนื่องจากวิธีการทดสอบมีคำอธิบายประกอบเป็น org.junit. ignore

พารามิเตอร์
test	TestDescription: ระบุการทดสอบ

บันทึกการทดสอบ

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

ให้ข้อมูลบันทึกหรือข้อมูลแก้ไขข้อบกพร่องที่เชื่อมโยงจากการเรียกใช้การทดสอบ

ต้องเรียกใช้ก่อน ERROR(/ITestInvocationListener#invocationFailed(Throwable)) หรือ ERROR(/ITestInvocationListener#invocationEnded(long))

เฟรมเวิร์ก TradeFederation จะเรียกใช้เมธอดนี้โดยอัตโนมัติ โดยจะระบุบันทึกของโฮสต์และบันทึก Logcat ของอุปกรณ์ (หากมี)

พารามิเตอร์
dataName	String: ชื่อที่สื่อความหมายถึง String ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการเรียกใช้ 1 ครั้ง เช่น ผู้ติดตั้งใช้งานต้องจัดการกับการเรียกใช้หลายครั้งที่มี dataName เดียวกันได้
dataType	LogDataType: LogDataType ของข้อมูล
dataStream	InputStreamSource: InputStreamSource ของข้อมูล ผู้ใช้งานควรเรียกใช้ createInputStream เพื่อเริ่มอ่านข้อมูล และอย่าลืมปิด InputStream ที่ได้เมื่ออ่านเสร็จแล้ว ผู้เรียกใช้ควรตรวจสอบว่าแหล่งที่มาของข้อมูลยังคงอยู่และเข้าถึงได้จนกว่าเมธอด testLog จะเสร็จสมบูรณ์

บันทึกการทดสอบที่บันทึกไว้

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

อย่าใช้การติดตั้งใช้งานเครื่องมือรวบรวมเมตริกภายใน การดำเนินการนี้เป็นการส่งต่ออย่างแท้จริง

พารามิเตอร์
dataName	String: ชื่อที่สื่อความหมายถึง String ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการเรียกใช้ 1 ครั้ง เช่น ผู้ติดตั้งใช้งานต้องจัดการกับการเรียกใช้หลายครั้งที่มี dataName เดียวกันได้
dataType	LogDataType: LogDataType ของข้อมูล
dataStream	InputStreamSource: InputStreamSource ของข้อมูล ผู้ใช้งานควรเรียกใช้ createInputStream เพื่อเริ่มอ่านข้อมูล และอย่าลืมปิด InputStream ที่ได้เมื่ออ่านเสร็จแล้ว
logFile	LogFile: LogFile ที่มีข้อมูลเมตาของไฟล์ที่บันทึกไว้

testModuleEnded

public final void testModuleEnded ()

รายงานเมื่อสิ้นสุดการเรียกใช้โมดูล

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

รายงานการเริ่มต้นการทํางานของโมดูล การเรียกกลับนี้เชื่อมโยงกับ testModuleEnded() และสามารถเลือกใช้ในลำดับหรือไม่ก็ได้ โดยจะใช้ระหว่างการวิ่งที่ใช้โมดูล: ตัววิ่งตามชุดโปรแกรมเท่านั้น

พารามิเตอร์
moduleContext	IInvocationContext: IInvocationContext ของโมดูล

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

รายงานการสิ้นสุดการทดสอบ

พารามิเตอร์
elapsedTime	long: เวลาที่อุปกรณ์รายงานเป็นมิลลิวินาทีที่ผ่านไป
runMetrics	: คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบ

testRunFailed

public final void testRunFailed (FailureDescription failure)

การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription

พารามิเตอร์
failure	FailureDescription: FailureDescription อธิบายความล้มเหลวและบริบท

testRunFailed

public final void testRunFailed (String errorMessage)

การเรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากข้อผิดพลาดร้ายแรง

พารามิเตอร์
errorMessage	String: String อธิบายสาเหตุของการเรียกใช้ที่ไม่สําเร็จ

เริ่มการทดสอบแล้ว

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

รายงานการเริ่มต้นการทดสอบ

พารามิเตอร์
runName	String: ชื่อการทดสอบ
testCount	int: จํานวนการทดสอบทั้งหมดในการทํางานทดสอบ
attemptNumber	int: หมายเลขคำสั่งซื้อ ซึ่งระบุการพยายามต่างๆ ของ runName เดียวกันที่เรียกใช้หลายครั้ง การทบทวน Number เป็น 0 และควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่เกิดขึ้น เช่น การทดสอบมีการลองใหม่ 3 ครั้ง ควรมีการเรียกใช้ทั้งหมด 4 ครั้งภายใต้ runName เดียวกัน และ beginNumber จาก 0 ถึง 3

เริ่มการทดสอบแล้ว

public final void testRunStarted (String runName, 
                int testCount)

ทดสอบการรัน Callback

พารามิเตอร์
runName	String: ชื่อการทดสอบ
testCount	int: จํานวนการทดสอบทั้งหมดในการทํางานทดสอบ

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

รายงานการเริ่มต้นการทดสอบ

พารามิเตอร์
runName	String: ชื่อการทดสอบ
testCount	int: จํานวนการทดสอบทั้งหมดในการทํางานทดสอบ
attemptNumber	int: หมายเลขคำสั่งซื้อ ระบุความพยายามที่แตกต่างกันของ runName เดียวกันที่เรียกใช้หลายครั้ง attemptNumber จะเริ่มต้นที่ 0 และควรเพิ่มขึ้นทุกครั้งที่มีการทำงานใหม่ เช่น การทดสอบได้รับการลองใหม่แบบละเอียด 3 ครั้ง ก็ควรมีการเรียกใช้ทั้งหมด 4 ครั้งภายใต้ runName เดียวกัน และ attemptNumber จะอยู่ระหว่าง 0 ถึง 3
startTime	long: เวลาเริ่มต้นการเรียกใช้ ซึ่งวัดผ่าน System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

การทดสอบรายงานหยุดลงก่อนเสร็จสมบูรณ์ตามคําขอของผู้ใช้

สิ่งที่ต้องทำ: ยังไม่ได้ใช้ในขณะนี้ ลองพิจารณาลบ

พารามิเตอร์
elapsedTime	long: เวลาที่ผ่านไปที่อุปกรณ์รายงานเป็นมิลลิวินาที

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

มีการเรียกใช้เมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่ไม่คาดคิด ระบบจะพยายามทดสอบเหล่านี้อีกครั้งเพื่อพยายามเรียกใช้อย่างถูกต้อง

พารามิเตอร์
test	TestDescription: ระบุการทดสอบ
reason	SkipReason: SkipReason

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

ทางเลือกสำหรับ testStarted(com.android.tradefed.result.TestDescription) ซึ่งเราจะระบุเวลาที่เริ่มการทดสอบด้วย ร่วมกับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) เพื่อการวัดผลที่แม่นยำ

พารามิเตอร์
test	TestDescription: ระบุการทดสอบ
startTime	long: เวลาที่การทดสอบเริ่มต้นขึ้น วัดผ่าน System.currentTimeMillis()

testStarted

public final void testStarted (TestDescription test)

Callback ของกรณีทดสอบ

พารามิเตอร์
test	TestDescription: ระบุการทดสอบ