อุปกรณ์เนทีฟ

public interface INativeDevice

com.android.tradefed.device.INativeDevice

คลาสย่อยโดยอ้อมที่รู้จัก IManagedTestDevice, ITestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice อุปกรณ์ทดสอบ IManaged ITestDevice ที่มีการจัดการวงจร  อุปกรณ์ ITest มี API ระดับที่เชื่อถือได้และสูงกว่าเล็กน้อยสำหรับ ddmlib IDevice  LocalAndroidVirtualDevice คลาสสำหรับอุปกรณ์เสมือนท้องถิ่นที่ทำงานบนโฮสต์ TradeFed  อุปกรณ์ระยะไกลที่มีการจัดการ อุปกรณ์ที่ทำงานภายในเครื่องเสมือนที่เราจัดการจากระยะไกลผ่านอินสแตนซ์ที่เทรดเฟดอยู่ภายใน VM  อุปกรณ์ที่มาพร้อมเครื่อง การใช้งานเริ่มต้นของอุปกรณ์ Android ที่ไม่เต็มรูปแบบ ITestDevice เครื่อง  อุปกรณ์ระยะไกลที่ซ้อนกัน ภาพอุปกรณ์ที่ทำงานอยู่ภายใน VM ของ Cuttlefish ระยะไกล  อุปกรณ์ Android ระยะไกล การใช้ ITestDevice สำหรับอุปกรณ์ Android ทั้งสแต็กที่เชื่อมต่อผ่าน adb Connect  RemoteAndroidVirtualDevice ขยายลักษณะการทำงาน RemoteAndroidDevice สำหรับอุปกรณ์ Android ทั้งสแต็กซึ่งทำงานอยู่ใน Google Compute Engine (Gce)  อุปกรณ์ทดสอบ การใช้ 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) วิธีของ Helper ในการตรวจสอบว่าอุปกรณ์เริ่มต้นอีกครั้งหรือไม่โดยการเปรียบเทียบ system_server ปัจจุบันกับ system_server ก่อนหน้า ProcessInfo
abstract boolean	deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit) เมธอดของตัวช่วยในการตรวจสอบว่าอุปกรณ์เริ่มใหม่ชั่วคราวตั้งแต่เวลา UTC ตั้งแต่ Epoch หรือไม่ อุปกรณ์และERROR(/TimeUnit)อุปกรณ์
abstract boolean	disableAdbRoot() ปิดราก adb
abstract boolean	doesFileExist(String deviceFilePath) เมธอดของตัวช่วยในการตรวจสอบว่ามีไฟล์อยู่ในอุปกรณ์หรือไม่
abstract boolean	enableAdbRoot() เปิดราก adb
abstract String	executeAdbCommand(long timeout, String... commandArgs) เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบโดยมีระยะหมดเวลาที่ระบุไว้
abstract String	executeAdbCommand(String... commandArgs) เมธอด Helper ซึ่งเรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ
abstract String	executeAdbCommand(long timeout, envMap, String... commandArgs) เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบโดยมีระยะหมดเวลาที่ระบุไว้
abstract CommandResult	executeFastbootCommand(long timeout, String... commandArgs) เมธอด Helper ที่เรียกใช้คำสั่ง Fastboot เป็นคําสั่งระบบ
abstract CommandResult	executeFastbootCommand(String... commandArgs) เมธอดของตัวช่วยที่เรียกใช้คำสั่ง Fastboot เป็นคําสั่งระบบโดยมีระยะหมดเวลาเริ่มต้นเป็น 2 นาที
abstract CommandResult	executeLongFastbootCommand(String... commandArgs) เมธอด Helper ซึ่งเรียกใช้คำสั่ง Fastboot ที่ใช้เวลานานเป็นคำสั่งของระบบ
abstract CommandResult	executeLongFastbootCommand( envVarMap, String... commandArgs) เมธอดของตัวช่วยที่เรียกใช้คำสั่ง Fastboot ที่ใช้เวลานานเป็นคําสั่งระบบกับระบบ ตัวแปรสภาพแวดล้อม
abstract String	executeShellCommand(String command) เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลเอาต์พุตเป็น String
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver) เรียกใช้คำสั่งเชลล์ adb ที่กำหนด ลองใหม่หลายครั้งหากคำสั่งล้มเหลว
abstract CommandResult	executeShellV2Command(String command) เมธอดของตัวช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ซึ่งสร้างโดยมีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง
abstract CommandResult	executeShellV2Command(String command, OutputStream pipeToOutput) เมธอดของ Helper ที่เรียกใช้คำสั่ง 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) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
abstract CommandResult	executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
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) เมธอด Helper จะรวบรวมแมปประวัติการเปิดเครื่องพร้อมเวลาเปิดเครื่องและเหตุผลที่เปิดเครื่องตั้งแต่ที่ระบุ เวลาตั้งแต่ Epoch จากอุปกรณ์และหน่วยเวลาที่ระบุ
abstract String	getBootloaderVersion() วิธีการที่สะดวกในการรับเวอร์ชันของ Bootloader ของอุปกรณ์นี้
abstract String	getBuildAlias() เรียกข้อมูลชื่อแทนของบิลด์ที่อุปกรณ์ทำงานอยู่
abstract String	getBuildFlavor() เรียกข้อมูลเวอร์ชันบิลด์ของอุปกรณ์
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() แสดงวันที่ของอุปกรณ์เป็นมิลลิวินาทีตั้งแต่ Epoch
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 Mode
abstract String	getFastbootProductVariant() วิธีที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ใน Fastboot Mode
abstract String	getFastbootSerialNumber() แสดงหมายเลขซีเรียล Fastboot Mode
abstract String	getFastbootVariable(String variableName) ดึงค่าตัวแปร Fastboot ที่ระบุจากอุปกรณ์
abstract IFileEntry	getFileEntry(String path) ดึงข้อมูลการอ้างอิงไปยังไฟล์ระยะไกลในอุปกรณ์
abstract IDevice	getIDevice() แสดงผลการอ้างอิงไปยัง IDevice ddmlib ที่เกี่ยวข้อง
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) จับสตรีมสแนปชอตของ maxBytes ล่าสุดของข้อมูล Logcat ที่บันทึกไว้
abstract InputStreamSource	getLogcatDump() รับดัมพ์ของ Logcat ปัจจุบันสำหรับอุปกรณ์
abstract InputStreamSource	getLogcatSince(long date) ดึงสตรีมสแนปชอตของข้อมูล Logcat ที่บันทึกไว้โดยเริ่มตั้งแต่วันที่ที่ระบุ
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) เมธอด Helper เรียกใช้ "pidof" และ "สถิติ" และแสดงออบเจ็กต์ ProcessInfo ด้วย PID และเวลาเริ่มต้นของกระบวนการของกระบวนการที่ระบุ
abstract String	getProcessPid(String process) แสดงผล Pid ของบริการหรือ Null หากเกิดข้อผิดพลาด
abstract String	getProductType() วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้
abstract String	getProductVariant() วิธีการที่สะดวกในการรับรายละเอียดปลีกย่อยของผลิตภัณฑ์ของอุปกรณ์นี้
abstract String	getProperty(String name) ดึงข้อมูลค่าคุณสมบัติที่ระบุจากอุปกรณ์
abstract ITestDevice.RecoveryMode	getRecoveryMode() รับโหมดการกู้คืนปัจจุบันที่ใช้สำหรับอุปกรณ์
abstract String	getSerialNumber() วิธีการที่สะดวกในการรับหมายเลขซีเรียลของอุปกรณ์นี้
abstract	getTombstones() ดึงข้อมูลและส่งคืนรายการ Tombstone จากอุปกรณ์ต่างๆ
abstract long	getTotalMemory() แสดงขนาดหน่วยความจำทางกายภาพทั้งหมดเป็นไบต์หรือ -1 ในกรณีที่เกิดข้อผิดพลาดภายใน
default String	getTrackingSerial() เพื่อวัตถุประสงค์ด้านการจัดการอุปกรณ์ ให้รับหมายเลขซีเรียลที่ใช้ติดตามอุปกรณ์
abstract boolean	getUseFastbootErase() รับว่าจะใช้รูปแบบ Fastboot Delete หรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์หรือไม่
abstract boolean	isAdbRoot()
abstract boolean	isAdbTcp()
abstract boolean	isAppEnumerationSupported() ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการแจกแจงแอปหรือไม่
abstract boolean	isBypassLowTargetSdkBlockSupported() ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการข้ามการบล็อก SDK เป้าหมายต่ำในการติดตั้งแอปหรือไม่
abstract boolean	isDebugfsMounted() ตรวจสอบว่าได้ต่อเชื่อม debugf หรือไม่
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() ต่อเชื่อม debugf
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 Mode
abstract void	rebootIntoRecovery() รีบูตอุปกรณ์ให้เข้าสู่โหมดการกู้คืน adb
abstract void	rebootIntoSideload(boolean autoReboot) รีบูตอุปกรณ์ให้เข้าสู่โหมด adb Sideload (โปรดทราบว่านี่เป็นโหมดพิเศษที่อยู่ภายใต้การกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดโหลดจากแหล่งที่ไม่รู้จัก
abstract void	rebootIntoSideload() รีบูตอุปกรณ์ให้เข้าสู่โหมด adb Sideload (โปรดทราบว่านี่เป็นโหมดพิเศษที่อยู่ภายใต้การกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดโหลดจากแหล่งที่ไม่รู้จัก
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 หากต้องการลบหรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์
abstract void	startLogcat() เริ่มบันทึกเอาต์พุต Logcat จากอุปกรณ์ในเบื้องหลัง
abstract void	stopEmulatorOutput() ปิดและลบเอาต์พุตของโปรแกรมจำลอง
abstract void	stopLogcat() หยุดบันทึกเอาต์พุต Logcat จากอุปกรณ์และทิ้งข้อมูล Logcat ที่บันทึกไว้ในปัจจุบัน
abstract String	switchToAdbTcp() เปลี่ยนอุปกรณ์เป็นโหมด adb-over-tcp
abstract boolean	switchToAdbUsb() เปลี่ยนอุปกรณ์เป็น adb ผ่านโหมด USB
abstract boolean	syncFiles(File localFileDir, String deviceFilePath) ซิงค์เนื้อหาของไดเรกทอรีไฟล์ในเครื่องบางส่วนกับอุปกรณ์
abstract boolean	unlockDevice() ปลดล็อกอุปกรณ์หากอุปกรณ์อยู่ในสถานะเข้ารหัส
abstract void	unmountDebugfs() ยกเลิกการต่อเชื่อม debugf
abstract boolean	waitForBootComplete(long timeOut) บล็อกจนกว่าจะมีการตั้งค่าสถานะการเปิดเครื่องของอุปกรณ์เสร็จสมบูรณ์
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 พื้นฐาน

ค่าคงที่

ระดับ API ที่ไม่รู้จัก

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() ส่งคืนเท่านั้น ข้อมูลบันทึกที่สร้างขึ้นหลังจากช่วงเวลาหนึ่ง (เช่น หลังจากแฟลชบิลด์ใหม่ของอุปกรณ์ เป็นต้น)

ลบไฟล์

public abstract void deleteFile (String deviceFilePath)

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

ลบไฟล์

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

อุปกรณ์ที่ซอฟต์รีสตาร์ท

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

วิธีของ Helper ในการตรวจสอบว่าอุปกรณ์เริ่มต้นอีกครั้งหรือไม่โดยการเปรียบเทียบ system_server ปัจจุบันกับ system_server ก่อนหน้า ProcessInfo ใช้getProcessByName(String)เพื่อรับProcessInfo

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

คิกรีเทิร์น
boolean	true หากรีเซ็ตอุปกรณ์ชั่วคราว

การขว้าง
RuntimeException	หากอุปกรณ์มีเหตุผลที่เปิดเครื่องผิดปกติ
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

deviceSoftรีสตาร์ทตั้งแต่

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

คิกรีเทิร์น
boolean	true หากรีเซ็ตอุปกรณ์ชั่วคราว

การขว้าง
RuntimeException	หากอุปกรณ์มีเหตุผลที่เปิดเครื่องผิดปกติ
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

ปิดใช้ AdbRoot

public abstract boolean disableAdbRoot ()

ปิดราก adb

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

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

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

doFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

คิกรีเทิร์น
boolean	true หากมีไฟล์อยู่ false มิเช่นนั้น

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

enabledAdbRoot

public abstract boolean enableAdbRoot ()

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

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

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

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

actionsAdbCommand

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

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

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

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

คิกรีเทิร์น
String	Stdout จากคำสั่ง null หากเรียกใช้คำสั่งไม่สำเร็จ

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

actionsAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

เมธอด Helper ซึ่งเรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ

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

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

คิกรีเทิร์น
String	Stdout จากคำสั่ง null หากเรียกใช้คำสั่งไม่สำเร็จ

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

actionsAdbCommand

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

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

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

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

คิกรีเทิร์น
String	Stdout จากคำสั่ง null หากเรียกใช้คำสั่งไม่สำเร็จ

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

ปฏิบัติการFastbootCommand

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

เมธอด Helper ที่เรียกใช้คำสั่ง Fastboot เป็นคําสั่งระบบ

คาดว่าจะใช้เมื่ออุปกรณ์อยู่ใน Fastboot Mode อยู่แล้ว

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

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

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

ปฏิบัติการFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

คาดว่าจะใช้เมื่ออุปกรณ์อยู่ใน Fastboot Mode อยู่แล้ว

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

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

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

ดำเนินการLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

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

ดำเนินการLongFastbootCommand

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

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

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

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

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

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

ปฏิบัติการเชลล์คำสั่ง

public abstract String executeShellCommand (String command)

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

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

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

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

ปฏิบัติการเชลล์คำสั่ง

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

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

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

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

ดูเพิ่มเติม

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

ปฏิบัติการเชลล์คำสั่ง

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

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

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

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

ดูเพิ่มเติม

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

ปฏิบัติการเชลล์คำสั่ง

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

เรียกใช้คำสั่งเชลล์ adb ที่กำหนด ลองใหม่หลายครั้งหากคำสั่งล้มเหลว

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

พารามิเตอร์
command	String: คำสั่ง Shell adb ที่จะเรียกใช้
receiver	IShellOutputReceiver: IShellOutputReceiver ที่จะส่งเอาต์พุตของ Shell โดยตรง

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

สั่งการShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

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

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

สั่งการShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

เมธอดของ Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult พร้อมเอาต์พุตสถานะคำสั่งและ stderr อย่างถูกต้อง Stdout คือ ถูกนำไปยังสตรีมที่ระบุ

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

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

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

สั่งการShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

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

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

สั่งการShellV2Command

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

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

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

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

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

ดูเพิ่มเติม

• executeShellV2Command(String)
• TimeUtil

สั่งการShellV2Command

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

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

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

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

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

ดูเพิ่มเติม

• executeShellV2Command(String)
• TimeUtil

สั่งการShellV2Command

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

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

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

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

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

ดูเพิ่มเติม

• executeShellV2Command(String)
• TimeUtil

สั่งการShellV2Command

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

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

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

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

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

ดูเพิ่มเติม

• executeShellV2Command(String)
• TimeUtil

FastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

คาดว่าจะใช้เมื่ออุปกรณ์อยู่ใน Fastboot Mode อยู่แล้ว

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

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

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

ระดับ getApi

public abstract int getApiLevel ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

เวอร์ชันของ GetBase Band

public abstract String getBasebandVersion ()

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

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

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

รับแบตเตอรี่

public abstract Integer getBattery ()

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

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

พร็อพเพอร์ตี้ GetBoolean

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

ประวัติการเปิดเครื่อง

public abstract  getBootHistory ()

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

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

การขว้าง
DeviceNotAvailableException

getBootประวัติการเข้าชมตั้งแต่

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

การขว้าง
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

จะพยายามเรียกเวอร์ชัน Bootloader จากสถานะปัจจุบันของอุปกรณ์ (เช่น ถ้าอุปกรณ์ อยู่ใน Fastboot Mode และจะพยายามเรียกเวอร์ชันจาก 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 ()

เรียกข้อมูลเวอร์ชันบิลด์ของอุปกรณ์

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

ดึงข้อมูลบิลด์ที่อุปกรณ์กำลังทำงานอยู่

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

คีย์การลงนามของการสร้างบิลด์

public abstract String getBuildSigningKeys ()

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

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

คิกรีเทิร์น
String	คีย์การลงชื่อ หากพบ จะเป็นค่าว่าง

การขว้าง
	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

รับเด็ก

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

แสดงวันที่ของอุปกรณ์เป็นมิลลิวินาทีตั้งแต่ Epoch

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

การขว้าง
	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

รับเวลาของอุปกรณ์

public abstract long getDeviceTimeOffset (Date date)

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

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

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

การขว้าง
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

เข้าถึงร้านค้าฟรีภายนอก

public abstract long getExternalStoreFreeSpace ()

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

คิกรีเทิร์น
long	ปริมาณพื้นที่ว่างในหน่วย KB

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

แสดงหมายเลขซีเรียล Fastboot Mode

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

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

การขว้าง
	ไม่สนับสนุนOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

แสดงผลการอ้างอิงไปยัง IDevice ddmlib ที่เกี่ยวข้อง

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

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

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

การขว้าง
DeviceNotAvailableException

getLastLastExpectรีบูตTimeมิลลิวินาที

public abstract long getLastExpectedRebootTimeMillis ()

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

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

ระดับ getLaunchApi

public abstract int getLaunchApiLevel ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

ดึงสตรีมสแนปชอตของข้อมูล Logcat

ทำงานใน 2 โหมดต่อไปนี้

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

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

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

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

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

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

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

มีข้อเสียตรงที่จะไม่ส่งคืนอุปกรณ์หากติดต่อไม่ได้

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

getLogcatหากยังไม่มี

public abstract InputStreamSource getLogcatSince (long date)

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

พารามิเตอร์
date	long: เป็นมิลลิวินาทีตั้งแต่รูปแบบ Epoch ของเวลาที่จะเริ่มสแนปชอตจนถึงปัจจุบัน (รับได้โดยใช้ "วันที่ +%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

getพาร์ติชัน FreeSpace

public abstract long getPartitionFreeSpace (String partition)

เมธอด Helper เพื่อกำหนดพื้นที่ว่างในพาร์ติชันอุปกรณ์

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

คิกรีเทิร์น
long	ปริมาณพื้นที่ว่างในหน่วย KB

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

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

พารามิเตอร์
processName	String: สตริงชื่อโพรเซส

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

การขว้าง
DeviceNotAvailableException

getProcessPid

public abstract String getProcessPid (String process)

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

พารามิเตอร์
process	String: สตริงชื่อโพรเซส

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

การขว้าง
DeviceNotAvailableException

getProductType

public abstract String getProductType ()

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

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

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

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

getProductVariant

public abstract String getProductVariant ()

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

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

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

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

GetProperty

public abstract String getProperty (String name)

ดึงข้อมูลค่าคุณสมบัติที่ระบุจากอุปกรณ์

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

โหมดกู้คืน

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getSerialNumber

public abstract String getSerialNumber ()

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

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

GetTombstones

public abstract  getTombstones ()

ดึงข้อมูลและส่งคืนรายการ Tombstone จากอุปกรณ์ต่างๆ ต้องใช้รูท

เป็นวิธีที่ดีที่สุด ดังนั้นหากไม่สามารถดึงหลุมฝังศพได้ 1 ก้อนไม่ว่าจะด้วยเหตุผลใดก็ตาม หายไปจากรายการ มีเพียง DeviceNotAvailableException เท่านั้นที่จะสิ้นสุดเมธอด ตั้งแต่เนิ่นๆ

คิกรีเทิร์น
	รายการไฟล์ Tombstone ให้ว่างเปล่าหากไม่มี Tombstone

การขว้าง
DeviceNotAvailableException

ดูเพิ่มเติม

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

getTotalMemory

public abstract long getTotalMemory ()

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

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

getTrackingSerial

public String getTrackingSerial ()

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

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

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

รับว่าจะใช้รูปแบบ Fastboot Delete หรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์หรือไม่

คิกรีเทิร์น
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 หรือไม่เช่นนั้น

รองรับ isAppEnumeration

public abstract boolean isAppEnumerationSupported ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

รองรับการปิดกั้นเป้าหมาย SDK ต่ำ

public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

ติดตั้ง isDebugfs

public abstract boolean isDebugfsMounted ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

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

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

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

ไดเรกทอรี

public abstract boolean isDirectory (String deviceFilePath)

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

รองรับการเข้ารหัส

public abstract boolean isEncryptionSupported ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

เป็นไฟล์ปฏิบัติการ

public abstract boolean isExecutable (String fullPath)

แสดงผลเป็น "จริง" หากเส้นทางของไฟล์ในอุปกรณ์เป็นไฟล์ปฏิบัติการ หรือเป็นเท็จ

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

เป็นแบบไม่มีส่วนหัว

public abstract boolean isHeadless ()

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

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

การขว้าง
DeviceNotAvailableException

รองรับรันไทม์ไหม

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

mountDebugf

public abstract void mountDebugfs ()

ต่อเชื่อม debugf

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

รีบูตแบบไม่บล็อก

public abstract void nonBlockingReboot ()

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

การตั้งค่าหลังจากเปิดเครื่อง

public abstract void postBootSetup ()

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

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

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

ส่วนที่อาจต้องโทรหาคือเมื่ออุปกรณ์รีบูตเนื่องจากเหตุการณ์อื่นๆ (เช่น เมื่อ คำสั่งอัปเดต Fastboot เสร็จสมบูรณ์)

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

postInvocationTearDown

public void postInvocationTearDown ()

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

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

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

ตั้งค่าการเรียกใช้ล่วงหน้า

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	หากการเชื่อมต่อกับอุปกรณ์หายไปและไม่สามารถ กู้คืน

พุชDir

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

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

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

คิกรีเทิร์น
boolean	true หากพุชไฟล์สำเร็จ จ่าย false

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

พุชDir

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

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

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

คิกรีเทิร์น
boolean	true หากพุชไฟล์สำเร็จ จ่าย false

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

พุชDir

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	หากการเชื่อมต่อกับอุปกรณ์หายไปและไม่สามารถ กู้คืน

สตริงพุช

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	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

รีบูตIntoBootloader

public abstract void rebootIntoBootloader ()

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

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

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

รีบูตIntoFastbootd

public abstract void rebootIntoFastbootd ()

รีบูตอุปกรณ์ให้เข้าสู่ Fastbootd Mode

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

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

รีบูตIntoRecovery

public abstract void rebootIntoRecovery ()

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

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

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

BootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

รีบูตอุปกรณ์ให้เข้าสู่โหมด adb Sideload (โปรดทราบว่านี่เป็นโหมดพิเศษที่อยู่ภายใต้การกู้คืน)

บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดโหลดจากแหล่งที่ไม่รู้จัก

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

การขว้าง
DeviceNotAvailableException	หากอุปกรณ์ไม่ได้โหลดจากแหล่งที่ไม่รู้จักหลังจากรีบูต

BootIntoSideload

public abstract void rebootIntoSideload ()

รีบูตอุปกรณ์ให้เข้าสู่โหมด adb Sideload (โปรดทราบว่านี่เป็นโหมดพิเศษที่อยู่ภายใต้การกู้คืน)

บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดโหลดจากแหล่งที่ไม่รู้จัก

การขว้าง
DeviceNotAvailableException	หากอุปกรณ์ไม่ได้โหลดจากแหล่งที่ไม่รู้จักหลังจากรีบูต

รีบูตจนถึงออนไลน์

public abstract void rebootUntilOnline ()

ทางเลือกเป็น reboot() ที่บล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น นั่นคือ ปรากฏแก่ adb

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

รีบูตจนถึงออนไลน์

public abstract void rebootUntilOnline (String reason)

ทางเลือกเป็น reboot() ที่บล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น นั่นคือ แสดงต่อ adb

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

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

ดูเพิ่มเติม

• reboot(String)

รีบูตUserspace

public abstract void rebootUserspace ()

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

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

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

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

รีบูตผู้ใช้พื้นที่จนถึงออนไลน์

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)

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

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

หากการเชื่อมต่อกับอุปกรณ์ขาดหายก่อนที่การทดสอบจะเสร็จสมบูรณ์ และการกู้คืนไม่สำเร็จ Listener จะได้รับแจ้งเกี่ยวกับ 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

ตั้งค่าพร็อพเพอร์ตี้

public abstract boolean setProperty (String propKey, 
                String propValue)

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

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

คิกรีเทิร์น
boolean	จะแสดงผล True หากคำสั่ง setprop สำเร็จ แสดงผลเป็น "เท็จ" หากไม่เป็นเช่นนั้น

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

SetRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

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

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

ตั้งโหมดการกู้คืน

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

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

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

ตั้งค่าUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

ตั้งค่าว่าจะใช้รูปแบบ Fastboot หากต้องการลบหรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์

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

ดูเพิ่มเติม

• fastbootWipePartition(String)

StartLogcat

public abstract void startLogcat ()

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

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

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

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

StopEmulatorเอาต์พุต

public abstract void stopEmulatorOutput ()

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

StopLogcat

public abstract void stopLogcat ()

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

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

SwitchToAdbTcp

public abstract String switchToAdbTcp ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

สลับไปยัง AdbUsb

public abstract boolean switchToAdbUsb ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

ซิงค์ไฟล์

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	หากการเชื่อมต่อกับอุปกรณ์หายไปและไม่สามารถ กู้คืน

ปลดล็อกอุปกรณ์

public abstract boolean unlockDevice ()

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

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

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

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

unmountDebugfs

public abstract void unmountDebugfs ()

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

รอสิ้นสุดการเปิดเครื่อง

public abstract boolean waitForBootComplete (long timeOut)

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

รออุปกรณ์ที่พร้อมใช้งาน

public abstract boolean waitForDeviceAvailable ()

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

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

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

รออุปกรณ์ที่พร้อมใช้งาน

public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

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

การขว้าง
DeviceNotAvailableException	หากอุปกรณ์ยังคงไม่ตอบสนองหลังจากเวลารอหมดลง

รอสำหรับอุปกรณ์ที่ใช้งานได้ในการกู้คืนเส้นทาง

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

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

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

รอสำหรับตัวโหลดอุปกรณ์

public abstract void waitForDeviceBootloader ()

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

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

รอการกู้คืนอุปกรณ์

public abstract boolean waitForDeviceInRecovery (long waitTime)

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

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

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

รออุปกรณ์ในไซด์โหลด

public abstract boolean waitForDeviceInSideload (long waitTime)

การบล็อกเพื่อให้อุปกรณ์อยู่ใน "adb ไซด์โหลด" สถานะ

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

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

รออุปกรณ์ไม่พร้อมให้บริการ

public abstract boolean waitForDeviceNotAvailable (long waitTime)

การบล็อกอุปกรณ์ไม่พร้อมใช้งานเนื่องจากขาดหายไปจาก adb

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

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

รออุปกรณ์ออนไลน์

public abstract void waitForDeviceOnline ()

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

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

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

รออุปกรณ์ออนไลน์

public abstract void waitForDeviceOnline (long waitTime)

บล็อกจนกว่าอุปกรณ์จะแสดงผ่าน adb

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

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

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

รอเชลล์อุปกรณ์

public abstract boolean waitForDeviceShell (long waitTime)

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

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

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