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

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)

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

void addInstrumentationArg(String key, String value)

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

IAbi getAbi()
IConfiguration getConfiguration()

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

String getCoverageTarget()

รับ ReportingTarget ที่ตั้งค่าไว้ก่อนหน้านี้ผ่าน 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

setMetricCollectors

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