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

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

TestRunResult

public class TestRunResult
extends Object

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

เก็บผลลัพธ์จากการทดสอบครั้งเดียว

รักษาจำนวนการทดสอบที่ถูกต้องและติดตามการทดสอบที่ไม่สมบูรณ์

ไม่ปลอดภัยสำหรับเธรด การเรียกกลับ test* ต้องเรียกตามลําดับ

สรุป

ช่อง
`public static final String`	`ERROR_DIVIDER`

ตัวสร้างแบบสาธารณะ
`TestRunResult()` สร้าง`TestRunResult`ว่าง

เมธอดสาธารณะ
`void`	`addTestResult(TestDescription test, TestResult testResult)`
	`getCompletedTests()` รับชุดการทดสอบที่เสร็จสมบูรณ์
`long`	`getElapsedTime()` แสดงผลเวลาที่ผ่านไปในการเรียกใช้ปัจจุบัน
`int`	`getExpectedTestCount()` รับจํานวนเฟรมทดสอบที่ TestRunResult นี้คาดว่าจะมี
	`getFailedTests()` รับชุดการทดสอบที่ไม่สําเร็จ
`String`	`getName()`
`int`	`getNumAllFailedTests()` แสดงจํานวนการทดสอบทั้งหมดที่อยู่ในสถานะไม่ผ่าน (ไม่ผ่าน สมมติฐานไม่ผ่าน)
`int`	`getNumCompleteTests()` รับจํานวนการทดสอบที่เสร็จสมบูรณ์ในการเรียกใช้นี้ เช่น มีสถานะ != ยังไม่เสร็จสมบูรณ์
`int`	`getNumTests()` รับจํานวนการทดสอบในการเรียกใช้ครั้งนี้
`int`	`getNumTestsInState(TestStatus status)` รับจํานวนการทดสอบในสถานะที่ระบุสําหรับการเรียกใช้นี้
`int`	`getNumTestsInState(TestResult.TestStatus ddmlibStatus)` เพื่อความเข้ากันได้กับสถานะเก่า
	`getPassedTests()` รับชุดการทดสอบที่ผ่าน
`FailureDescription`	`getRunFailureDescription()` แสดงผลตัวบ่งชี้การเรียกใช้ที่ไม่สําเร็จ `null` หากการเรียกใช้ไม่สําเร็จ
`String`	`getRunFailureMessage()` แสดงข้อความแสดงข้อผิดพลาด "การเรียกใช้ไม่สําเร็จ" `null` หากการเรียกใช้ไม่ล้มเหลว
`MultiMap<String, LogFile>`	`getRunLoggedFiles()` แสดงผลสำเนาของแผนที่ที่มีไฟล์ที่บันทึกไว้ทั้งหมดซึ่งเชื่อมโยงกับกรณีทดสอบนั้น
	`getRunMetrics()`
	`getRunProtoMetrics()`
`long`	`getStartTime()` แสดงเวลาเริ่มต้นของการเรียก testRunStart ครั้งแรก
	`getTestEntriesInState( statuses)` รับชุดการทดสอบในสถานะที่ระบุ
	`getTestResults()` แสดงแผนที่ของผลการทดสอบ
	`getTestsInState( statuses)` รับชุดการทดสอบในสถานะที่ระบุ
	`getTestsResultsInState(TestStatus status)` แสดงผล `TestResult` ทั้งหมดในสถานะหนึ่งๆ
`String`	`getTextSummary()` แสดงผลสตริงที่อธิบายผลลัพธ์ในลักษณะที่ผู้ใช้เข้าใจ
`boolean`	`hasFailedTests()`
`boolean`	`isRunComplete()`
`boolean`	`isRunFailure()`
`static TestRunResult`	`merge( testRunResults)`
`static TestRunResult`	`merge( testRunResults, MergeStrategy strategy)` ผสาน TestRunResults หลายรายการของ testRunName เดียวกัน
`void`	`resetRunFailure()` รีเซ็ตสถานะการเรียกใช้ที่ไม่สําเร็จ
`void`	`setAggregateMetrics(boolean metricAggregation)`
`void`	`setRunComplete(boolean runComplete)`
`void`	`testAssumptionFailure(TestDescription test, String trace)`
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`void`	`testEnded(TestDescription test, testMetrics)`
`void`	`testFailed(TestDescription test, FailureDescription failure)`
`void`	`testFailed(TestDescription test, String trace)`
`void`	`testIgnored(TestDescription test)`
`void`	`testLogSaved(String dataName, LogFile logFile)` ระบบจะจัดเก็บและเชื่อมโยงข้อมูลเกี่ยวกับไฟล์ที่บันทึกไว้กับกรณีทดสอบหรือการทดสอบที่กำลังดำเนินอยู่
`void`	`testRunEnded(long elapsedTime, runMetrics)`
`void`	`testRunFailed(FailureDescription failureDescription)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String runName, int testCount, long startTime)` แจ้งว่าเริ่มการทดสอบแล้ว
`void`	`testRunStarted(String runName, int testCount)` แจ้งว่าเริ่มการทดสอบแล้ว
`void`	`testRunStopped(long elapsedTime)`
`void`	`testSkipped(TestDescription test, SkipReason reason)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

ช่อง

ERROR_DIVIDER

public static final String ERROR_DIVIDER

ตัวสร้างแบบสาธารณะ

TestRunResult

public TestRunResult ()

สร้างTestRunResultว่าง

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

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

พารามิเตอร์
`test`	`TestDescription`
`testResult`	`TestResult`

getCompletedTests

public  getCompletedTests ()

รับชุดการทดสอบที่เสร็จสมบูรณ์

คิกรีเทิร์น

getElapsedTime

public long getElapsedTime ()

แสดงผลเวลาที่ผ่านไปในการเรียกใช้ปัจจุบัน

คิกรีเทิร์น
`long`

getExpectedTestCount

public int getExpectedTestCount ()

รับจํานวนเฟรมทดสอบที่ TestRunResult นี้คาดว่าจะมี จํานวนจริงอาจน้อยกว่าจํานวนที่ต้องการเนื่องจากข้อขัดข้องในการทดสอบ โดยปกติแล้ว ความไม่ตรงกันดังกล่าวบ่งชี้ว่าการทดสอบไม่สำเร็จ

คิกรีเทิร์น
`int`

getFailedTests

public  getFailedTests ()

รับชุดการทดสอบที่ไม่สําเร็จ

คิกรีเทิร์น

getName

public String getName ()

คิกรีเทิร์น
`String`	ชื่อการทดสอบ

getNumAllFailedTests

public int getNumAllFailedTests ()

แสดงจํานวนการทดสอบทั้งหมดที่อยู่ในสถานะไม่ผ่าน (ไม่ผ่าน สมมติฐานไม่ผ่าน)

คิกรีเทิร์น
`int`

getNumCompleteTests

public int getNumCompleteTests ()

รับจํานวนการทดสอบที่เสร็จสมบูรณ์ในการเรียกใช้นี้ เช่น มีสถานะ != ยังไม่เสร็จสมบูรณ์

คิกรีเทิร์น
`int`

getNumTests

public int getNumTests ()

รับจํานวนการทดสอบในการเรียกใช้ครั้งนี้

คิกรีเทิร์น
`int`

getNumTestsInState

public int getNumTestsInState (TestStatus status)

รับจํานวนการทดสอบในสถานะที่ระบุสําหรับการเรียกใช้นี้

พารามิเตอร์
`status`	`TestStatus`

คิกรีเทิร์น
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

เพื่อความเข้ากันได้กับสถานะเก่า ให้ใช้ getNumTestsInState(com.android.tradefed.result.TestStatus) แทน

พารามิเตอร์
`ddmlibStatus`	`TestResult.TestStatus`

คิกรีเทิร์น
`int`

getPassedTests

public  getPassedTests ()

รับชุดการทดสอบที่ผ่าน

คิกรีเทิร์น

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

แสดงผลตัวบ่งชี้การเรียกใช้ที่ไม่สําเร็จ null หากการเรียกใช้ไม่สําเร็จ

คิกรีเทิร์น
`FailureDescription`

getRunFailureMessage

public String getRunFailureMessage ()

แสดงข้อความแสดงข้อผิดพลาด "การเรียกใช้ไม่สําเร็จ" null หากการเรียกใช้ไม่ล้มเหลว

คิกรีเทิร์น
`String`

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

แสดงผลสำเนาของแผนที่ที่มีไฟล์ที่บันทึกไว้ทั้งหมดซึ่งเชื่อมโยงกับกรณีทดสอบนั้น

คิกรีเทิร์น
`MultiMap<String, LogFile>`

getRunMetrics

public  getRunMetrics ()

คิกรีเทิร์น
	`ERROR(/Map)` ของเมตริกการทดสอบ

getRunProtoMetrics

public  getRunProtoMetrics ()

คิกรีเทิร์น
	`ERROR(/Map)` ของเมตริกการทดสอบด้วยรูปแบบโปรโตคอลใหม่

getStartTime

public long getStartTime ()

แสดงเวลาเริ่มต้นของการเรียก testRunStart ครั้งแรก

คิกรีเทิร์น
`long`

getTestEntriesInState

public  getTestEntriesInState ( statuses)

รับชุดการทดสอบในสถานะที่ระบุ

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

คิกรีเทิร์น

getTestResults

public  getTestResults ()

แสดงแผนที่ของผลการทดสอบ

คิกรีเทิร์น

getTestsInState

public  getTestsInState ( statuses)

รับชุดการทดสอบในสถานะที่ระบุ

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

คิกรีเทิร์น

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

แสดงผล TestResult ทั้งหมดในสถานะหนึ่งๆ

พารามิเตอร์
`status`	`TestStatus`

คิกรีเทิร์น

getTextSummary

public String getTextSummary ()

แสดงผลสตริงที่อธิบายผลลัพธ์ในลักษณะที่ผู้ใช้เข้าใจ

คิกรีเทิร์น
`String`

hasFailedTests

public boolean hasFailedTests ()

คิกรีเทิร์น
`boolean`	`true` หากการทดสอบดำเนินการไม่สำเร็จหรือมีข้อผิดพลาด

isRunComplete

public boolean isRunComplete ()

คิกรีเทิร์น
`boolean`	`true` หากการทดสอบเสร็จสิ้นแล้ว

isRunFailure

public boolean isRunFailure ()

คิกรีเทิร์น
`boolean`	`true` หากการทดสอบไม่สำเร็จ

รวม

public static TestRunResult merge ( testRunResults)

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

คิกรีเทิร์น
`TestRunResult`

ดูเพิ่มเติม

ERROR(/#merge(List, MergeStrategy))

รวม

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

ผสาน TestRunResults หลายรายการของ testRunName เดียวกัน หาก Test Case ปรากฏใน TestRunResults หลายรายการแต่มีผลลัพธ์แตกต่างกัน (เช่น "boottest-device" ทำงาน 3 ครั้งโดยมีผลการทดสอบ FAIL-FAIL-PASS) เราจะต่อสต็กเทรซทั้งหมดจากการเรียกใช้ที่ "ไม่ผ่าน" และเชื่อถือผลการเรียกใช้สุดท้ายสำหรับสถานะ เมตริก ไฟล์บันทึก เวลาเริ่มต้น/สิ้นสุด

พารามิเตอร์
`testRunResults`	: รายการ TestRunResult ที่จะผสาน
`strategy`	`MergeStrategy`: กลยุทธ์การผสานที่ใช้ผสานผลลัพธ์

คิกรีเทิร์น
`TestRunResult`	TestRunResult สุดท้ายที่มีข้อมูลที่ผสานจาก testRunResults

resetRunFailure

public void resetRunFailure ()

รีเซ็ตสถานะการเรียกใช้ที่ไม่สําเร็จ

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

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

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

setRunComplete

public void setRunComplete (boolean runComplete)

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

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

พารามิเตอร์
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

พารามิเตอร์
`test`	`TestDescription`
`testMetrics`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

พารามิเตอร์
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

พารามิเตอร์
`test`	`TestDescription`

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

ระบบจะจัดเก็บและเชื่อมโยงข้อมูลเกี่ยวกับไฟล์ที่บันทึกไว้กับกรณีทดสอบหรือการทดสอบที่กำลังดำเนินอยู่

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

พารามิเตอร์
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

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

testRunFailed

public void testRunFailed (String errorMessage)

พารามิเตอร์
`errorMessage`	`String`

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                long startTime)

แจ้งว่าเริ่มการทดสอบแล้ว

พารามิเตอร์
`runName`	`String`: ชื่อที่เชื่อมโยงกับการดำเนินการทดสอบเพื่อวัตถุประสงค์ในการติดตาม
`testCount`	`int`: จํานวนเฟรมทดสอบที่คาดไว้ซึ่งเชื่อมโยงกับการทดสอบ
`startTime`	`long`

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

แจ้งว่าเริ่มการทดสอบแล้ว

พารามิเตอร์
`runName`	`String`: ชื่อที่เชื่อมโยงกับการดำเนินการทดสอบเพื่อวัตถุประสงค์ในการติดตาม
`testCount`	`int`: จํานวนเฟรมทดสอบที่คาดไว้ซึ่งเชื่อมโยงกับการทดสอบ

testRunStopped

public void testRunStopped (long elapsedTime)

พารามิเตอร์
`elapsedTime`	`long`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

พารามิเตอร์
`test`	`TestDescription`
`reason`	`SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

พารามิเตอร์
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

พารามิเตอร์
`test`	`TestDescription`