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

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

ResultAggregator

public class ResultAggregator
extends CollectingTestListener

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

ผู้ส่งต่อพิเศษที่รวบรวมผลลัพธ์เมื่อจำเป็น โดยอิงตามกลยุทธ์การลองใหม่ที่ ใช้

สรุป

เครื่องมือสร้างสาธารณะ
`ResultAggregator(List<ITestInvocationListener> listeners, RetryStrategy strategy)`

เมธอดสาธารณะ
`void`	`cleanEventsFiles()`
`final void`	`forwardAggregatedInvocationLogs()` ส่งต่อบันทึกระดับการเรียกใช้ทั้งหมดไปยังเครื่องมือรายงานผลลัพธ์ที่ไม่รองรับผลลัพธ์แบบละเอียด
`void`	`invocationEnded(long elapsedTime)` รายงานว่าการเรียกใช้สิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือไม่ก็ตาม หรือเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
`void`	`invocationFailed(FailureDescription failure)`
`void`	`invocationFailed(Throwable cause)` รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
`void`	`invocationSkipped(SkipReason reason)` รายงานการเรียกใช้ว่าข้าม
`void`	`invocationStarted(IInvocationContext context)` รายงานการเริ่มต้นการเรียกใช้การทดสอบ
`void`	`logAssociation(String dataName, LogFile logFile)` ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างใกล้ชิด แต่ไม่สามารถดำเนินการดังกล่าวใน`testLogSaved(String,LogDataType,InputStreamSource,LogFile)` การเรียกกลับโดยตรงได้
`void`	`setLogSaver(ILogSaver logSaver)`
`void`	`setUpdatedReporting(boolean updatedReporting)` ตั้งค่าการรายงานใหม่
`void`	`testAssumptionFailure(TestDescription test, String trace)` เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ
`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`	`testModuleEnded()` รายงานการสิ้นสุดการเรียกใช้โมดูล
`void`	`testModuleStarted(IInvocationContext moduleContext)` รายงานการเริ่มต้นการทำงานของโมดูล
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` รายงานสิ้นสุดการทดสอบ
`void`	`testRunFailed(FailureDescription failure)` การทดสอบการเรียกใช้รายงานไม่สำเร็จเนื่องจากความล้มเหลวที่อธิบายโดย `FailureDescription`
`void`	`testRunFailed(String errorMessage)` การทดสอบการเรียกใช้รายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง
`void`	`testRunStarted(String name, int testCount, int attemptNumber, long startTime)` รายงานการเริ่มต้นการทดสอบ
`void`	`testSkipped(TestDescription test, SkipReason reason)` เรียกใช้เมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่ไม่คาดคิด
`void`	`testStarted(TestDescription test, long startTime)` ทางเลือกแทน `testStarted(TestDescription)` ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบ ร่วมกับ `testEnded(TestDescription,long,Map)` เพื่อการวัดที่แม่นยำ

วิธีการที่ได้รับการป้องกัน
`File[]`	`getEventsLogs()`

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

ResultAggregator

public ResultAggregator (List<ITestInvocationListener> listeners, 
                RetryStrategy strategy)

พารามิเตอร์
`listeners`	`List`
`strategy`	`RetryStrategy`

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

cleanEventsFiles

public void cleanEventsFiles ()

forwardAggregatedInvocationLogs

public final void forwardAggregatedInvocationLogs ()

ส่งต่อบันทึกระดับการเรียกใช้ทั้งหมดไปยังเครื่องมือรายงานผลลัพธ์ที่ไม่รองรับผลลัพธ์แบบละเอียด

invocationEnded

public void invocationEnded (long elapsedTime)

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

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ

พารามิเตอร์
`elapsedTime`	`long`: เวลาที่ผ่านไปของการเรียกใช้ในหน่วยมิลลิวินาที

invocationFailed

public void invocationFailed (FailureDescription failure)

พารามิเตอร์
`failure`	`FailureDescription`

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`: ข้อมูลเกี่ยวกับการเรียกใช้

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

setLogSaver

public void setLogSaver (ILogSaver logSaver)

พารามิเตอร์
`logSaver`	`ILogSaver`

setUpdatedReporting

public void setUpdatedReporting (boolean updatedReporting)

ตั้งค่าการรายงานใหม่

พารามิเตอร์
`updatedReporting`	`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, 
                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`

testModuleEnded

public void testModuleEnded ()

รายงานการสิ้นสุดการเรียกใช้โมดูล

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

รายงานการเริ่มต้นการทำงานของโมดูล โดยการเรียกกลับนี้เชื่อมโยงกับ testModuleEnded() และเป็นแบบไม่บังคับในลำดับ โดยจะใช้เฉพาะในระหว่างการเรียกใช้ที่ใช้โมดูล ซึ่งเป็นโปรแกรมเรียกใช้ตามชุดทดสอบ

พารามิเตอร์
`moduleContext`	`IInvocationContext`: `IInvocationContext` ของโมดูล

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

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

พารามิเตอร์
`name`	`String`: ชื่อการทดสอบ
`testCount`	`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()`

วิธีการที่ได้รับการป้องกัน

getEventsLogs

protected File[] getEventsLogs ()

การคืนสินค้า
`File[]`