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

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

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

ผู้รับเหมาก่อสร้างสาธารณะ

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)

ตั้งค่าตัวเลือก Force-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'

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

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

ผู้รับเหมาก่อสร้างสาธารณะ

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

public InstrumentationTest ()

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

เพิ่ม DeviceListeners

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

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 setAbi (IAbi abi)

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

ตั้งชื่อคลาส

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 static  excludeNonExecuted (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