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

Listener โมดูล

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)` โดยตรง Callback ไม่ได้
`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)` เรียกใช้เมื่อการทดสอบจะไม่ทำงาน โดยทั่วไปเนื่องจากวิธีการทดสอบมีคำอธิบายประกอบด้วย 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))` เพื่อการวัดผลที่แม่นยำ

ช่างก่อสร้างสาธารณะ

Listener โมดูล

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

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

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

วิธีการสาธารณะ

ความพยายามล่าสุดล้มเหลว

public boolean hasLastAttemptFailed ()

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

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

การเชื่อมโยงบันทึก

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 ไม่ได้ ดังนั้น Callback นี้จึงช่วยให้เกิดการเชื่อมโยงที่แข็งแกร่ง อย่างชัดเจน

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

ตั้งค่าความพยายามแยก

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

กำหนดว่าควรรายงานการพยายามแยกต่างหากหรือไม่

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

ตั้งค่า CollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

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

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

setMarkTestsข้าม

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` ที่อธิบายความล้มเหลวและบริบท

สิ้นสุดการทดสอบ

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)` รายการที่ระบบปล่อยออกมา

สิ้นสุดการทดสอบ

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`testMetrics`	: เมตริก `ERROR(/Map)` รายการที่ระบบปล่อยออกมา

การทดสอบล้มเหลว

public void testFailed (TestDescription test, 
                FailureDescription failure)

รายงานความล้มเหลวของกรอบการทดสอบแต่ละรายการ

จะมีการเรียกระหว่าง testStarted และ testEnded

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`failure`	`FailureDescription`: `FailureDescription` ที่อธิบายความล้มเหลวและบริบท

การทดสอบล้มเหลว

public void testFailed (TestDescription test, 
                String trace)

รายงานความล้มเหลวของกรอบการทดสอบแต่ละรายการ

จะมีการเรียกระหว่าง testStarted และ testEnded

พารามิเตอร์
`test`	`TestDescription`: ระบุการทดสอบ
`trace`	`String`: สแต็กเทรซของความล้มเหลว

ละเว้นการทดสอบแล้ว

public void testIgnored (TestDescription test)

เรียกใช้เมื่อการทดสอบจะไม่ทำงาน โดยทั่วไปเนื่องจากวิธีการทดสอบมีคำอธิบายประกอบด้วย org.junit. ignore

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

บันทึกการทดสอบ

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

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

บันทึกการทดสอบที่บันทึกไว้

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

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

สิ้นสุดการทดสอบแล้ว

public void testRunEnded (long elapsedTime, 
                 runMetrics)

สิ้นสุดการทดสอบรายงาน แก้ไข: เราไม่สามารถมีแผนที่ 2 แบบ<> ที่มีอินเทอร์เฟซหลายประเภท ดังนั้น เราต้องใช้ HashMap ตรงนี้

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

พารามิเตอร์
`failure`	`FailureDescription`: `FailureDescription` ที่อธิบายความล้มเหลวและบริบท

testRunFailed

public void testRunFailed (String errorMessage)

การดำเนินการทดสอบรายงานไม่สำเร็จเนื่องจากข้อผิดพลาดร้ายแรง

พารามิเตอร์
`errorMessage`	`String`: `String` อธิบายสาเหตุที่ทำให้เรียกใช้ล้มเหลว

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

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

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

พารามิเตอร์
`name`	`String`: ชื่อการดำเนินการทดสอบ
`numTests`	`int`: จำนวนการทดสอบทั้งหมดในการทดสอบ
`attemptNumber`	`int`: หมายเลขคำสั่งซื้อ ซึ่งระบุความพยายามที่แตกต่างกันของ RunName เดียวกัน ซึ่งทำงานหลายครั้ง ค่าความพยายามNumber เป็น 0 และควรเพิ่มขึ้นทุกครั้ง การเรียกใช้ใหม่จะเกิดขึ้น เช่น ทำการทดสอบแบบละเอียด 3 ครั้ง ซึ่งน่าจะได้ทั้งหมด 4 ครั้ง ทำงานภายใต้ runName เดียวกัน และ beginNumber มีค่าตั้งแต่ 0 ถึง 3

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

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

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

ข้ามการทดสอบแล้ว

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

เริ่มทดสอบแล้ว

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