CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener


ITestInvocationListener ที่จะรวบรวมผลการทดสอบทั้งหมด

แม้ว่าโครงสร้างข้อมูลที่ใช้ในออบเจ็กต์นี้จะปลอดภัยต่อการทำงานแบบหลายเธรด แต่ต้องเรียกใช้แฮนเดิล ITestInvocationListener ตามลำดับที่ถูกต้อง

สรุป

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

CollectingTestListener()

เมธอดสาธารณะ

IBuildInfo getBuildInfo()

เลิกใช้เมธอดนี้แล้ว ต้องพึ่งพา IBuildInfo จาก getInvocationContext()

TestRunResult getCurrentRunResults()

รับผลลัพธ์สำหรับการทดสอบที่กำลังดำเนินการ

int getExpectedTests()

แสดงผลจำนวนการทดสอบที่คาดไว้

IInvocationContext getInvocationContext()

แสดงบริบทการเรียกใช้ที่รายงานผ่าน invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults()

ส่งคืนคอลเล็กชันผลลัพธ์ที่ผสานรวมสำหรับการเรียกใช้ทั้งหมดในการพยายามต่างๆ

IInvocationContext getModuleContextForRunResult(String testRunName)

แสดงผล IInvocationContext ของโมดูลที่เชื่อมโยงกับผลลัพธ์

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

แสดงข้อมูลบิลด์หลักที่รายงานผ่าน invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getRunResults()

เลิกใช้เมธอดนี้แล้ว ใช้ getMergedTestRunResults()

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

ส่งคืน TestRunResult เพื่อลองอีกครั้ง

int getTestRunAttemptCount(String testRunName)

แสดงผลจำนวนครั้งที่พยายามสำหรับชื่อการทดสอบที่ระบุ

getTestRunAttempts(String testRunName)

รับความพยายามทั้งหมดสำหรับ TestRunResult ของการทดสอบที่กำหนด

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)

ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างแน่นแฟ้น แต่ไม่สามารถดำเนินการดังกล่าวในtestLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) การเรียกกลับโดยตรงได้

void setBuildInfo(IBuildInfo buildInfo)

เลิกใช้เมธอดนี้แล้ว ไม่จำเป็นสำหรับการทดสอบอีกต่อไป

void setDisable(boolean isDisabled)

กำหนดว่าควรปิดใช้วัตถุหรือไม่

void setMergeStrategy(MergeStrategy strategy)

ตั้งค่า MergeStrategy ที่จะใช้เมื่อผสานผลลัพธ์

void testAssumptionFailure(TestDescription test, String trace)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ

void testAssumptionFailure(TestDescription test, FailureDescription failure)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ

void testEnded(TestDescription test, long endTime, testMetrics)

ทางเลือกแทน ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) ซึ่งเราสามารถระบุเวลาสิ้นสุด ได้โดยตรง

void testEnded(TestDescription test, testMetrics)

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

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

รายงานเมื่อการทดสอบสิ้นสุด

void testRunFailed(FailureDescription failure)

การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription

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)

ทางเลือกแทน testStarted(com.android.tradefed.result.TestDescription) ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบด้วย ร่วมกับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) เพื่อการวัดที่แม่นยำ

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

public  getMergedTestRunResults ()

ส่งคืนคอลเล็กชันผลลัพธ์ที่ผสานรวมสำหรับการเรียกใช้ทั้งหมดในการพยายามต่างๆ

หากมีผลลัพธ์หลายรายการ ระบบจะผสานการทดสอบแต่ละครั้ง โดยผลการทดสอบล่าสุด จะเขียนทับผลการทดสอบของการทดสอบครั้งก่อนๆ ระบบจะจัดเรียงการทดสอบตามหมายเลขการทดสอบ

ระบบจะผสานเมตริกสําหรับความพยายามเดียวกันตามค่ากําหนดที่ 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

public  getRunResults ()

เลิกใช้เมธอดนี้แล้ว
ใช้ 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

public  getTestRunAttempts (String testRunName)

รับความพยายามทั้งหมดสำหรับ TestRunResult ของการทดสอบที่เรียกใช้ที่กำหนด

พารามิเตอร์
testRunName String: ชื่อที่ {testRunStarted(String, int) ระบุ

คิกรีเทิร์น
TestRunResult ทั้งหมดสำหรับการทดสอบที่ระบุ โดยเรียงตามความพยายาม

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

รับผลลัพธ์ทั้งหมดสำหรับการพยายามที่ระบุ

พารามิเตอร์
attempt int: ความพยายามที่เราต้องการผลลัพธ์

คิกรีเทิร์น
TestRunResult ทั้งหมดสำหรับการพยายามครั้งหนึ่งๆ

getTestRunNames

public  getTestRunNames ()

แสดงชื่อทั้งหมดของการทดสอบทั้งหมด

การทดสอบเหล่านี้อาจทำงานหลายครั้งโดยมีการพยายามที่แตกต่างกัน

คิกรีเทิร์น

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