INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

คลาสย่อยโดยอ้อมที่ทราบ IManagedTestDevice, ITestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice IManagedTestDevice ITestDevice ที่มีการจัดการวงจร  ITestDevice ให้ API ที่เชื่อถือได้และระดับสูงกว่าเล็กน้อยแก่ ddmlib IDevice  LocalAndroidVirtualDevice คลาสสำหรับอุปกรณ์เสมือนในพื้นที่ที่ทำงานบนโฮสต์ TradeFed  ManagedRemoteDevice อุปกรณ์ที่ทำงานภายในเครื่องเสมือนที่เราจัดการจากระยะไกลผ่านอินสแตนซ์ Tradefed ภายใน VM  NativeDevice การติดตั้งใช้งานเริ่มต้นของITestDevice อุปกรณ์ Android ที่ไม่ใช้สแต็กแบบสมบูรณ์  NestedRemoteDevice การนําเสนออุปกรณ์ที่ทํางานภายใน Cuttlefish VM ระยะไกล  RemoteAndroidDevice การติดตั้งใช้งาน ITestDevice สําหรับอุปกรณ์ Android แบบสแต็กเต็มรูปแบบที่เชื่อมต่อผ่าน adb connect  RemoteAndroidVirtualDevice ขยายลักษณะการทํางานของ RemoteAndroidDevice สําหรับอุปกรณ์ Android สแต็กแบบสมบูรณ์ที่ทํางานใน Google Compute Engine (GCE)  TestDevice การติดตั้งใช้งาน ITestDevice สําหรับอุปกรณ์ Android แบบสแต็กเต็ม

---

ให้ API ที่เชื่อถือได้และระดับสูงกว่าเล็กน้อยแก่ ddmlib IDevice

พยายามส่งคําสั่งไปยังอุปกรณ์อีกครั้งตามจํานวนที่กำหนดได้ และแสดงอินเทอร์เฟซการกู้คืนอุปกรณ์สําหรับอุปกรณ์ที่ไม่ตอบสนอง

สรุป

ค่าคงที่
int	UNKNOWN_API_LEVEL ค่าเริ่มต้นเมื่อตรวจไม่พบระดับ API

เมธอดสาธารณะ
abstract boolean	checkApiLevelAgainstNextRelease(int strictMinLevel) ตรวจสอบว่าฟีเจอร์ใดรองรับในขณะนี้หรือไม่โดยพิจารณาจากระดับที่รองรับขั้นต่ำ
abstract void	clearLogcat() ลบข้อมูล logcat ที่สะสมไว้
abstract void	deleteFile(String deviceFilePath) เมธอดตัวช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์
abstract void	deleteFile(String deviceFilePath, int userId) เมธอดตัวช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์
abstract boolean	deviceSoftRestarted(ProcessInfo prevSystemServerProcess) เมธอดผู้ช่วยสำหรับตรวจสอบว่าอุปกรณ์รีสตาร์ทแบบซอฟต์แล้วหรือไม่โดยเปรียบเทียบ system_server ปัจจุบันกับ ProcessInfo system_server ก่อนหน้า
abstract boolean	deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit) เมธอดตัวช่วยสำหรับตรวจสอบว่าอุปกรณ์รีสตาร์ทแบบซอฟต์ตั้งแต่เวลา UTC นับจากจุดเริ่มต้นจากอุปกรณ์และ ERROR(/TimeUnit) หรือไม่
abstract boolean	disableAdbRoot() ปิด adb root
abstract boolean	doesFileExist(String deviceFilePath) เมธอดตัวช่วยเพื่อระบุว่ามีไฟล์ในอุปกรณ์หรือไม่
abstract boolean	enableAdbRoot() เปิด adb root
abstract String	executeAdbCommand(long timeout, String... commandArgs) เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb เป็นคําสั่งระบบที่มีระยะหมดเวลาตามที่ระบุ
abstract String	executeAdbCommand(String... commandArgs) เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb เป็นคําสั่งของระบบ
abstract String	executeAdbCommand(long timeout, envMap, String... commandArgs) เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb เป็นคําสั่งระบบที่มีระยะหมดเวลาตามที่ระบุ
abstract CommandResult	executeFastbootCommand(long timeout, String... commandArgs) เมธอดตัวช่วยที่ดำเนินการคำสั่ง fastboot เป็นคำสั่งของระบบ
abstract CommandResult	executeFastbootCommand(String... commandArgs) เมธอดตัวช่วยที่เรียกใช้คำสั่ง fastboot เป็นคำสั่งของระบบที่มีระยะหมดเวลาเริ่มต้น 2 นาที
abstract CommandResult	executeLongFastbootCommand(String... commandArgs) เมธอดตัวช่วยที่เรียกใช้คำสั่ง fastboot ที่ทำงานเป็นเวลานานเป็นคำสั่งของระบบ
abstract CommandResult	executeLongFastbootCommand( envVarMap, String... commandArgs) เมธอดตัวช่วยที่ดำเนินการคำสั่ง fastboot ที่ทำงานเป็นเวลานานเป็นคำสั่งระบบที่มีตัวแปรสภาพแวดล้อมของระบบ
abstract String	executeShellCommand(String command) เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb shell และแสดงผลลัพธ์เป็น String
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver) ดำเนินการตามคำสั่ง adb shell ที่ระบุ โดยพยายามใหม่หลายครั้งหากคำสั่งไม่สำเร็จ
abstract CommandResult	executeShellV2Command(String command) เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ที่สร้างขึ้นอย่างถูกต้องพร้อมเอาต์พุตสถานะคําสั่ง, stdout และ stderr
abstract CommandResult	executeShellV2Command(String command, OutputStream pipeToOutput) เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ที่สร้างขึ้นอย่างถูกต้องพร้อมเอาต์พุตสถานะคําสั่งและ stderr
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput) เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ที่สร้างขึ้นอย่างถูกต้องพร้อมเอาต์พุตสถานะคําสั่ง, stdout และ stderr
abstract CommandResult	executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง
abstract CommandResult	executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit) เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง
abstract CommandResult	fastbootWipePartition(String partition) เมธอดตัวช่วยซึ่งล้างพาร์ติชันของอุปกรณ์
abstract int	getApiLevel() รับระดับ API ของอุปกรณ์
abstract String	getBasebandVersion() วิธีการที่สะดวกในการรับเวอร์ชันเบสแบนด์ (วิทยุ) ของอุปกรณ์นี้
abstract Integer	getBattery() แสดงระดับแบตเตอรี่ปัจจุบันของอุปกรณ์ หรือ Null หากไม่มีระดับแบตเตอรี่
abstract boolean	getBooleanProperty(String name, boolean defaultValue) แสดงผลค่าบูลีนของพร็อพเพอร์ตี้ที่ระบุ
abstract	getBootHistory() เมธอด Helper จะรวบรวมแผนที่ประวัติการบูตพร้อมเวลาบูตและเหตุผลในการบูต
abstract	getBootHistorySince(long utcEpochTime, TimeUnit timeUnit) เมธอดตัวช่วยจะรวบรวมแผนที่ประวัติการบูตพร้อมเวลาบูตและเหตุผลในการบูตนับจากเวลาที่ระบุนับจากจุดเริ่มต้นจากอุปกรณ์และหน่วยเวลาที่ระบุ
abstract String	getBootloaderVersion() วิธีการที่สะดวกในการรับเวอร์ชัน Bootloader ของอุปกรณ์นี้
abstract String	getBuildAlias() เรียกข้อมูลแทนของบิลด์ที่อุปกรณ์ใช้อยู่
abstract String	getBuildFlavor() ดึงข้อมูล Flavor ของบิลด์สำหรับอุปกรณ์
abstract String	getBuildId() เรียกข้อมูลบิลด์ที่อุปกรณ์ใช้อยู่
abstract String	getBuildSigningKeys() แสดงผลประเภทคีย์ที่ใช้รับรองรูปภาพอุปกรณ์ โดยทั่วไปอุปกรณ์ Android อาจได้รับการรับรองด้วยคีย์ทดสอบ (เช่น ใน AOSP) หรือคีย์รุ่น (ควบคุมโดยผู้ผลิตอุปกรณ์แต่ละราย)
abstract DeviceDescriptor	getCachedDeviceDescriptor() แสดง DeviceDescriptor ที่แคชไว้หากมีการจัดสรรอุปกรณ์ไว้ มิเช่นนั้นแสดง DeviceDescriptor ปัจจุบัน
abstract DeviceDescriptor	getCachedDeviceDescriptor(boolean shortDescriptor) แสดง DeviceDescriptor ที่แคชไว้หากมีการจัดสรรอุปกรณ์ไว้ มิเช่นนั้นแสดง DeviceDescriptor ปัจจุบัน
abstract String[]	getChildren(String deviceFilePath) ทางเลือกในการใช้ IFileEntry ที่บางครั้งอาจใช้ไม่ได้เนื่องจากสิทธิ์
abstract AbstractConnection	getConnection() แสดงการเชื่อมต่อที่เชื่อมโยงกับอุปกรณ์
abstract String	getDeviceClass() รับคลาสอุปกรณ์
abstract long	getDeviceDate() แสดงผลวันที่ของอุปกรณ์เป็นมิลลิวินาทีนับจากวันที่ 1 มกราคม ค.ศ. 1970
abstract DeviceDescriptor	getDeviceDescriptor() แสดงผล DeviceDescriptor จากข้อมูลอุปกรณ์เพื่อรับข้อมูลโดยไม่ต้องส่งออบเจ็กต์อุปกรณ์จริง
abstract DeviceDescriptor	getDeviceDescriptor(boolean shortDescriptor) แสดงผล DeviceDescriptor จากข้อมูลอุปกรณ์เพื่อรับข้อมูลโดยไม่ต้องส่งออบเจ็กต์อุปกรณ์จริง
abstract TestDeviceState	getDeviceState() รับสถานะของอุปกรณ์
abstract long	getDeviceTimeOffset(Date date) ตัวช่วยรับเวลาที่แตกต่างกันระหว่างอุปกรณ์กับ ERROR(/Date) ที่ระบุ
abstract InputStreamSource	getEmulatorOutput() รับสตรีมของ stdout และ stderr ของโปรแกรมจำลอง
abstract long	getExternalStoreFreeSpace() เมธอดตัวช่วยในการระบุปริมาณพื้นที่ว่างในอุปกรณ์จัดเก็บข้อมูลภายนอก
abstract String	getFastbootProductType() วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ในโหมด Fastboot
abstract String	getFastbootProductVariant() วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ในโหมด Fastboot
abstract String	getFastbootSerialNumber() แสดงผลหมายเลขซีเรียลของโหมด Fastboot
abstract String	getFastbootVariable(String variableName) ดึงค่าตัวแปร fastboot ที่ระบุจากอุปกรณ์
abstract IFileEntry	getFileEntry(String path) เรียกข้อมูลอ้างอิงไปยังไฟล์ระยะไกลในอุปกรณ์
abstract IDevice	getIDevice() แสดงการอ้างอิงไปยัง ddmlib IDevice ที่เชื่อมโยง
abstract long	getIntProperty(String name, long defaultValue) แสดงผลค่าจำนวนเต็มของพร็อพเพอร์ตี้ที่ระบุจากอุปกรณ์
abstract long	getLastExpectedRebootTimeMillis() แสดงเวลาล่าสุดที่ Tradefed API ทริกเกอร์การรีบูตเป็นมิลลิวินาทีนับจาก EPOCH ตามที่ได้มาจาก System.currentTimeMillis()
abstract int	getLaunchApiLevel() ดูระดับ API ที่เปิดตัวครั้งแรกของอุปกรณ์
abstract InputStreamSource	getLogcat() ดึงข้อมูลสตรีมภาพรวมของข้อมูล logcat
abstract InputStreamSource	getLogcat(int maxBytes) ดึงข้อมูลสตรีมสแนปชอตของข้อมูล Logcat maxBytes รายการล่าสุดที่บันทึกไว้
abstract InputStreamSource	getLogcatDump() รับการดัมพ์ Logcat ปัจจุบันของอุปกรณ์
abstract InputStreamSource	getLogcatSince(long date) ดึงข้อมูลสตรีมสแนปชอตของข้อมูลบันทึกที่บันทึกไว้โดยเริ่มจากวันที่ที่ระบุ
abstract String	getMountPoint(String mountName) แสดงผลจุดต่อเชื่อม
abstract ITestDevice.MountPointInfo	getMountPointInfo(String mountpoint) แสดงผล MountPointInfo ที่สอดคล้องกับเส้นทางจุดต่อเชื่อมที่ระบุ หรือ null หากเส้นทางนั้นไม่มีสิ่งที่ต่อเชื่อมอยู่หรือไม่ปรากฏใน /proc/mounts เป็นจุดต่อเชื่อม
abstract	getMountPointInfo() แสดงผลข้อมูลใน /proc/mounts บนอุปกรณ์เวอร์ชันที่แยกวิเคราะห์แล้ว
abstract long	getPartitionFreeSpace(String partition) เมธอดตัวช่วยในการระบุปริมาณพื้นที่ว่างบนพาร์ติชันของอุปกรณ์
abstract ProcessInfo	getProcessByName(String processName) เมธอดตัวช่วยจะเรียกใช้คําสั่ง "pidof" และ "stat" และแสดงผลออบเจ็กต์ ProcessInfo ที่มี PID และเวลาเริ่มต้นของกระบวนการที่ระบุ
abstract String	getProcessPid(String process) แสดง PID ของบริการหรือค่าว่างหากเกิดข้อผิดพลาด
abstract String	getProductType() วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้
abstract String	getProductVariant() วิธีการที่สะดวกในการรับผลิตภัณฑ์ย่อยของอุปกรณ์นี้
abstract String	getProperty(String name) ดึงค่าพร็อพเพอร์ตี้ที่ระบุจากอุปกรณ์
abstract ITestDevice.RecoveryMode	getRecoveryMode() ดูโหมดการกู้คืนปัจจุบันที่ใช้กับอุปกรณ์
abstract String	getSerialNumber() วิธีการที่สะดวกในการรับหมายเลขซีเรียลของอุปกรณ์นี้
abstract	getTombstones() ดึงข้อมูลและแสดงรายการรายการที่ลบไปแล้วจากอุปกรณ์
abstract long	getTotalMemory() แสดงขนาดหน่วยความจําจริงทั้งหมดเป็นไบต์ หรือ -1 ในกรณีที่เกิดข้อผิดพลาดภายใน
default String	getTrackingSerial() หาหมายเลขซีเรียลที่ใช้ติดตามอุปกรณ์เพื่อวัตถุประสงค์ในการจัดการอุปกรณ์
abstract boolean	getUseFastbootErase() ดูว่าควรใช้ fastboot erase หรือ fastboot format เพื่อล้างพาร์ติชันในอุปกรณ์
abstract boolean	isAdbRoot()
abstract boolean	isAdbTcp()
abstract boolean	isAppEnumerationSupported() ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการแจกแจงแอปหรือไม่
abstract boolean	isBypassLowTargetSdkBlockSupported() ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการข้ามการบล็อก SDK เป้าหมายต่ำในการติดตั้งแอปหรือไม่
abstract boolean	isDebugfsMounted() ตรวจสอบว่าระบบได้ต่อเชื่อม debugfs หรือไม่
abstract boolean	isDeviceEncrypted() แสดงผลหากอุปกรณ์มีการเข้ารหัส
abstract boolean	isDirectory(String deviceFilePath) แสดงผลเป็น "จริง" หากเส้นทางในอุปกรณ์เป็นไดเรกทอรี หากไม่ใช่จะแสดงผลเป็น "เท็จ"
abstract boolean	isEncryptionSupported() แสดงผลหากอุปกรณ์รองรับการเข้ารหัส
abstract boolean	isExecutable(String fullPath) แสดงผลเป็น "จริง" หากเส้นทางไฟล์ในอุปกรณ์เป็นไฟล์ที่เรียกใช้ได้ หากไม่ใช่จะแสดงผลเป็น "เท็จ"
abstract boolean	isHeadless() แสดงผลเป็น "จริง" หากอุปกรณ์ไม่มีจอแสดงผล (ไม่มีหน้าจอ) หากไม่ใช่จะแสดงผลเป็น "เท็จ"
abstract boolean	isRuntimePermissionSupported() ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการให้สิทธิ์รันไทม์หรือไม่
abstract boolean	isStateBootloaderOrFastbootd() แสดงค่า "จริง" หากอุปกรณ์อยู่ใน TestDeviceState.FASTBOOT หรือ TestDeviceState.FASTBOOTD
abstract boolean	logAnrs(ITestLogger logger) รวบรวมและบันทึก ANR จากอุปกรณ์
abstract void	logOnDevice(String tag, Log.LogLevel level, String format, Object... args) บันทึกข้อความใน Logcat ของอุปกรณ์
abstract void	mountDebugfs() ติดตั้ง debugfs
abstract void	nonBlockingReboot() ส่งคําสั่งให้รีบูตอุปกรณ์และแสดงผลเมื่อคําสั่งเสร็จสมบูรณ์และเมื่อ adb ไม่เห็นอุปกรณ์อีกต่อไป
abstract void	postBootSetup() ทำตามวิธีการเพื่อกำหนดค่าอุปกรณ์สำหรับการทดสอบหลังจากการบูตทุกครั้ง
default void	postInvocationTearDown() เราเลิกใช้งานเมธอดนี้แล้ว ให้ใช้ postInvocationTearDown(Throwable) แทน
abstract void	postInvocationTearDown(Throwable invocationException) ขั้นตอนเพิ่มเติมสำหรับการล้างข้อมูลที่จำเป็นสำหรับอุปกรณ์โดยเฉพาะที่จะดำเนินการหลังจากการเรียกใช้เสร็จสิ้น
default void	preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes) ขั้นตอนเพิ่มเติมสำหรับการตั้งค่าที่จำเป็นเฉพาะอุปกรณ์ที่จะดำเนินการในอุปกรณ์ก่อนขั้นตอนเรียกใช้
abstract boolean	pullDir(String deviceFilePath, File localDir) ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์แบบซ้ำ
abstract boolean	pullDir(String deviceFilePath, File localDir, int userId) ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์แบบซ้ำ
abstract File	pullFile(String remoteFilePath, int userId) ดึงไฟล์ออกจากอุปกรณ์ จัดเก็บไว้ใน ERROR(/File) ชั่วคราวในเครื่อง และแสดง File นั้น
abstract File	pullFile(String remoteFilePath) ดึงไฟล์ออกจากอุปกรณ์ จัดเก็บไว้ใน ERROR(/File) ชั่วคราวในเครื่อง และแสดง File นั้น
abstract boolean	pullFile(String remoteFilePath, File localFile) ดึงข้อมูลไฟล์ออกจากอุปกรณ์
abstract boolean	pullFile(String remoteFilePath, File localFile, int userId) ดึงข้อมูลไฟล์ออกจากอุปกรณ์
abstract String	pullFileContents(String remoteFilePath) ดึงข้อมูลไฟล์ออกจากอุปกรณ์และแสดงผลเนื้อหา
abstract File	pullFileFromExternal(String remoteFilePath) วิธีการที่สะดวกในการดึงไฟล์จากที่จัดเก็บข้อมูลภายนอกของอุปกรณ์ จัดเก็บไฟล์ในERROR(/File)ชั่วคราวในเครื่อง และแสดงผลข้อมูลอ้างอิงไปยังFileนั้น
abstract boolean	pushDir(File localDir, String deviceFilePath, int userId) พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบซ้ำ
abstract boolean	pushDir(File localDir, String deviceFilePath, excludedDirectories) พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบซ้ำซ้อนขณะยกเว้นไดเรกทอรีบางรายการที่กรองออก
abstract boolean	pushDir(File localDir, String deviceFilePath) พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบซ้ำ
abstract boolean	pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) ตัวแปรของ pushFile(File, String) ซึ่งอาจพิจารณาประเมินความจำเป็นสำหรับผู้ให้บริการเนื้อหา
abstract boolean	pushFile(File localFile, String deviceFilePath) พุชไฟล์ไปยังอุปกรณ์
abstract boolean	pushFile(File localFile, String deviceFilePath, int userId) พุชไฟล์ไปยังอุปกรณ์
abstract boolean	pushString(String contents, String deviceFilePath) พุชไฟล์ที่สร้างจากสตริงไปยังอุปกรณ์
abstract void	reboot() รีบูตอุปกรณ์เป็นโหมด adb
abstract void	reboot(String reason) รีบูตอุปกรณ์เป็นโหมด ADB ด้วย reason ที่ระบุไว้เพื่อให้คงอยู่หลังจากรีบูต
abstract void	rebootIntoBootloader() รีบูตอุปกรณ์เป็นโหมด Bootloader
abstract void	rebootIntoFastbootd() รีบูตอุปกรณ์เข้าสู่โหมด fastbootd
abstract void	rebootIntoRecovery() รีบูตอุปกรณ์ให้อยู่ในโหมดการกู้คืน adb
abstract void	rebootIntoSideload(boolean autoReboot) รีบูตอุปกรณ์เป็นโหมดการโหลดจากแหล่งที่ไม่รู้จักของ adb (โปรดทราบว่านี่เป็นโหมดพิเศษในการกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดการโหลดจากภายนอก
abstract void	rebootIntoSideload() รีบูตอุปกรณ์เป็นโหมดการโหลดจากแหล่งที่ไม่รู้จักของ adb (โปรดทราบว่านี่เป็นโหมดพิเศษในการกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดการโหลดจากภายนอก
abstract void	rebootUntilOnline() คำสั่งอื่นแทน reboot() ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์ เช่น มองเห็นโดย adb
abstract void	rebootUntilOnline(String reason) คำสั่งอื่นแทน reboot() ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์ เช่น มองเห็นโดย adb
abstract void	rebootUserspace() รีบูตเฉพาะพื้นที่ผู้ใช้ของอุปกรณ์
abstract void	rebootUserspaceUntilOnline() คำสั่งอื่นแทน rebootUserspace() ()} ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์ เช่น มองเห็นโดย adb
abstract void	remountSystemReadOnly() ทำให้พาร์ติชันระบบในอุปกรณ์เป็นแบบอ่านอย่างเดียว
abstract void	remountSystemWritable() ทำให้สามารถเขียนพาร์ติชันระบบในอุปกรณ์ได้
abstract void	remountVendorReadOnly() ทำให้พาร์ติชันของผู้ให้บริการในอุปกรณ์เป็นแบบอ่านอย่างเดียว
abstract void	remountVendorWritable() ทำให้สามารถเขียนพาร์ติชันของผู้ให้บริการในอุปกรณ์ได้
abstract boolean	runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) เมธอดที่สะดวกสำหรับการดำเนินการ ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) ที่มี Listener อย่างน้อย 1 รายการที่ส่งผ่านเป็นพารามิเตอร์
abstract boolean	runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners) เรียกใช้การทดสอบการใช้เครื่องมือและให้การกู้คืนอุปกรณ์
abstract boolean	runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners) เหมือนกับ ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) แต่จะเป็นการเรียกใช้การทดสอบสําหรับผู้ใช้ที่ระบุ
abstract boolean	runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) เหมือนกับ ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) แต่ทำการทดสอบสําหรับผู้ใช้หนึ่งๆ
abstract void	setDate(Date date) ตั้งค่าวันที่ในอุปกรณ์ หมายเหตุ: การตั้งค่าวันที่ในอุปกรณ์ต้องเข้าถึงระดับรูท
abstract void	setOptions(TestDeviceOptions options) ตั้งค่า TestDeviceOptions สําหรับอุปกรณ์
abstract boolean	setProperty(String propKey, String propValue) ตั้งค่าพร็อพเพอร์ตี้ที่ระบุในอุปกรณ์
abstract void	setRecovery(IDeviceRecovery recovery) ตั้งค่า IDeviceRecovery เพื่อใช้กับอุปกรณ์นี้
abstract void	setRecoveryMode(ITestDevice.RecoveryMode mode) ตั้งค่าโหมดการกู้คืนปัจจุบันที่จะใช้กับอุปกรณ์
abstract void	setTrackingSerial(String trackingSerial) ติดตามหมายเลขซีเรียลที่เราใช้อ้างอิงอุปกรณ์เพื่อวัตถุประสงค์ในการจัดการอุปกรณ์
abstract void	setUseFastbootErase(boolean useFastbootErase) ตั้งค่าว่าจะใช้ fastboot erase หรือ fastboot format เพื่อล้างพาร์ติชันในอุปกรณ์
abstract void	startLogcat() เริ่มบันทึกเอาต์พุต Logcat จากอุปกรณ์ในเบื้องหลัง
abstract boolean	startTradeInModeTesting(int timeoutMs) เปิดใช้โหมดการทดสอบการแลกซื้อ
abstract void	stopEmulatorOutput() ปิดและลบเอาต์พุตของโปรแกรมจำลอง
abstract void	stopLogcat() หยุดบันทึกเอาต์พุต logcat จากอุปกรณ์และทิ้งข้อมูล logcat ที่บันทึกไว้ในปัจจุบัน
abstract void	stopTradeInModeTesting() หยุดการทดสอบโหมดแลกซื้อเครื่องใหม่
abstract String	switchToAdbTcp() เปลี่ยนอุปกรณ์เป็นโหมด adb-over-tcp
abstract boolean	switchToAdbUsb() เปลี่ยนอุปกรณ์เป็นโหมด adb ผ่าน USB
abstract boolean	syncFiles(File localFileDir, String deviceFilePath) ซิงค์เนื้อหาของไดเรกทอรีไฟล์ในเครื่องกับอุปกรณ์แบบเพิ่ม
abstract boolean	unlockDevice() ปลดล็อกอุปกรณ์หากอุปกรณ์อยู่ในสถานะเข้ารหัส
abstract void	unmountDebugfs() ยกเลิกการต่อเชื่อม debugfs
abstract boolean	waitForBootComplete(long timeOut) บล็อกจนกว่าจะมีการตั้งค่า Flag การบูตเสร็จสมบูรณ์ของอุปกรณ์
abstract boolean	waitForDeviceAvailable() รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
abstract boolean	waitForDeviceAvailable(long waitTime) รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
abstract boolean	waitForDeviceAvailableInRecoverPath(long waitTime) รอให้อุปกรณ์ตอบสนองและพร้อมใช้งานโดยไม่คำนึงถึงเส้นทางการกู้คืน
abstract void	waitForDeviceBootloader() บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน Fastboot
abstract boolean	waitForDeviceInRecovery(long waitTime) บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "การกู้คืน adb" (โปรดทราบว่าสถานะนี้แตกต่างจาก IDeviceRecovery)
abstract boolean	waitForDeviceInSideload(long waitTime) บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "การโหลดจากด้านข้างด้วย adb"
abstract boolean	waitForDeviceNotAvailable(long waitTime) บล็อกไม่ให้อุปกรณ์พร้อมใช้งาน เช่น ไม่อยู่ใน ADB
abstract void	waitForDeviceOnline() บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน adb
abstract void	waitForDeviceOnline(long waitTime) บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน adb
abstract boolean	waitForDeviceShell(long waitTime) รอให้อุปกรณ์ตอบสนองต่อคําสั่งเชลล์ adb พื้นฐาน

ค่าคงที่

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

ค่าเริ่มต้นเมื่อตรวจไม่พบระดับ API

ค่าคงที่: -1 (0xffffffff)

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

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

ตรวจสอบว่าฟีเจอร์ใดรองรับในขณะนี้หรือไม่โดยพิจารณาจากระดับที่รองรับขั้นต่ำ วิธีนี้พิจารณาฟีเจอร์ที่ยังไม่เผยแพร่ก่อนที่จะเพิ่มระดับ API

พารามิเตอร์
strictMinLevel	int: ระดับขั้นต่ำที่เป็นไปได้ซึ่งรองรับฟีเจอร์

คิกรีเทิร์น
boolean	จริงหากระบบรองรับระดับนั้น จะเป็นเท็จหากไม่เป็นเช่นนั้น

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

ลบข้อมูล logcat ที่สะสมไว้

ซึ่งจะมีประโยชน์ในกรณีที่คุณต้องการตรวจสอบว่า ITestDevice.getLogcat() จะแสดงเฉพาะข้อมูลบันทึกที่สร้างขึ้นหลังจากจุดหนึ่งๆ (เช่น หลังจากแฟลชบิลด์อุปกรณ์ใหม่ เป็นต้น)

deleteFile

public abstract void deleteFile (String deviceFilePath)

เมธอดตัวช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์

พารามิเตอร์
deviceFilePath	String: เส้นทางแบบสัมบูรณ์ของไฟล์ในอุปกรณ์

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

เมธอดตัวช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์

พารามิเตอร์
deviceFilePath	String: เส้นทางแบบสัมบูรณ์ของไฟล์ในอุปกรณ์
userId	int: รหัสผู้ใช้ที่จะลบ

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

เมธอดผู้ช่วยสำหรับตรวจสอบว่าอุปกรณ์รีสตาร์ทแบบซอฟต์แล้วหรือไม่โดยเปรียบเทียบ system_server ปัจจุบันกับ ProcessInfo system_server ก่อนหน้า ใช้ getProcessByName(String) เพื่อรับ ProcessInfo

พารามิเตอร์
prevSystemServerProcess	ProcessInfo: กระบวนการ system_server ก่อนหน้า ProcessInfo

คิกรีเทิร์น
boolean	true หากอุปกรณ์รีสตาร์ทแบบซอฟต์

การโยน
RuntimeException	if device has abnormal boot reason
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

เมธอดตัวช่วยสำหรับตรวจสอบว่าอุปกรณ์รีสตาร์ทแบบซอฟต์ตั้งแต่เวลา UTC นับจากจุดเริ่มต้นจากอุปกรณ์และ ERROR(/TimeUnit) หรือไม่ การรีสตาร์ทแบบเบาหมายถึงการรีสตาร์ท system_server นอกการรีบูตอุปกรณ์แบบฮาร์ด (เช่น การรีบูตที่ขอ) คุณสามารถรับ utcEpochTime ของอุปกรณ์ปัจจุบันเป็นมิลลิวินาทีได้ด้วยเมธอด getDeviceDate()

พารามิเตอร์
utcEpochTime	long: เวลาของอุปกรณ์เป็นวินาทีนับตั้งแต่ Epoch
timeUnit	TimeUnit: หน่วยเวลา TimeUnit สำหรับ utcEpochTime ที่ระบุ

คิกรีเทิร์น
boolean	true หากอุปกรณ์รีสตาร์ทแบบซอฟต์

การโยน
RuntimeException	if device has abnormal boot reason
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract boolean disableAdbRoot ()

ปิด adb root

การปิดใช้รูท adb อาจทำให้อุปกรณ์ตัดการเชื่อมต่อจาก adb วิธีนี้จะบล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน

คิกรีเทิร์น
boolean	true หากดำเนินการสำเร็จ

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

เมธอดตัวช่วยเพื่อระบุว่ามีไฟล์ในอุปกรณ์หรือไม่

พารามิเตอร์
deviceFilePath	String: เส้นทางแบบสัมบูรณ์ของไฟล์ในอุปกรณ์ที่จะตรวจสอบ

คิกรีเทิร์น
boolean	true หากมีไฟล์ false หากไม่มี

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

enableAdbRoot

public abstract boolean enableAdbRoot ()

เปิด adb root หากการตั้งค่า "enable-root" เป็น "เท็จ" ระบบจะบันทึกข้อความและแสดงผลโดยไม่ได้เปิดใช้รูท

การเปิดใช้ adb root อาจทำให้อุปกรณ์ยกเลิกการเชื่อมต่อกับ adb วิธีนี้จะบล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน

คิกรีเทิร์น
boolean	true หากดำเนินการสำเร็จ

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb เป็นคําสั่งระบบที่มีระยะหมดเวลาตามที่ระบุ

คุณควรใช้ executeShellCommand(String) แทนเมื่อเป็นไปได้ เนื่องจากวิธีนี้มีประสิทธิภาพและตรวจหาข้อผิดพลาดได้ดีกว่า

พารามิเตอร์
timeout	long: ระยะเวลาเป็นมิลลิวินาทีก่อนที่ระบบจะถือว่าอุปกรณ์ไม่ตอบสนอง 0L สำหรับการไม่มีระยะหมดเวลา
commandArgs	String: คำสั่ง adb และอาร์กิวเมนต์ที่จะเรียกใช้

คิกรีเทิร์น
String	stdout จากคําสั่ง null หากคําสั่งไม่ทํางาน

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb เป็นคําสั่งของระบบ

คุณควรใช้ executeShellCommand(String) แทนเมื่อเป็นไปได้ เนื่องจากวิธีนี้มีประสิทธิภาพและตรวจหาข้อผิดพลาดได้ดีกว่า

พารามิเตอร์
commandArgs	String: คำสั่ง adb และอาร์กิวเมนต์ที่จะเรียกใช้

คิกรีเทิร์น
String	stdout จากคําสั่ง null หากคําสั่งไม่ทํางาน

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb เป็นคําสั่งระบบที่มีระยะหมดเวลาตามที่ระบุ

คุณควรใช้ executeShellCommand(String) แทนเมื่อเป็นไปได้ เนื่องจากวิธีนี้มีประสิทธิภาพและตรวจหาข้อผิดพลาดได้ดีกว่า

พารามิเตอร์
timeout	long: ระยะเวลาเป็นมิลลิวินาทีก่อนที่ระบบจะถือว่าอุปกรณ์ไม่ตอบสนอง 0L สำหรับการไม่มีระยะหมดเวลา
envMap	: สภาพแวดล้อมที่จะตั้งค่าสําหรับคําสั่ง
commandArgs	String: คำสั่ง adb และอาร์กิวเมนต์ที่จะเรียกใช้

คิกรีเทิร์น
String	stdout จากคําสั่ง null หากคําสั่งไม่ทํางาน

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

เมธอดตัวช่วยที่ดำเนินการคำสั่ง fastboot เป็นคำสั่งของระบบ

ควรใช้เมื่ออุปกรณ์อยู่ในโหมด Fastboot อยู่แล้ว

พารามิเตอร์
timeout	long: เวลาเป็นมิลลิวินาทีก่อนที่คําสั่งจะหมดอายุ
commandArgs	String: คำสั่ง fastboot และอาร์กิวเมนต์ที่จะเรียกใช้

คิกรีเทิร์น
CommandResult	CommandResult ที่มีเอาต์พุตของคําสั่ง

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

ควรใช้เมื่ออุปกรณ์อยู่ในโหมด Fastboot อยู่แล้ว

พารามิเตอร์
commandArgs	String: คำสั่ง fastboot และอาร์กิวเมนต์ที่จะเรียกใช้

คิกรีเทิร์น
CommandResult	CommandResult ที่มีเอาต์พุตของคําสั่ง

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

เมธอดตัวช่วยที่เรียกใช้คำสั่ง fastboot ที่ทำงานเป็นเวลานานเป็นคำสั่งของระบบ

เหมือนกับ executeFastbootCommand(String) ยกเว้นใช้ระยะหมดเวลาที่นานขึ้น

พารามิเตอร์
commandArgs	String: คำสั่ง fastboot และอาร์กิวเมนต์ที่จะเรียกใช้

คิกรีเทิร์น
CommandResult	CommandResult ที่มีเอาต์พุตของคําสั่ง

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

เมธอดตัวช่วยที่ดำเนินการคำสั่ง fastboot ที่ทำงานเป็นเวลานานเป็นคำสั่งระบบที่มีตัวแปรสภาพแวดล้อมของระบบ

เหมือนกับ executeFastbootCommand(String) ยกเว้นใช้ระยะหมดเวลาที่นานขึ้น

พารามิเตอร์
envVarMap	: ตัวแปรสภาพแวดล้อมของระบบที่คำสั่ง fastboot ทำงานด้วย
commandArgs	String: คำสั่ง fastboot และอาร์กิวเมนต์ที่จะเรียกใช้

คิกรีเทิร์น
CommandResult	CommandResult ที่มีเอาต์พุตของคําสั่ง

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellCommand

public abstract String executeShellCommand (String command)

เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb shell และแสดงผลลัพธ์เป็น String

พารามิเตอร์
command	String: คำสั่ง adb shell ที่จะเรียกใช้

คิกรีเทิร์น
String	เอาต์พุตเชลล์

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง

พารามิเตอร์
command	String: คำสั่ง adb shell ที่จะเรียกใช้
receiver	IShellOutputReceiver: IShellOutputReceiver สำหรับส่งเอาต์พุตเชลล์
maxTimeToOutputShellResponse	long: ระยะเวลาสูงสุดที่อนุญาตให้คําสั่งไม่แสดงผลลัพธ์ใดๆ หน่วยตามที่ระบุไว้ใน timeUnit
timeUnit	TimeUnit: หน่วยของ maxTimeToOutputShellResponse
retryAttempts	int: จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากดำเนินการไม่สำเร็จเนื่องจากมีข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ retryAttempts ไม่สำเร็จ

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง

พารามิเตอร์
command	String: คำสั่ง adb shell ที่จะเรียกใช้
receiver	IShellOutputReceiver: IShellOutputReceiver สำหรับส่งเอาต์พุตเชลล์
maxTimeoutForCommand	long: ระยะหมดเวลาที่นานที่สุดเพื่อให้คําสั่งเสร็จสมบูรณ์ หน่วยตามที่ระบุใน timeUnit
maxTimeToOutputShellResponse	long: ระยะเวลาสูงสุดที่อนุญาตให้คําสั่งไม่แสดงผลลัพธ์ใดๆ หน่วยตามที่ระบุไว้ใน timeUnit
timeUnit	TimeUnit: หน่วยของ maxTimeToOutputShellResponse
retryAttempts	int: จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากดำเนินการไม่สำเร็จเนื่องจากมีข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ retryAttempts ไม่สำเร็จ

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

ดำเนินการตามคำสั่ง adb shell ที่ระบุ โดยพยายามใหม่หลายครั้งหากคำสั่งไม่สำเร็จ

รูปแบบที่เรียบง่ายของ executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) ที่มีค่าเริ่มต้น

พารามิเตอร์
command	String: คำสั่ง adb shell ที่จะเรียกใช้
receiver	IShellOutputReceiver: IShellOutputReceiver สำหรับส่งเอาต์พุตเชลล์

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ที่สร้างขึ้นอย่างถูกต้องพร้อมเอาต์พุตสถานะคําสั่ง, stdout และ stderr

พารามิเตอร์
command	String: คำสั่งที่ควรเรียกใช้

คิกรีเทิร์น
CommandResult	ผลการค้นหาใน CommandResult

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ที่สร้างขึ้นอย่างถูกต้องพร้อมเอาต์พุตสถานะคําสั่งและ stderr โดยระบบจะส่ง stdout ไปยังสตรีมที่ระบุ

พารามิเตอร์
command	String: คำสั่งที่ควรเรียกใช้
pipeToOutput	OutputStream: ERROR(/OutputStream) ซึ่งจะเป็นปลายทางที่ระบบจะเปลี่ยนเส้นทางเอาต์พุต std หรือเป็นค่า null

คิกรีเทิร์น
CommandResult	ผลการค้นหาใน CommandResult

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

เมธอดตัวช่วยที่เรียกใช้คําสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ที่สร้างขึ้นอย่างถูกต้องพร้อมเอาต์พุตสถานะคําสั่ง, stdout และ stderr

พารามิเตอร์
command	String: คำสั่งที่ควรเรียกใช้
pipeAsInput	File: ERROR(/File) ที่ส่งผ่านเป็นอินพุตไปยังคําสั่ง หรือเป็นค่า Null

คิกรีเทิร์น
CommandResult	ผลการค้นหาใน CommandResult

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง

พารามิเตอร์
command	String: คำสั่ง adb shell ที่จะเรียกใช้
maxTimeoutForCommand	long: ระยะหมดเวลาที่นานที่สุดเพื่อให้คําสั่งเสร็จสมบูรณ์ หน่วยตามที่ระบุใน timeUnit
timeUnit	TimeUnit: หน่วยของ maxTimeToOutputShellResponse
retryAttempts	int: จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากดำเนินการไม่สำเร็จเนื่องจากมีข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ retryAttempts ไม่สำเร็จ

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

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม

• executeShellV2Command(String)
• TimeUtil

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง

พารามิเตอร์
command	String: คำสั่ง adb shell ที่จะเรียกใช้
maxTimeoutForCommand	long: ระยะหมดเวลาที่นานที่สุดเพื่อให้คําสั่งเสร็จสมบูรณ์ หน่วยตามที่ระบุใน timeUnit
timeUnit	TimeUnit: หน่วยของ maxTimeToOutputShellResponse

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

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม

• executeShellV2Command(String)
• TimeUtil

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง

พารามิเตอร์
command	String: คำสั่ง adb shell ที่จะเรียกใช้
pipeAsInput	File: ERROR(/File) ที่ส่งผ่านเป็นอินพุตไปยังคําสั่ง หรือเป็นค่า Null
pipeToOutput	OutputStream: ERROR(/OutputStream) ซึ่งจะเป็นปลายทางที่ระบบจะเปลี่ยนเส้นทางเอาต์พุต std หรือเป็นค่า null
maxTimeoutForCommand	long: ระยะหมดเวลาที่นานที่สุดเพื่อให้คําสั่งเสร็จสมบูรณ์ หน่วยตามที่ระบุใน timeUnit
timeUnit	TimeUnit: หน่วยของ maxTimeToOutputShellResponse
retryAttempts	int: จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากดำเนินการไม่สำเร็จเนื่องจากมีข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ retryAttempts ไม่สำเร็จ

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

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม

• executeShellV2Command(String)
• TimeUtil

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทํางานของคําสั่ง

พารามิเตอร์
command	String: คำสั่ง adb shell ที่จะเรียกใช้
pipeAsInput	File: ERROR(/File) ที่ส่งผ่านเป็นอินพุตไปยังคําสั่ง หรือเป็นค่า Null
pipeToOutput	OutputStream: ERROR(/OutputStream) ซึ่งจะเป็นปลายทางที่ระบบจะเปลี่ยนเส้นทางเอาต์พุต std หรือเป็นค่า null
pipeToError	OutputStream: ERROR(/OutputStream) ซึ่งระบบจะเปลี่ยนเส้นทางข้อผิดพลาด std หรือเป็นค่า null
maxTimeoutForCommand	long: ระยะหมดเวลาที่นานที่สุดเพื่อให้คําสั่งเสร็จสมบูรณ์ หน่วยตามที่ระบุใน timeUnit
timeUnit	TimeUnit: หน่วยของ maxTimeToOutputShellResponse
retryAttempts	int: จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากดำเนินการไม่สำเร็จเนื่องจากมีข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ retryAttempts ไม่สำเร็จ

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

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม

• executeShellV2Command(String)
• TimeUtil

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

เมธอดตัวช่วยซึ่งล้างพาร์ติชันของอุปกรณ์

หาก getUseFastbootErase() เป็น true ระบบจะใช้การลบของ Fastboot เพื่อล้างข้อมูลพาร์ติชัน จากนั้นอุปกรณ์จะต้องสร้างระบบไฟล์ในครั้งถัดไปที่บูต ไม่เช่นนั้น ระบบจะใช้การฟอร์แมต Fastboot ซึ่งจะสร้างระบบไฟล์ใหม่ในอุปกรณ์

ควรใช้เมื่ออุปกรณ์อยู่ในโหมด Fastboot อยู่แล้ว

พารามิเตอร์
partition	String: พาร์ติชันที่จะล้างข้อมูล

คิกรีเทิร์น
CommandResult	CommandResult ที่มีเอาต์พุตของคําสั่ง

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getApiLevel

public abstract int getApiLevel ()

รับระดับ API ของอุปกรณ์ ค่าเริ่มต้นคือ UNKNOWN_API_LEVEL

คิกรีเทิร์น
int	จำนวนเต็มที่ระบุระดับ API ของอุปกรณ์

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

วิธีการที่สะดวกในการรับเวอร์ชันเบสแบนด์ (วิทยุ) ของอุปกรณ์นี้ การดูเวอร์ชันวิทยุจะเจาะจงอุปกรณ์ ดังนั้นจึงอาจแสดงข้อมูลที่ถูกต้องสำหรับอุปกรณ์บางเครื่อง วิธีการนี้ใช้พร็อพเพอร์ตี้ gsm.version.baseband เพื่อแสดงข้อมูลเวอร์ชันที่ถูกต้อง ข้อมูลนี้ไม่ถูกต้องสำหรับอุปกรณ์ CDMA บางรุ่น และเวอร์ชันที่แสดงที่นี่อาจไม่ตรงกับเวอร์ชันที่รายงานจาก Fastboot และอาจไม่แสดงเวอร์ชันสำหรับวิทยุ CDMA TL;DR วิธีการนี้จะรายงานเฉพาะเวอร์ชันที่ถูกต้องหากพร็อพเพอร์ตี้ gsm.version.baseband เหมือนกับเวอร์ชันที่ fastboot getvar version-baseband แสดง

คิกรีเทิร์น
String	เวอร์ชันเบสแบนด์ String หรือ null หากไม่สามารถระบุได้ (อุปกรณ์ไม่มีวิทยุหรืออ่านสตริงเวอร์ชันไม่ได้)

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getBattery

public abstract Integer getBattery ()

แสดงระดับแบตเตอรี่ปัจจุบันของอุปกรณ์ หรือ Null หากไม่มีระดับแบตเตอรี่

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

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

แสดงผลค่าบูลีนของพร็อพเพอร์ตี้ที่ระบุ

พารามิเตอร์
name	String: ชื่อพร็อพเพอร์ตี้
defaultValue	boolean: ค่าเริ่มต้นที่จะแสดงหากพร็อพเพอร์ตี้ว่างเปล่าหรือไม่มีอยู่

คิกรีเทิร์น
boolean	true หากพร็อพเพอร์ตี้มีค่า "1", "y", "yes", "on" หรือ "true", false หากพร็อพเพอร์ตี้มีค่า "0", "n", "no", "off", "false" หรือ defaultValue มิเช่นนั้น

การโยน
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

เมธอด Helper จะรวบรวมแผนที่ประวัติการบูตพร้อมเวลาบูตและเหตุผลในการบูต

คิกรีเทิร์น
	แผนที่ของเวลาบูต (เวลา UTC เป็นวินาทีนับตั้งแต่ Epoch) และเหตุผลในการบูต

การโยน
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

เมธอดตัวช่วยจะรวบรวมแผนที่ประวัติการบูตพร้อมเวลาบูตและเหตุผลในการบูตนับจากเวลาที่ระบุนับจากจุดเริ่มต้นจากอุปกรณ์และหน่วยเวลาที่ระบุ คุณสามารถรับ utcEpochTime ของอุปกรณ์ปัจจุบันเป็นมิลลิวินาทีได้ด้วยเมธอด getDeviceDate()

พารามิเตอร์
utcEpochTime	long: เวลาของอุปกรณ์นับตั้งแต่ Epoch
timeUnit	TimeUnit: หน่วยเวลา TimeUnit

คิกรีเทิร์น
	แผนที่ของเวลาบูต (เวลา UTC เป็นวินาทีนับตั้งแต่ Epoch) และเหตุผลในการบูต

การโยน
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

วิธีการที่สะดวกในการรับเวอร์ชัน Bootloader ของอุปกรณ์นี้

จะพยายามดึงข้อมูลเวอร์ชัน Bootloader จากสถานะปัจจุบันของอุปกรณ์ (เช่น หากอุปกรณ์อยู่ในโหมด Fastboot ระบบจะพยายามดึงข้อมูลเวอร์ชันจาก Fastboot)

คิกรีเทิร์น
String	เวอร์ชัน String bootloader หรือ null หากไม่พบ

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getBuildAlias

public abstract String getBuildAlias ()

เรียกข้อมูลแทนของบิลด์ที่อุปกรณ์ใช้อยู่

โดยปกติแล้วชื่อแทนของบิลด์จะเป็นสตริงที่อ่านง่ายกว่ารหัสบิลด์ (โดยปกติแล้วจะเป็นตัวเลขสำหรับบิลด์ Nexus) ตัวอย่างเช่น เวอร์ชันสุดท้ายของ Android 4.2 มีชื่อแทนของบิลด์ JDQ39 และรหัสบิลด์ 573038

คิกรีเทิร์น
String	โดยใช้ชื่อแทนของบิลด์ หรือใช้รหัสบิลด์แทนหากเรียกข้อมูลไม่ได้

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

ดึงข้อมูล Flavor ของบิลด์สำหรับอุปกรณ์

คิกรีเทิร์น
String	รสชาติของบิลด์หรือค่าว่างหากดึงข้อมูลไม่ได้

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

เรียกข้อมูลบิลด์ที่อุปกรณ์ใช้อยู่

คิกรีเทิร์น
String	รหัสบิลด์หรือ IBuildInfo.UNKNOWN_BUILD_ID หากเรียกข้อมูลไม่ได้

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

แสดงผลประเภทคีย์ที่ใช้รับรองรูปภาพอุปกรณ์

โดยทั่วไปอุปกรณ์ Android อาจได้รับการรับรองด้วยคีย์ทดสอบ (เช่น ใน AOSP) หรือคีย์รุ่น (ควบคุมโดยผู้ผลิตอุปกรณ์แต่ละราย)

คิกรีเทิร์น
String	คีย์ Signing หากพบ มิเช่นนั้นจะเป็น Null

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

แสดง DeviceDescriptor ที่แคชไว้หากมีการจัดสรรอุปกรณ์ไว้ มิเช่นนั้นแสดง DeviceDescriptor ปัจจุบัน

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

แสดง DeviceDescriptor ที่แคชไว้หากมีการจัดสรรอุปกรณ์ไว้ มิเช่นนั้นแสดง DeviceDescriptor ปัจจุบัน

พารามิเตอร์
shortDescriptor	boolean: กำหนดให้คำอธิบายมีข้อมูลขั้นต่ำเท่านั้นหรือไม่

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

getChildren

public abstract String[] getChildren (String deviceFilePath)

ทางเลือกในการใช้ IFileEntry ที่บางครั้งอาจใช้ไม่ได้เนื่องจากสิทธิ์

พารามิเตอร์
deviceFilePath	String: คือเส้นทางในอุปกรณ์ที่จะทำการค้นหา

คิกรีเทิร์น
String[]	อาร์เรย์สตริงที่มีไฟล์ทั้งหมดในเส้นทางบนอุปกรณ์

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

แสดงการเชื่อมต่อที่เชื่อมโยงกับอุปกรณ์

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

getDeviceClass

public abstract String getDeviceClass ()

รับคลาสอุปกรณ์

คิกรีเทิร์น
String	คลาสอุปกรณ์ String

getDeviceDate

public abstract long getDeviceDate ()

แสดงผลวันที่ของอุปกรณ์เป็นมิลลิวินาทีนับจากวันที่ 1 มกราคม ค.ศ. 1970

คิกรีเทิร์น
long	วันที่ของอุปกรณ์ในรูปแบบอีพอค

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

แสดงผล DeviceDescriptor จากข้อมูลอุปกรณ์เพื่อรับข้อมูลโดยไม่ต้องส่งออบเจ็กต์อุปกรณ์จริง

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

แสดงผล DeviceDescriptor จากข้อมูลอุปกรณ์เพื่อรับข้อมูลโดยไม่ต้องส่งออบเจ็กต์อุปกรณ์จริง

พารามิเตอร์
shortDescriptor	boolean: กำหนดให้คำอธิบายมีข้อมูลขั้นต่ำเท่านั้นหรือไม่

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

getDeviceState

public abstract TestDeviceState getDeviceState ()

รับสถานะของอุปกรณ์

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

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

ตัวช่วยรับเวลาที่แตกต่างกันระหว่างอุปกรณ์กับ ERROR(/Date) ที่ระบุ ใช้เวลา Epoch ภายใน

พารามิเตอร์
date	Date

คิกรีเทิร์น
long	ความแตกต่างเป็นมิลลิวินาที

การโยน
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

รับสตรีมของ stdout และ stderr ของโปรแกรมจำลอง

คิกรีเทิร์น
InputStreamSource	เอาต์พุตของโปรแกรมจำลอง

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

เมธอดตัวช่วยในการระบุปริมาณพื้นที่ว่างในอุปกรณ์จัดเก็บข้อมูลภายนอก

คิกรีเทิร์น
long	จำนวนพื้นที่ว่างใน KB

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getFastbootProductType

public abstract String getFastbootProductType ()

วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ในโหมด Fastboot

ใช้วิธีนี้ในกรณีที่อุปกรณ์ควรอยู่ในโหมด Fastboot เท่านั้น ในกรณีนี้ ตัวแปรนี้ปลอดภัยกว่าเมธอด getProductType() ทั่วไป เนื่องจาก ITestDevice จะรู้วิธีกู้คืนอุปกรณ์เป็น Fastboot หากอุปกรณ์อยู่ในสถานะที่ไม่ถูกต้องหรือไม่ตอบสนอง

คิกรีเทิร์น
String	ชื่อประเภทผลิตภัณฑ์ String หรือ null หากไม่สามารถระบุได้

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ในโหมด Fastboot

ใช้วิธีนี้ในกรณีที่อุปกรณ์ควรอยู่ในโหมด Fastboot เท่านั้น ในกรณีนี้ ตัวแปรนี้ปลอดภัยกว่าเมธอด getProductType() ทั่วไป เนื่องจาก ITestDevice จะรู้วิธีกู้คืนอุปกรณ์เป็น Fastboot หากอุปกรณ์อยู่ในสถานะที่ไม่ถูกต้องหรือไม่ตอบสนอง

คิกรีเทิร์น
String	ชื่อประเภทผลิตภัณฑ์ String หรือ null หากไม่สามารถระบุได้

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

แสดงผลหมายเลขซีเรียลของโหมด Fastboot

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

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

ดึงค่าตัวแปร fastboot ที่ระบุจากอุปกรณ์

พารามิเตอร์
variableName	String: ชื่อตัวแปร

คิกรีเทิร์น
String	ค่าพร็อพเพอร์ตี้หรือ null หากไม่มี

การโยน
	UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

เรียกข้อมูลอ้างอิงไปยังไฟล์ระยะไกลในอุปกรณ์

พารามิเตอร์
path	String: เส้นทางไฟล์ที่จะดึงข้อมูล อาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับ "/" (เช่น ระบบรองรับทั้งไวยากรณ์ "/system" และ "system")

คิกรีเทิร์น
IFileEntry	IFileEntry หรือ null หากไม่พบไฟล์ใน path ที่ระบุ

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

แสดงการอ้างอิงไปยัง ddmlib IDevice ที่เชื่อมโยง

DDMS อาจจัดสรร IDevice ใหม่ทุกครั้งที่อุปกรณ์ยกเลิกการเชื่อมต่อและเชื่อมต่อจาก adb อีกครั้ง ดังนั้น ผู้เรียกใช้ไม่ควรเก็บข้อมูลอ้างอิง IDevice ไว้ เนื่องจากข้อมูลอ้างอิงดังกล่าวอาจล้าสมัย

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

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

แสดงผลค่าจำนวนเต็มของพร็อพเพอร์ตี้ที่ระบุจากอุปกรณ์

พารามิเตอร์
name	String: ชื่อพร็อพเพอร์ตี้
defaultValue	long: ค่าเริ่มต้นที่จะแสดงหากพร็อพเพอร์ตี้ว่างเปล่าหรือไม่มีอยู่

คิกรีเทิร์น
long	ค่าพร็อพเพอร์ตี้หรือ defaultValue หากพร็อพเพอร์ตี้ว่างเปล่า ไม่มีอยู่ หรือไม่มีค่าจำนวนเต็ม

การโยน
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

แสดงเวลาล่าสุดที่ Tradefed API ทริกเกอร์การรีบูตเป็นมิลลิวินาทีนับจาก EPOCH ตามที่ได้มาจาก System.currentTimeMillis()

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

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

ดูระดับ API ที่เปิดตัวครั้งแรกของอุปกรณ์ ค่าเริ่มต้นคือ UNKNOWN_API_LEVEL

คิกรีเทิร์น
int	จำนวนเต็มซึ่งระบุระดับ API ที่เปิดตัวครั้งแรกของอุปกรณ์

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

ดึงข้อมูลสตรีมภาพรวมของข้อมูล logcat

ทำงานได้ 2 โหมด ได้แก่

หากกำลังบันทึก Logcat ในเบื้องหลัง ระบบจะแสดงผลเนื้อหาปัจจุบันของการบันทึก Logcat ในเบื้องหลังได้สูงสุด TestDeviceOptions.getMaxLogcatDataSize() ไบต์

มิเช่นนั้น ระบบจะแสดงผลข้อมูลการดัมพ์แบบคงที่ของ Logcat หากอุปกรณ์ตอบสนองอยู่

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

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

ดึงข้อมูลสตรีมสแนปชอตของข้อมูล Logcat maxBytes รายการล่าสุดที่บันทึกไว้

มีประโยชน์ในกรณีที่คุณต้องการจับภาพสแนปชอตของข้อมูลบันทึกที่บันทึกไว้บ่อยๆ โดยที่ไม่ต้องเสียพื้นที่ดิสก์มากจากการรับสแนปชอต getLogcat() ทั้งหมด

พารามิเตอร์
maxBytes	int: จํานวนข้อมูลสูงสุดที่จะแสดง ควรเป็นจำนวนที่หน่วยความจํารองรับได้

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

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

รับการดัมพ์ Logcat ปัจจุบันของอุปกรณ์ ซึ่งต่างจาก getLogcat() ตรงที่จะแสดงผลลัพธ์เป็นไฟล์บันทึกแบบคงที่ของ Logcat เสมอ

ข้อเสียคือระบบจะไม่แสดงผลหากเข้าถึงอุปกรณ์ไม่ได้

คิกรีเทิร์น
InputStreamSource	InputStreamSource ของข้อมูลบันทึก ระบบจะแสดงผลสตรีมว่างหากจับข้อมูลบันทึกไม่ได้

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

ดึงข้อมูลสตรีมสแนปชอตของข้อมูลบันทึกที่บันทึกไว้โดยเริ่มจากวันที่ที่ระบุ คุณควรใช้เวลาในอุปกรณ์ getDeviceDate()

พารามิเตอร์
date	long: เป็นมิลลิวินาทีนับจากรูปแบบยุคเริ่มต้นของเวลาที่จะเริ่มสแนปชอตจนถึงปัจจุบัน (รับได้โดยใช้ "date +%s")

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

getMountPoint

public abstract String getMountPoint (String mountName)

แสดงผลจุดต่อเชื่อม

ค้นหาอุปกรณ์โดยตรงหากไม่มีข้อมูลแคชใน IDevice

สิ่งที่ต้องทํา: ย้ายลักษณะการทํางานนี้ไปยัง IDevice.getMountPoint(String)

พารามิเตอร์
mountName	String: ชื่อของจุดต่อเชื่อม

คิกรีเทิร์น
String	จุดต่อเชื่อมหรือ null

ดูเพิ่มเติม

• IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

แสดงผล MountPointInfo ที่สอดคล้องกับเส้นทางจุดต่อเชื่อมที่ระบุ หรือ null หากเส้นทางนั้นไม่มีสิ่งที่ต่อเชื่อมอยู่หรือไม่ปรากฏใน /proc/mounts เป็นจุดต่อเชื่อม

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

คิกรีเทิร์น
ITestDevice.MountPointInfo	ERROR(/List) ของ MountPointInfo ที่มีข้อมูลใน "/proc/mounts"

การโยน
DeviceNotAvailableException

ดูเพิ่มเติม

• getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

แสดงผลข้อมูลใน /proc/mounts บนอุปกรณ์เวอร์ชันที่แยกวิเคราะห์แล้ว

คิกรีเทิร์น
	ERROR(/List) ของ MountPointInfo ที่มีข้อมูลใน "/proc/mounts"

การโยน
DeviceNotAvailableException

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

เมธอดตัวช่วยในการระบุปริมาณพื้นที่ว่างบนพาร์ติชันของอุปกรณ์

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

คิกรีเทิร์น
long	จำนวนพื้นที่ว่างใน KB

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

เมธอดตัวช่วยจะเรียกใช้คําสั่ง "pidof" และ "stat" และแสดงผลออบเจ็กต์ ProcessInfo ที่มี PID และเวลาเริ่มต้นของกระบวนการที่ระบุ

พารามิเตอร์
processName	String: สตริงชื่อกระบวนการ

คิกรีเทิร์น
ProcessInfo	ProcessInfo ของ processName ที่ระบุ

การโยน
DeviceNotAvailableException

getProcessPid

public abstract String getProcessPid (String process)

แสดง PID ของบริการหรือค่าว่างหากเกิดข้อผิดพลาด

พารามิเตอร์
process	String: สตริงชื่อกระบวนการ

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

การโยน
DeviceNotAvailableException

getProductType

public abstract String getProductType ()

วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้

วิธีการนี้จะใช้ได้หากอุปกรณ์อยู่ในโหมด adb หรือ Fastboot

คิกรีเทิร์น
String	ชื่อประเภทผลิตภัณฑ์ String จะไม่เป็นค่าว่าง

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้ หรือหากไม่สามารถระบุประเภทผลิตภัณฑ์ได้

getProductVariant

public abstract String getProductVariant ()

วิธีการที่สะดวกในการรับผลิตภัณฑ์ย่อยของอุปกรณ์นี้

วิธีการนี้จะใช้ได้หากอุปกรณ์อยู่ในโหมด adb หรือ Fastboot

คิกรีเทิร์น
String	ชื่อผลิตภัณฑ์ย่อย String หรือ null หากไม่สามารถระบุได้

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getProperty

public abstract String getProperty (String name)

ดึงค่าพร็อพเพอร์ตี้ที่ระบุจากอุปกรณ์

พารามิเตอร์
name	String: ชื่อพร็อพเพอร์ตี้

คิกรีเทิร์น
String	ค่าพร็อพเพอร์ตี้หรือ null หากไม่มี

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

ดูโหมดการกู้คืนปัจจุบันที่ใช้กับอุปกรณ์

คิกรีเทิร์น
ITestDevice.RecoveryMode	โหมดการกู้คืนปัจจุบันที่ใช้กับอุปกรณ์

getSerialNumber

public abstract String getSerialNumber ()

วิธีการที่สะดวกในการรับหมายเลขซีเรียลของอุปกรณ์นี้

คิกรีเทิร์น
String	หมายเลขซีเรียล String

getTombstones

public abstract  getTombstones ()

ดึงข้อมูลและแสดงรายการรายการที่ลบไปแล้วจากอุปกรณ์ ต้องเข้าถึงสิทธิ์รูท

วิธีการนี้เป็นการดำเนินการที่น่าจะดีที่สุด ดังนั้นหากดึงข้อมูลรายการใดรายการหนึ่งไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม รายการดังกล่าวจะหายไปจากรายการ เฉพาะ DeviceNotAvailableException เท่านั้นที่จะสิ้นสุดเมธอดก่อนกำหนด

คิกรีเทิร์น
	รายการไฟล์การลบออก จะเป็นค่าว่างหากไม่มีการลบออก

การโยน
DeviceNotAvailableException

ดูเพิ่มเติม

• เอกสารประกอบเกี่ยวกับ Tombstone

getTotalMemory

public abstract long getTotalMemory ()

แสดงขนาดหน่วยความจําจริงทั้งหมดเป็นไบต์ หรือ -1 ในกรณีที่เกิดข้อผิดพลาดภายใน

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

getTrackingSerial

public String getTrackingSerial ()

หาหมายเลขซีเรียลที่ใช้ติดตามอุปกรณ์เพื่อวัตถุประสงค์ในการจัดการอุปกรณ์

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

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

ดูว่าควรใช้ fastboot erase หรือ fastboot format เพื่อล้างพาร์ติชันในอุปกรณ์

คิกรีเทิร์น
boolean	true หากจะใช้การลบด้วย Fastboot หรือ false หากจะใช้การฟอร์แมตด้วย Fastboot

ดูเพิ่มเติม

• fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

คิกรีเทิร์น
boolean	true หากอุปกรณ์มีสิทธิ์เข้าถึงระดับรูทของ adb อยู่ในปัจจุบัน false ไม่เช่นนั้น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

isAdbTcp

public abstract boolean isAdbTcp ()

คิกรีเทิร์น
boolean	true หากอุปกรณ์เชื่อมต่อกับ adb-over-tcp, false มิเช่นนั้น

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการแจกแจงแอปหรือไม่

คิกรีเทิร์น
boolean	เป็นจริงหากระบบรองรับการแจกแจงแอป เป็นเท็จหากไม่รองรับ

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการข้ามการบล็อก SDK เป้าหมายต่ำในการติดตั้งแอปหรือไม่

คิกรีเทิร์น
boolean	เป็นจริงหากระบบรองรับการข้ามบล็อก SDK เป้าหมายระดับต่ำ เป็นเท็จหากไม่รองรับ

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

ตรวจสอบว่าระบบได้ต่อเชื่อม debugfs หรือไม่

คิกรีเทิร์น
boolean	true หากต่อเชื่อม debugfs

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

แสดงผลหากอุปกรณ์มีการเข้ารหัส

คิกรีเทิร์น
boolean	true หากอุปกรณ์ได้รับการเข้ารหัส

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

แสดงผลเป็น "จริง" หากเส้นทางในอุปกรณ์เป็นไดเรกทอรี หากไม่ใช่จะแสดงผลเป็น "เท็จ"

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

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

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

แสดงผลหากอุปกรณ์รองรับการเข้ารหัส

คิกรีเทิร์น
boolean	true หากอุปกรณ์รองรับการเข้ารหัส

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isExecutable

public abstract boolean isExecutable (String fullPath)

แสดงผลเป็น "จริง" หากเส้นทางไฟล์ในอุปกรณ์เป็นไฟล์ที่เรียกใช้ได้ หากไม่ใช่จะแสดงผลเป็น "เท็จ"

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

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

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isHeadless

public abstract boolean isHeadless ()

แสดงผลเป็น "จริง" หากอุปกรณ์ไม่มีจอแสดงผล (ไม่มีหน้าจอ) หากไม่ใช่จะแสดงผลเป็น "เท็จ"

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

การโยน
DeviceNotAvailableException

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการให้สิทธิ์รันไทม์หรือไม่

คิกรีเทิร์น
boolean	เป็นจริงหากรองรับสิทธิ์รันไทม์ เป็นเท็จหากไม่รองรับ

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

แสดงค่า "จริง" หากอุปกรณ์อยู่ใน TestDeviceState.FASTBOOT หรือ TestDeviceState.FASTBOOTD

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

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

รวบรวมและบันทึก ANR จากอุปกรณ์

พารามิเตอร์
logger	ITestLogger: ITestLogger เพื่อบันทึก ANR

คิกรีเทิร์น
boolean	จริง หากการบันทึกสําเร็จ หรือเป็นเท็จ

การโยน
DeviceNotAvailableException

logOnDevice

public abstract void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

บันทึกข้อความใน Logcat ของอุปกรณ์ การเรียกนี้ปลอดภัยและจะไม่แสดงข้อผิดพลาดแม้ว่าการบันทึกจะล้มเหลวก็ตาม

พารามิเตอร์
tag	String: แท็กที่เราบันทึกข้อความในบันทึกข้อบกพร่อง
level	Log.LogLevel: ระดับการแก้ไขข้อบกพร่องของข้อความใน Logcat
format	String: รูปแบบข้อความ
args	Object: อาร์กิวเมนต์ที่จะแทนที่ผ่าน String.format()

mountDebugfs

public abstract void mountDebugfs ()

ติดตั้ง debugfs

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

nonBlockingReboot

public abstract void nonBlockingReboot ()

ส่งคําสั่งให้รีบูตอุปกรณ์และแสดงผลเมื่อคําสั่งเสร็จสมบูรณ์และเมื่อ adb ไม่เห็นอุปกรณ์อีกต่อไป

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

postBootSetup

public abstract void postBootSetup ()

ทำตามวิธีการเพื่อกำหนดค่าอุปกรณ์สำหรับการทดสอบหลังจากการบูตทุกครั้ง

ควรเรียกใช้หลังจากอุปกรณ์บูต/พร้อมใช้งานอย่างสมบูรณ์

ภายใต้สถานการณ์ปกติ คุณไม่จำเป็นต้องเรียกใช้เมธอดนี้อย่างชัดเจน เนื่องจากการติดตั้งใช้งานควรทำตามขั้นตอนเหล่านี้โดยอัตโนมัติเมื่อทำการรีบูต

กรณีที่อาจต้องเรียกใช้คือเมื่ออุปกรณ์รีบูตเนื่องจากเหตุการณ์อื่นๆ (เช่น เมื่อคำสั่ง fastboot update เสร็จสมบูรณ์)

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

postInvocationTearDown

public void postInvocationTearDown ()

วิธีการนี้เลิกใช้งานแล้ว
โปรดใช้ postInvocationTearDown(Throwable) แทน

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

พารามิเตอร์
invocationException	Throwable: ข้อยกเว้นสุดท้ายที่ยกขึ้นเมื่อการเรียกใช้ไม่สำเร็จ (หากมี)

preInvocationSetup

public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

ขั้นตอนเพิ่มเติมสำหรับการตั้งค่าที่จำเป็นเฉพาะอุปกรณ์ที่จะดำเนินการในอุปกรณ์ก่อนขั้นตอนเรียกใช้

พารามิเตอร์
info	IBuildInfo: IBuildInfo ของอุปกรณ์
attributes	MultiMap: แอตทริบิวต์ที่เก็บไว้ในบริบทการเรียกใช้

การโยน
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
TargetSetupError

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์แบบซ้ำ

พารามิเตอร์
deviceFilePath	String: เส้นทางไฟล์แบบสัมบูรณ์ของแหล่งที่มาระยะไกล
localDir	File: ไดเรกทอรีในเครื่องที่จะดึงไฟล์เข้ามา

คิกรีเทิร์น
boolean	true หากดึงข้อมูลไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์แบบซ้ำ

พารามิเตอร์
deviceFilePath	String: เส้นทางไฟล์แบบสัมบูรณ์ของแหล่งที่มาระยะไกล
localDir	File: ไดเรกทอรีในเครื่องที่จะดึงไฟล์เข้ามา
userId	int: รหัสผู้ใช้ที่จะดึงข้อมูล

คิกรีเทิร์น
boolean	true หากดึงข้อมูลไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

ดึงไฟล์ออกจากอุปกรณ์ จัดเก็บไว้ใน ERROR(/File) ชั่วคราวในเครื่อง และแสดง File นั้น

พารามิเตอร์
remoteFilePath	String: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์
userId	int: รหัสผู้ใช้ที่จะดึงข้อมูล

คิกรีเทิร์น
File	ERROR(/File) ที่มีเนื้อหาของไฟล์อุปกรณ์ หรือ null หากคัดลอกไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์โฮสต์)

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullFile

public abstract File pullFile (String remoteFilePath)

ดึงไฟล์ออกจากอุปกรณ์ จัดเก็บไว้ใน ERROR(/File) ชั่วคราวในเครื่อง และแสดง File นั้น

พารามิเตอร์
remoteFilePath	String: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์

คิกรีเทิร์น
File	ERROR(/File) ที่มีเนื้อหาของไฟล์อุปกรณ์ หรือ null หากคัดลอกไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์โฮสต์)

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

ดึงข้อมูลไฟล์ออกจากอุปกรณ์

พารามิเตอร์
remoteFilePath	String: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์
localFile	File: ไฟล์ในเครื่องสำหรับจัดเก็บเนื้อหา หากไม่ว่างเปล่า ระบบจะแทนที่เนื้อหา

คิกรีเทิร์น
boolean	true หากดึงข้อมูลไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

ดึงข้อมูลไฟล์ออกจากอุปกรณ์

พารามิเตอร์
remoteFilePath	String: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์
localFile	File: ไฟล์ในเครื่องสำหรับจัดเก็บเนื้อหา หากไม่ว่างเปล่า ระบบจะแทนที่เนื้อหา
userId	int: รหัสผู้ใช้ที่จะดึงข้อมูล

คิกรีเทิร์น
boolean	true หากดึงข้อมูลไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

ดึงข้อมูลไฟล์ออกจากอุปกรณ์และแสดงผลเนื้อหา

พารามิเตอร์
remoteFilePath	String: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์

คิกรีเทิร์น
String	String ที่มีเนื้อหาของไฟล์อุปกรณ์ หรือ null หากคัดลอกไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์โฮสต์)

การโยน
DeviceNotAvailableException

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

วิธีการที่สะดวกในการดึงไฟล์จากที่จัดเก็บข้อมูลภายนอกของอุปกรณ์ จัดเก็บไฟล์ในERROR(/File)ชั่วคราวในเครื่อง และแสดงผลข้อมูลอ้างอิงไปยังFileนั้น

พารามิเตอร์
remoteFilePath	String: เส้นทางไปยังไฟล์ในอุปกรณ์ซึ่งสัมพันธ์กับจุดต่อเชื่อมของอุปกรณ์เก็บข้อมูลภายนอก

คิกรีเทิร์น
File	ERROR(/File) ที่มีเนื้อหาของไฟล์อุปกรณ์ หรือ null หากคัดลอกไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์โฮสต์)

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                int userId)

พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบซ้ำ

พารามิเตอร์
localDir	File: ไดเรกทอรีในเครื่องที่จะพุช
deviceFilePath	String: เส้นทางไฟล์แบบสัมบูรณ์ของปลายทางระยะไกล
userId	int: รหัสผู้ใช้ที่จะพุช

คิกรีเทิร์น
boolean	true หากพุชไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                 excludedDirectories)

พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบซ้ำซ้อนขณะยกเว้นไดเรกทอรีบางรายการที่กรองออก

พารามิเตอร์
localDir	File: ไดเรกทอรีในเครื่องที่จะพุช
deviceFilePath	String: เส้นทางไฟล์แบบสัมบูรณ์ของปลายทางระยะไกล
excludedDirectories	: ชุดชื่อไดเรกทอรีที่ยกเว้นซึ่งไม่ควรพุช

คิกรีเทิร์น
boolean	true หากพุชไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบซ้ำ

พารามิเตอร์
localDir	File: ไดเรกทอรีในเครื่องที่จะพุช
deviceFilePath	String: เส้นทางไฟล์แบบสัมบูรณ์ของปลายทางระยะไกล

คิกรีเทิร์น
boolean	true หากพุชไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                boolean evaluateContentProviderNeeded)

ตัวแปรของ pushFile(File, String) ซึ่งอาจพิจารณาประเมินความจำเป็นสำหรับผู้ให้บริการเนื้อหา

พารามิเตอร์
localFile	File: ไฟล์ในเครื่องที่จะพุช
deviceFilePath	String: เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล
evaluateContentProviderNeeded	boolean: ตรวจสอบว่าจำเป็นต้องมีผู้ให้บริการเนื้อหาหรือไม่

คิกรีเทิร์น
boolean	true หากพุชไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

พุชไฟล์ไปยังอุปกรณ์ ใช้ผู้ให้บริการเนื้อหาโดยค่าเริ่มต้น

พารามิเตอร์
localFile	File: ไฟล์ในเครื่องที่จะพุช
deviceFilePath	String: เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล

คิกรีเทิร์น
boolean	true หากพุชไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                int userId)

พุชไฟล์ไปยังอุปกรณ์ ใช้ผู้ให้บริการเนื้อหาโดยค่าเริ่มต้น

พารามิเตอร์
localFile	File: ไฟล์ในเครื่องที่จะพุช
deviceFilePath	String: เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล
userId	int: รหัสผู้ใช้ที่จะพุช

คิกรีเทิร์น
boolean	true หากพุชไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

พุชไฟล์ที่สร้างจากสตริงไปยังอุปกรณ์

พารามิเตอร์
contents	String: เนื้อหาของไฟล์ที่จะพุช
deviceFilePath	String: เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล

คิกรีเทิร์น
boolean	true หากมีการพุชสตริงเรียบร้อยแล้ว false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

รีบูต

public abstract void reboot ()

รีบูตอุปกรณ์เป็นโหมด adb

บล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน

การโยน
DeviceNotAvailableException	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

รีบูต

public abstract void reboot (String reason)

รีบูตอุปกรณ์เป็นโหมด ADB ด้วย reason ที่ระบุไว้เพื่อให้คงอยู่หลังจากรีบูต

บล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน

คุณดูสาเหตุการรีบูตครั้งล่าสุดได้โดยค้นหาพร็อพเพอร์ตี้ sys.boot.reason

พารามิเตอร์
reason	String: เหตุผลของการรีบูตครั้งนี้ หรือ null หากไม่ได้ระบุเหตุผล

การโยน
DeviceNotAvailableException	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

รีบูตอุปกรณ์เป็นโหมด Bootloader

บล็อกจนกว่าอุปกรณ์จะอยู่ในโหมด Bootloader

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

รีบูตอุปกรณ์เข้าสู่โหมด fastbootd

บล็อกจนกว่าอุปกรณ์จะอยู่ในโหมด fastbootd

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

รีบูตอุปกรณ์ให้อยู่ในโหมดการกู้คืน adb

บล็อกจนกว่าอุปกรณ์จะเข้าสู่การกู้คืน

การโยน
DeviceNotAvailableException	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

รีบูตอุปกรณ์เป็นโหมดการโหลดจากแหล่งที่ไม่รู้จักของ adb (โปรดทราบว่านี่เป็นโหมดพิเศษในการกู้คืน)

บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดการโหลดจากภายนอก

พารามิเตอร์
autoReboot	boolean: รีบูตอุปกรณ์โดยอัตโนมัติหลังจากการโหลดจากแหล่งที่ไม่รู้จักหรือไม่

การโยน
DeviceNotAvailableException	หากอุปกรณ์ไม่ได้อยู่ในการโหลดจากภายนอกหลังจากรีบูต

rebootIntoSideload

public abstract void rebootIntoSideload ()

รีบูตอุปกรณ์เป็นโหมดการโหลดจากแหล่งที่ไม่รู้จักของ adb (โปรดทราบว่านี่เป็นโหมดพิเศษในการกู้คืน)

บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดการโหลดจากภายนอก

การโยน
DeviceNotAvailableException	หากอุปกรณ์ไม่ได้อยู่ในการโหลดจากภายนอกหลังจากรีบูต

rebootUntilOnline

public abstract void rebootUntilOnline ()

คำสั่งอื่นแทน reboot() ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์ เช่น มองเห็นโดย adb

การโยน
DeviceNotAvailableException	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

คำสั่งอื่นแทน reboot() ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์ เช่น มองเห็นโดย adb

พารามิเตอร์
reason	String: เหตุผลของการรีบูตครั้งนี้ หรือ null หากไม่ได้ระบุเหตุผล

การโยน
DeviceNotAvailableException	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

ดูเพิ่มเติม

• reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

รีบูตเฉพาะพื้นที่ผู้ใช้ของอุปกรณ์

บล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน

คำเตือน การรีบูตพื้นที่ผู้ใช้กำลังอยู่ระหว่างการพัฒนา คุณจึงใช้โดยยอมรับความเสี่ยงเอง

การโยน
DeviceNotAvailableException	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

คำสั่งอื่นแทน rebootUserspace() ()} ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์ เช่น มองเห็นโดย adb

การโยน
DeviceNotAvailableException	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

ทำให้พาร์ติชันระบบในอุปกรณ์เป็นแบบอ่านอย่างเดียว อาจรีบูตอุปกรณ์

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

remountSystemWritable

public abstract void remountSystemWritable ()

ทำให้สามารถเขียนพาร์ติชันระบบในอุปกรณ์ได้ อาจรีบูตอุปกรณ์

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

ทำให้พาร์ติชันของผู้ให้บริการในอุปกรณ์เป็นแบบอ่านอย่างเดียว อาจรีบูตอุปกรณ์

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

remountVendorWritable

public abstract void remountVendorWritable ()

ทำให้สามารถเขียนพาร์ติชันของผู้ให้บริการในอุปกรณ์ได้ อาจรีบูตอุปกรณ์

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                ITestLifeCycleReceiver... listeners)

เมธอดที่สะดวกสำหรับการดำเนินการ ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) ที่มี Listener อย่างน้อย 1 รายการที่ส่งผ่านเป็นพารามิเตอร์

พารามิเตอร์
runner	IRemoteAndroidTestRunner: IRemoteAndroidTestRunner ที่ทำการทดสอบ
listeners	ITestLifeCycleReceiver: รายการที่รับฟังผลการทดสอบ

คิกรีเทิร์น
boolean	true หากคําสั่งทดสอบเสร็จสมบูรณ์ false หากดำเนินการไม่สำเร็จ แต่กู้คืนสำเร็จ

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้ เช่น ทดสอบคำสั่งไม่สำเร็จและกู้คืนไม่สำเร็จ

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

เรียกใช้การทดสอบการใช้เครื่องมือและให้การกู้คืนอุปกรณ์

หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปก่อนที่การทดสอบจะเสร็จสมบูรณ์และการกู้คืนสําเร็จ ฟีเจอร์นี้จะแจ้งให้ผู้ฟังทุกคนทราบเกี่ยวกับ testRunFailed และระบบจะแสดงผล "เท็จ" ระบบจะไม่เรียกใช้คําสั่งทดสอบซ้ำ ผู้โทรจะต้องลองอีกครั้งหากจำเป็น

หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปก่อนที่การทดสอบจะเสร็จสมบูรณ์และการกู้คืนไม่สำเร็จ ผู้ฟังทั้งหมดจะได้รับแจ้งว่า testRunFailed และระบบจะแสดง DeviceNotAvailableException

พารามิเตอร์
runner	IRemoteAndroidTestRunner: IRemoteAndroidTestRunner ที่ทำการทดสอบ
listeners	: รายการที่รับฟังผลการทดสอบ

คิกรีเทิร์น
boolean	true หากคําสั่งทดสอบเสร็จสมบูรณ์ false หากดำเนินการไม่สำเร็จเนื่องจากข้อยกเว้นการสื่อสารของอุปกรณ์ แต่การกู้คืนสำเร็จ

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้ เช่น ทดสอบคำสั่งไม่สำเร็จและกู้คืนไม่สำเร็จ

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                 listeners)

เหมือนกับ ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) แต่จะเป็นการเรียกใช้การทดสอบสําหรับผู้ใช้ที่ระบุ

พารามิเตอร์
runner	IRemoteAndroidTestRunner
userId	int
listeners

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

การโยน
DeviceNotAvailableException

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

เหมือนกับ ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) แต่ทำการทดสอบสําหรับผู้ใช้หนึ่งๆ

พารามิเตอร์
runner	IRemoteAndroidTestRunner
userId	int
listeners	ITestLifeCycleReceiver

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

การโยน
DeviceNotAvailableException

setDate

public abstract void setDate (Date date)

ตั้งค่าวันที่ในอุปกรณ์

หมายเหตุ: การตั้งค่าวันที่ในอุปกรณ์ต้องเข้าถึงระดับรูท

พารามิเตอร์
date	Date: ระบุวันที่ที่เจาะจง จะใช้วันที่ของโฮสต์หาก null

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setOptions

public abstract void setOptions (TestDeviceOptions options)

ตั้งค่า TestDeviceOptions สําหรับอุปกรณ์

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

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

ตั้งค่าพร็อพเพอร์ตี้ที่ระบุในอุปกรณ์ Requires adb root เป็น "จริง"

พารามิเตอร์
propKey	String: คีย์ที่กำหนดเป้าหมายที่จะตั้งค่า
propValue	String: ค่าพร็อพเพอร์ตี้ที่จะตั้งค่า

คิกรีเทิร์น
boolean	แสดงผล True หากคำสั่ง setprop ดำเนินการสำเร็จ หรือแสดงผล False หากไม่สำเร็จ

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

ตั้งค่า IDeviceRecovery เพื่อใช้กับอุปกรณ์นี้ ควรตั้งค่าเมื่อจัดสรรอุปกรณ์เป็นครั้งแรก

พารามิเตอร์
recovery	IDeviceRecovery: IDeviceRecovery

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

ตั้งค่าโหมดการกู้คืนปัจจุบันที่จะใช้กับอุปกรณ์

ใช้เพื่อควบคุมวิธีการกู้คืนที่จะใช้เมื่อพบปัญหาการสื่อสารของอุปกรณ์ เราขอแนะนำให้ใช้วิธีนี้เฉพาะเมื่อจำเป็นเท่านั้น (เช่น เมื่อเฟรมเวิร์กไม่ทำงาน ฯลฯ

พารามิเตอร์
mode	ITestDevice.RecoveryMode: ควรเปิดโหมด "กู้คืนจนกว่าจะออนไลน์เท่านั้น" หรือไม่

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

ติดตามหมายเลขซีเรียลที่เราใช้อ้างอิงอุปกรณ์เพื่อวัตถุประสงค์ในการจัดการอุปกรณ์

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

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

ตั้งค่าว่าจะใช้ fastboot erase หรือ fastboot format เพื่อล้างพาร์ติชันในอุปกรณ์

พารามิเตอร์
useFastbootErase	boolean: true หากควรใช้การลบด้วย Fastboot หรือ false หากควรใช้การฟอร์แมตด้วย Fastboot

ดูเพิ่มเติม

• fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

เริ่มบันทึกเอาต์พุต Logcat จากอุปกรณ์ในเบื้องหลัง

จะไม่มีผลหากมีการบันทึกเอาต์พุตของ Logcat อยู่แล้ว คุณจะเรียกข้อมูลในภายหลังได้ผ่าน getLogcat

เมื่อไม่ได้ใช้งานอุปกรณ์แล้ว จะต้องเรียก stopLogcat()

โดยทั่วไปแล้ว ไม่จำเป็นต้องเรียกใช้ startLogcat() และ stopLogcat() เมื่ออยู่ภายในบริบทการเรียกใช้ TF เนื่องจากเฟรมเวิร์ก TF จะเริ่มต้นและหยุด logcat

startTradeInModeTesting

public abstract boolean startTradeInModeTesting (int timeoutMs)

เปิดใช้โหมดการทดสอบการแลกซื้อ ระบบจะล้างข้อมูลในอุปกรณ์และรีบูต

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

คิกรีเทิร์น
boolean	จริง หากเราดำเนินการสำเร็จ หรือเป็นเท็จ

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

ปิดและลบเอาต์พุตของโปรแกรมจำลอง

stopLogcat

public abstract void stopLogcat ()

หยุดบันทึกเอาต์พุต logcat จากอุปกรณ์และทิ้งข้อมูล logcat ที่บันทึกไว้ในปัจจุบัน

จะไม่มีผลหากไม่ได้บันทึกเอาต์พุตของ Logcat

stopTradeInModeTesting

public abstract void stopTradeInModeTesting ()

หยุดการทดสอบโหมดแลกซื้อเครื่องใหม่ อุปกรณ์จะรีบูต

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchToAdbTcp

public abstract String switchToAdbTcp ()

เปลี่ยนอุปกรณ์เป็นโหมด adb-over-tcp

คิกรีเทิร์น
String	หมายเลขซีเรียลของ TCP หรือ null หากเปลี่ยนอุปกรณ์ไม่ได้

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

เปลี่ยนอุปกรณ์เป็นโหมด adb ผ่าน USB

คิกรีเทิร์น
boolean	true หากเปลี่ยนสำเร็จ หรือ false หากเปลี่ยนไม่สำเร็จ

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

ซิงค์เนื้อหาของไดเรกทอรีไฟล์ในเครื่องกับอุปกรณ์แบบเพิ่ม

เลือกไฟล์ที่จะพุชโดยเปรียบเทียบการประทับเวลาของไฟล์ในเครื่องกับไฟล์ที่เทียบเท่าในระบบระยะไกล ระบบจะพุชเฉพาะไฟล์ที่ "ใหม่กว่า" หรือไม่มีอยู่ในอุปกรณ์ ดังนั้น ค่าใช้จ่ายเพิ่มเติมจึงควรมีไม่มากนักหากไฟล์ที่ตั้งค่าไว้ในอุปกรณ์เป็นเวอร์ชันล่าสุดอยู่แล้ว

ระบบจะไม่สนใจไฟล์ที่ซ่อนอยู่ (ชื่อขึ้นต้นด้วย ".")

ตัวอย่างการใช้งาน: syncFiles("/tmp/files", "/sdcard") จะสร้างไดเรกทอรี /sdcard/files หากยังไม่มี และพุชเนื้อหา /tmp/files ไปยัง /sdcard/files แบบซ้ำ

พารามิเตอร์
localFileDir	File: ไดเรกทอรีไฟล์ในเครื่องที่มีไฟล์ที่จะพุชแบบซ้ำ
deviceFilePath	String: รูทเส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล ไดเรกทอรีทั้งหมดในเส้นทางไฟล์ดังกล่าวต้องอ่านได้ เช่น การพุชไปยัง /data/local/tmp เมื่อ adb ไม่ใช่รูทจะดำเนินการไม่สำเร็จ

คิกรีเทิร์น
boolean	true หากซิงค์ไฟล์สําเร็จ false ในกรณีอื่น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

unlockDevice

public abstract boolean unlockDevice ()

ปลดล็อกอุปกรณ์หากอุปกรณ์อยู่ในสถานะเข้ารหัส

วิธีนี้อาจรีสตาร์ทเฟรมเวิร์ก แต่ไม่เรียกใช้ postBootSetup() ดังนั้น อุปกรณ์อาจยังไม่พร้อมที่จะทดสอบอย่างเต็มรูปแบบเมื่อใช้วิธีการนี้

คิกรีเทิร์น
boolean	true หากดำเนินการสำเร็จหรืออุปกรณ์ไม่ได้เข้ารหัส

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้
UnsupportedOperationException	หากอุปกรณ์ไม่รองรับการเข้ารหัส

unmountDebugfs

public abstract void unmountDebugfs ()

ยกเลิกการต่อเชื่อม debugfs

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

บล็อกจนกว่าจะมีการตั้งค่า Flag การบูตเสร็จสมบูรณ์ของอุปกรณ์

พารามิเตอร์
timeOut	long: เวลาเป็นมิลลิวินาทีที่รอให้ตั้งค่า Flag

คิกรีเทิร์น
boolean	จริงหากตั้งค่า Flag การบูตเสร็จสมบูรณ์ของอุปกรณ์ภายในระยะหมดเวลา

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ ใช้ระยะหมดเวลาเริ่มต้น

คิกรีเทิร์น
boolean	เป็นจริงหากอุปกรณ์พร้อมใช้งาน เป็นเท็จหากการกู้คืนปิดอยู่และไม่พร้อมใช้งาน

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ

พารามิเตอร์
waitTime	long: เวลารอเป็นมิลลิวินาที

คิกรีเทิร์น
boolean	เป็นจริงหากอุปกรณ์พร้อมใช้งาน เป็นเท็จหากการกู้คืนปิดอยู่และไม่พร้อมใช้งาน

การโยน
DeviceNotAvailableException	if device is still unresponsive after waitTime expires.

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

รอให้อุปกรณ์ตอบสนองและพร้อมใช้งานโดยไม่คำนึงถึงเส้นทางการกู้คืน

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

คิกรีเทิร์น
boolean	เป็นจริงหากอุปกรณ์พร้อมใช้งาน เป็นเท็จหากไม่พร้อมใช้งาน

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน Fastboot ใช้ระยะหมดเวลาเริ่มต้น

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "การกู้คืน adb" (โปรดทราบว่าสถานะนี้แตกต่างจาก IDeviceRecovery)

พารามิเตอร์
waitTime	long: เวลารอเป็นมิลลิวินาที

คิกรีเทิร์น
boolean	true หากอุปกรณ์บูตเข้าสู่ Recovery ก่อนหมดเวลา false เมื่อสั่งซื้อนอกเหนือจากมูลค่าที่กำหนด

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "การโหลดจากด้านข้างด้วย adb"

พารามิเตอร์
waitTime	long: เวลารอเป็นมิลลิวินาที

คิกรีเทิร์น
boolean	true หากอุปกรณ์บูตเข้าสู่การโหลดจากแหล่งที่ไม่รู้จักก่อนที่เวลาจะหมด false เมื่อสั่งซื้อนอกเหนือจากมูลค่าที่กำหนด

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

บล็อกไม่ให้อุปกรณ์พร้อมใช้งาน เช่น ไม่อยู่ใน ADB

พารามิเตอร์
waitTime	long: เวลารอเป็นมิลลิวินาที

คิกรีเทิร์น
boolean	true หากอุปกรณ์ไม่พร้อมใช้งานก่อนหมดเวลา false เมื่อสั่งซื้อนอกเหนือจากมูลค่าที่กำหนด

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน adb ใช้ระยะหมดเวลาเริ่มต้น

โปรดทราบว่าอุปกรณ์อาจไม่ตอบสนองต่อคําสั่งเมื่อดำเนินการเสร็จสมบูรณ์ ให้ใช้ waitForDeviceAvailable() แทน

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน adb

โปรดทราบว่าอุปกรณ์อาจไม่ตอบสนองต่อคําสั่งเมื่อดำเนินการเสร็จสมบูรณ์ ให้ใช้ waitForDeviceAvailable() แทน

พารามิเตอร์
waitTime	long: เวลารอเป็นมิลลิวินาที

การโยน
DeviceNotAvailableException	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

รอให้อุปกรณ์ตอบสนองต่อคําสั่งเชลล์ adb พื้นฐาน

พารามิเตอร์
waitTime	long: เวลารอเป็นมิลลิวินาที

คิกรีเทิร์น
boolean	true หากอุปกรณ์เริ่มตอบสนองก่อนที่ waitTime จะหมดเวลา