การทดสอบเครื่องมือวัด
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) วิธีการนี้เลิกใช้แล้ว วิธีนี้เป็นวิธีที่ไม่ต้องดำเนินการ |
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) ตั้งค่าตัวเลือก Force-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 ()
วิธีการสาธารณะ
เพิ่ม DeviceListeners
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 |
รับดีบัก
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 |
getRunnerName
public String getRunnerName ()
รับนักวิ่งเครื่องมือวัด Android เพื่อใช้งาน
การส่งคืน | |
---|---|
String |
วิ่ง
public void run (TestInformation testInfo, ITestInvocationListener listener)
ดำเนินการทดสอบและรายงานผลไปยังผู้ฟัง
พารามิเตอร์ | |
---|---|
testInfo | TestInformation : ออบเจ็กต์ TestInformation ที่มีข้อมูลที่เป็นประโยชน์ในการรันการทดสอบ |
listener | ITestInvocationListener : ITestInvocationListener ของผลการทดสอบ |
ขว้าง | |
---|---|
DeviceNotAvailableException |
ตั้งชื่อคลาส
public void setClassName (String testClassName)
ทางเลือก ตั้งชื่อคลาสทดสอบเพื่อรัน
พารามิเตอร์ | |
---|---|
testClassName | String |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
เปิดใช้งานหรือปิดใช้งานโหมดการรวบรวมการทดสอบ
setCollectsTestsShellTimeout
public void setCollectsTestsShellTimeout (int timeout)
วิธีการนี้เลิกใช้แล้ว
วิธีนี้เป็นวิธีที่ไม่ต้องดำเนินการ
ตั้งเวลาสูงสุดเป็น ms เพื่ออนุญาต 'เวลาสูงสุดในการตอบกลับเอาต์พุตของเชลล์' เมื่อรวบรวมการทดสอบ
พารามิเตอร์ | |
---|---|
timeout | int |
ตั้งค่าคอนฟิก
public void setConfiguration (IConfiguration config)
แทรก IConfiguration
ที่ใช้งานอยู่
พารามิเตอร์ | |
---|---|
config | IConfiguration |
setCoverageTarget
public void setCoverageTarget (String coverageTarget)
ตั้งเป้าหมายความครอบคลุมของการทดสอบนี้
ปัจจุบันไม่ได้ใช้. เมธอดนี้เพิ่งมีอยู่ ดังนั้นจึงสามารถดึงข้อมูล CoverageTarget ได้ในภายหลังผ่าน getCoverageTarget()
พารามิเตอร์ | |
---|---|
coverageTarget | String |
ตั้งค่า Debug
public void setDebug (boolean debug)
ตั้งค่าการตั้งค่าดีบักเครื่องมือวัด
พารามิเตอร์ | |
---|---|
debug | boolean : ค่าบูลีนเพื่อตั้งค่าการตั้งค่าดีบักเครื่องมือวัด |
ตั้งค่าอุปกรณ์
public void setDevice (ITestDevice device)
ฉีดอุปกรณ์ภายใต้การทดสอบ
พารามิเตอร์ | |
---|---|
device | ITestDevice : ITestDevice ที่จะใช้ |
ตั้งค่า EnforceFormat
public void setEnforceFormat (boolean enforce)
ตั้งค่าเป็น True หากเราบังคับใช้รูปแบบเอาต์พุต AJUR ของเครื่องมือวัด
พารามิเตอร์ | |
---|---|
enforce | boolean |
setForceAbi
public void setForceAbi (String abi)
ตั้งค่าตัวเลือก Force-abi
ตั้งค่าติดตั้งไฟล์
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 |
ตั้งค่า RerunMode
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 |
ตั้งค่าTestSize
public void setTestSize (String size)
คุณสามารถเลือกตั้งค่าขนาดการทดสอบที่จะรันได้
พารามิเตอร์ | |
---|---|
size | String |
ตั้งค่าTestTimeout
public void setTestTimeout (long timeout)
หรือตั้งเวลาสูงสุด (เป็นมิลลิวินาที) สำหรับการทดสอบแต่ละครั้ง
พารามิเตอร์ | |
---|---|
timeout | long |
ตั้งค่า TestsToRun
public void setTestsToRun (tests)
ตั้งค่าการรวบรวมการทดสอบที่ควรดำเนินการโดย InstrumentationTest นี้
พารามิเตอร์ | |
---|---|
tests |
setWindowAnimation
public void setWindowAnimation (boolean windowAnimation)
พารามิเตอร์ | |
---|---|
windowAnimation | boolean |
วิธีการที่ได้รับการป้องกัน
ไม่รวม NonExecuted
protected staticexcludeNonExecuted (TestRunResult results)
กรอง "NOT_EXECUTED" ออกเพื่อวัตถุประสงค์ในการติดตามสิ่งที่จำเป็นต้องเรียกใช้ซ้ำ
พารามิเตอร์ | |
---|---|
results | TestRunResult |
การส่งคืน | |
---|---|
รับClassName
protected String getClassName ()
รับชื่อคลาสเพื่อรัน
การส่งคืน | |
---|---|
String |
getListInstrumentationParser
protected ListInstrumentationParser getListInstrumentationParser ()
รับ ListInstrumentationParser
ที่ใช้ในการแยกวิเคราะห์แบบสอบถาม 'เครื่องมือรายการ pm'
การส่งคืน | |
---|---|
ListInstrumentationParser |
getMethodName
protected String getMethodName ()
รับวิธีทดสอบเพื่อรัน
การส่งคืน | |
---|---|
String |
getTestPackageName
protected String getTestPackageName ()
รับแพ็คเกจทดสอบ Java เพื่อรัน
การส่งคืน | |
---|---|
String |
queryRunnerName
protected String queryRunnerName ()
ค้นหาอุปกรณ์เพื่อให้นักวิ่งทดสอบใช้งาน
การส่งคืน | |
---|---|
String | ชื่อนักวิ่งทดสอบแรกที่ตรงกับแพ็คเกจหรือเป็นโมฆะหากเราไม่พบ |
ขว้าง | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
พารามิเตอร์ | |
---|---|
runner | IRemoteAndroidTestRunner |