IRemoteAndroidTestRunner
public
interface
IRemoteAndroidTestRunner
| com.android.ddmlib.testrunner.IRemoteAndroidTestRunner |
อินเทอร์เฟซสําหรับเรียกใช้คําสั่งทดสอบ Android จากระยะไกลและรายงานผลลัพธ์ไปยัง Listener
สรุป
เมธอดสาธารณะ | |
|---|---|
abstract
void
|
addBooleanArg(String name, boolean value)
เพิ่มอาร์กิวเมนต์บูลีนที่จะรวมไว้ในคำสั่งการวัดคุม |
abstract
void
|
addInstrumentationArg(String name, String value)
เพิ่มอาร์กิวเมนต์ที่จะรวมไว้ในคำสั่งการวัดคุม |
abstract
void
|
cancel()
ขอให้ยกเลิกการทดสอบนี้ |
abstract
IRemoteAndroidTestRunner.CoverageOutput
|
getCoverageOutputType()
แสดงผลประเภทของการทดสอบครอบคลุมที่โปรแกรมเรียกใช้สร้างขึ้น |
abstract
String
|
getPackageName()
แสดงผลชื่อแพ็กเกจของแอปพลิเคชัน |
abstract
String
|
getRunnerName()
แสดงผล runnerName |
abstract
void
|
removeInstrumentationArg(String name)
นำอาร์กิวเมนต์ที่เพิ่มไว้ก่อนหน้านี้ออก |
abstract
void
|
run(ITestRunListener... listeners)
เรียกใช้การทดสอบนี้ |
abstract
void
|
run(
เรียกใช้การทดสอบนี้ |
abstract
void
|
setAdditionalTestOutputLocation(String additionalTestDataPath)
กำหนดตำแหน่งของเอาต์พุตการทดสอบเพิ่มเติมที่จะคัดลอกไปยังโฮสต์ก่อนที่จะถอนการติดตั้งแอปทดสอบ |
abstract
void
|
setClassName(String className)
ตั้งค่าให้เรียกใช้เฉพาะการทดสอบในคลาสนี้ ต้องเรียกใช้ก่อน "run" |
abstract
void
|
setClassNames(String[] classNames)
ตั้งค่าให้เรียกใช้เฉพาะการทดสอบในคลาสที่ระบุ ต้องเรียกใช้ก่อน "run" |
abstract
void
|
setCoverage(boolean coverage)
ตั้งค่าโหมดความครอบคลุมของโค้ดของการทดสอบนี้ |
abstract
void
|
setCoverageReportLocation(String reportPath)
กำหนดตำแหน่งของรายงานความครอบคลุมที่สร้างขึ้น |
abstract
void
|
setDebug(boolean debug)
ตั้งค่าโหมดแก้ไขข้อบกพร่องของการทดสอบนี้ |
abstract
void
|
setLogOnly(boolean logOnly)
ตั้งค่าการทดสอบนี้เป็นโหมดบันทึกเท่านั้น - ข้ามการดำเนินการทดสอบ |
abstract
void
|
setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)
กำหนดเวลาสูงสุดที่อนุญาตระหว่างเอาต์พุตของคำสั่งเชลล์ที่เรียกใช้การทดสอบในอุปกรณ์ |
abstract
void
|
setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)
กำหนดเวลาสูงสุดที่อนุญาตให้การวัดผลเสร็จสิ้น |
abstract
void
|
setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
เลิกใช้เมธอดนี้แล้ว
ใช้ |
abstract
void
|
setMethodName(String className, String testName)
ตั้งค่าให้เรียกใช้เฉพาะเมธอดการทดสอบที่ระบุเท่านั้น ต้องเรียกใช้ก่อน "run" |
abstract
void
|
setRunName(String runName)
ตั้งชื่อการเรียกใช้ที่กำหนดเองเพื่อรายงานไปยัง หากไม่ระบุ ระบบจะใช้ชื่อแพ็กเกจ |
abstract
void
|
setTestCollection(boolean collection)
ตั้งค่าการทดสอบนี้เป็นโหมดการรวบรวมการทดสอบ |
abstract
void
|
setTestPackageName(String packageName)
ตั้งค่าให้เรียกใช้การทดสอบทั้งหมดในแพ็กเกจที่ระบุ ต้องเรียกใช้ก่อน "run" |
abstract
void
|
setTestSize(IRemoteAndroidTestRunner.TestSize size)
ตั้งค่าให้เรียกใช้เฉพาะการทดสอบที่มีขนาดที่ระบุ |
เมธอดสาธารณะ
addBooleanArg
public abstract void addBooleanArg (String name,
boolean value)เพิ่มอาร์กิวเมนต์บูลีนที่จะรวมไว้ในคำสั่งการวัดคุม
| พารามิเตอร์ | |
|---|---|
name |
String: ชื่ออาร์กิวเมนต์ของชุดเครื่องมือ |
value |
boolean: ค่าของอาร์กิวเมนต์ |
addInstrumentationArg
public abstract void addInstrumentationArg (String name,
String value)เพิ่มอาร์กิวเมนต์ที่จะรวมไว้ในคำสั่งการวัดคุม
ต้องเรียกใช้ก่อน 'run' หากมีการระบุอาร์กิวเมนต์ที่มีชื่อที่กำหนดไว้แล้ว ค่าของอาร์กิวเมนต์นั้นจะถูกลบล้าง
| พารามิเตอร์ | |
|---|---|
name |
String: ชื่ออาร์กิวเมนต์ของชุดเครื่องมือ |
value |
String: ค่าของอาร์กิวเมนต์ |
ยกเลิก
public abstract void cancel ()
ขอให้ยกเลิกการทดสอบนี้
getCoverageOutputType
public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()
แสดงผลประเภทของการทดสอบครอบคลุมที่โปรแกรมเรียกใช้สร้างขึ้น ดูCoverageOutput
| คิกรีเทิร์น | |
|---|---|
IRemoteAndroidTestRunner.CoverageOutput |
|
getPackageName
public abstract String getPackageName ()
แสดงผลชื่อแพ็กเกจของแอปพลิเคชัน
| คิกรีเทิร์น | |
|---|---|
String |
|
getRunnerName
public abstract String getRunnerName ()
แสดงผล runnerName
| คิกรีเทิร์น | |
|---|---|
String |
|
removeInstrumentationArg
public abstract void removeInstrumentationArg (String name)
นำอาร์กิวเมนต์ที่เพิ่มไว้ก่อนหน้านี้ออก
| พารามิเตอร์ | |
|---|---|
name |
String: ชื่อของอาร์กิวเมนต์แพ็กเกจการวัดผลที่จะนำออก |
โฮมรัน
public abstract void run (ITestRunListener... listeners)
เรียกใช้การทดสอบนี้
เมธอดที่สะดวกสำหรับ ERROR(/#run(Collection))
| พารามิเตอร์ | |
|---|---|
listeners |
ITestRunListener: ฟังผลการทดสอบ |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
ShellCommandUnresponsiveException |
หากอุปกรณ์ไม่แสดงผลการทดสอบใดๆ เป็นระยะเวลานานกว่าเวลาสูงสุดในการแสดงผล |
|
หากการเชื่อมต่อกับอุปกรณ์ขาดหายไป |
ดูเพิ่มเติม:
โฮมรัน
public abstract void run (listeners)
เรียกใช้การทดสอบนี้
| พารามิเตอร์ | |
|---|---|
listeners |
|
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
ShellCommandUnresponsiveException |
หากอุปกรณ์ไม่แสดงผลการทดสอบใดๆ เป็นระยะเวลานานกว่าเวลาสูงสุดในการแสดงผล |
|
หากการเชื่อมต่อกับอุปกรณ์ขาดหายไป |
ดูเพิ่มเติม:
setAdditionalTestOutputLocation
public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)
กำหนดตำแหน่งของเอาต์พุตการทดสอบเพิ่มเติมที่จะคัดลอกไปยังโฮสต์ก่อนที่จะถอนการติดตั้งแอปทดสอบ เช่น รายงานการเปรียบเทียบที่สร้างขึ้น
| พารามิเตอร์ | |
|---|---|
additionalTestDataPath |
String |
setClassName
public abstract void setClassName (String className)
ตั้งค่าให้เรียกใช้เฉพาะการทดสอบในคลาสนี้ ต้องเรียกใช้ก่อน "run"
| พารามิเตอร์ | |
|---|---|
className |
String: ชื่อคลาสที่สมบูรณ์ (เช่น x.y.z) |
setClassNames
public abstract void setClassNames (String[] classNames)
ตั้งค่าให้เรียกใช้เฉพาะการทดสอบในคลาสที่ระบุ ต้องเรียกใช้ก่อน "run"
หากระบุคลาสมากกว่า 1 คลาส จะต้องมี InstrumentationTestRunner ที่รองรับไวยากรณ์อาร์กิวเมนต์ของคลาสหลายรายการ
| พารามิเตอร์ | |
|---|---|
classNames |
String: อาร์เรย์ของชื่อคลาสที่สมบูรณ์ (เช่น x.y.z) |
setCoverage
public abstract void setCoverage (boolean coverage)
ตั้งค่าโหมดความครอบคลุมของโค้ดของการทดสอบนี้
| พารามิเตอร์ | |
|---|---|
coverage |
boolean |
setCoverageReportLocation
public abstract void setCoverageReportLocation (String reportPath)
กำหนดตำแหน่งของรายงานความครอบคลุมที่สร้างขึ้น
| พารามิเตอร์ | |
|---|---|
reportPath |
String |
setDebug
public abstract void setDebug (boolean debug)
ตั้งค่าโหมดแก้ไขข้อบกพร่องของการทดสอบนี้ หากเป็นจริง โปรแกรมเรียกใช้การทดสอบ Android จะรอให้โปรแกรมแก้ไขข้อบกพร่องแนบข้อมูลก่อนดำเนินการทดสอบต่อ
| พารามิเตอร์ | |
|---|---|
debug |
boolean |
setLogOnly
public abstract void setLogOnly (boolean logOnly)
ตั้งค่าการทดสอบนี้เป็นโหมดบันทึกเท่านั้น - ข้ามการดำเนินการทดสอบ
| พารามิเตอร์ | |
|---|---|
logOnly |
boolean |
setMaxTimeToOutputResponse
public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse,
TimeUnit maxTimeUnits)กำหนดเวลาสูงสุดที่อนุญาตระหว่างเอาต์พุตของคำสั่งเชลล์ที่เรียกใช้การทดสอบในอุปกรณ์
ซึ่งจะช่วยให้ตั้งค่าการหมดเวลาได้ในกรณีที่การทดสอบค้างและไม่เสร็จสิ้น ซึ่งแตกต่างจาก การหมดเวลาปกติในการเชื่อมต่อ
โดยค่าเริ่มต้น จะไม่มีการระบุการหมดเวลา
| พารามิเตอร์ | |
|---|---|
maxTimeToOutputResponse |
long: ระยะเวลาสูงสุดที่อนุญาตให้คำสั่งไม่ต้องแสดงเอาต์พุตใดๆ
ค่า 0 หมายความว่าเมธอดจะรอต่อไปเรื่อยๆ (จนกว่า receiver จะยกเลิกการดำเนินการ) สำหรับเอาต์พุตคำสั่งและจะไม่เกิดข้อผิดพลาด |
maxTimeUnits |
TimeUnit: หน่วยสำหรับค่าที่ไม่ใช่ 0 ของ maxTimeToOutputResponse และ maxTimeout
|
setMaxTimeout
public abstract void setMaxTimeout (long maxTimeout,
TimeUnit maxTimeUnits)กำหนดเวลาสูงสุดที่อนุญาตให้การวัดผลเสร็จสิ้น
ซึ่งจะช่วยให้ตั้งค่าการหมดเวลาได้ในกรณีที่การทดสอบค้างและไม่เสร็จสิ้น ซึ่งแตกต่างจาก การหมดเวลาปกติในการเชื่อมต่อ
โดยค่าเริ่มต้น จะไม่มีการระบุการหมดเวลา
| พารามิเตอร์ | |
|---|---|
maxTimeout |
long: ระยะเวลาสูงสุดที่คำสั่งได้รับอนุญาตให้ไม่ต้อง
แสดงผลการตอบกลับใดๆ ค่า 0 หมายความว่าเมธอดจะรอต่อไปเรื่อยๆ (จนกว่า receiver จะยกเลิกการดำเนินการ) สำหรับเอาต์พุตคำสั่งและจะไม่เกิดข้อผิดพลาด |
maxTimeUnits |
TimeUnit: หน่วยสำหรับค่าที่ไม่ใช่ 0 ของ maxTimeToOutputResponse และ maxTimeout
|
setMaxtimeToOutputResponse
public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)
เลิกใช้เมธอดนี้แล้ว
ใช้ ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit))
| พารามิเตอร์ | |
|---|---|
maxTimeToOutputResponse |
int |
setMethodName
public abstract void setMethodName (String className,
String testName)ตั้งค่าให้เรียกใช้เฉพาะเมธอดการทดสอบที่ระบุเท่านั้น ต้องเรียกใช้ก่อน "run"
| พารามิเตอร์ | |
|---|---|
className |
String: ชื่อคลาสที่สมบูรณ์ (เช่น x.y.z) |
testName |
String: ชื่อเมธอด |
setRunName
public abstract void setRunName (String runName)
ตั้งชื่อการเรียกใช้ที่กำหนดเองเพื่อรายงานไปยัง ITestRunListener ในวันที่ run(
หากไม่ระบุ ระบบจะใช้ชื่อแพ็กเกจ
setTestCollection
public abstract void setTestCollection (boolean collection)
ตั้งค่าการทดสอบนี้เป็นโหมดการรวบรวมการทดสอบ หากเป็นจริง ระบบจะข้ามการดำเนินการทดสอบและตั้งค่าอาร์กิวเมนต์ของโปรแกรมเรียกใช้ที่เหมาะสมทั้งหมดที่จำเป็นสำหรับการรวบรวมการทดสอบที่สำเร็จ
| พารามิเตอร์ | |
|---|---|
collection |
boolean |
setTestPackageName
public abstract void setTestPackageName (String packageName)
ตั้งค่าให้เรียกใช้การทดสอบทั้งหมดในแพ็กเกจที่ระบุ ต้องเรียกใช้ก่อน "run"
| พารามิเตอร์ | |
|---|---|
packageName |
String: ชื่อแพ็กเกจที่สมบูรณ์ (เช่น x.y.z) |
setTestSize
public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)
ตั้งค่าให้เรียกใช้เฉพาะการทดสอบที่มีขนาดที่ระบุ ต้องเรียกใช้ก่อน 'run'
| พารามิเตอร์ | |
|---|---|
size |
IRemoteAndroidTestRunner.TestSize: TestSize ที่จะเรียกใช้ |