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

สรุป

ช่อง

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)

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

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

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

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

แสดงผลอุปกรณ์ที่ไม่ใช่อุปกรณ์จำลองทั้งหมดจากรายการ 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: ข้อมูลเกี่ยวกับการเรียกใช้

isDisabled

public final boolean isDisabled ()

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

คิกรีเทิร์น
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)

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