BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

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

สรุป

ค่าคงที่

String TEST_CASE_EXCLUDE_GROUP_OPTION

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()

แสดงอุปกรณ์ทั้งหมดที่ไม่ใช่ 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 Listeners สำหรับการส่งต่อ

final boolean isDisabled()

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

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)

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

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, 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-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

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

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

BaseDeviceMetricCollector

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 ()

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

คิกรีเทิร์น

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 สรุปสำหรับผู้ฟังใหม่จะแทนที่สรุปสำหรับผู้ฟังเดิม
การขว้าง
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 Listeners สำหรับการส่งต่อ

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

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, 
                 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

onTestModuleStarted

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)

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

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

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

rebootStarted

public void rebootStarted (ITestDevice device)

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

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

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

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

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 อธิบายความล้มเหลวและบริบทของความล้มเหลวนั้น

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)) หรือ 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 อาจไม่ซ้ำกันต่อการเรียกใช้แต่ละครั้ง กล่าวคือ ผู้ใช้ต้องสามารถจัดการ การเรียกหลายครั้งที่มี 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 อธิบายเหตุผลที่การเรียกใช้ล้มเหลว

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(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)

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

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