การทดสอบเครื่องมือวัด

public class InstrumentationTest
extends Object implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver

java.lang.Object
↳ com.android.tradefed.testtype.InstrumentationTest

การทดสอบที่เรียกใช้ชุดทดสอบเครื่องมือวัดบนอุปกรณ์ที่กำหนด

สรุป

เขตข้อมูล

public static final String RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_ON_SDK_SANDBOX

protected boolean mDebug

ผู้สร้างสาธารณะ

InstrumentationTest ()

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

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

อนุญาตให้เพิ่มผู้ฟังที่กำหนดเองให้กับนักวิ่ง

void addInstrumentationArg (String key, String value)

เพิ่มอาร์กิวเมนต์ที่จะให้เมื่อเรียกใช้การทดสอบเครื่องมือ

IAbi getAbi ()
IConfiguration getConfiguration ()

รับ IConfiguration สำหรับการทดสอบนี้

String getCoverageTarget ()

รับ coverageTarget ที่ตั้งไว้ก่อนหน้านี้ผ่าน setCoverageTarget(String)

boolean getDebug ()

รับการตั้งค่าการดีบักเครื่องมือวัด

ITestDevice getDevice ()

รับอุปกรณ์ภายใต้การทดสอบ

String getForceAbi ()
long getMaxTimeout ()

ส่งกลับค่าการหมดเวลาสูงสุดที่ตั้งไว้สำหรับเครื่องมือวัด

String getPackageName ()

รับแพ็คเกจรายการ Android เพื่อเรียกใช้

String getRunName ()

รับชื่อการทดสอบการทำงานแบบกำหนดเองที่จะมอบให้กับผู้ฟัง

String getRunnerName ()

รับตัวเรียกใช้เครื่องมือวัด Android เพื่อใช้งาน

void run ( TestInformation testInfo, ITestInvocationListener listener)

ดำเนินการทดสอบและรายงานผลให้ผู้ฟังทราบ

void setAbi ( IAbi abi)
void setClassName (String testClassName)

หรือตั้งค่าชื่อคลาสทดสอบให้รัน

void setCollectTestsOnly (boolean shouldCollectTest)

เปิดหรือปิดโหมดรวบรวมการทดสอบ

void setCollectsTestsShellTimeout (int timeout)

วิธีนี้เลิกใช้แล้ว วิธีนี้เป็นวิธีที่ไม่ต้องดำเนินการ

void setConfiguration ( IConfiguration config)

ใส่ IConfiguration ที่ใช้งานอยู่

void setCoverageTarget (String coverageTarget)

กำหนดเป้าหมายความครอบคลุมของการทดสอบนี้

void setDebug (boolean debug)

ตั้งค่าดีบักเครื่องมือวัด

void setDevice ( ITestDevice device)

ฉีดอุปกรณ์ภายใต้การทดสอบ

void setEnforceFormat (boolean enforce)

ตั้งค่า True ถ้าเราบังคับใช้รูปแบบเอาต์พุต AJUR ของเครื่องมือวัด

void setForceAbi (String abi)

ตั้งค่าตัวเลือกบังคับ-abi

void setInstallFile (File installFile)

ตั้งค่าไฟล์เผื่อเลือกเพื่อติดตั้งที่มีการทดสอบ

void setIsolatedStorage (boolean isolatedStorage)

ตั้งค่าว่าจะใช้ที่เก็บข้อมูลแยกหรือไม่

void setMethodName (String testMethodName)

หรือตั้งค่าวิธีการทดสอบให้ทำงาน

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

ตั้งค่ารายการของ IMetricCollector ที่กำหนดไว้สำหรับการเรียกใช้การทดสอบ

void setPackageName (String packageName)

ตั้งค่าแพ็คเกจรายการ Android ให้ทำงาน

void setReRunUsingTestFile (boolean reRunUsingTestFile)

ตั้งค่าตัวเลือก --rerun-from-file

void setRerunMode (boolean rerun)

หรือตั้งค่าโหมดการฉายซ้ำ

void setRunName (String runName)

ตั้งชื่อการทดสอบการทำงานแบบกำหนดเองที่จะให้แก่ผู้ฟัง

void setRunnerName (String runnerName)

หรือตั้งค่ารันเนอร์เครื่องมือวัด Android เพื่อใช้

void setShellTimeout (long timeout)

เลือกที่จะตั้งเวลาสูงสุด (เป็นมิลลิวินาที) ที่คาดหวังเอาต์พุตเชลล์จากอุปกรณ์

void setTestFilePathOnDevice (String testFilePathOnDevice)

หรือกำหนดเส้นทางไปยังไฟล์ที่อยู่ในอุปกรณ์ที่ควรมีรายการของคลาสการทดสอบและวิธีการที่คั่นด้วยบรรทัด (รูปแบบ: com.foo.Class#method) ที่จะเรียกใช้

void setTestPackageName (String testPackageName)

ตั้งค่าตัวกรองแพ็คเกจทดสอบ

void setTestSize (String size)

หรือตั้งค่าขนาดการทดสอบให้รัน

void setTestTimeout (long timeout)

หรือตั้งเวลาสูงสุด (เป็นมิลลิวินาที) สำหรับการเรียกใช้การทดสอบแต่ละครั้ง

void setTestsToRun ( tests) setTestsToRun ( tests)

ตั้งค่าชุดของการทดสอบที่ควรดำเนินการโดย InstrumentationTest นี้

void setWindowAnimation (boolean windowAnimation)

วิธีการป้องกัน

static excludeNonExecuted ( TestRunResult results)

กรอง "NOT_EXECUTED" ออกเพื่อจุดประสงค์ในการติดตามสิ่งที่ต้องเรียกใช้ซ้ำ

String getClassName ()

รับชื่อชั้นเพื่อเรียกใช้

ListInstrumentationParser getListInstrumentationParser ()

รับ ListInstrumentationParser ที่ใช้ในการแยกวิเคราะห์แบบสอบถาม 'pm list instrumentation'

String getMethodName ()

รับวิธีการทดสอบเพื่อเรียกใช้

String getTestPackageName ()

รับการทดสอบแพ็คเกจจาวาเพื่อรัน

String queryRunnerName ()

สอบถามอุปกรณ์สำหรับนักวิ่งทดสอบที่จะใช้

void setRunnerArgs (IRemoteAndroidTestRunner runner)

เขตข้อมูล

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

ผู้สร้างสาธารณะ

การทดสอบเครื่องมือวัด

public InstrumentationTest ()

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

เพิ่มอุปกรณ์ฟัง

public void addDeviceListeners ( extraListeners)

อนุญาตให้เพิ่มผู้ฟังที่กำหนดเองให้กับนักวิ่ง

พารามิเตอร์
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

เพิ่มอาร์กิวเมนต์ที่จะให้เมื่อเรียกใช้การทดสอบเครื่องมือ

พารามิเตอร์
key String : ชื่ออาร์กิวเมนต์

value String : ค่าอาร์กิวเมนต์

รับเอบี

public IAbi getAbi ()

ส่งคืน
IAbi

รับการกำหนดค่า

public IConfiguration getConfiguration ()

รับ IConfiguration สำหรับการทดสอบนี้

ส่งคืน
IConfiguration

รับความคุ้มครองเป้าหมาย

public String getCoverageTarget ()

รับ coverageTarget ที่ตั้งไว้ก่อนหน้านี้ผ่าน setCoverageTarget(String)

ส่งคืน
String

รับดีบัก

public boolean getDebug ()

รับการตั้งค่าการดีบักเครื่องมือวัด

ส่งคืน
boolean การตั้งค่าดีบักบูลีน

รับอุปกรณ์

public ITestDevice getDevice ()

รับอุปกรณ์ภายใต้การทดสอบ

ส่งคืน
ITestDevice ITestDevice

getForceAbi

public String getForceAbi ()

ส่งคืน
String

getMaxTimeout

public long getMaxTimeout ()

ส่งกลับค่าการหมดเวลาสูงสุดที่ตั้งไว้สำหรับเครื่องมือวัด

ส่งคืน
long

getPackageName

public String getPackageName ()

รับแพ็คเกจรายการ Android เพื่อเรียกใช้

ส่งคืน
String

getRunName

public String getRunName ()

รับชื่อการทดสอบการทำงานแบบกำหนดเองที่จะมอบให้กับผู้ฟัง

ส่งคืน
String

รับชื่อนักวิ่ง

public String getRunnerName ()

รับตัวเรียกใช้เครื่องมือวัด Android เพื่อใช้งาน

ส่งคืน
String

วิ่ง

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

ดำเนินการทดสอบและรายงานผลให้ผู้ฟังทราบ

พารามิเตอร์
testInfo TestInformation : อ็อบเจกต์ TestInformation ที่มีข้อมูลที่เป็นประโยชน์เพื่อเรียกใช้การทดสอบ

listener ITestInvocationListener : ITestInvocationListener ของผลการทดสอบ

พ่น
DeviceNotAvailableException

เซทเอบี

public void setAbi (IAbi abi)

พารามิเตอร์
abi IAbi

setClassName

public void setClassName (String testClassName)

หรือตั้งค่าชื่อคลาสทดสอบให้รัน

พารามิเตอร์
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

เปิดหรือปิดโหมดรวบรวมการทดสอบ

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

วิธีนี้เลิกใช้แล้ว
วิธีนี้เป็นวิธีที่ไม่ต้องดำเนินการ

ตั้งเวลาสูงสุดในหน่วย ms เพื่ออนุญาตให้มี 'เวลาสูงสุดในการตอบสนองเอาต์พุตของเชลล์' เมื่อรวบรวมการทดสอบ

พารามิเตอร์
timeout int

setConfiguration

public void setConfiguration (IConfiguration config)

ใส่ IConfiguration ที่ใช้งานอยู่

พารามิเตอร์
config IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

กำหนดเป้าหมายความครอบคลุมของการทดสอบนี้

ปัจจุบันยังไม่ได้ใช้ วิธีนี้เพิ่งนำเสนอเพื่อให้สามารถดึงข้อมูล coverageTarget ในภายหลังผ่าน getCoverageTarget()

พารามิเตอร์
coverageTarget String

setDebug

public void setDebug (boolean debug)

ตั้งค่าดีบักเครื่องมือวัด

พารามิเตอร์
debug boolean : ค่าบูลีนเพื่อตั้งค่าการดีบักเครื่องมือวัดเป็น

ชุดอุปกรณ์

public void setDevice (ITestDevice device)

ฉีดอุปกรณ์ภายใต้การทดสอบ

พารามิเตอร์
device ITestDevice : ITestDevice ที่จะใช้

setEnforceFormat

public void setEnforceFormat (boolean enforce)

ตั้งค่า True ถ้าเราบังคับใช้รูปแบบเอาต์พุต AJUR ของเครื่องมือวัด

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

เซ็ตฟอร์ซเอบี

public void setForceAbi (String abi)

ตั้งค่าตัวเลือกบังคับ-abi

setInstallFile

public void setInstallFile (File installFile)

ตั้งค่าไฟล์เผื่อเลือกเพื่อติดตั้งที่มีการทดสอบ

พารามิเตอร์
installFile File : ERROR(/File)

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

ตั้งค่าว่าจะใช้ที่เก็บข้อมูลแยกหรือไม่

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

setMethodName

public void setMethodName (String testMethodName)

หรือตั้งค่าวิธีการทดสอบให้ทำงาน

พารามิเตอร์
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

ตั้งค่ารายการของ IMetricCollector ที่กำหนดไว้สำหรับการเรียกใช้การทดสอบ

พารามิเตอร์
collectors

setPackageName

public void setPackageName (String packageName)

ตั้งค่าแพ็คเกจรายการ Android ให้ทำงาน

พารามิเตอร์
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

ตั้งค่าตัวเลือก --rerun-from-file

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

ตั้งโหมดรีรัน

public void setRerunMode (boolean rerun)

หรือตั้งค่าโหมดการฉายซ้ำ

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

ตั้งค่า RunName

public void setRunName (String runName)

ตั้งชื่อการทดสอบการทำงานแบบกำหนดเองที่จะให้แก่ผู้ฟัง

พารามิเตอร์
runName String

ตั้งค่าชื่อนักวิ่ง

public void setRunnerName (String runnerName)

หรือตั้งค่ารันเนอร์เครื่องมือวัด Android เพื่อใช้

พารามิเตอร์
runnerName String

ตั้งค่า ShellTimeout

public void setShellTimeout (long timeout)

เลือกที่จะตั้งเวลาสูงสุด (เป็นมิลลิวินาที) ที่คาดหวังเอาต์พุตเชลล์จากอุปกรณ์

พารามิเตอร์
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

หรือกำหนดเส้นทางไปยังไฟล์ที่อยู่ในอุปกรณ์ที่ควรมีรายการของคลาสการทดสอบและวิธีการที่คั่นด้วยบรรทัด (รูปแบบ: com.foo.Class#method) ที่จะเรียกใช้ หากตั้งค่าไว้ จะพยายามรันการทดสอบใหม่โดยอัตโนมัติโดยใช้ไฟล์ทดสอบนี้ผ่าน

พารามิเตอร์
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

ตั้งค่าตัวกรองแพ็คเกจทดสอบ

หากไม่เป็นโมฆะ เฉพาะการทดสอบภายในแพ็คเกจจาวาที่กำหนดเท่านั้นที่จะถูกดำเนินการ

จะถูกละเว้นหากมีการระบุค่าที่ไม่ใช่ค่า Null ให้กับ setClassName(String)

พารามิเตอร์
testPackageName String

setTestSize

public void setTestSize (String size)

หรือตั้งค่าขนาดการทดสอบให้รัน

พารามิเตอร์
size String

setTestTimeout

public void setTestTimeout (long timeout)

หรือตั้งเวลาสูงสุด (เป็นมิลลิวินาที) สำหรับการเรียกใช้การทดสอบแต่ละครั้ง

พารามิเตอร์
timeout long

setTestsToRun

public void setTestsToRun ( tests)

ตั้งค่าชุดของการทดสอบที่ควรดำเนินการโดย InstrumentationTest นี้

พารามิเตอร์
tests : การทดสอบการทำงาน

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

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

วิธีการป้องกัน

ไม่รวมไม่ดำเนินการ

protected static  excludeNonExecuted (TestRunResult results)

กรอง "NOT_EXECUTED" ออกเพื่อจุดประสงค์ในการติดตามสิ่งที่ต้องเรียกใช้ซ้ำ

พารามิเตอร์
results TestRunResult

ส่งคืน

getClassName

protected String getClassName ()

รับชื่อชั้นเพื่อเรียกใช้

ส่งคืน
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

รับ ListInstrumentationParser ที่ใช้ในการแยกวิเคราะห์แบบสอบถาม 'pm list instrumentation'

ส่งคืน
ListInstrumentationParser

getMethodName

protected String getMethodName ()

รับวิธีการทดสอบเพื่อเรียกใช้

ส่งคืน
String

getTestPackageName

protected String getTestPackageName ()

รับการทดสอบแพ็คเกจจาวาเพื่อรัน

ส่งคืน
String

แบบสอบถามRunnerName

protected String queryRunnerName ()

สอบถามอุปกรณ์สำหรับนักวิ่งทดสอบที่จะใช้

ส่งคืน
String ชื่อนักวิ่งทดสอบแรกที่ตรงกับแพ็คเกจหรือเป็น null หากเราไม่พบชื่อใด ๆ

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

พารามิเตอร์
runner IRemoteAndroidTestRunner