การทดสอบเครื่องมือวัด
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 () รับ |
String | getCoverageTarget () รับ coverageTarget ที่ตั้งค่าไว้ก่อนหน้านี้ผ่าน |
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) วิธีนี้เลิกใช้แล้ว วิธีนี้เป็นวิธี no-op |
void | setConfiguration ( IConfiguration config) |
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) ตั้งค่ารายการของ |
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 () รับ |
String | getMethodName () รับวิธีการทดสอบเพื่อเรียกใช้ |
String | getTestPackageName () รับแพ็คเกจทดสอบ java เพื่อรัน |
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 ()
วิธีการสาธารณะ
addDeviceListeners
public void addDeviceListeners (extraListeners)
อนุญาตให้เพิ่มผู้ฟังที่กำหนดเองให้กับนักวิ่งมากขึ้น
พารามิเตอร์ | |
---|---|
extraListeners |
addInstrumentationArg
public void addInstrumentationArg (String key, String value)
เพิ่มอาร์กิวเมนต์เพื่อให้เมื่อรันการทดสอบเครื่องมือวัด
พารามิเตอร์ | |
---|---|
key | String : ชื่ออาร์กิวเมนต์ |
value | String : ค่าอาร์กิวเมนต์ |
รับการกำหนดค่า
public IConfiguration getConfiguration ()
รับ IConfiguration
สำหรับการทดสอบนี้
คืนสินค้า | |
---|---|
IConfiguration |
getCoverageTarget
public String getCoverageTarget ()
รับ coverageTarget ที่ตั้งค่าไว้ก่อนหน้านี้ผ่าน setCoverageTarget(String)
คืนสินค้า | |
---|---|
String |
getDebug
public boolean getDebug ()
รับการตั้งค่าดีบักเครื่องมือวัด
คืนสินค้า | |
---|---|
boolean | การตั้งค่าดีบักบูลีน |
getDevice
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 |
getRunnerName
public String getRunnerName ()
รับตัววิ่งเครื่องมือวัด Android ที่จะใช้
คืนสินค้า | |
---|---|
String |
วิ่ง
public void run (TestInformation testInfo, ITestInvocationListener listener)
ดำเนินการทดสอบและรายงานผลให้ผู้ฟังทราบ
พารามิเตอร์ | |
---|---|
testInfo | TestInformation : ออบเจ็กต์ TestInformation ที่มีข้อมูลที่เป็นประโยชน์ในการรันการทดสอบ |
listener | ITestInvocationListener : ITestInvocationListener ของผลการทดสอบ |
ขว้าง | |
---|---|
DeviceNotAvailableException |
setClassName
public void setClassName (String testClassName)
ทางเลือก ตั้งชื่อคลาสทดสอบเพื่อรัน
พารามิเตอร์ | |
---|---|
testClassName | String |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
เปิดหรือปิดโหมดการรวบรวมการทดสอบ
setCollectsTestsShellTimeout
public void setCollectsTestsShellTimeout (int timeout)
วิธีนี้เลิกใช้แล้ว
วิธีนี้เป็นวิธี no-op
ตั้งเวลาสูงสุดในหน่วย 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 : ค่าบูลีนเพื่อตั้งค่าการดีบักเครื่องมือวัดเป็น |
setDevice
public void setDevice (ITestDevice device)
ฉีดอุปกรณ์ภายใต้การทดสอบ
พารามิเตอร์ | |
---|---|
device | ITestDevice : ITestDevice ที่จะใช้ |
setEnforceFormat
public void setEnforceFormat (boolean enforce)
ตั้งค่าเป็น True หากเราบังคับใช้รูปแบบเอาต์พุต AJUR ของเครื่องมือวัด
พารามิเตอร์ | |
---|---|
enforce | boolean |
setForceAbi
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 |
setRerunMode
public void setRerunMode (boolean rerun)
ทางเลือก ตั้งค่าโหมดรันซ้ำ
พารามิเตอร์ | |
---|---|
rerun | boolean |
setRunName
public void setRunName (String runName)
ตั้งชื่อรันการทดสอบแบบกำหนดเองที่จะจัดเตรียมให้กับผู้ฟัง
พารามิเตอร์ | |
---|---|
runName | String |
setRunnerName
public void setRunnerName (String runnerName)
หรือตั้งค่าตัวเรียกใช้เครื่องมือวัด Android เพื่อใช้
พารามิเตอร์ | |
---|---|
runnerName | String |
setShellTimeout
public void setShellTimeout (long timeout)
ทางเลือก ตั้งเวลาสูงสุด (เป็นมิลลิวินาที) โดยคาดหวังเอาต์พุตเชลล์จากอุปกรณ์
พารามิเตอร์ | |
---|---|
timeout | long |
setTestFilePathOnDevice
public void setTestFilePathOnDevice (String testFilePathOnDevice)
ทางเลือก ตั้งค่าพาธไปยังไฟล์ที่อยู่ในอุปกรณ์ที่ควรมีรายการคลาสและเมธอดการทดสอบที่แยกบรรทัด (รูปแบบ: com.foo.Class#method) ที่จะรัน หากตั้งค่าไว้ จะพยายามเรียกใช้การทดสอบอีกครั้งโดยอัตโนมัติโดยใช้ไฟล์ทดสอบนี้ผ่าน InstrumentationFileTest
แทนการเรียกใช้คำสั่ง adb แยกกันสำหรับการทดสอบที่เหลือแต่ละครั้งผ่านการรันซ้ำ
พารามิเตอร์ | |
---|---|
testFilePathOnDevice | String |
setTestPackageName
public void setTestPackageName (String testPackageName)
ตั้งค่าตัวกรองแพ็คเกจการทดสอบ
หากไม่ใช่ค่าว่าง เฉพาะการทดสอบภายในแพ็คเกจ java ที่กำหนดเท่านั้นที่จะถูกดำเนินการ จะถูกละเว้นหากมีการจัดเตรียมค่าที่ไม่ใช่ค่าว่างให้กับ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 |
วิธีการป้องกัน
ไม่รวมNonExecuted
protected staticexcludeNonExecuted (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 ()
รับแพ็คเกจทดสอบ java เพื่อรัน
คืนสินค้า | |
---|---|
String |
แบบสอบถามชื่อนักวิ่ง
protected String queryRunnerName ()
สอบถามอุปกรณ์สำหรับนักวิ่งทดสอบที่จะใช้
คืนสินค้า | |
---|---|
String | ชื่อผู้ทดสอบคนแรกที่ตรงกับแพ็คเกจหรือ null หากเราไม่พบ |
ขว้าง | |
---|---|
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
พารามิเตอร์ | |
---|---|
runner | IRemoteAndroidTestRunner |