ตัวรวบรวมเมตริกอุปกรณ์ฐาน

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
com.android.tradefed.device.metric.BaseDeviceMetricCollector


การใช้งานฐานของ IMetricCollector ที่อนุญาตให้เริ่มและหยุดการเก็บรวบรวมเมื่อ onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) และ ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))

สรุป

ช่อง

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

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

BaseDeviceMetricCollector()

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

void extraInit(IInvocationContext context, ITestInvocationListener listener)
final getBuildInfos()

แสดงรายการข้อมูลบิลด์ที่มีอยู่ในการเรียกใช้

final getDevices()

แสดงรายการอุปกรณ์ที่มีในการเรียกใช้

File getFileFromTestArtifacts(String fileName)

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

final ITestInvocationListener getInvocationListener()

แสดง ITestInvocationListener เดิมที่เราส่งต่อผลลัพธ์

String getModuleName()
final getRealDevices()

แสดงอุปกรณ์ที่ไม่มีต้นขั้วทั้งหมดจากรายการ getDevices()

String getRunName()

แสดงชื่อของการเรียกใช้การทดสอบ mRunName ที่ทริกเกอร์ตัวรวบรวม

final ITestInvocationListener init(IInvocationContext context, ITestInvocationListener listener)

การเริ่มต้นเครื่องมือรวบรวมพร้อมบริบทปัจจุบันและตำแหน่งที่จะส่งต่อผลลัพธ์

final void invocationEnded(long elapsedTime)

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

final void invocationFailed(FailureDescription failure)

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

final void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

รายงานการเรียกใช้ว่าข้าม

final void invocationStarted(IInvocationContext context)

Listener การเรียกใช้สำหรับการส่งต่อ

final boolean isDisabled()

แสดงค่า "จริง" หากปิดใช้ออบเจ็กต์ทั้งหมด (ข้ามทั้งการตั้งค่าและการลบออก)

boolean isDisabledReceiver()

มีการปิดใช้งาน IDeviceActionReceiver หรือไม่

final void logAssociation(String dataName, LogFile logFile)

อย่าใช้ตัวรวบรวมเมตริกภายใน

void onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)

ติดต่อกลับเมื่อกรอบการทดสอบล้มเหลวเนื่องจากสันนิษฐานล้มเหลว

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)

ติดต่อกลับเมื่อกรอบการทดสอบสิ้นสุดลง

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)

ติดต่อกลับเมื่อกรอบการทดสอบสิ้นสุดลง

void onTestFail(DeviceMetricData testData, TestDescription test)

ติดต่อกลับเมื่อกรอบการทดสอบไม่สำเร็จ

void onTestModuleEnded()

อนุญาตให้บันทึกเหตุการณ์ที่สิ้นสุดโมดูล

void onTestModuleStarted()

อนุญาตให้บันทึกเหตุการณ์ที่เริ่มโดยโมดูล

void onTestRunEnd(DeviceMetricData runData, currentRunMetrics)

ติดต่อกลับเมื่อการทดสอบสิ้นสุดลง

void onTestRunFailed(DeviceMetricData testData, FailureDescription failure)

การเรียกกลับสำหรับเหตุการณ์ testRunFailed

void onTestRunStart(DeviceMetricData runData)

ติดต่อกลับเมื่อเริ่มการทดสอบ

void onTestStart(DeviceMetricData testData)

ติดต่อกลับเมื่อเริ่มกรอบการทดสอบ

void rebootEnded(ITestDevice device)

รับการแจ้งเตือนเมื่อสิ้นสุดการรีบูตในอุปกรณ์

void rebootStarted(ITestDevice device)

รับการแจ้งเตือนเมื่อเริ่มการรีบูตในอุปกรณ์

final void setDisable(boolean isDisabled)

ตั้งค่าว่าควรปิดใช้ออบเจ็กต์ไหม

void setDisableReceiver(boolean isDisabled)

ตั้งค่าว่าควรปิดใช้ IDeviceActionReceiver หรือไม่

final void setLogSaver(ILogSaver logSaver)

อย่าใช้ตัวรวบรวมเมตริกภายใน

final void testAssumptionFailure(TestDescription test, String trace)

เรียกใช้เมื่อตัวบ่งชี้การทดสอบแบบอะตอมระบุว่ามีเงื่อนไขที่เป็นเท็จ

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

เรียกใช้เมื่อตัวบ่งชี้การทดสอบแบบอะตอมระบุว่ามีเงื่อนไขที่เป็นเท็จ

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

ใช้แทน ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) ที่เราสามารถระบุเวลาสิ้นสุดได้ โดยตรง

final void testEnded(TestDescription test, testMetrics)

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

final void testFailed(TestDescription test, FailureDescription failure)

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

final void testFailed(TestDescription test, String trace)

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

final void testIgnored(TestDescription test)

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

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

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

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

อย่าใช้ตัวรวบรวมเมตริกภายใน

final void testModuleEnded()

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

final void testModuleStarted(IInvocationContext moduleContext)

รายงานช่วงเริ่มต้นของโมดูลที่ทำงานอยู่

final void testRunEnded(long elapsedTime, runMetrics)

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

final void testRunFailed(FailureDescription failure)

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

final void testRunFailed(String errorMessage)

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

final void testRunStarted(String runName, int testCount, int attemptNumber)

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

final void testRunStarted(String runName, int testCount)

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

final void testRunStarted(String runName, int testCount, int attemptNumber, long startTime)

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

final void testRunStopped(long elapsedTime)

การเรียกใช้การทดสอบรายงานหยุดลงก่อนที่จะเสร็จสมบูรณ์เนื่องจากคำขอของผู้ใช้

final void testSkipped(TestDescription test, SkipReason reason)

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

final void testStarted(TestDescription test, long startTime)

ใช้แทน testStarted(com.android.tradefed.result.TestDescription) ซึ่งเราจะระบุเวลาที่ทดสอบด้วย เริ่ม รวมกับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) เพื่อการวัดผลที่แม่นยำ

final void testStarted(TestDescription test)

Callback ของกรอบการทดสอบ

ช่อง

ตัวเลือกกลุ่มตัวอย่างไม่รวมทดสอบ

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

ตัวเลือกกลุ่มสำหรับทดสอบกรณี

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

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

ตัวรวบรวมเมตริกอุปกรณ์ฐาน

public BaseDeviceMetricCollector ()

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

ExtraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

การขว้าง
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

getBuildInfos

public final  getBuildInfos ()

แสดงรายการข้อมูลบิลด์ที่มีอยู่ในการเรียกใช้

คิกรีเทิร์น

รับอุปกรณ์

public final  getDevices ()

แสดงรายการอุปกรณ์ที่มีอยู่ในการเรียกใช้

คิกรีเทิร์น

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

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

พารามิเตอร์
fileName String: ชื่อไฟล์ที่จะค้นหาในอาร์ติแฟกต์

คิกรีเทิร์น
File ไฟล์จากอาร์ติแฟกต์ทดสอบหรือโมดูล แสดงผลค่า Null หากไม่พบไฟล์

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

แสดง ITestInvocationListener เดิมที่เราส่งต่อผลลัพธ์

คิกรีเทิร์น
ITestInvocationListener

ชื่อโมดูล

public String getModuleName ()

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

getRealDevices

public final  getRealDevices ()

แสดงอุปกรณ์ที่ไม่มีต้นขั้วทั้งหมดจากรายการ getDevices()

คิกรีเทิร์น

getRunName

public String getRunName ()

แสดงชื่อของการเรียกใช้การทดสอบ mRunName ที่ทริกเกอร์ตัวรวบรวม

คิกรีเทิร์น
String mRunName ซึ่งเป็นชื่อการเรียกใช้การทดสอบปัจจุบัน

Init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

อย่าลบล้างเว้นแต่คุณจะทราบว่าคุณกำลังทำอะไรอยู่

พารามิเตอร์
context IInvocationContext: IInvocationContext สำหรับการเรียกใช้ที่อยู่ระหว่างดำเนินการ

listener ITestInvocationListener: ITestInvocationListener ตำแหน่งที่จะวางผลลัพธ์

คิกรีเทิร์น
ITestInvocationListener ให้ผู้ฟังใหม่รวม URL เดิมเอาไว้

การขว้าง
DeviceNotAvailableException

สิ้นสุดการเรียกใช้

public final void invocationEnded (long elapsedTime)

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

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

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

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

public final void invocationFailed (FailureDescription failure)

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

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

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

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

public final void invocationFailed (Throwable cause)

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

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

พารามิเตอร์
cause Throwable: สาเหตุ Throwable ของความล้มเหลว

ข้ามการเรียกใช้

public void invocationSkipped (SkipReason reason)

รายงานการเรียกใช้ว่าข้าม

พารามิเตอร์
reason SkipReason

เริ่มคำขอแล้ว

public final void invocationStarted (IInvocationContext context)

Listener การเรียกใช้สำหรับการส่งต่อ

พารามิเตอร์
context IInvocationContext: ข้อมูลเกี่ยวกับคำขอ

ปิดใช้อยู่

public final boolean isDisabled ()

แสดงค่า "จริง" หากปิดใช้ออบเจ็กต์ทั้งหมด (ข้ามทั้งการตั้งค่าและการลบออก) เป็นเท็จ

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

ผู้รับ isDisabled

public boolean isDisabledReceiver ()

มีการปิดใช้งาน IDeviceActionReceiver หรือไม่

คิกรีเทิร์น
boolean ส่งคืนค่าจริงหากปิดใช้ หรือเป็นเท็จ

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

public final void logAssociation (String dataName, 
                LogFile logFile)

อย่าใช้ตัวรวบรวมเมตริกภายใน นี่คือการส่งต่อเท่านั้น

พารามิเตอร์
dataName String: ชื่อของข้อมูล

logFile LogFile: LogFile ที่บันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับ กรอบการทดสอบ

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

ติดต่อกลับเมื่อกรอบการทดสอบล้มเหลวเนื่องจากสันนิษฐานล้มเหลว

พารามิเตอร์
testData DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรอบการทดสอบ

test TestDescription: TestDescription ของกรอบการทดสอบอยู่ระหว่างดำเนินการ

การขว้าง
DeviceNotAvailableException

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

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

ติดต่อกลับเมื่อกรอบการทดสอบสิ้นสุดลง ซึ่งควรถึงเวลาทำความสะอาด

พารามิเตอร์
testData DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรอบการทดสอบ จะเป็น เป็นวัตถุเดียวกับระหว่าง onTestStart(com.android.tradefed.device.metric.DeviceMetricData)

currentTestCaseMetrics : แผนที่ปัจจุบันของเมตริกที่ส่งไปยัง ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))

test TestDescription: TestDescription ของกรอบการทดสอบอยู่ระหว่างดำเนินการ

การขว้าง
DeviceNotAvailableException

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

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

ติดต่อกลับเมื่อกรอบการทดสอบสิ้นสุดลง ซึ่งควรถึงเวลาทำความสะอาด

พารามิเตอร์
testData DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรอบการทดสอบ จะเป็น เป็นวัตถุเดียวกับระหว่าง onTestStart(com.android.tradefed.device.metric.DeviceMetricData)

currentTestCaseMetrics : แผนที่ปัจจุบันของเมตริกที่ส่งไปยัง ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))

การขว้าง
DeviceNotAvailableException

เมื่อTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

ติดต่อกลับเมื่อกรอบการทดสอบไม่สำเร็จ

พารามิเตอร์
testData DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรอบการทดสอบ

test TestDescription: TestDescription ของกรอบการทดสอบอยู่ระหว่างดำเนินการ

การขว้าง
DeviceNotAvailableException

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

public void onTestModuleEnded ()

อนุญาตให้บันทึกเหตุการณ์ที่สิ้นสุดโมดูล

การขว้าง
DeviceNotAvailableException

onTestModuleเริ่ม

public void onTestModuleStarted ()

อนุญาตให้บันทึกเหตุการณ์ที่เริ่มโดยโมดูล

การขว้าง
DeviceNotAvailableException

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

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

ติดต่อกลับเมื่อการทดสอบสิ้นสุดลง ซึ่งควรถึงเวลาทำความสะอาด

พารามิเตอร์
runData DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับการเรียกใช้ จะเหมือนเดิม เช่น ระหว่าง onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)

currentRunMetrics : แผนที่ปัจจุบันของเมตริกที่ส่งไปยัง ERROR(/#testRunEnded(long,Map))

การขว้าง
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

การเรียกกลับสำหรับเหตุการณ์ testRunFailed

การขว้าง
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

ติดต่อกลับเมื่อเริ่มการทดสอบ

พารามิเตอร์
runData DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับการเรียกใช้

การขว้าง
DeviceNotAvailableException

เริ่มการทดสอบ

public void onTestStart (DeviceMetricData testData)

ติดต่อกลับเมื่อเริ่มกรอบการทดสอบ

พารามิเตอร์
testData DeviceMetricData: DeviceMetricData ที่เก็บข้อมูลสำหรับกรอบการทดสอบ

การขว้าง
DeviceNotAvailableException

รีบูตแล้ว

public void rebootEnded (ITestDevice device)

รับการแจ้งเตือนเมื่อสิ้นสุดการรีบูตในอุปกรณ์

หมายเหตุ: ผู้รับควรหลีกเลี่ยงการรีบูตในระหว่าง Callback นี้ การพยายามรีบูตทั้งหมด ถูกละเว้น

พารามิเตอร์
device ITestDevice: ITestDevice สิ้นสุดการรีบูตแล้ว

การขว้าง
DeviceNotAvailableException

รีบูต

public void rebootStarted (ITestDevice device)

รับการแจ้งเตือนเมื่อเริ่มการรีบูตในอุปกรณ์

หมายเหตุ: ผู้รับควรหลีกเลี่ยงการรีบูตในระหว่าง Callback นี้ การพยายามรีบูตทั้งหมด ถูกละเว้น

พารามิเตอร์
device ITestDevice: ITestDevice จุดที่การรีบูตเริ่มต้นขึ้น

การขว้าง
DeviceNotAvailableException

ตั้งค่าปิดใช้งาน

public final void setDisable (boolean isDisabled)

ตั้งค่าว่าควรปิดใช้ออบเจ็กต์ไหม "ปิดใช้" หมายความว่าทั้งขั้นตอนการตั้งค่าและการทำลาย ควรข้าม ใช้เพื่อทำให้ออบเจ็กต์ปิดใช้โดยค่าเริ่มต้นโดยค่าเริ่มต้นได้ เครื่องมือสร้างขึ้นมา

พารามิเตอร์
isDisabled boolean: สถานะที่ควรใส่ออบเจ็กต์

setCancelReceiver

public void setDisableReceiver (boolean isDisabled)

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

พารามิเตอร์
isDisabled boolean

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

อย่าใช้ตัวรวบรวมเมตริกภายใน นี่คือการส่งต่อเท่านั้น

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

เรียกใช้เมื่อตัวบ่งชี้การทดสอบแบบอะตอมระบุว่ามีเงื่อนไขที่เป็นเท็จ

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

trace String: สแต็กเทรซของความล้มเหลว

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

เรียกใช้เมื่อตัวบ่งชี้การทดสอบแบบอะตอมระบุว่ามีเงื่อนไขที่เป็นเท็จ

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

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

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

public final 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 final void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

testMetrics : เมตริก ERROR(/Map) รายการที่ระบบปล่อยออกมา

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

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

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

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

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

trace String: สแต็กเทรซของความล้มเหลว

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

public final void testIgnored (TestDescription test)

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

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

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

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

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

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

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

พารามิเตอร์
dataName String: ชื่อที่สื่อความหมายถึง String ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจซ้ำกันต่อการเรียกใช้ คือผู้ติดตั้งใช้งานจะต้องสามารถ การโทรหลายครั้งโดยใช้ dataName เดียวกัน

dataType LogDataType: LogDataType ของข้อมูล

dataStream InputStreamSource: InputStreamSource ของข้อมูล ผู้ปฏิบัติงานควรโทรติดต่อ createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบว่าได้ปิด InputStream เมื่อเสร็จสมบูรณ์ ผู้โทรควรตรวจสอบว่าข้อมูลต้นฉบับยังคงอยู่ ปรากฏและเข้าถึงได้จนกว่าเมธอด testLog จะเสร็จสมบูรณ์

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

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

อย่าใช้ตัวรวบรวมเมตริกภายใน นี่คือการส่งต่อเท่านั้น

พารามิเตอร์
dataName String: ชื่อที่สื่อความหมายถึง String ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจซ้ำกันต่อการเรียกใช้ คือผู้ติดตั้งใช้งานจะต้องสามารถ การโทรหลายครั้งโดยใช้ dataName เดียวกัน

dataType LogDataType: LogDataType ของข้อมูล

dataStream InputStreamSource: InputStreamSource ของข้อมูล ผู้ปฏิบัติงานควรโทรติดต่อ createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบว่าได้ปิด InputStream เมื่อเสร็จสมบูรณ์

logFile LogFile: LogFile ที่มีข้อมูลเมตาของไฟล์ที่บันทึกไว้

โมดูลทดสอบสิ้นสุดแล้ว

public final void testModuleEnded ()

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

testModuleStarted แล้ว

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

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

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

runMetrics : คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบด้วย Metric

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public final void testRunFailed (String errorMessage)

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

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

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

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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

พารามิเตอร์
runName String: ชื่อการดำเนินการทดสอบ

testCount int: จำนวนการทดสอบทั้งหมดในการทดสอบ

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

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

public final void testRunStarted (String runName, 
                int testCount)

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

พารามิเตอร์
runName String: ชื่อการดำเนินการทดสอบ

testCount int: จำนวนการทดสอบทั้งหมดในการทดสอบ

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

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

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

พารามิเตอร์
runName String: ชื่อการดำเนินการทดสอบ

testCount int: จำนวนการทดสอบทั้งหมดในการทดสอบ

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

startTime long: เวลาที่การเรียกใช้เริ่มต้น ซึ่งวัดผ่าน System.currentTimeMillis()

หยุดการทดสอบแล้ว

public final void testRunStopped (long elapsedTime)

การเรียกใช้การทดสอบรายงานหยุดลงก่อนที่จะเสร็จสมบูรณ์เนื่องจากคำขอของผู้ใช้

สิ่งที่ต้องทำ: ยังไม่ได้ใช้ในขณะนี้ ลองพิจารณาลบ

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

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

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

reason SkipReason: SkipReason

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

public final 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()

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

public final void testStarted (TestDescription test)

Callback ของกรอบการทดสอบ

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