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