CollectingTestListener
public
class
CollectingTestListener
extends Object
implements
IDisableable,
ILogSaverListener,
ITestInvocationListener
| java.lang.Object | |
| ↳ | com.android.tradefed.result.CollectingTestListener |
ITestInvocationListener ที่จะรวบรวมผลการทดสอบทั้งหมด
แม้ว่าโครงสร้างข้อมูลที่ใช้ในออบเจ็กต์นี้จะปลอดภัยต่อการทำงานแบบหลายเธรด แต่ต้องเรียกใช้แฮนเดิล ITestInvocationListener ตามลำดับที่ถูกต้อง
สรุป
เครื่องมือสร้างสาธารณะ | |
|---|---|
CollectingTestListener()
|
|
เมธอดสาธารณะ | |
|---|---|
IBuildInfo
|
getBuildInfo()
เลิกใช้เมธอดนี้แล้ว
ต้องพึ่งพา |
TestRunResult
|
getCurrentRunResults()
รับผลลัพธ์สำหรับการทดสอบที่กำลังดำเนินการ |
int
|
getExpectedTests()
แสดงผลจำนวนการทดสอบที่คาดไว้ |
IInvocationContext
|
getInvocationContext()
แสดงบริบทการเรียกใช้ที่รายงานผ่าน |
|
getMergedTestRunResults()
ส่งคืนคอลเล็กชันผลลัพธ์ที่ผสานรวมสำหรับการเรียกใช้ทั้งหมดในการพยายามต่างๆ |
IInvocationContext
|
getModuleContextForRunResult(String testRunName)
แสดงผล |
MultiMap<String, LogFile>
|
getModuleLogFiles()
ส่งคืนสำเนาของแผนที่ที่มีไฟล์ที่บันทึกทั้งหมดซึ่งเชื่อมโยงกับโมดูล |
MultiMap<String, LogFile>
|
getNonAssociatedLogFiles()
ส่งคืนสำเนาของแผนที่ที่มีไฟล์ที่บันทึกทั้งหมดซึ่งไม่ได้เชื่อมโยงกับการทดสอบหรือโมดูล |
int
|
getNumAllFailedTestRuns()
แสดงผลจำนวนการทดสอบทั้งหมดที่อยู่ในสถานะล้มเหลว |
int
|
getNumAllFailedTests()
แสดงผลจำนวนการทดสอบทั้งหมดที่อยู่ในสถานะล้มเหลว (เฉพาะที่ล้มเหลวเท่านั้น การล้มเหลวของสมมติฐานจะไม่นับรวม) |
int
|
getNumTestsInState(TestStatus status)
แสดงผลจำนวนการทดสอบในสถานะที่ระบุสำหรับการเรียกใช้นี้ |
int
|
getNumTestsInState(TestResult.TestStatus ddmlibStatus)
เพื่อความเข้ากันได้กับประเภทสถานะรุ่นเก่า |
int
|
getNumTotalTests()
แสดงจำนวนการทดสอบที่เสร็จสมบูรณ์ทั้งหมดสำหรับการเรียกใช้ทั้งหมด |
IBuildInfo
|
getPrimaryBuildInfo()
แสดงข้อมูลบิลด์หลักที่รายงานผ่าน |
|
getRunResults()
เลิกใช้เมธอดนี้แล้ว
ใช้ |
TestRunResult
|
getTestRunAtAttempt(String testRunName, int attempt)
ส่งคืน |
int
|
getTestRunAttemptCount(String testRunName)
แสดงผลจำนวนครั้งที่พยายามสำหรับชื่อการทดสอบที่ระบุ |
|
getTestRunAttempts(String testRunName)
รับความพยายามทั้งหมดสำหรับ |
|
getTestRunForAttempts(int attempt)
รับผลลัพธ์ทั้งหมดสำหรับการพยายามที่ระบุ |
|
getTestRunNames()
แสดงชื่อทั้งหมดของการทดสอบทั้งหมด |
boolean
|
hasFailedTests()
แสดงผลหากการเรียกใช้มีการทดสอบที่ล้มเหลวหรือการทดสอบที่ล้มเหลวตามสมมติฐาน |
boolean
|
hasTestRunResultsForName(String testRunName)
แสดงผลว่าชื่อการทดสอบที่ระบุมีผลลัพธ์หรือไม่ |
void
|
invocationEnded(long elapsedTime)
รายงานว่าการเรียกใช้สิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือเกิดจากข้อผิดพลาด บางอย่าง |
void
|
invocationFailed(Throwable cause)
รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void
|
invocationSkipped(SkipReason reason)
รายงานการเรียกใช้ว่าข้ามไป |
void
|
invocationStarted(IInvocationContext context)
รายงานการเรียกใช้การทดสอบที่เริ่มต้น |
boolean
|
isDisabled()
แสดงค่า True หากปิดใช้ออบเจ็กต์ทั้งหมด (ข้ามทั้งการตั้งค่าและการล้างข้อมูล) |
void
|
logAssociation(String dataName, LogFile logFile)
ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างแน่นแฟ้น แต่ไม่สามารถดำเนินการดังกล่าวใน |
void
|
setBuildInfo(IBuildInfo buildInfo)
เลิกใช้เมธอดนี้แล้ว ไม่จำเป็นสำหรับการทดสอบอีกต่อไป |
void
|
setDisable(boolean isDisabled)
กำหนดว่าควรปิดใช้วัตถุหรือไม่ |
void
|
setMergeStrategy(MergeStrategy strategy)
ตั้งค่า |
void
|
testAssumptionFailure(TestDescription test, String trace)
เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ |
void
|
testEnded(TestDescription test, long endTime,
ทางเลือกแทน |
void
|
testEnded(TestDescription test,
รายงานจุดสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ |
void
|
testFailed(TestDescription test, FailureDescription failure)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ |
void
|
testFailed(TestDescription test, String trace)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ |
void
|
testIgnored(TestDescription test)
เรียกใช้เมื่อจะไม่ทำการทดสอบ โดยทั่วไปเนื่องจากมีการใส่คำอธิบายประกอบเมธอดทดสอบด้วย org.junit.Ignore |
void
|
testModuleEnded()
รายงานการสิ้นสุดการเรียกใช้โมดูล |
void
|
testModuleStarted(IInvocationContext moduleContext)
รายงานจุดเริ่มต้นของการเรียกใช้โมดูล |
void
|
testRunEnded(long elapsedTime,
รายงานเมื่อการทดสอบสิ้นสุด |
void
|
testRunFailed(FailureDescription failure)
การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย |
void
|
testRunFailed(String errorMessage)
การทดสอบการเรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง |
void
|
testRunStarted(String name, int numTests, int attemptNumber)
รายงานการเริ่มต้นการทดสอบ |
void
|
testRunStarted(String name, int numTests)
รายงานการเริ่มต้นการทดสอบ |
void
|
testRunStarted(String name, int numTests, int attemptNumber, long startTime)
รายงานการเริ่มต้นการทดสอบ |
void
|
testRunStopped(long elapsedTime)
การทดสอบรายงานหยุดก่อนที่จะเสร็จสมบูรณ์เนื่องจากคำขอของผู้ใช้ |
void
|
testSkipped(TestDescription test, SkipReason reason)
เรียกใช้เมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่มักไม่คาดคิด |
void
|
testStarted(TestDescription test, long startTime)
ทางเลือกแทน |
void
|
testStarted(TestDescription test)
รายงานจุดเริ่มต้นของกรณีทดสอบแต่ละรายการ |
วิธีการที่ได้รับการป้องกัน | |
|---|---|
final
void
|
clearModuleLogFiles()
ช่วยให้เราล้างไฟล์โมดูลได้เพื่อไม่ให้ไฟล์เหล่านี้ค้างอยู่นานเกินไป |
final
void
|
clearResultsForName(String testRunName)
ช่วยให้ล้างผลลัพธ์สำหรับชื่อการเรียกใช้ที่ระบุได้ |
final
void
|
clearTestRunResults()
ช่วยให้ล้างผลการทดสอบทั้งหมดได้เพื่อไม่ให้เก็บผลการทดสอบไว้นานเกินไป |
void
|
setIsAggregrateMetrics(boolean aggregate)
สลับตัวเลือก "เมตริกรวม" |
เครื่องมือสร้างสาธารณะ
CollectingTestListener
public CollectingTestListener ()
เมธอดสาธารณะ
getBuildInfo
public IBuildInfo getBuildInfo ()
เลิกใช้เมธอดนี้แล้ว
ใช้ IBuildInfo จาก getInvocationContext()
แสดงข้อมูลการสร้าง
| คิกรีเทิร์น | |
|---|---|
IBuildInfo |
|
getCurrentRunResults
public TestRunResult getCurrentRunResults ()
รับผลลัพธ์สำหรับการทดสอบที่กำลังดำเนินการ
โปรดทราบว่าผลลัพธ์อาจไม่สมบูรณ์ เราขอแนะนําให้ทดสอบค่าของ TestRunResult.isRunComplete() และ/หรือ (@link TestRunResult#isRunFailure()} ตามความเหมาะสม
ก่อนประมวลผลผลลัพธ์
| คิกรีเทิร์น | |
|---|---|
TestRunResult |
TestRunResult แสดงข้อมูลที่รวบรวมระหว่างการทดสอบครั้งล่าสุด |
getExpectedTests
public int getExpectedTests ()
แสดงผลจำนวนการทดสอบที่คาดไว้ อาจแตกต่างจาก getNumTotalTests() หาก
การทดสอบบางอย่างไม่ได้ทำงาน
| คิกรีเทิร์น | |
|---|---|
int |
|
getInvocationContext
public IInvocationContext getInvocationContext ()
แสดงบริบทการเรียกใช้ที่รายงานผ่าน invocationStarted(com.android.tradefed.invoker.IInvocationContext)
| คิกรีเทิร์น | |
|---|---|
IInvocationContext |
|
getMergedTestRunResults
publicgetMergedTestRunResults ()
ส่งคืนคอลเล็กชันผลลัพธ์ที่ผสานรวมสำหรับการเรียกใช้ทั้งหมดในการพยายามต่างๆ
หากมีผลลัพธ์หลายรายการ ระบบจะผสานการทดสอบแต่ละครั้ง โดยผลการทดสอบล่าสุด จะเขียนทับผลการทดสอบของการทดสอบครั้งก่อนๆ ระบบจะจัดเรียงการทดสอบตามหมายเลขการทดสอบ
ระบบจะผสานเมตริกสําหรับความพยายามเดียวกันตามค่ากําหนดที่ aggregate-metrics ตั้งไว้ เมตริกสุดท้ายจะเป็นเมตริกของการพยายามครั้งสุดท้าย
| คิกรีเทิร์น | |
|---|---|
|
|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
แสดงผล IInvocationContext ของโมดูลที่เชื่อมโยงกับผลลัพธ์
| พารามิเตอร์ | |
|---|---|
testRunName |
String: ชื่อที่ {testRunStarted(String, int) ระบุ |
| คิกรีเทิร์น | |
|---|---|
IInvocationContext |
IInvocationContext ของโมดูลสำหรับชื่อการทดสอบที่ระบุ null
หากไม่มีผลลัพธ์สำหรับชื่อนั้น |
getModuleLogFiles
public MultiMap<String, LogFile> getModuleLogFiles ()
ส่งคืนสำเนาของแผนที่ที่มีไฟล์ที่บันทึกทั้งหมดซึ่งเชื่อมโยงกับโมดูล
| คิกรีเทิร์น | |
|---|---|
MultiMap<String, LogFile> |
|
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
ส่งคืนสำเนาของแผนที่ที่มีไฟล์ที่บันทึกทั้งหมดซึ่งไม่ได้เชื่อมโยงกับการทดสอบหรือโมดูล
| คิกรีเทิร์น | |
|---|---|
MultiMap<String, LogFile> |
|
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
แสดงผลจำนวนการทดสอบทั้งหมดที่อยู่ในสถานะล้มเหลว
| คิกรีเทิร์น | |
|---|---|
int |
|
getNumAllFailedTests
public int getNumAllFailedTests ()
แสดงผลจำนวนการทดสอบทั้งหมดที่อยู่ในสถานะล้มเหลว (เฉพาะที่ล้มเหลวเท่านั้น การล้มเหลวของสมมติฐานจะไม่นับรวม)
| คิกรีเทิร์น | |
|---|---|
int |
|
getNumTestsInState
public int getNumTestsInState (TestStatus status)
แสดงผลจำนวนการทดสอบในสถานะที่ระบุสำหรับการเรียกใช้นี้
| พารามิเตอร์ | |
|---|---|
status |
TestStatus |
| คิกรีเทิร์น | |
|---|---|
int |
|
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)
เพื่อความเข้ากันได้กับประเภทสถานะรุ่นเก่า
| พารามิเตอร์ | |
|---|---|
ddmlibStatus |
TestResult.TestStatus |
| คิกรีเทิร์น | |
|---|---|
int |
|
getNumTotalTests
public int getNumTotalTests ()
แสดงจำนวนการทดสอบที่เสร็จสมบูรณ์ทั้งหมดสำหรับการเรียกใช้ทั้งหมด
| คิกรีเทิร์น | |
|---|---|
int |
|
getPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
แสดงข้อมูลบิลด์หลักที่รายงานผ่าน invocationStarted(com.android.tradefed.invoker.IInvocationContext) บิลด์หลักคือบิลด์ที่ผู้ให้บริการบิลด์รายแรก
ของการกำหนดค่าที่กำลังทำงานส่งคืน แสดงผล Null หากไม่มีบริบท (ไม่มีการสร้างกรณีทดสอบ)
| คิกรีเทิร์น | |
|---|---|
IBuildInfo |
|
getRunResults
publicgetRunResults ()
เลิกใช้เมธอดนี้แล้ว
ใช้ getMergedTestRunResults()
แสดงผลลัพธ์สำหรับการทดสอบทั้งหมด
| คิกรีเทิร์น | |
|---|---|
|
|
getTestRunAtAttempt
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
ส่งคืน TestRunResult เพื่อลองอีกครั้ง
| พารามิเตอร์ | |
|---|---|
testRunName |
String: ชื่อที่ {testRunStarted(String, int) ระบุ |
attempt |
int: รหัสความพยายาม |
| คิกรีเทิร์น | |
|---|---|
TestRunResult |
TestRunResult สำหรับชื่อและรหัสการพยายามที่ระบุ หรือ null หากไม่มี |
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
แสดงผลจำนวนการพยายามสำหรับชื่อการทดสอบที่ระบุ
| พารามิเตอร์ | |
|---|---|
testRunName |
String: ชื่อที่ {testRunStarted(String, int) ระบุ |
| คิกรีเทิร์น | |
|---|---|
int |
|
getTestRunAttempts
publicgetTestRunAttempts (String testRunName)
รับความพยายามทั้งหมดสำหรับ TestRunResult ของการทดสอบที่เรียกใช้ที่กำหนด
| พารามิเตอร์ | |
|---|---|
testRunName |
String: ชื่อที่ {testRunStarted(String, int) ระบุ |
| คิกรีเทิร์น | |
|---|---|
|
TestRunResult ทั้งหมดสำหรับการทดสอบที่ระบุ โดยเรียงตามความพยายาม |
getTestRunForAttempts
publicgetTestRunForAttempts (int attempt)
รับผลลัพธ์ทั้งหมดสำหรับการพยายามที่ระบุ
| พารามิเตอร์ | |
|---|---|
attempt |
int: ความพยายามที่เราต้องการผลลัพธ์ |
| คิกรีเทิร์น | |
|---|---|
|
TestRunResult ทั้งหมดสำหรับการพยายามครั้งหนึ่งๆ |
getTestRunNames
publicgetTestRunNames ()
แสดงชื่อทั้งหมดของการทดสอบทั้งหมด
การทดสอบเหล่านี้อาจทำงานหลายครั้งโดยมีการพยายามที่แตกต่างกัน
| คิกรีเทิร์น | |
|---|---|
|
|
hasFailedTests
public boolean hasFailedTests ()
แสดงผลหากการเรียกใช้มีการทดสอบที่ล้มเหลวหรือการทดสอบที่ล้มเหลวเนื่องจากสมมติฐาน
| คิกรีเทิร์น | |
|---|---|
boolean |
|
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
แสดงผลว่าชื่อการทดสอบที่ระบุมีผลลัพธ์หรือไม่
| พารามิเตอร์ | |
|---|---|
testRunName |
String: ชื่อที่ {testRunStarted(String, int) ระบุ |
| คิกรีเทิร์น | |
|---|---|
boolean |
|
invocationEnded
public void invocationEnded (long elapsedTime)
รายงานว่าการเรียกใช้สิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือเกิดจากข้อผิดพลาด บางอย่าง
เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ
| พารามิเตอร์ | |
|---|---|
elapsedTime |
long: เวลาที่ผ่านไปของการเรียกใช้ในหน่วยมิลลิวินาที |
invocationFailed
public void invocationFailed (Throwable cause)
รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ
| พารามิเตอร์ | |
|---|---|
cause |
Throwable: สาเหตุที่ Throwable ไม่สำเร็จ |
invocationSkipped
public void invocationSkipped (SkipReason reason)
รายงานการเรียกใช้ว่าข้ามไป
| พารามิเตอร์ | |
|---|---|
reason |
SkipReason |
invocationStarted
public void invocationStarted (IInvocationContext context)
รายงานการเรียกใช้การทดสอบที่เริ่มต้น
เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ ผู้รายงานต้องลบล้าง เมธอดนี้เพื่อรองรับการรายงานจากอุปกรณ์หลายเครื่อง
| พารามิเตอร์ | |
|---|---|
context |
IInvocationContext: ข้อมูลเกี่ยวกับการเรียกใช้ |
isDisabled
public boolean isDisabled ()
แสดงค่า True หากปิดใช้ออบเจ็กต์ทั้งหมด (ข้ามทั้งการตั้งค่าและการล้างข้อมูล) มิเช่นนั้นจะเป็น "เท็จ"
| คิกรีเทิร์น | |
|---|---|
boolean |
|
logAssociation
public void logAssociation (String dataName,
LogFile logFile)ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างแน่นแฟ้น แต่ไม่สามารถดำเนินการดังกล่าวในtestLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
การเรียกกลับโดยตรงได้ ดังนั้น Callback นี้จึงช่วยให้คุณเชื่อมโยงได้อย่างชัดเจน
| พารามิเตอร์ | |
|---|---|
dataName |
String: ชื่อของข้อมูล |
logFile |
LogFile: LogFile ที่บันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับ
กรณีทดสอบ |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
เลิกใช้เมธอดนี้แล้ว
ไม่จำเป็นสำหรับการทดสอบอีกต่อไป
ตั้งค่าข้อมูลการสร้าง ควรใช้สำหรับการทดสอบเท่านั้น
| พารามิเตอร์ | |
|---|---|
buildInfo |
IBuildInfo |
setDisable
public void setDisable (boolean isDisabled)
กำหนดว่าควรปิดใช้วัตถุหรือไม่ ปิดใช้หมายความว่าควรข้ามทั้งขั้นตอนการตั้งค่าและการสิ้นสุด ใช้เพื่อทำให้ออบเจ็กต์ปิดใช้โดยค่าเริ่มต้นในตัวสร้างเริ่มต้นได้
| พารามิเตอร์ | |
|---|---|
isDisabled |
boolean: สถานะที่ควรใช้กับออบเจ็กต์ |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
ตั้งค่า MergeStrategy ที่จะใช้เมื่อผสานผลลัพธ์
| พารามิเตอร์ | |
|---|---|
strategy |
MergeStrategy |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
trace |
String: สแต็กเทรซของความล้มเหลว |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
failure |
FailureDescription: FailureDescription อธิบายความล้มเหลวและบริบทของความล้มเหลวนั้น |
testEnded
public 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 void testEnded (TestDescription test,testMetrics)
รายงานจุดสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ
หากไม่ได้เรียกใช้ testFailed(TestDescription, FailureDescription) การทดสอบนี้จะผ่าน นอกจากนี้ยังแสดงผลเมตริกคีย์/ค่า
ที่อาจมีการปล่อยออกมาในระหว่างการดำเนินการกรณีทดสอบด้วย
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
testMetrics |
: ERROR(/Map) ของเมตริกที่ปล่อยออกมา |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
จะเรียกใช้ระหว่าง testStarted และ testEnded
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
failure |
FailureDescription: FailureDescription อธิบายความล้มเหลวและบริบทของความล้มเหลวนั้น |
testFailed
public void testFailed (TestDescription test, String trace)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
จะเรียกใช้ระหว่าง testStarted และ testEnded
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
trace |
String: สแต็กเทรซของความล้มเหลว |
testIgnored
public void testIgnored (TestDescription test)
เรียกใช้เมื่อจะไม่ทำการทดสอบ โดยทั่วไปเนื่องจากมีการใส่คำอธิบายประกอบเมธอดทดสอบด้วย org.junit.Ignore
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
testModuleEnded
public void testModuleEnded ()
รายงานการสิ้นสุดการเรียกใช้โมดูล
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
รายงานจุดเริ่มต้นของการเรียกใช้โมดูล โดยการเรียกกลับนี้เชื่อมโยงกับ testModuleEnded() และเป็นแบบไม่บังคับในลำดับ โดยจะใช้เฉพาะในระหว่างการเรียกใช้ที่ใช้โมดูล
ซึ่งเป็นโปรแกรมเรียกใช้ตามชุดทดสอบ
| พารามิเตอร์ | |
|---|---|
moduleContext |
IInvocationContext: IInvocationContext ของโมดูล |
testRunEnded
public void testRunEnded (long elapsedTime,
runMetrics) รายงานเมื่อการทดสอบสิ้นสุด
| พารามิเตอร์ | |
|---|---|
elapsedTime |
long: อุปกรณ์รายงานเวลาที่ผ่านไปเป็นมิลลิวินาที |
runMetrics |
: คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบ |
testRunFailed
public void testRunFailed (FailureDescription failure)
การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription
| พารามิเตอร์ | |
|---|---|
failure |
FailureDescription: FailureDescription อธิบายความล้มเหลวและบริบทของความล้มเหลวนั้น |
testRunFailed
public void testRunFailed (String errorMessage)
การทดสอบการเรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง
| พารามิเตอร์ | |
|---|---|
errorMessage |
String: String อธิบายเหตุผลที่การเรียกใช้ล้มเหลว |
testRunStarted
public void testRunStarted (String name,
int numTests,
int attemptNumber)รายงานการเริ่มต้นการทดสอบ
| พารามิเตอร์ | |
|---|---|
name |
String: ชื่อการทดสอบ |
numTests |
int: จำนวนการทดสอบทั้งหมดในการทดสอบการเรียกใช้ |
attemptNumber |
int: หมายเลขคำสั่งซื้อ ซึ่งระบุความพยายามต่างๆ ของ runName เดียวกัน
ที่เรียกใช้หลายครั้ง attemptNumber มีดัชนีเป็น 0 และควรเพิ่มขึ้นทุกครั้ง
ที่มีการเรียกใช้ใหม่ เช่น หากมีการลองใหม่แบบละเอียด 3 ครั้ง การทดสอบควรมีการเรียกใช้ทั้งหมด 4 ครั้ง
ภายใต้ runName เดียวกัน และ attemptNumber จะมีค่าตั้งแต่ 0 ถึง 3 |
testRunStarted
public void testRunStarted (String name,
int numTests)รายงานการเริ่มต้นการทดสอบ
| พารามิเตอร์ | |
|---|---|
name |
String: ชื่อการทดสอบ |
numTests |
int: จำนวนการทดสอบทั้งหมดในการทดสอบการเรียกใช้ |
testRunStarted
public void testRunStarted (String name,
int numTests,
int attemptNumber,
long startTime)รายงานการเริ่มต้นการทดสอบ
| พารามิเตอร์ | |
|---|---|
name |
String: ชื่อการทดสอบ |
numTests |
int: จำนวนการทดสอบทั้งหมดในการทดสอบการเรียกใช้ |
attemptNumber |
int: หมายเลขคำสั่งซื้อ ซึ่งระบุความพยายามต่างๆ ของ runName เดียวกัน
ที่เรียกใช้หลายครั้ง attemptNumber มีดัชนีเป็น 0 และควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น หากมีการลองใหม่แบบละเอียด 3 ครั้ง ควรมีการเรียกใช้ทั้งหมด 4 ครั้งภายใต้ runName เดียวกัน และ attemptNumber จะมีค่าตั้งแต่ 0 ถึง 3 |
startTime |
long: เวลาที่เริ่มวิ่ง ซึ่งวัดผ่าน System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
การทดสอบรายงานหยุดก่อนที่จะเสร็จสมบูรณ์เนื่องจากคำขอของผู้ใช้
TODO: currently unused, consider removing
| พารามิเตอร์ | |
|---|---|
elapsedTime |
long: อุปกรณ์รายงานเวลาที่ผ่านไปเป็นมิลลิวินาที |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
เรียกใช้เมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่มักไม่คาดคิด ระบบจะพยายามลองทดสอบเหล่านี้อีกครั้งเพื่อให้ดำเนินการได้อย่างถูกต้อง
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
reason |
SkipReason: SkipReason |
testStarted
public 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 void testStarted (TestDescription test)
รายงานจุดเริ่มต้นของกรณีทดสอบแต่ละรายการ อินเทอร์เฟซรุ่นเก่าควรใช้ testStarted(com.android.tradefed.result.TestDescription) เมื่อเป็นไปได้
| พารามิเตอร์ | |
|---|---|
test |
TestDescription: ระบุการทดสอบ |
วิธีการที่ได้รับการป้องกัน
clearModuleLogFiles
protected final void clearModuleLogFiles ()
ช่วยให้เราล้างไฟล์โมดูลได้เพื่อไม่ให้ไฟล์เหล่านี้ค้างอยู่นานเกินไป
clearResultsForName
protected final void clearResultsForName (String testRunName)
ช่วยให้ล้างผลลัพธ์สำหรับชื่อการเรียกใช้ที่ระบุได้ ควรใช้ในบางกรณีเท่านั้น เช่น ผู้รวบรวมผลลัพธ์
| พารามิเตอร์ | |
|---|---|
testRunName |
String |
clearTestRunResults
protected final void clearTestRunResults ()
ช่วยให้ล้างผลการทดสอบทั้งหมดได้เพื่อไม่ให้เก็บผลการทดสอบไว้นานเกินไป
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
สลับตัวเลือก "เมตริกรวม"
| พารามิเตอร์ | |
|---|---|
aggregate |
boolean |