INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

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

---

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

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

สรุป

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

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

ค่าคงที่

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

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

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

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

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

การคืนสินค้า
boolean	จริงหากระบบรองรับระดับ มิเช่นนั้นจะเป็น "เท็จ"

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
RuntimeException	หากอุปกรณ์มีเหตุผลในการบูตที่ผิดปกติ
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
RuntimeException	หากอุปกรณ์มีสาเหตุการบูตที่ผิดปกติ
DeviceNotAvailableException

disableAdbRoot

public abstract boolean disableAdbRoot ()

ปิดรูท adb

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

การคืนสินค้า
boolean	true หากสำเร็จ

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

เมธอด Helper เพื่อตรวจสอบว่ามีไฟล์ในอุปกรณ์หรือไม่

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

การคืนสินค้า
boolean	true หากมีไฟล์อยู่ false มิฉะนั้น

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

การคืนสินค้า
boolean	true หากสำเร็จ

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

executeAdbCommand

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

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

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

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

การคืนสินค้า
String	stdout จากคำสั่ง null หากคำสั่งดำเนินการไม่สำเร็จ

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

การคืนสินค้า
String	stdout จากคำสั่ง null หากคำสั่งดำเนินการไม่สำเร็จ

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

executeAdbCommand

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

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

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

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

การคืนสินค้า
String	stdout จากคำสั่ง null หากคำสั่งดำเนินการไม่สำเร็จ

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

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

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

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

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

executeAdbV2Command

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

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

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

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

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                int retryAttempts, 
                String... commandArgs)

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

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

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

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                String... commandArgs)

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

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

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

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

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

executeFastbootCommand

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

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

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

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

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

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

เหมือนกับ executeFastbootCommand(String...) แต่ใช้การหมดเวลาที่นานกว่า

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

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

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (Map<String, String> envVarMap, 
                String... commandArgs)

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

เหมือนกับ executeFastbootCommand(String...) แต่ใช้การหมดเวลาที่นานกว่า

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

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

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

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

การคืนสินค้า
String	เอาต์พุตของเชลล์

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

executeShellCommand

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

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

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

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

ดูเพิ่มเติม:

• executeShellCommand(String,IShellOutputReceiver)
• TimeUtil

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

เรียกใช้คำสั่ง adb shell ที่ระบุ โดยจะลองอีกหลายครั้งหากคำสั่งล้มเหลว

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

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

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

executeShellCommand

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

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

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

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

ดูเพิ่มเติม:

• executeShellCommand(String,IShellOutputReceiver)
• TimeUtil

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

การคืนสินค้า
CommandResult	ผลการค้นหาในภาษาCommandResult

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

executeShellV2Command

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

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

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

การคืนสินค้า
CommandResult

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

ดูเพิ่มเติม:

• executeShellV2Command(String)
• TimeUtil

executeShellV2Command

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

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

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

การคืนสินค้า
CommandResult

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

ดูเพิ่มเติม:

• executeShellV2Command(String)
• TimeUtil

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

การคืนสินค้า
CommandResult	ผลการค้นหาในภาษาCommandResult

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

พารามิเตอร์
command	String: คำสั่งที่ควรเรียกใช้
pipeToOutput	OutputStream: OutputStream ที่จะเปลี่ยนเส้นทางเอาต์พุตมาตรฐาน หรือ null

การคืนสินค้า
CommandResult	ผลการค้นหาในภาษาCommandResult

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

executeShellV2Command

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

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

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

การคืนสินค้า
CommandResult

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

ดูเพิ่มเติม:

• executeShellV2Command(String)
• TimeUtil

executeShellV2Command

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

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

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

การคืนสินค้า
CommandResult

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

ดูเพิ่มเติม:

• executeShellV2Command(String)
• TimeUtil

executeShellV2Command

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

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

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

การคืนสินค้า
CommandResult

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

ดูเพิ่มเติม:

• executeShellV2Command(String)
• TimeUtil

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                IShellOutputReceiver receiver)

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

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

การคืนสินค้า
CommandResult	ผลการค้นหาในภาษาCommandResult

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

fastbootOemRamdumpNow

public abstract CommandResult fastbootOemRamdumpNow ()

วิธีการช่วยที่เรียกใช้ ramdump จากโหมด fastboot

วิธีนี้จะเรียกใช้คำสั่ง "oem ramdump now" ซึ่งแตกต่างจาก ERROR(/#executeFastbootCommand()), โดยจะไม่พยายามลองอีกครั้งหรือกู้คืนอุปกรณ์หากคำสั่งล้มเหลวหรือสถานะ ไม่ถูกต้อง เนื่องจากผลลัพธ์ที่ต้องการคืออุปกรณ์ขัดข้อง คาดว่าจะใช้เมื่ออุปกรณ์อยู่ในโหมด Fastboot อยู่แล้ว

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

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

วิธีการช่วยล้างพาร์ติชันสำหรับอุปกรณ์

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

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

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

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

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

getApiLevel

public abstract int getApiLevel ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getApiLevelFull

public abstract int getApiLevelFull ()

คล้ายกับ getApiLevel() แต่จะแสดงผลเวอร์ชันเต็ม

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ดูเพิ่มเติม:

• ERROR(/frameworks/base/core/java/android/os/Build.java#parseFullVersion(String, String))

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

getBattery

public abstract Integer getBattery ()

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

การคืนสินค้า
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

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

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

ส่ง
DeviceNotAvailableException

getBootHistory

public abstract Map<Long, String> getBootHistory ()

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

การคืนสินค้า
Map<Long, String>	แผนที่ของเวลาบูต (เวลา UTC เป็นวินาทีตั้งแต่ Epoch) และเหตุผลในการบูต

ส่ง
DeviceNotAvailableException

getBootHistorySince

public abstract Map<Long, String> getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

การคืนสินค้า
Map<Long, String>	แผนที่ของเวลาบูต (เวลา UTC เป็นวินาทีตั้งแต่ Epoch) และเหตุผลในการบูต

ส่ง
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

การคืนสินค้า
String	String เวอร์ชัน Bootloader หรือ null หากไม่พบ

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

การคืนสินค้า
String	คีย์การลงนาม (หากพบ) หรือ Null

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

การคืนสินค้า
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

พารามิเตอร์
shortDescriptor	boolean: จะจำกัดข้อบ่งชี้ให้มีข้อมูลขั้นต่ำหรือไม่

การคืนสินค้า
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

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

การคืนสินค้า
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

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

การคืนสินค้า
String	String คลาสอุปกรณ์

getDeviceDate

public abstract long getDeviceDate ()

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

การคืนสินค้า
long	วันที่ของอุปกรณ์ในรูปแบบ 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

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Helper เพื่อรับความแตกต่างของเวลาระหว่างอุปกรณ์กับ Date ที่ระบุ ใช้เวลา Epoch ภายใน

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

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

ส่ง
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

การคืนสินค้า
long	ปริมาณพื้นที่ว่างเป็น KB

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

การคืนสินค้า
String	Stringชื่อประเภทสินค้าหรือnullหากระบุไม่ได้

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

การคืนสินค้า
String	Stringชื่อประเภทสินค้าหรือnullหากระบุไม่ได้

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

การคืนสินค้า
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

ส่ง
	UnsupportedOperationException
DeviceNotAvailableException
UnsupportedOperationException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

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

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

การคืนสินค้า
IDevice	IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

ส่ง
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

การคืนสินค้า
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

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

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

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

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

การคืนสินค้า
InputStreamSource

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

การคืนสินค้า
InputStreamSource

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

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

มีข้อเสียคือจะไม่มีการส่งคืนข้อมูลใดๆ หากเข้าถึงอุปกรณ์ไม่ได้

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

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

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

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

การคืนสินค้า
InputStreamSource

getMountPoint

public abstract String getMountPoint (String mountName)

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

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

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

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

การคืนสินค้า
String	จุดต่อเชื่อมหรือ null

ดูเพิ่มเติม:

• IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

การคืนสินค้า
ITestDevice.MountPointInfo	List ของ MountPointInfo ที่มีข้อมูลใน "/proc/mounts"

ส่ง
DeviceNotAvailableException

ดูเพิ่มเติม:

• getMountPointInfo()

getMountPointInfo

public abstract List<ITestDevice.MountPointInfo> getMountPointInfo ()

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

การคืนสินค้า
List<ITestDevice.MountPointInfo>	List ของ MountPointInfo ที่มีข้อมูลใน "/proc/mounts"

ส่ง
DeviceNotAvailableException

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

พารามิเตอร์
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 ของบริการหรือค่าว่างหากเกิดข้อผิดพลาด

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

การคืนสินค้า
String

ส่ง
DeviceNotAvailableException

getProductType

public abstract String getProductType ()

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

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

การคืนสินค้า
String	Stringชื่อประเภทสินค้า ต้องไม่เป็นค่าว่าง

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

getProductVariant

public abstract String getProductVariant ()

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

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

การคืนสินค้า
String	Stringชื่อสินค้าย่อยnullหรือหากไม่สามารถระบุได้

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

getProperty

public abstract String getProperty (String name)

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

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getSerialNumber

public abstract String getSerialNumber ()

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

การคืนสินค้า
String	String หมายเลขซีเรียล

getTombstones

public abstract List<File> getTombstones ()

ดึงและแสดงรายการเครื่องหมายหลุมศพจากอุปกรณ์ ต้องใช้รูท

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

การคืนสินค้า
List<File>	รายการไฟล์ที่ถูกทำเครื่องหมายว่าไม่พร้อมใช้งาน ซึ่งจะว่างเปล่าหากไม่มีไฟล์ที่ถูกทำเครื่องหมาย

ส่ง
DeviceNotAvailableException

ดูเพิ่มเติม:

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

getTotalMemory

public abstract long getTotalMemory ()

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

การคืนสินค้า
long

getTrackingSerial

public String getTrackingSerial ()

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

การคืนสินค้า
String

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

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

การคืนสินค้า
boolean	true หากจะใช้ fastboot erase หรือ false หากจะใช้ fastboot format

ดูเพิ่มเติม:

• fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

การคืนสินค้า
boolean	true หากอุปกรณ์มีการรูท adb อยู่ในปัจจุบัน false มิฉะนั้น

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

isAdbTcp

public abstract boolean isAdbTcp ()

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

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

การคืนสินค้า
boolean	เป็นจริงหากรองรับการข้ามการบล็อก SDK เป้าหมายต่ำ มิเช่นนั้นจะเป็นเท็จ

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

ตรวจสอบว่าได้ติดตั้ง debugfs แล้วหรือไม่

การคืนสินค้า
boolean	true หากมีการติดตั้ง debugfs

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

แสดงว่าอุปกรณ์มีการเข้ารหัสหรือไม่

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

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

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

แสดงค่าเป็น True หากเส้นทางในอุปกรณ์เป็นไดเรกทอรี หากไม่ แสดงค่าเป็น False

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

การคืนสินค้า
boolean

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

แสดงว่าอุปกรณ์รองรับการเข้ารหัสหรือไม่

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isExecutable

public abstract boolean isExecutable (String fullPath)

แสดงค่าเป็น True หากเส้นทางไฟล์ในอุปกรณ์เป็นไฟล์ที่เรียกใช้งานได้ หากไม่ แสดงค่าเป็น False

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

การคืนสินค้า
boolean

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isHeadless

public abstract boolean isHeadless ()

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

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

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

การคืนสินค้า
boolean

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

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

พารามิเตอร์
logger	ITestLogger: ITestLogger สำหรับบันทึก ANR

การคืนสินค้า
boolean	เป็นจริงหากการบันทึกสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

ส่ง
DeviceNotAvailableException

logOnDevice

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

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

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

mountDebugfs

public abstract void mountDebugfs ()

เมานต์ debugfs

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

nonBlockingReboot

public abstract void nonBlockingReboot ()

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

postBootSetup

public abstract void postBootSetup ()

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

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

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

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

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

postInvocationTearDown

public void postInvocationTearDown ()

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

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

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

preInvocationSetup

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

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
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, 
                long timeout)

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

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

การคืนสินค้า
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)

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

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

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

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

pullFile

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

ดึงไฟล์ออกจากอุปกรณ์

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

การคืนสินค้า
boolean	true หากดึงข้อมูลไฟล์สำเร็จ false หรือไม่เช่นนั้น

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

pullFile

public abstract File pullFile (String remoteFilePath)

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

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

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

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

pullFile

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

ดึงไฟล์ออกจากอุปกรณ์

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

การคืนสินค้า
boolean	true หากดึงข้อมูลไฟล์สำเร็จ false หรือไม่เช่นนั้น

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

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

ดึงไฟล์ออกจากอุปกรณ์

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

การคืนสินค้า
boolean	true หากดึงข้อมูลไฟล์สำเร็จ false หรือไม่เช่นนั้น

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

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

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

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

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

ส่ง
DeviceNotAvailableException

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

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

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

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

pushDir

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

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

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

การคืนสินค้า
boolean	true หากพุชไฟล์สำเร็จ false หรือไม่เช่นนั้น

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

pushDir

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

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

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

การคืนสินค้า
boolean	true หากพุชไฟล์สำเร็จ false หรือไม่เช่นนั้น

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

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

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

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

การคืนสินค้า
boolean	true หากพุชไฟล์สำเร็จ false หรือไม่เช่นนั้น

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

pushFile

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

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

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

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

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

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

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

การคืนสินค้า
boolean	true หากส่งสตริงสำเร็จ false หรือไม่เช่นนั้น

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

เริ่มต้นใหม่

public abstract void reboot ()

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

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

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

เริ่มต้นใหม่

public abstract void reboot (String reason)

รีบูตอุปกรณ์เข้าสู่โหมด adb โดยมี reason ที่กำหนดเพื่อคงไว้หลังการรีบูต

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

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

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

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

เริ่มต้นใหม่

public String reboot (String command, 
                String reason)

รีบูตอุปกรณ์โดยใช้ command ที่ระบุ

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

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

พารามิเตอร์
command	String: คำสั่งที่ส่งไปยัง `adb` โปรดทราบว่าคำสั่งจะส่ง "ตามที่เป็น" ดังนั้นผู้เรียกจึงต้องใส่เครื่องหมายคำพูดที่เหมาะสมหากจำเป็น (โดยเฉพาะอย่างยิ่งหากมีหลายส่วนที่คั่นด้วยช่องว่าง)
reason	String: เหตุผลในการรีบูตนี้ หรือ null หากไม่ได้ระบุเหตุผล

การคืนสินค้า
String

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

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

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

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

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

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

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

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

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

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

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

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload ()

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

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

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

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

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

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

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

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

ดูเพิ่มเติม:

• reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

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

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

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

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

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

ทางเลือกแทน rebootUserspace() ()} ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น ซึ่งจะมองเห็นได้ใน adb

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

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

remountSystemWritable

public abstract void remountSystemWritable ()

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

remountVendorWritable

public abstract void remountVendorWritable ()

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                Collection<ITestLifeCycleReceiver> listeners)

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

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

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

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

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

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

runInstrumentationTests

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

วิธีที่สะดวกในการดำเนินการ runInstrumentationTests(IRemoteAndroidTestRunner,Collection) โดยมีผู้ฟังอย่างน้อย 1 คนส่งเป็นพารามิเตอร์

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

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

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

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                Collection<ITestLifeCycleReceiver> listeners)

เหมือนกับ ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection) แต่ เรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ

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

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

runInstrumentationTestsAsUser

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

เหมือนกับ ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,ITestLifeCycleReceiver...) แต่จะเรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ

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

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

setDate

public abstract void setDate (Date date)

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

หมายเหตุ: การตั้งค่าวันที่ในอุปกรณ์ต้องใช้สิทธิ์รูท

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setOptions

public abstract void setOptions (TestDeviceOptions options)

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

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

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

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

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

การคืนสินค้า
boolean	จะแสดง True หากคำสั่ง setprop สำเร็จ หรือ False หากไม่สำเร็จ

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

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

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

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

พารามิเตอร์
useFastbootErase	boolean: true หากควรใช้ fastboot erase หรือ false หากควรใช้ fastboot format

ดูเพิ่มเติม:

• fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

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

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

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

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

startTradeInModeTesting

public abstract boolean startTradeInModeTesting (int timeoutMs)

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

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

การคืนสินค้า
boolean	เป็นจริงหากสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

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

stopLogcat

public abstract void stopLogcat ()

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

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

stopTradeInModeTesting

public abstract void stopTradeInModeTesting ()

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchToAdbTcp

public abstract String switchToAdbTcp ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

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

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

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

การคืนสินค้า
boolean	true หากซิงค์ไฟล์สำเร็จ false หรือไม่เช่นนั้น

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

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

public abstract boolean unlockDevice ()

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

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

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

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

unmountDebugfs

public abstract void unmountDebugfs ()

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

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

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

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

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

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

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

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

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

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

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

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

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

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

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

การคืนสินค้า
boolean	true หากอุปกรณ์บูตเข้าสู่การกู้คืนก่อนเวลาหมด false มิฉะนั้น

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "adb sideload"

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

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

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

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

การคืนสินค้า
boolean	true หากอุปกรณ์ไม่พร้อมใช้งานก่อนเวลาหมดอายุ false มิฉะนั้น

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

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

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

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

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

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

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

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

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

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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

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

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