ตั้งแต่ปี 2026 เป็นต้นไป เราจะเผยแพร่ซอร์สโค้ดไปยัง AOSP ในไตรมาสที่ 2 และ 4 เพื่อให้สอดคล้องกับโมเดลการพัฒนาแบบ Trunk Stable และรับประกันความเสถียรของแพลตฟอร์มสำหรับระบบนิเวศ หากต้องการสร้างและมีส่วนร่วมใน AOSP ให้ใช้ android-latest-release android-latest-release สาขา Manifest จะอ้างอิงถึงรุ่นล่าสุดที่พุชไปยัง AOSP เสมอ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงใน AOSP

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

Listener ที่แนบมากับแต่ละ IRemoteTest ของแต่ละโมดูลเพื่อรวบรวมรายการผลลัพธ์

สรุป

เครื่องมือสร้างสาธารณะ
`ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)` เครื่องมือสร้าง

เมธอดสาธารณะ
`boolean`	`hasLastAttemptFailed()` แสดงผลว่าเซสชันการลองใหม่ครั้งล่าสุดของผู้ฟังล้มเหลวหรือไม่
`void`	`logAssociation(String dataName, LogFile logFile)` ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างใกล้ชิด แต่ไม่สามารถดำเนินการดังกล่าวใน`testLogSaved(String,LogDataType,InputStreamSource,LogFile)` การเรียกกลับโดยตรงได้
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` กำหนดว่าจะรายงานความพยายามดังกล่าวว่าเป็นการแยกหรือไม่
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` กำหนดว่าจะรวบรวมเฉพาะการทดสอบหรือไม่
`void`	`setMarkTestsSkipped(boolean skip)` เลือกว่าจะทำเครื่องหมายว่าข้ามกรณีทดสอบทั้งหมดหรือไม่
`void`	`setTestMappingSources(List<String> testMappingSources)` ตั้งค่าแหล่งที่มาของการแมปการทดสอบที่จะแทรกลงในเมตริก
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`void`	`testAssumptionFailure(TestDescription test, String trace)` เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` รายงานจุดสิ้นสุดของการดำเนินการของกรณีทดสอบแต่ละรายการ
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` ทางเลือกแทน `testEnded(TestDescription,Map)` ซึ่งเราสามารถระบุเวลาสิ้นสุด ได้โดยตรง
`void`	`testFailed(TestDescription test, FailureDescription failure)` รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
`void`	`testFailed(TestDescription test, String trace)` รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
`void`	`testIgnored(TestDescription test)` เรียกใช้เมื่อจะไม่ทำการทดสอบ โดยทั่วไปเนื่องจากมีการใส่คำอธิบายประกอบเมธอดทดสอบด้วย org.junit.Ignore
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` รายงานสิ้นสุดการทดสอบ
`void`	`testRunFailed(FailureDescription failure)` การทดสอบการเรียกใช้รายงานไม่สำเร็จเนื่องจากความล้มเหลวที่อธิบายโดย `FailureDescription`
`void`	`testRunFailed(String errorMessage)` การทดสอบการเรียกใช้รายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง
`void`	`testRunStarted(String name, int numTests, int attemptNumber)` รายงานการเริ่มต้นการทดสอบ
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` รายงานการเริ่มต้นการทดสอบ
`void`	`testSkipped(TestDescription test, SkipReason reason)` เรียกใช้เมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่ไม่คาดคิด
`void`	`testStarted(TestDescription test, long startTime)` ทางเลือกแทน `testStarted(TestDescription)` ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบ ร่วมกับ `testEnded(TestDescription,long,Map)` เพื่อการวัดที่แม่นยำ

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

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

เครื่องมือสร้าง

พารามิเตอร์
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

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

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

แสดงผลว่าเซสชันการลองใหม่ครั้งล่าสุดของผู้ฟังล้มเหลวหรือไม่

การคืนสินค้า
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

พารามิเตอร์
`dataName`	`String`: ชื่อข้อมูล
`logFile`	`LogFile`: `LogFile` ที่บันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับ กรณีทดสอบ

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

กำหนดว่าจะรายงานความพยายามดังกล่าวว่าเป็นการแยกหรือไม่

พารามิเตอร์
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

กำหนดว่าจะรวบรวมเฉพาะการทดสอบหรือไม่

พารามิเตอร์
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

เลือกว่าจะทำเครื่องหมายว่าข้ามกรณีทดสอบทั้งหมดหรือไม่

พารามิเตอร์
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources (List<String> testMappingSources)

ตั้งค่าแหล่งที่มาของการแมปการทดสอบที่จะแทรกลงในเมตริก

พารามิเตอร์
`testMappingSources`	`List`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

พารามิเตอร์
`useModuleResultsForwarder`	`boolean`

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

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

หากไม่ได้เรียกใช้ testFailed(TestDescription, FailureDescription) การทดสอบนี้จะผ่าน นอกจากนี้ยังแสดงผลเมตริกคีย์/ค่า ที่อาจมีการปล่อยออกมาในระหว่างการดำเนินการของกรณีทดสอบด้วย

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`testMetrics`	`HashMap`: `Map` ของเมตริกที่ปล่อยออกมา

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

ทางเลือกแทน testEnded(TestDescription,Map) ซึ่งเราสามารถระบุเวลาสิ้นสุด ได้โดยตรง รวมกับ testStarted(TestDescription,long) เพื่อการวัดที่แม่นยำ

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`endTime`	`long`: เวลาที่การทดสอบสิ้นสุดลง ซึ่งวัดผ่าน `System.currentTimeMillis()`
`testMetrics`	`HashMap`: `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`: ระบุการทดสอบ

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

พารามิเตอร์
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

พารามิเตอร์
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

รายงานสิ้นสุดการทดสอบ FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

พารามิเตอร์
`elapsedTime`	`long`: อุปกรณ์รายงานเวลาที่ผ่านไปเป็นมิลลิวินาที
`runMetrics`	`HashMap`: คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบด้วย `Metric`

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, 
                int attemptNumber, 
                long startTime)

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

พารามิเตอร์
`name`	`String`: ชื่อการทดสอบ
`numTests`	`int`: จำนวนการทดสอบทั้งหมดในการทดสอบ
`attemptNumber`	`int`: หมายเลขคำสั่งซื้อ ซึ่งระบุความพยายามต่างๆ ของ runName เดียวกัน ที่เรียกใช้หลายครั้ง attemptNumber จะมีดัชนีเป็น 0 และควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น หากมีการลองใหม่แบบละเอียด 3 ครั้ง การทดสอบควรมีการเรียกใช้ทั้งหมด 4 ครั้งภายใต้ runName เดียวกัน และ attemptNumber จะมีค่าตั้งแต่ 0 ถึง 3
`startTime`	`long`: เวลาที่การวิ่งเริ่มต้น ซึ่งวัดผ่าน `System.currentTimeMillis()`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

เรียกใช้เมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่ไม่คาดคิด ระบบจะพยายามลองทดสอบเหล่านี้อีกครั้งเพื่อให้ดำเนินการได้อย่างถูกต้อง

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

ทางเลือกแทน testStarted(TestDescription) ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบ ร่วมกับ testEnded(TestDescription,long,Map) เพื่อการวัดที่แม่นยำ

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`startTime`	`long`: เวลาที่การทดสอบเริ่มต้น วัดผ่าน `System.currentTimeMillis()`