InstrumentationTest

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

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

คลาสย่อยโดยตรงที่ทราบ AndroidJUnitTest, CodeCoverageTest AndroidJUnitTest การทดสอบที่เรียกใช้แพ็กเกจการทดสอบการใช้เครื่องมือในอุปกรณ์ที่ระบุโดยใช้ android.support.test.runner.AndroidJUnitRunner  CodeCoverageTest การทดสอบที่เรียกใช้แพ็กเกจการทดสอบการใช้เครื่องมือในอุปกรณ์ที่ระบุและสร้างรายงานความครอบคลุมของโค้ด

---

การทดสอบที่เรียกใช้แพ็กเกจการทดสอบการวัดคุมในอุปกรณ์ที่ระบุ

สรุป

ค่าคงที่
String	RUN_TESTS_AS_USER_KEY
String	RUN_TESTS_ON_SDK_SANDBOX

ช่อง
protected boolean	mDebug
protected boolean	mInstrumentSdkInSandbox
protected boolean	mInstrumentSdkSandbox

เครื่องมือสร้างสาธารณะ
InstrumentationTest()

เมธอดสาธารณะ
void	addDeviceListeners( extraListeners) อนุญาตให้เพิ่ม Listener ที่กำหนดเองลงใน Runner
void	addInstrumentationArg(String key, String value) เพิ่มอาร์กิวเมนต์ที่จะระบุเมื่อเรียกใช้การทดสอบการวัดคุม
IAbi	getAbi()
IConfiguration	getConfiguration() รับ IConfiguration สำหรับการทดสอบนี้
String	getCoverageTarget() รับการกำหนดเป้าหมายความครอบคลุมที่ตั้งไว้ก่อนหน้านี้ผ่าน 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) เรียกใช้การทดสอบและรายงานผลลัพธ์ไปยัง 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) ตั้งค่ารายการ 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" และ "ข้าม" ออกเพื่อติดตามสิ่งที่ต้องเรียกใช้ซ้ำ
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_AS_USER"

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

ค่าคงที่: "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)

อนุญาตให้เพิ่ม Listener ที่กำหนดเองลงใน 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 ()

รับการกำหนดเป้าหมายความครอบคลุมที่ตั้งไว้ก่อนหน้านี้ผ่าน 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)

เรียกใช้การทดสอบและรายงานผลลัพธ์ไปยัง 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)

ตั้งค่าเป็น True หากเราบังคับใช้รูปแบบเอาต์พุต 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" และ "ข้าม" ออกเพื่อติดตามสิ่งที่ต้องเรียกใช้ซ้ำ

พารามิเตอร์
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	ชื่อโปรแกรมเรียกใช้การทดสอบแรกที่ตรงกับแพ็กเกจ หรือ null หากไม่พบ

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

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