BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

การติดตั้งใช้งานพื้นฐานของ IMetricCollector ที่อนุญาตให้เริ่มและหยุดการรวบรวมข้อมูลใน onTestRunStart(DeviceMetricData) และ onTestRunEnd(DeviceMetricData,Map)

สรุป

ค่าคงที่

String TEST_CASE_EXCLUDE_GROUP_OPTION

String TEST_CASE_INCLUDE_GROUP_OPTION

เครื่องมือสร้างสาธารณะ

BaseDeviceMetricCollector()

เมธอดสาธารณะ

boolean doesModuleContainFailure()

แสดงค่าเป็นจริงหากโมดูลปัจจุบันมีกรณีทดสอบหรือการทดสอบที่ล้มเหลว

void enableDefaultMetricCollection()

อนุญาตให้ผู้รวบรวมเปิดใช้การรวบรวมเมตริกเริ่มต้น

void extraInit(IInvocationContext context, ITestInvocationListener listener)
IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel()
final List<IBuildInfo> getBuildInfos()

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

final List<ITestDevice> getDevices()

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

File getFileFromTestArtifacts(String fileName)

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

final ITestInvocationListener getInvocationListener()

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

String getModuleName()
IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel()
final List<ITestDevice> getRealDevices()

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

String getRunName()

แสดงผลชื่อของการทดสอบที่เรียกใช้ mRunName ซึ่งทริกเกอร์ตัวรวบรวม

String getTestName()

แสดงผลชื่อของการทดสอบ mTestName ที่ทริกเกอร์ตัวรวบรวม

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)

Invocation Listener สำหรับการส่งต่อ

boolean isDefaultMetricCollectionEnabled()

ไม่ว่าตัวรวบรวมจะรวบรวมเมตริกเป็นส่วนหนึ่งของการรวบรวมเมตริกเริ่มต้นหรือไม่

final boolean isDisabled()

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

boolean isDisabledReceiver()

IDeviceActionReceiver ปิดใช้หรือไม่

final void logAssociation(String dataName, LogFile logFile)

อย่าใช้ในการติดตั้งใช้งานเครื่องมือรวบรวมเมตริกภายใน

void onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)

การเรียกกลับเมื่อกรณีทดสอบล้มเหลวเนื่องจากสมมติฐานไม่ถูกต้อง

void onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

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

void onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)

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

void onTestFail(DeviceMetricData testData, TestDescription test)

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

void onTestModuleEnded()

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

void onTestModuleStarted()

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

void onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)

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

void onTestRunFailed(DeviceMetricData testData, FailureDescription failure)

การเรียกกลับสำหรับเหตุการณ์ testRunFailed

void onTestRunStart(DeviceMetricData runData)

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

void onTestStart(DeviceMetricData testData)

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

void rebootEnded(ITestDevice device)

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

void rebootStarted(ITestDevice device)

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

void setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)

กำหนดระดับที่ควรให้ตัวรวบรวมรวบรวมบันทึกโดยไม่คำนึงถึงความล้มเหลว

final void setDisable(boolean isDisabled)

กำหนดว่าควรปิดใช้วัตถุหรือไม่

void setDisableReceiver(boolean isDisabled)

ตั้งค่าว่าจะปิดใช้ IDeviceActionReceiver หรือไม่

final void setLogSaver(ILogSaver logSaver)

อย่าใช้ในการติดตั้งใช้งานเครื่องมือรวบรวมเมตริกภายใน

void setModuleContainsFailure()

ตั้งค่าว่าโมดูลมีความล้มเหลวหรือไม่ (กรณีทดสอบ การทดสอบ)

void setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)

กำหนดระดับที่ควรให้ตัวรวบรวมบันทึกรวบรวมบันทึกระหว่างที่เกิดข้อผิดพลาด

final void testAssumptionFailure(TestDescription test, String trace)

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

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

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

final void testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)

ทางเลือกแทน testEnded(TestDescription,Map) ซึ่งเราสามารถระบุเวลาสิ้นสุด ได้โดยตรง

final void testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)

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

final void testFailed(TestDescription test, FailureDescription failure)

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

final void testFailed(TestDescription test, String trace)

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

final void testIgnored(TestDescription test)

เรียกใช้เมื่อจะไม่ทำการทดสอบ โดยทั่วไปเนื่องจากมีการใส่คำอธิบายประกอบเมธอดทดสอบด้วย 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, HashMap<String, MetricMeasurement.Metric> 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(TestDescription) ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบ ร่วมกับ testEnded(TestDescription,long,Map) เพื่อการวัดที่แม่นยำ

final void testStarted(TestDescription test)

การเรียกกลับของกรณีทดสอบ

ค่าคงที่

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

ค่าคงที่ "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

ค่าคงที่ "test-case-include-group"

เครื่องมือสร้างสาธารณะ

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

เมธอดสาธารณะ

doesModuleContainFailure

public boolean doesModuleContainFailure ()

แสดงค่าเป็นจริงหากโมดูลปัจจุบันมีกรณีทดสอบหรือการทดสอบที่ล้มเหลว

การคืนสินค้า
boolean

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

อนุญาตให้ผู้รวบรวมเปิดใช้การรวบรวมเมตริกเริ่มต้น เมื่อ เปิดใช้การรวบรวมเมตริกเริ่มต้นแล้ว ตัวรวบรวมควรเก็บรวบรวมที่ระดับการรวบรวมที่ระบุเท่านั้น

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

การคืนสินค้า
IMetricCollector.MetricCollectionLevel

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

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

การคืนสินค้า
List<IBuildInfo>

getDevices

public final List<ITestDevice> getDevices ()

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

การคืนสินค้า
List<ITestDevice>

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

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

พารามิเตอร์
fileName String: ชื่อของไฟล์ที่จะค้นหาในอาร์ติแฟกต์
การคืนสินค้า
File ไฟล์จากอาร์ติแฟกต์การทดสอบหรืออาร์ติแฟกต์โมดูล แสดงผล Null หากไม่พบไฟล์

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

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

การคืนสินค้า
ITestInvocationListener

getModuleName

public String getModuleName ()

การคืนสินค้า
String

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

การคืนสินค้า
IMetricCollector.MetricCollectionLevel

getRealDevices

public final List<ITestDevice> getRealDevices ()

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

การคืนสินค้า
List<ITestDevice>

getRunName

public String getRunName ()

แสดงผลชื่อของการทดสอบที่เรียกใช้ mRunName ซึ่งทริกเกอร์ตัวรวบรวม

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

getTestName

public String getTestName ()

แสดงผลชื่อของการทดสอบ mTestName ที่ทริกเกอร์ตัวรวบรวม

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

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

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

พารามิเตอร์
context IInvocationContext: IInvocationContext สำหรับการเรียกใช้ที่กำลังดำเนินการ
listener ITestInvocationListener: ITestInvocationListener ที่ใช้แสดงผลลัพธ์
การคืนสินค้า
ITestInvocationListener Listener ใหม่ที่ครอบ Listener เดิม
ส่ง
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)

Invocation Listener สำหรับการส่งต่อ

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

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

ไม่ว่าตัวรวบรวมจะรวบรวมเมตริกเป็นส่วนหนึ่งของการรวบรวมเมตริกเริ่มต้นหรือไม่

การคืนสินค้า
boolean

isDisabled

public final boolean isDisabled ()

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

การคืนสินค้า
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

IDeviceActionReceiver ปิดใช้หรือไม่

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

logAssociation

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, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

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

พารามิเตอร์
testData DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรณีทดสอบ จะเป็นออบเจ็กต์เดียวกันกับในระหว่าง onTestStart(DeviceMetricData)
currentTestCaseMetrics Map: แผนที่เมตริกปัจจุบันที่ส่งไปยัง testEnded(TestDescription,Map)
ส่ง
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

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

พารามิเตอร์
testData DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรณีทดสอบ จะเป็นออบเจ็กต์เดียวกันกับในระหว่าง onTestStart(DeviceMetricData)
currentTestCaseMetrics Map: แผนที่เมตริกปัจจุบันที่ส่งไปยัง testEnded(TestDescription,Map)
test TestDescription: TestDescription ของกรณีทดสอบที่กำลังดำเนินการ
ส่ง
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

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

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

onTestModuleEnded

public void onTestModuleEnded ()

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

ส่ง
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

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

ส่ง
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

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

พารามิเตอร์
runData DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสําหรับการเรียกใช้ จะเป็นออบเจ็กต์เดียวกันกับตอน onTestRunStart(DeviceMetricData)
currentRunMetrics Map: แผนที่เมตริกปัจจุบันที่ส่งไปยัง 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)

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

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

พารามิเตอร์
device ITestDevice: ITestDevice ที่การรีบูตสิ้นสุดลง
ส่ง
DeviceNotAvailableException

rebootStarted

public void rebootStarted (ITestDevice device)

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

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

พารามิเตอร์
device ITestDevice: ITestDevice ที่เริ่มการรีบูต
ส่ง
DeviceNotAvailableException

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

กำหนดระดับที่ควรให้ตัวรวบรวมรวบรวมบันทึกโดยไม่คำนึงถึงความล้มเหลว

ระดับ NULL จะส่งผลให้ไม่มีการรวบรวม

พารามิเตอร์
level IMetricCollector.MetricCollectionLevel: MetricCollectionLevel ที่จะรวบรวมบันทึก

setDisable

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

setModuleContainsFailure

public void setModuleContainsFailure ()

ตั้งค่าว่าโมดูลมีความล้มเหลวหรือไม่ (กรณีทดสอบ การทดสอบ)

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

กำหนดระดับที่ควรให้ตัวรวบรวมบันทึกรวบรวมบันทึกระหว่างที่เกิดข้อผิดพลาด

ระดับ NULL จะส่งผลให้ไม่มีการรวบรวม

พารามิเตอร์
level IMetricCollector.MetricCollectionLevel: MetricCollectionLevel ที่จะรวบรวมบันทึก

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

ทางเลือกแทน testEnded(TestDescription,Map) ซึ่งเราสามารถระบุเวลาสิ้นสุด ได้โดยตรง รวมกับ testStarted(TestDescription,long) เพื่อการวัดที่แม่นยำ

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

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

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

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

พารามิเตอร์
test TestDescription: ระบุการทดสอบ
testMetrics HashMap: Map ของเมตริกที่ปล่อยออกมา

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

testFailed

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: ระบุการทดสอบ

testLog

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

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

ต้องเรียกใช้ก่อน ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) 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 จะเสร็จสมบูรณ์

testLogSaved

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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

รายงานสิ้นสุดการทดสอบ FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

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

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public final void testRunFailed (String errorMessage)

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

พารามิเตอร์
errorMessage String: String อธิบายเหตุผลที่การเรียกใช้ล้มเหลว

testRunStarted

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

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

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

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

การเรียกกลับของการทดสอบการเรียกใช้

พารามิเตอร์
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)

การทดสอบรายงานหยุดก่อนที่จะเสร็จสมบูรณ์เนื่องจากคำขอของผู้ใช้

TODO: currently unused, consider removing

พารามิเตอร์
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(TestDescription) ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบ ร่วมกับ testEnded(TestDescription,long,Map) เพื่อการวัดที่แม่นยำ

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

testStarted

public final void testStarted (TestDescription test)

การเรียกกลับของกรณีทดสอบ

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