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()
แสดงผล |
String
|
getModuleName()
|
final
|
getRealDevices()
แสดงผลอุปกรณ์ที่ไม่ใช่อุปกรณ์จำลองทั้งหมดจากรายการ |
String
|
getRunName()
แสดงผลชื่อการเรียกใช้การทดสอบ |
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()
|
final
void
|
logAssociation(String dataName, LogFile logFile)
อย่าใช้การติดตั้งใช้งานเครื่องมือรวบรวมเมตริกภายใน |
void
|
onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)
เรียกกลับเมื่อกรอบการทดสอบไม่ผ่านเนื่องจากความคาดหวังไม่สำเร็จ |
void
|
onTestEnd(DeviceMetricData testData,
การติดต่อกลับเมื่อกรณีทดสอบสิ้นสุดลง |
void
|
onTestEnd(DeviceMetricData testData,
การติดต่อกลับเมื่อเคสทดสอบสิ้นสุดลง |
void
|
onTestFail(DeviceMetricData testData, TestDescription test)
เรียกกลับเมื่อกรอบการทดสอบไม่ผ่าน |
void
|
onTestModuleEnded()
อนุญาตให้บันทึกเหตุการณ์ที่โมดูลสิ้นสุด |
void
|
onTestModuleStarted()
อนุญาตให้บันทึกเหตุการณ์ที่โมดูลเริ่มต้น |
void
|
onTestRunEnd(DeviceMetricData runData,
การโทรกลับเมื่อการทดสอบสิ้นสุดลง |
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)
ตั้งค่าว่าควรปิดใช้ |
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,
ทางเลือกสำหรับ |
final
void
|
testEnded(TestDescription test,
รายงานการสิ้นสุดการดําเนินการของเคสทดสอบแต่ละรายการ |
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,
รายงานการสิ้นสุดการทดสอบ |
final
void
|
testRunFailed(FailureDescription failure)
การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย |
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)
ทางเลือกสำหรับ |
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 finalgetBuildInfos ()
แสดงรายการข้อมูลบิลด์ที่มีในการเรียกใช้
คิกรีเทิร์น | |
---|---|
|
getDevices
public finalgetDevices ()
แสดงรายการอุปกรณ์ที่ใช้ได้ในการเรียกใช้
คิกรีเทิร์น | |
---|---|
|
getFileFromTestArtifacts
public File getFileFromTestArtifacts (String fileName)
เรียกข้อมูลไฟล์จากอาร์ติแฟกต์การทดสอบหรืออาร์ติแฟกต์โมดูล และแคชไว้ในแผนที่สําหรับการเรียกใช้ครั้งต่อๆ ไป
พารามิเตอร์ | |
---|---|
fileName |
String : ชื่อไฟล์ที่จะค้นหาในอาร์ติแฟกต์ |
คิกรีเทิร์น | |
---|---|
File |
ไฟล์จากอาร์ติแฟกต์การทดสอบหรืออาร์ติแฟกต์โมดูล แสดงผล Null หากไม่พบไฟล์ |
getInvocationListener
public final ITestInvocationListener getInvocationListener ()
แสดงผล ITestInvocationListener
เดิมที่เราส่งต่อผลลัพธ์
คิกรีเทิร์น | |
---|---|
ITestInvocationListener |
getModuleName
public String getModuleName ()
คิกรีเทิร์น | |
---|---|
String |
getRealDevices
public finalgetRealDevices ()
แสดงผลอุปกรณ์ที่ไม่ใช่อุปกรณ์จำลองทั้งหมดจากรายการ 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 : ระบุการทดสอบ |