InstrumentationTest

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

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

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

สรุป

ค่าคงที่

String RUN_TESTS_AS_USER_KEY

String RUN_TESTS_ON_SDK_SANDBOX

ทุ่ง

protected boolean mDebug

protected boolean mInstrumentInPcc

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

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

InstrumentationTest()

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

void addDeviceListeners(Set<String> extraListeners)

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

void addInstrumentationArg(String key, String value)

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

IAbi getAbi()
IConfiguration getConfiguration()

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

String getCoverageTarget()

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

boolean getDebug()

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

ITestDevice getDevice()

เตรียมอุปกรณ์ภายใต้การทดสอบ

String getForceAbi()
long getMaxTimeout()

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

String getPackageName()

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

String getRunName()

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

String getRunnerName()

รับเครื่องมือเรียกใช้การทดสอบเครื่องมือ Android ที่จะใช้

boolean isCollectTestsOnly()
boolean isOrchestrator()

แสดงผลค่าของ ERROR(InstrumentationTest.mOrchestrator/#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)

ตั้งค่าเป็น True หากเราบังคับใช้รูปแบบเอาต์พุต AJUR ของการตรวจสอบ

void setForceAbi(String abi)

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

void setInstallFile(File installFile)

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

void setIsolatedStorage(boolean isolatedStorage)

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

void setMethodName(String testMethodName)

คุณเลือกตั้งค่าวิธีการทดสอบที่จะเรียกใช้ได้

void setMetricCollectors(List<IMetricCollector> 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 setRetryAttemptNumber(int attemptNumber)

กำหนดหมายเลขการลองใหม่สำหรับการทดสอบ

กำหนดหมายเลขการพยายามลองใหม่โดยการส่งเป็นอาร์กิวเมนต์การวัดผล "retry_attempt" ไปยังโปรแกรมเรียกใช้ฝั่งอุปกรณ์

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(Collection<TestDescription> tests)

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

void setWindowAnimation(boolean windowAnimation)

วิธีการที่ได้รับการป้องกัน

static Set<TestDescription> 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

mInstrumentInPcc

protected boolean mInstrumentInPcc

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

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

InstrumentationTest

public InstrumentationTest ()

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

addDeviceListeners

public void addDeviceListeners (Set<String> extraListeners)

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

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

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

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

isCollectTestsOnly

public boolean isCollectTestsOnly ()

การคืนสินค้า
boolean ไม่ว่าการทดสอบนี้จะอยู่ในโหมด collect-tests-only หรือไม่

isOrchestrator

public boolean isOrchestrator ()

แสดงผลค่าของ ERROR(InstrumentationTest.mOrchestrator/#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)

ตั้งค่าเป็น True หากเราบังคับใช้รูปแบบเอาต์พุต AJUR ของการตรวจสอบ

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

setForceAbi

public void setForceAbi (String abi)

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

setInstallFile

public void setInstallFile (File installFile)

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

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

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

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

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

setMethodName

public void setMethodName (String testMethodName)

คุณเลือกตั้งค่าวิธีการทดสอบที่จะเรียกใช้ได้

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

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

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

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

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

setRetryAttemptNumber

public void setRetryAttemptNumber (int attemptNumber)

กำหนดหมายเลขการลองใหม่สำหรับการทดสอบ ค่าเริ่มต้นจะไม่มีการดำเนินการใดๆ

กำหนดหมายเลขการพยายามลองใหม่โดยการส่งเป็นอาร์กิวเมนต์การวัดผล "retry_attempt" ไปยังโปรแกรมเรียกใช้ฝั่งอุปกรณ์

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

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)

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

หากไม่ใช่ Null ระบบจะเรียกใช้เฉพาะการทดสอบภายในแพ็กเกจ Java ที่ระบุเท่านั้น

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

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

setTestSize

public void setTestSize (String size)

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

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

setTestTimeout

public void setTestTimeout (long timeout)

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

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

setTestsToRun

public void setTestsToRun (Collection<TestDescription> tests)

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

พารามิเตอร์
tests Collection: การทดสอบที่จะเรียกใช้

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

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

วิธีการที่ได้รับการป้องกัน

excludeNonExecuted

protected static Set<TestDescription> excludeNonExecuted (TestRunResult results)

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

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

การคืนสินค้า
Set<TestDescription>

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 ชื่อ Test Runner แรกที่ตรงกับแพ็กเกจ หรือ null หากไม่พบ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

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