RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.ddmlib.testrunner.RemoteAndroidTestRunner

เรียกใช้คำสั่งทดสอบ Android จากระยะไกลและรายงานผลลัพธ์

สรุป

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

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

เครื่องมือสร้างสำรอง

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

เครื่องมือสร้างสำรอง

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

สร้างโปรแกรมเรียกใช้การทดสอบ Android ระยะไกล

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

void addBooleanArg(String name, boolean value)

เพิ่มอาร์กิวเมนต์บูลีนที่จะรวมไว้ในคำสั่งการวัดคุม

void addInstrumentationArg(String name, String value)

เพิ่มอาร์กิวเมนต์ที่จะรวมไว้ในคำสั่งการวัดคุม

void cancel()

ขอให้ยกเลิกการทดสอบนี้

IInstrumentationResultParser createParser(String runName, listeners)

สร้าง InstrumentationResultParser ที่จะใช้ในการแยกวิเคราะห์เอาต์พุตการวัดผล

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

แสดงผลประเภทของการทดสอบครอบคลุมที่โปรแกรมเรียกใช้สร้างขึ้น

String getPackageName()

แสดงผลชื่อแพ็กเกจของแอปพลิเคชัน

String getRunOptions()

แสดงตัวเลือกสำหรับคำสั่งเครื่องมือ am

String getRunnerName()

แสดงผล runnerName

void removeInstrumentationArg(String name)

นำอาร์กิวเมนต์ที่เพิ่มไว้ก่อนหน้านี้ออก

void run(ITestRunListener... listeners)

เรียกใช้การทดสอบนี้

void run( listeners)

เรียกใช้การทดสอบนี้

void setAdditionalTestOutputLocation(String additionalTestDataPath)

กำหนดตำแหน่งของเอาต์พุตการทดสอบเพิ่มเติมที่จะคัดลอกไปยังโฮสต์ก่อนที่จะถอนการติดตั้งแอปทดสอบ

void setClassName(String className)

ตั้งค่าให้เรียกใช้เฉพาะการทดสอบในคลาสนี้ ต้องเรียกใช้ก่อน "run"

void setClassNames(String[] classNames)

ตั้งค่าให้เรียกใช้เฉพาะการทดสอบในคลาสที่ระบุ ต้องเรียกใช้ก่อน "run"

void setCoverage(boolean coverage)

ตั้งค่าโหมดความครอบคลุมของโค้ดของการทดสอบนี้

void setCoverageReportLocation(String reportPath)

กำหนดตำแหน่งของรายงานความครอบคลุมที่สร้างขึ้น

void setDebug(boolean debug)

ตั้งค่าโหมดแก้ไขข้อบกพร่องของการทดสอบนี้

void setLogOnly(boolean logOnly)

ตั้งค่าการทดสอบนี้เป็นโหมดบันทึกเท่านั้น - ข้ามการดำเนินการทดสอบ

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

กำหนดเวลาสูงสุดที่อนุญาตระหว่างเอาต์พุตของคำสั่งเชลล์ที่เรียกใช้การทดสอบในอุปกรณ์

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

กำหนดเวลาสูงสุดที่อนุญาตให้การวัดผลเสร็จสิ้น

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
void setMethodName(String className, String testName)

ตั้งค่าให้เรียกใช้เฉพาะเมธอดการทดสอบที่ระบุเท่านั้น ต้องเรียกใช้ก่อน "run"

void setRunName(String runName)

ตั้งชื่อการเรียกใช้ที่กำหนดเองเพื่อรายงานไปยัง ITestRunListener ในวันที่ run()

หากไม่ระบุ ระบบจะใช้ชื่อแพ็กเกจ

void setRunOptions(String options)

ตั้งค่าตัวเลือกสำหรับคำสั่งเครื่องมือ am

void setTestCollection(boolean collect)

ตั้งค่าการทดสอบนี้เป็นโหมดการรวบรวมการทดสอบ

void setTestPackageName(String packageName)

ตั้งค่าให้เรียกใช้การทดสอบทั้งหมดในแพ็กเกจที่ระบุ ต้องเรียกใช้ก่อน "run"

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

ตั้งค่าให้เรียกใช้เฉพาะการทดสอบที่มีขนาดที่ระบุ

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

String getArgsCommand()

แสดงผลไวยากรณ์บรรทัดคำสั่งการวัดคุมแบบเต็มสำหรับอาร์กิวเมนต์การวัดคุมที่ระบุ

String getRunnerPath()

แสดงผลเส้นทางคอมโพเนนต์การวัดที่สมบูรณ์

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

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

เครื่องมือสร้างสำรอง ใช้เครื่องมือเรียกใช้การตรวจสอบเริ่มต้น

พารามิเตอร์
packageName String: แพ็กเกจแอปพลิเคชัน Android ที่มีการทดสอบที่จะเรียกใช้
remoteDevice IShellEnabledDevice: อุปกรณ์ Android ที่จะใช้ทดสอบ

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

เครื่องมือสร้างสำรอง ใช้ statusReporterMode โดยค่าเริ่มต้น

พารามิเตอร์
packageName String: แพ็กเกจแอปพลิเคชัน Android ที่มีการทดสอบที่จะเรียกใช้
runnerName String: ตัวเรียกใช้การทดสอบการวัดคุมเพื่อดำเนินการ หากเป็น Null จะใช้ โปรแกรมเรียกใช้เริ่มต้น
remoteDevice IShellEnabledDevice: อุปกรณ์ Android ที่จะใช้ดำเนินการทดสอบ

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

สร้างโปรแกรมเรียกใช้การทดสอบ Android ระยะไกล

พารามิเตอร์
packageName String: แพ็กเกจแอปพลิเคชัน Android ที่มีการทดสอบที่จะเรียกใช้
runnerName String: ตัวเรียกใช้การทดสอบการวัดคุมเพื่อดำเนินการ หากเป็น Null จะใช้ โปรแกรมเรียกใช้เริ่มต้น
remoteDevice IShellEnabledDevice: อุปกรณ์ Android ที่จะใช้ทดสอบ
statusReporterMode RemoteAndroidTestRunner.StatusReporterMode: โหมดเครื่องมือรายงานสถานะที่จะใช้สำหรับคำสั่งเครื่องมือ

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

addBooleanArg

public void addBooleanArg (String name, 
                boolean value)

เพิ่มอาร์กิวเมนต์บูลีนที่จะรวมไว้ในคำสั่งการวัดคุม

พารามิเตอร์
name String: ชื่ออาร์กิวเมนต์ของชุดเครื่องมือ
value boolean: ค่าของอาร์กิวเมนต์

addInstrumentationArg

public void addInstrumentationArg (String name, 
                String value)

เพิ่มอาร์กิวเมนต์ที่จะรวมไว้ในคำสั่งการวัดคุม

ต้องเรียกใช้ก่อน 'run' หากมีการระบุอาร์กิวเมนต์ที่มีชื่อที่กำหนดไว้แล้ว ค่าของอาร์กิวเมนต์นั้นจะถูกลบล้าง

พารามิเตอร์
name String: ชื่ออาร์กิวเมนต์ของชุดเครื่องมือ
value String: ค่าของอาร์กิวเมนต์

ยกเลิก

public void cancel ()

ขอให้ยกเลิกการทดสอบนี้

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

สร้าง InstrumentationResultParser ที่จะใช้ในการแยกวิเคราะห์เอาต์พุตการวัดผล

พารามิเตอร์
runName String: ชื่อของการเรียกใช้ที่จะใช้
listeners : ผู้ฟังที่รายงานผล
คิกรีเทิร์น
IInstrumentationResultParser อินสแตนซ์ของ InstrumentationResultParser

getAmInstrumentCommand

public String getAmInstrumentCommand ()

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

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

แสดงผลประเภทของการทดสอบครอบคลุมที่โปรแกรมเรียกใช้สร้างขึ้น ดูCoverageOutput

คิกรีเทิร์น
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

แสดงผลชื่อแพ็กเกจของแอปพลิเคชัน

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

getRunOptions

public String getRunOptions ()

แสดงตัวเลือกสำหรับคำสั่งเครื่องมือ am

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

getRunnerName

public String getRunnerName ()

แสดงผล runnerName

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

removeInstrumentationArg

public void removeInstrumentationArg (String name)

นำอาร์กิวเมนต์ที่เพิ่มไว้ก่อนหน้านี้ออก

พารามิเตอร์
name String: ชื่อของอาร์กิวเมนต์แพ็กเกจการวัดผลที่จะนำออก

โฮมรัน

public void run (ITestRunListener... listeners)

เรียกใช้การทดสอบนี้

เมธอดที่สะดวกสำหรับ ERROR(/#run(Collection))

พารามิเตอร์
listeners ITestRunListener: ฟังผลการทดสอบ
การขว้าง
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

โฮมรัน

public void run ( listeners)

เรียกใช้การทดสอบนี้

พารามิเตอร์
listeners : คอลเล็กชันของ Listener สำหรับผลการทดสอบ
การขว้าง
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

กำหนดตำแหน่งของเอาต์พุตการทดสอบเพิ่มเติมที่จะคัดลอกไปยังโฮสต์ก่อนที่จะถอนการติดตั้งแอปทดสอบ เช่น รายงานการเปรียบเทียบที่สร้างขึ้น

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

setClassName

public void setClassName (String className)

ตั้งค่าให้เรียกใช้เฉพาะการทดสอบในคลาสนี้ ต้องเรียกใช้ก่อน "run"

พารามิเตอร์
className String: ชื่อคลาสที่สมบูรณ์ (เช่น x.y.z)

setClassNames

public void setClassNames (String[] classNames)

ตั้งค่าให้เรียกใช้เฉพาะการทดสอบในคลาสที่ระบุ ต้องเรียกใช้ก่อน "run"

หากระบุคลาสมากกว่า 1 คลาส จะต้องมี InstrumentationTestRunner ที่รองรับไวยากรณ์อาร์กิวเมนต์ของคลาสหลายรายการ

พารามิเตอร์
classNames String: อาร์เรย์ของชื่อคลาสที่สมบูรณ์ (เช่น x.y.z)

setCoverage

public void setCoverage (boolean coverage)

ตั้งค่าโหมดความครอบคลุมของโค้ดของการทดสอบนี้

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

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

กำหนดตำแหน่งของรายงานความครอบคลุมที่สร้างขึ้น

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

setDebug

public void setDebug (boolean debug)

ตั้งค่าโหมดแก้ไขข้อบกพร่องของการทดสอบนี้ หากเป็นจริง โปรแกรมเรียกใช้การทดสอบ Android จะรอให้โปรแกรมแก้ไขข้อบกพร่องแนบข้อมูลก่อนดำเนินการทดสอบต่อ

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

setLogOnly

public void setLogOnly (boolean logOnly)

ตั้งค่าการทดสอบนี้เป็นโหมดบันทึกเท่านั้น - ข้ามการดำเนินการทดสอบ

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

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

กำหนดเวลาสูงสุดที่อนุญาตระหว่างเอาต์พุตของคำสั่งเชลล์ที่เรียกใช้การทดสอบในอุปกรณ์

ซึ่งจะช่วยให้ตั้งค่าการหมดเวลาได้ในกรณีที่การทดสอบค้างและไม่เสร็จสิ้น ซึ่งแตกต่างจาก การหมดเวลาปกติในการเชื่อมต่อ

โดยค่าเริ่มต้น จะไม่มีการระบุการหมดเวลา

พารามิเตอร์
maxTimeToOutputResponse long: ระยะเวลาสูงสุดที่อนุญาตให้คำสั่งไม่ต้องแสดงเอาต์พุตใดๆ ค่า 0 หมายความว่าเมธอดจะรอต่อไปเรื่อยๆ (จนกว่า receiver จะยกเลิกการดำเนินการ) สำหรับเอาต์พุตคำสั่งและจะไม่เกิดข้อผิดพลาด
maxTimeUnits TimeUnit: หน่วยสำหรับค่าที่ไม่ใช่ 0 ของ maxTimeToOutputResponse และ maxTimeout

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

กำหนดเวลาสูงสุดที่อนุญาตให้การวัดผลเสร็จสิ้น

ซึ่งจะช่วยให้ตั้งค่าการหมดเวลาได้ในกรณีที่การทดสอบค้างและไม่เสร็จสิ้น ซึ่งแตกต่างจาก การหมดเวลาปกติในการเชื่อมต่อ

โดยค่าเริ่มต้น จะไม่มีการระบุการหมดเวลา

พารามิเตอร์
maxTimeout long: ระยะเวลาสูงสุดที่คำสั่งได้รับอนุญาตให้ไม่ต้อง แสดงผลการตอบกลับใดๆ ค่า 0 หมายความว่าเมธอดจะรอต่อไปเรื่อยๆ (จนกว่า receiver จะยกเลิกการดำเนินการ) สำหรับเอาต์พุตคำสั่งและจะไม่เกิดข้อผิดพลาด
maxTimeUnits TimeUnit: หน่วยสำหรับค่าที่ไม่ใช่ 0 ของ maxTimeToOutputResponse และ maxTimeout

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

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

setMethodName

public void setMethodName (String className, 
                String testName)

ตั้งค่าให้เรียกใช้เฉพาะเมธอดการทดสอบที่ระบุเท่านั้น ต้องเรียกใช้ก่อน "run"

พารามิเตอร์
className String: ชื่อคลาสที่สมบูรณ์ (เช่น x.y.z)
testName String: ชื่อเมธอด

setRunName

public void setRunName (String runName)

ตั้งชื่อการเรียกใช้ที่กำหนดเองเพื่อรายงานไปยัง ITestRunListener ในวันที่ run()

หากไม่ระบุ ระบบจะใช้ชื่อแพ็กเกจ

setRunOptions

public void setRunOptions (String options)

ตั้งค่าตัวเลือกสำหรับคำสั่งเครื่องมือ am ดูรายการตัวเลือกทั้งหมดได้ที่ com/android/commands/am/Am.java

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

setTestCollection

public void setTestCollection (boolean collect)

ตั้งค่าการทดสอบนี้เป็นโหมดการรวบรวมการทดสอบ หากเป็นจริง ระบบจะข้ามการดำเนินการทดสอบและตั้งค่าอาร์กิวเมนต์ของโปรแกรมเรียกใช้ที่เหมาะสมทั้งหมดที่จำเป็นสำหรับการรวบรวมการทดสอบที่สำเร็จ

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

setTestPackageName

public void setTestPackageName (String packageName)

ตั้งค่าให้เรียกใช้การทดสอบทั้งหมดในแพ็กเกจที่ระบุ ต้องเรียกใช้ก่อน "run"

พารามิเตอร์
packageName String: ชื่อแพ็กเกจที่สมบูรณ์ (เช่น x.y.z)

setTestSize

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

ตั้งค่าให้เรียกใช้เฉพาะการทดสอบที่มีขนาดที่ระบุ ต้องเรียกใช้ก่อน 'run'

พารามิเตอร์
size IRemoteAndroidTestRunner.TestSize: TestSize ที่จะเรียกใช้

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

getArgsCommand

protected String getArgsCommand ()

แสดงผลไวยากรณ์บรรทัดคำสั่งการวัดคุมแบบเต็มสำหรับอาร์กิวเมนต์การวัดคุมที่ระบุ แสดงผลสตริงว่างหากไม่ได้ระบุอาร์กิวเมนต์

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

getRunnerPath

protected String getRunnerPath ()

แสดงผลเส้นทางคอมโพเนนต์การวัดที่สมบูรณ์

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