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

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

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

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

---

การทดสอบที่เรียกใช้แพ็กเกจการทดสอบการใช้เครื่องมือในอุปกรณ์ที่กำหนด

สรุป

ช่อง
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) อนุญาตให้เพิ่ม Listener ที่กำหนดเองเพิ่มเติมลงในตัววิ่ง
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() รับชื่อตัวดำเนินการทดสอบที่กำหนดเองซึ่งจะให้กับ Listener
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) ตั้งชื่อการเรียกใช้การทดสอบที่กำหนดเองซึ่งจะให้กับ Listener
void	setRunnerName(String runnerName) ตั้งค่าการเรียกใช้เครื่องมือของ Android ที่จะใช้ (ไม่บังคับ)
void	setShellTimeout(long timeout) (ไม่บังคับ) ให้กำหนดเวลาสูงสุด (เป็นมิลลิวินาที) ที่จะคาดหวังเอาต์พุตของ Shell จากอุปกรณ์
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" การค้นหา
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

SDK สำหรับ 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 ()

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

addDeviceListener

public void addDeviceListeners ( extraListeners)

อนุญาตให้เพิ่ม Listener ที่กำหนดเองเพิ่มเติมลงในตัววิ่ง

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

เพิ่มการวัดค่าArg

public void addInstrumentationArg (String key, 
                String value)

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

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

GetAbi

public IAbi getAbi ()

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

GetConfiguration

public IConfiguration getConfiguration ()

รับ IConfiguration สำหรับการทดสอบนี้

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

กำหนดเป้าหมายการครอบคลุม

public String getCoverageTarget ()

รับ ReportingTarget ที่ตั้งค่าไว้ก่อนหน้านี้ผ่าน setCoverageTarget(String)

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

getDebug

public boolean getDebug ()

รับการตั้งค่าการแก้ไขข้อบกพร่องของการใช้เครื่องมือ

คิกรีเทิร์น
boolean	การตั้งค่าการแก้ไขข้อบกพร่องแบบบูลีน

GetDevice

public ITestDevice getDevice ()

นำอุปกรณ์มาทดสอบ

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

getForceAbi

public String getForceAbi ()

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

getMaxระยะหมดเวลา

public long getMaxTimeout ()

แสดงผลการหมดเวลาสูงสุดที่ตั้งค่าไว้สำหรับการใช้เครื่องมือ

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

รับชื่อแพ็กเกจ

public String getPackageName ()

ดาวน์โหลดแพ็กเกจไฟล์ Manifest ของ Android เพื่อเรียกใช้

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

getRunName

public String getRunName ()

รับชื่อตัวดำเนินการทดสอบที่กำหนดเองซึ่งจะให้กับ Listener

คิกรีเทิร์น
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

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

public void setClassName (String testClassName)

(ไม่บังคับ) ให้ตั้งชื่อคลาสการทดสอบที่จะทำงาน

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

ตั้งค่า CollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

เปิดหรือปิดใช้โหมดคอลเล็กชันทดสอบ

setCollectsTestsShellระยะหมดเวลา

public void setCollectsTestsShellTimeout (int timeout)

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

ตั้งเวลาสูงสุดเป็นมิลลิวินาทีเพื่ออนุญาต "เวลาสูงสุดที่จะแสดงการตอบสนองเอาต์พุตของเชลล์" เมื่อเก็บรวบรวม การทดสอบ

พารามิเตอร์
timeout	int

ตั้งค่าการกำหนดค่า

public void setConfiguration (IConfiguration config)

แทรก IConfiguration ที่ใช้งานอยู่

พารามิเตอร์
config	IConfiguration

กำหนดเป้าหมายการครอบคลุม

public void setCoverageTarget (String coverageTarget)

กำหนดเป้าหมายการครอบคลุมของการทดสอบนี้

ขณะนี้ยังไม่มีการใช้งาน วิธีนี้เป็นเพียงตัวอย่างบางส่วนเท่านั้น จึงสามารถดึงข้อมูล reportingTarget ได้ในภายหลังผ่าน getCoverageTarget()

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

setDebug

public void setDebug (boolean debug)

ตั้งค่าแก้ไขข้อบกพร่องของการใช้เครื่องมือ

พารามิเตอร์
debug	boolean: ค่าบูลีนที่จะใช้เป็นการตั้งค่าการแก้ไขข้อบกพร่องของการใช้เครื่องมือ

ตั้งค่าอุปกรณ์

public void setDevice (ITestDevice device)

ใส่อุปกรณ์ที่อยู่ระหว่างการทดสอบ

พารามิเตอร์
device	ITestDevice: ITestDevice ที่จะใช้

ตั้งค่าEnforcementFormat

public void setEnforceFormat (boolean enforce)

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

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

ตั้งค่า ForceAbi

public void setForceAbi (String abi)

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

ตั้งค่าไฟล์การติดตั้ง

public void setInstallFile (File installFile)

ตั้งค่าไฟล์ที่ไม่บังคับเพื่อติดตั้งซึ่งมีการทดสอบ

พารามิเตอร์
installFile	File: ERROR(/File) ที่ติดตั้งได้

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

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

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

ชื่อเมธอด

public void setMethodName (String testMethodName)

กำหนดวิธีทดสอบที่จะเรียกใช้ (ไม่บังคับ)

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

setMetricCollector"

public void setMetricCollectors ( collectors)

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

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

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

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

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

ตั้งชื่อแพ็กเกจ

public void setPackageName (String packageName)

ตั้งค่าแพ็กเกจไฟล์ Manifest ของ Android เพื่อเรียกใช้

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

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

ตั้งค่าตัวเลือก --rerun-from-file

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

ตั้งค่าโหมดทำงานซ้ำ

public void setRerunMode (boolean rerun)

ตั้งค่าโหมดเรียกใช้อีกครั้ง (ไม่บังคับ)

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

ตั้งชื่อการเรียกใช้

public void setRunName (String runName)

ตั้งชื่อตัวดำเนินการทดสอบที่กำหนดเองซึ่งจะให้กับ Listener

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

ตั้งชื่อตัวเรียกใช้

public void setRunnerName (String runnerName)

ตั้งค่าการเรียกใช้เครื่องมือของ Android ที่จะใช้ (ไม่บังคับ)

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

setShellระยะหมดเวลา

public void setShellTimeout (long timeout)

(ไม่บังคับ) ให้กำหนดเวลาสูงสุด (เป็นมิลลิวินาที) ที่จะคาดหวังเอาต์พุตของ Shell จากอุปกรณ์

พารามิเตอร์
timeout	long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

(ไม่บังคับ) ตั้งค่าเส้นทางไปยังไฟล์ที่อยู่ในอุปกรณ์ที่ควรมีรายการบรรทัด แยกคลาสและเมธอด (รูปแบบ: com.foo.Class#method) ที่จะเรียกใช้ หากตั้งค่า ระบบจะ พยายามเรียกใช้การทดสอบอีกครั้งโดยอัตโนมัติโดยใช้ไฟล์ทดสอบนี้ผ่าน InstrumentationFileTest แทนที่จะใช้คำสั่ง adb แยกต่างหากสำหรับการทดสอบที่เหลือแต่ละครั้ง ผ่านการแสดงซ้ำ

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

ตั้งชื่อแพ็กเกจทดสอบ

public void setTestPackageName (String testPackageName)

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

หากไม่เป็นค่าว่าง ระบบจะดำเนินการทดสอบภายในแพ็กเกจ Java ที่ระบุเท่านั้น

จะถูกละเว้นหากมีการระบุค่าที่ไม่ใช่ค่าว่างใน setClassName(String)

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

ตั้งค่าขนาดการทดสอบ

public void setTestSize (String size)

(ไม่บังคับ) กำหนดขนาดทดสอบที่จะเรียกใช้

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

setTestระยะหมดเวลา

public void setTestTimeout (long timeout)

(ไม่บังคับ) กำหนดเวลาสูงสุด (เป็นมิลลิวินาที) สำหรับการเรียกใช้การทดสอบแต่ละครั้ง

พารามิเตอร์
timeout	long

ตั้งค่าการทดสอบที่จะดำเนินการ

public void setTestsToRun ( tests)

ตั้งค่าคอลเล็กชันการทดสอบที่ควรจะดำเนินการโดย InstrumentationTest นี้

พารามิเตอร์
tests	: การทดสอบที่จะทำ

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

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

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

ไม่รวมยังไม่ดำเนินการ

protected static  excludeNonExecuted (TestRunResult results)

กรอง "NOT_EXECUTED" ออก และ "ข้าม" เพื่อจุดประสงค์ในการติดตามสิ่งที่จำเป็นต้องเรียกใช้ใหม่

พารามิเตอร์
results	TestRunResult

คิกรีเทิร์น

getClassName

protected String getClassName ()

ทำให้ชื่อชั้นเรียนเรียกใช้ได้

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

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

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

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

getMethodName

protected String getMethodName ()

เรียกใช้วิธีการทดสอบ

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

รับชื่อแพ็กเกจทดสอบ

protected String getTestPackageName ()

รับแพ็กเกจ Java การทดสอบเพื่อเรียกใช้

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

ชื่อตัวดำเนินการของ Query

protected String queryRunnerName ()

ค้นหาอุปกรณ์สำหรับตัวดำเนินการทดสอบที่จะใช้

คิกรีเทิร์น
String	ชื่อตัวดำเนินการทดสอบแรกที่ตรงกับแพ็คเกจหรือค่าว่าง ถ้าเราไม่พบ

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

SetRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

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