ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

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, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` callbacks โดยตรงนั้นไม่สามารถทำได้
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` ตั้งค่าว่าควรรายงานความพยายามดังกล่าวเป็นเหตุการณ์แยกต่างหากหรือไม่
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` ตั้งค่าว่าจะรวบรวมเฉพาะการทดสอบหรือไม่
`void`	`setMarkTestsSkipped(boolean skip)` เลือกว่าจะทําเครื่องหมายว่าข้ามกรอบการทดสอบทั้งหมดหรือไม่
`void`	`setTestMappingSources( testMappingSources)` ตั้งค่าแหล่งที่มาของการแมปการทดสอบที่จะแทรกลงในเมตริก
`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)` เรียกใช้เมื่อระบบจะไม่เรียกใช้การทดสอบ ซึ่งโดยทั่วไปแล้วเป็นเพราะเมธอดทดสอบมีคำอธิบายประกอบด้วย annotate ของ 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, 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(com.android.tradefed.result.TestDescription)` ซึ่งเราจะระบุเวลาที่เริ่มการทดสอบด้วย ร่วมกับ `ERROR(/#testEnded(com.android.tradefed.result.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, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callbacks โดยตรงนั้นไม่สามารถทำได้ ด้วยเหตุนี้ จึงเป็นวิธีที่ช่วยให้มีการเชื่อมโยงที่ชัดเจน

พารามิเตอร์
`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 ( testMappingSources)

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

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

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)

เรียกใช้เมื่อระบบจะไม่เรียกใช้การทดสอบ ซึ่งโดยทั่วไปแล้วเป็นเพราะเมธอดทดสอบมีคำอธิบายประกอบด้วย annotate ของ 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, 
                 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, 
                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(com.android.tradefed.result.TestDescription) ซึ่งเราจะระบุเวลาที่เริ่มการทดสอบด้วย ร่วมกับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) เพื่อการวัดผลที่แม่นยำ

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