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

ชาร์ดListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

ITestInvocationListener ที่รวบรวมผลลัพธ์จากกลุ่มการเรียกใช้ (หรือที่เรียกว่าการแยกการเรียกใช้เพื่อเรียกใช้หลายรายการพร้อมกันในหลายทรัพยากร) และส่งต่อไปยังโปรแกรมฟังอื่น

สรุป

ตัวสร้างแบบสาธารณะ
`ShardListener(ITestInvocationListener main)` สร้าง `ShardListener`

เมธอดสาธารณะ
	`getUnderlyingResultReporter()`
`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, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` โดยตรงได้
`void`	`setSupportGranularResults(boolean enableGranularResults)`
`boolean`	`supportGranularResults()` แสดงค่า True หากเครื่องมือรายงานรองรับผลลัพธ์แบบละเอียด หากไม่ แสดงค่า False
`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, runMetrics)` รายงานการสิ้นสุดการทดสอบ
`void`	`testRunFailed(FailureDescription failure)` การทดสอบรายงานไม่เสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย `FailureDescription`
`void`	`testRunFailed(String failureMessage)` การเรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากข้อผิดพลาดร้ายแรง
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` รายงานการเริ่มต้นการทดสอบ

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

ShardListener

public ShardListener (ITestInvocationListener main)

สร้าง ShardListener

พารามิเตอร์

พารามิเตอร์
`main`	`ITestInvocationListener`: `ITestInvocationListener` ที่ควรส่งต่อผลลัพธ์ ออบเจ็กต์นี้จะซิงค์ใน `main` เมื่อส่งต่อผลลัพธ์เพื่อป้องกันไม่ให้มี `ShardListener` รายการอื่นทับซ้อนกัน และระบบจะส่งผลลัพธ์ก็ต่อเมื่อกลุ่มการเรียกใช้เสร็จสมบูรณ์เท่านั้น

main

ITestInvocationListener: ITestInvocationListener ที่ควรส่งต่อผลลัพธ์ ออบเจ็กต์นี้จะซิงค์ใน main เมื่อส่งต่อผลลัพธ์เพื่อป้องกันไม่ให้มี ShardListener รายการอื่นทับซ้อนกัน และระบบจะส่งผลลัพธ์ก็ต่อเมื่อกลุ่มการเรียกใช้เสร็จสมบูรณ์เท่านั้น

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

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

คิกรีเทิร์น

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

พารามิเตอร์
`elapsedTime`	`long`: เวลาผ่านไปของคําเรียกเป็นมิลลิวินาที

การเรียกใช้ล้มเหลว

public void invocationFailed (FailureDescription failure)

รายงานการเรียกใช้ที่ไม่สมบูรณ์เนื่องจากสภาพขณะเกิดข้อผิดพลาดบางอย่าง

จะถูกเรียกโดยอัตโนมัติโดยเฟรมเวิร์ก TradeFederation

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

การเรียกใช้ล้มเหลว

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, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) โดยตรงได้ ดังนั้น แคล็กแบ็กนี้จึงช่วยให้มีการเชื่อมโยงที่ชัดเจน

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

ตั้งค่าผลลัพธ์แบบละเอียด

public void setSupportGranularResults (boolean enableGranularResults)

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

supportGranularResults

public boolean supportGranularResults ()

แสดงค่า True หากเครื่องมือรายงานรองรับผลลัพธ์แบบละเอียด หากไม่ แสดงค่า False

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

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

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

ให้ข้อมูลบันทึกหรือข้อมูลแก้ไขข้อบกพร่องที่เชื่อมโยงจากการเรียกใช้การทดสอบ

ต้องเรียกใช้ก่อน ERROR(/ITestInvocationListener#invocationFailed(Throwable)) หรือ ERROR(/ITestInvocationListener#invocationEnded(long))

เฟรมเวิร์ก TradeFederation จะเรียกใช้เมธอดนี้โดยอัตโนมัติ โดยจะระบุบันทึกของโฮสต์และบันทึก Logcat ของอุปกรณ์ (หากมี)

พารามิเตอร์
`dataName`	`String`: `String` ชื่อที่สื่อความหมายของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการเรียกใช้ 1 ครั้ง เช่น ผู้ติดตั้งใช้งานต้องจัดการกับการเรียกใช้หลายครั้งที่มี dataName เดียวกันได้
`dataType`	`LogDataType`: `LogDataType` ของข้อมูล
`dataStream`	`InputStreamSource`: `InputStreamSource` ของข้อมูล ผู้ใช้งานควรเรียกใช้ createInputStream เพื่อเริ่มอ่านข้อมูล และอย่าลืมปิด InputStream ที่ได้เมื่ออ่านเสร็จแล้ว ผู้เรียกใช้ควรตรวจสอบว่าแหล่งที่มาของข้อมูลยังคงอยู่และเข้าถึงได้จนกว่าเมธอด testLog จะเสร็จสมบูรณ์

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

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` ของโมดูล

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

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String failureMessage)

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

พารามิเตอร์
`failureMessage`	`String`: `String` อธิบายสาเหตุของการเรียกใช้ที่ไม่สําเร็จ

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