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

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  อุปกรณ์ระยะไกลที่มีการจัดการ อุปกรณ์ที่ทำงานภายในเครื่องเสมือนที่เราจัดการจากระยะไกลผ่านอินสแตนซ์ 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) วิธีการของตัวช่วยในการตรวจสอบว่าอุปกรณ์เริ่มต้นอีกครั้งหรือไม่โดยการเปรียบเทียบ 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) เมธอด Helper ที่เรียกใช้คำสั่ง Fastboot เป็นคําสั่งระบบโดยมีระยะหมดเวลาเริ่มต้น 2 นาที
abstract CommandResult	executeLongFastbootCommand(String... commandArgs) เมธอด Helper ซึ่งเรียกใช้คำสั่ง Fastboot ที่ใช้เวลานานเป็นคำสั่งของระบบ
abstract CommandResult	executeLongFastbootCommand( envVarMap, String... commandArgs) เมธอด Helper ซึ่งเรียกใช้คำสั่ง 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) เมธอด Helper เพื่อกำหนดพื้นที่ว่างในพาร์ติชันอุปกรณ์
abstract ProcessInfo	getProcessByName(String processName) เมธอด Helper จะเรียกใช้คำสั่ง "pidof" และ "stat" และแสดงผลออบเจ็กต์ 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 ในกรณีที่เกิดข้อผิดพลาดภายใน
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	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)

วิธีการของตัวช่วยในการตรวจสอบว่าอุปกรณ์เริ่มต้นอีกครั้งหรือไม่โดยการเปรียบเทียบ 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)

เมธอด Helper ที่เรียกใช้คำสั่ง 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)

เมธอด Helper ซึ่งเรียกใช้คำสั่ง 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)

เมธอดของตัวช่วยที่เรียกใช้คำสั่ง 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) ที่จะส่งไปยังอินพุตเป็นอินพุตหรือ Null
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" และ "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

getLastExpectรีบูตTime Millis

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" และ "stat" และแสดงผลออบเจ็กต์ 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 จากอุปกรณ์ต่างๆ ต้องใช้รูท

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

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

การขว้าง
DeviceNotAvailableException

ดูเพิ่มเติม

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

getTotalMemory

public abstract long getTotalMemory ()

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

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

getUseFastbootDELETE

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 และผลลัพธ์เป็น "เท็จ" ระบบจะไม่เรียกใช้คำสั่งทดสอบอีกครั้ง ระบบจะแจ้งให้ผู้โทรลองอีกครั้งหากจำเป็น

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

ตั้งค่าUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

พารามิเตอร์
useFastbootErase	boolean: true หากควรใช้ Fastboot Delete หรือ 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