InstrumentationTest

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

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)

อนุญาตให้เพิ่มตัวรับฟังที่กําหนดเองลงใน Runner ได้

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

เรียกใช้แพ็กเกจไฟล์ Manifest ของ Android

String getRunName()

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

String getRunnerName()

รับเครื่องมือรันไทม์ที่ใช้วัดประสิทธิภาพของ Android

boolean isOrchestrator()

แสดงผลค่าของ ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)

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)

ตั้งค่าเป็น "จริง" หากเราบังคับใช้รูปแบบเอาต์พุต AJUR ของเครื่องมือวัด

void setForceAbi(String abi)

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

void setInstallFile(File installFile)

ตั้งค่าไฟล์ที่ไม่บังคับให้ติดตั้งซึ่งมีชุดทดสอบ

void setIsolatedStorage(boolean isolatedStorage)

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

void setMethodName(String testMethodName)

(ไม่บังคับ) ตั้งค่าวิธีการทดสอบให้ทํางาน

void setMetricCollectors( collectors)

ตั้งค่ารายการ IMetricCollector ที่กําหนดไว้สําหรับการทดสอบ

void setOrchestrator(boolean useOrchestrator)

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

void setPackageName(String packageName)

ตั้งค่าแพ็กเกจไฟล์ Manifest ของ 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)

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

void setWindowAnimation(boolean windowAnimation)

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

static excludeNonExecuted(TestRunResult results)

กรอง "NOT_EXECUTED" และ "Skipped" ออกเพื่อติดตามสิ่งที่ต้องเรียกใช้อีกครั้ง

String getClassName()

รับชื่อคลาสที่จะเรียกใช้

ListInstrumentationParser getListInstrumentationParser()

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

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

ตัวสร้างแบบสาธารณะ

InstrumentationTest

public InstrumentationTest ()

เมธอดสาธารณะ

addDeviceListeners

public void addDeviceListeners ( extraListeners)

อนุญาตให้เพิ่มตัวรับฟังที่กําหนดเองลงใน Runner ได้

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

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

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

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

getAbi

public IAbi getAbi ()

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

getConfiguration

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

เรียกใช้แพ็กเกจไฟล์ Manifest ของ Android

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

getRunName

public String getRunName ()

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

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

getRunnerName

public String getRunnerName ()

รับเครื่องมือรันไทม์ที่ใช้วัดประสิทธิภาพของ Android

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

isOrchestrator

public boolean isOrchestrator ()

แสดงผลค่าของ ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)

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

โฮมรัน

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

เรียกใช้การทดสอบและรายงานผลลัพธ์ไปยังผู้ฟัง

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

setAbi

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)

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

ตั้งค่าเวลาสูงสุดเป็นมิลลิวินาทีเพื่อให้มี "เวลาสูงสุดในการตอบสนองเอาต์พุตเชลล์" เมื่อรวบรวมการทดสอบ

พารามิเตอร์
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)

ตั้งค่าเป็น "จริง" หากเราบังคับใช้รูปแบบเอาต์พุต AJUR ของเครื่องมือวัด

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

setForceAbi

public void setForceAbi (String abi)

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

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

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

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

setPackageName

public void setPackageName (String packageName)

ตั้งค่าแพ็กเกจไฟล์ Manifest ของ 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 แยกต่างหากสําหรับการทดสอบที่เหลือแต่ละรายการผ่าน rerun

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

setTestPackageName

public void setTestPackageName (String testPackageName)

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

หากไม่ใช่ค่า Null ระบบจะเรียกใช้เฉพาะการทดสอบภายในแพ็กเกจ 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

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

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

กรอง "NOT_EXECUTED" และ "Skipped" ออกเพื่อติดตามสิ่งที่ต้องเรียกใช้อีกครั้ง

พารามิเตอร์
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

queryRunnerName

protected String queryRunnerName ()

ค้นหาอุปกรณ์สำหรับใช้โปรแกรมรันทดสอบ

คิกรีเทิร์น
String ชื่อโปรแกรมรันทดสอบแรกที่ตรงกับแพ็กเกจ หรือเป็นค่าว่างหากไม่พบ
โยน
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

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