ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

StubDevice

public class StubDevice
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.StubDevice

คลาสย่อยโดยตรงที่ทราบ

DeviceManager.FastbootDevice, NullDevice, RemoteAvdIDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice

DeviceManager.FastbootDevice	การแสดงอุปกรณ์ใน Fastboot Mode
NullDevice	ตัวยึดตําแหน่ง `IDevice` ที่ `DeviceManager` ใช้ในการจัดสรรเมื่อ `IDeviceSelection.nullDeviceRequested()` เป็น `true`
RemoteAvdIDevice	ตัวยึดตําแหน่ง `IDevice` ที่ `DeviceManager` ใช้ในการจัดสรรเมื่อ `DeviceSelectionOptions.gceDeviceRequested()` เป็น `true`
StubLocalAndroidVirtualDevice	ตัวยึดตําแหน่ง `IDevice` ที่ `DeviceManager` ใช้ในการจัดสรรเมื่อ `DeviceSelectionOptions.localVirtualDeviceRequested()` เป็น `true`
VmRemoteDevice	อุปกรณ์เสมือนระยะไกลที่เราจะจัดการจากภายในเครื่องเสมือน

การใช้งานตัวยึดตำแหน่ง Stub ของ IDevice

สรุป

เครื่องมือสร้างสาธารณะ
`StubDevice(String serial)`
`StubDevice(String serial, boolean isEmulator)`

เมธอดสาธารณะ
`boolean`	`arePropertiesSet()` แสดง `true` หากมีการแคชพร็อพเพอร์ตี้
`void`	`createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` สร้างการเปลี่ยนเส้นทางพอร์ระหว่างพอร์ต TCP ในเครื่องกับซ็อกเก็ตโดเมน Unix ระยะไกล
`void`	`createForward(int localPort, int remotePort)` สร้างการส่งต่อพอร์ระหว่างพอร์ตในเครื่องกับพอร์ตระยะไกล
`void`	`createReverse(int remotePort, int localPort)` สร้างการย้อนกลับพอร์ระหว่างพอร์ตระยะไกลกับพอร์ตภายใน
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` เรียกใช้คำสั่งเชลล์ในอุปกรณ์และส่งผลลัพธ์ไปยัง `receiver`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` เรียกใช้คำสั่งเชลล์ในอุปกรณ์ และส่งผลลัพธ์ไปยัง `receiver` ซึ่งคล้ายกับการเรียกใช้ `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)` เลิกใช้เมธอดนี้แล้ว ใช้ `executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` เรียกใช้คำสั่งเชลล์ในอุปกรณ์และส่งผลลัพธ์ไปยัง `receiver`
	`getAbis()` แสดง ABI ที่อุปกรณ์นี้รองรับ
`String`	`getAvdName()` แสดงผลชื่อของ AVD ที่โปรแกรมจำลองกำลังทำงานอยู่
`String`	`getAvdPath()` แสดงผลเส้นทางสัมบูรณ์ไปยังอุปกรณ์เสมือนในระบบไฟล์
	`getBattery(long freshnessTime, TimeUnit timeUnit)` แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์
	`getBattery()` แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์
`Integer`	`getBatteryLevel(long freshnessMs)` เลิกใช้เมธอดนี้แล้ว โปรดใช้ `getBattery(long, TimeUnit)` แทน
`Integer`	`getBatteryLevel()` เลิกใช้เมธอดนี้แล้ว โปรดใช้ `getBattery()` แทน
`Client`	`getClient(String applicationName)` แสดง `Client` ตามชื่อแอปพลิเคชัน
`String`	`getClientName(int pid)` แสดงผลชื่อไคลเอ็นต์ตาม pid หรือ `null` หากไม่ทราบ pid
`Client[]`	`getClients()` แสดงผลอาร์เรย์ของไคลเอ็นต์
`int`	`getDensity()` แสดงผลที่เก็บความหนาแน่นของหน้าจออุปกรณ์โดยอ่านค่าสำหรับพร็อพเพอร์ตี้ของระบบ `PROP_DEVICE_DENSITY`
`FileListingService`	`getFileListingService()` แสดง `FileListingService` สำหรับอุปกรณ์นี้
`String`	`getLanguage()` แสดงผลภาษาของผู้ใช้
`String`	`getMountPoint(String name)` แสดงผลจุดต่อเชื่อม
`String`	`getName()` แสดงชื่อ (ที่อ่านง่าย) ของอุปกรณ์นี้
	`getProperties()` เลิกใช้เมธอดนี้แล้ว โปรดใช้ `getSystemProperty(String)` แทน
`String`	`getProperty(String name)` เมธอดอำนวยความสะดวกที่พยายามดึงข้อมูลพร็อพเพอร์ตี้ผ่าน `IShellEnabledDevice.getSystemProperty(String)` โดยมีเวลารอที่สั้นมาก และไม่สนใจข้อยกเว้น
`String`	`getPropertyCacheOrSync(String name)` เลิกใช้เมธอดนี้แล้ว โปรดใช้ `getProperty(String)` แทน
`int`	`getPropertyCount()` เลิกใช้เมธอดนี้แล้ว เลิกใช้งานใน ddmlib โดยมีเหตุผลเป็น "รายละเอียดการติดตั้งใช้งาน"
`String`	`getPropertySync(String name)` เลิกใช้เมธอดนี้แล้ว โปรดใช้ `getProperty(String)` แทน
`String`	`getRegion()` แสดงผลภูมิภาคของผู้ใช้
`RawImage`	`getScreenshot()` ถ่ายภาพหน้าจอของอุปกรณ์และส่งกลับเป็น `RawImage`
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` แสดงหมายเลขซีเรียลของอุปกรณ์
`IDevice.DeviceState`	`getState()` แสดงสถานะของอุปกรณ์
`SyncService`	`getSyncService()` แสดงออบเจ็กต์ `SyncService` เพื่อพุช / ดึงไฟล์ไปยังและจากอุปกรณ์
`ListenableFuture<String>`	`getSystemProperty(String name)` ทำการค้นหาแบบอะซิงโครนัสที่เป็นไปได้สำหรับพร็อพเพอร์ตี้ของระบบ
`boolean`	`hasClients()` แสดงผลว่า `IDevice` มี `Client` หรือไม่
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์
`void`	`installPackages( apkFilePaths, boolean reinstall, extraArgs, long timeOutInMs, TimeUnit timeunit)` ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลัก 1 รายการและแพ็กเกจแยก 0..n รายการ)
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` ติดตั้งแพ็กเกจแอปพลิเคชันที่พุชไปยังตำแหน่งชั่วคราวในอุปกรณ์
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)` ติดตั้งแพ็กเกจแอปพลิเคชันที่พุชไปยังตำแหน่งชั่วคราวในอุปกรณ์
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` ติดตั้งแพ็กเกจแอปพลิเคชันที่พุชไปยังตำแหน่งชั่วคราวในอุปกรณ์
`boolean`	`isBootLoader()` แสดงว่าอุปกรณ์อยู่ในโหมด Bootloader หรือไม่
`boolean`	`isEmulator()` แสดง `true` หากอุปกรณ์เป็นโปรแกรมจำลอง
`boolean`	`isOffline()` แสดงว่าอุปกรณ์ออฟไลน์หรือไม่
`boolean`	`isOnline()` แสดงว่าอุปกรณ์พร้อมหรือไม่
`boolean`	`isRoot()` ค้นหาสถานะรูทปัจจุบันของอุปกรณ์
`void`	`pullFile(String remote, String local)` ดึงไฟล์เดียว
`void`	`pushFile(String local, String remote)` ส่งไฟล์เดียว
`void`	`reboot(String into)` รีบูตอุปกรณ์
`void`	`removeForward(int localPort)` นำการส่งต่อพอร์ตระหว่างพอร์ตในเครื่องและพอร์ตระยะไกลออก
`void`	`removeForward(int localPort, int remotePort)`
`void`	`removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`void`	`removeRemotePackage(String remoteFilePath)` นำไฟล์ออกจากอุปกรณ์
`void`	`removeReverse(int remotePort)` นำการสลับพอร์ตระหว่างพอร์ตระยะไกลและพอร์ตภายในออก
`boolean`	`root()` ขอให้ daemon ของ adb กลายเป็นรูทในอุปกรณ์
`void`	`setSerial(String serial)`
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` เริ่มการบันทึกหน้าจอบนอุปกรณ์หากอุปกรณ์รองรับ `IDevice.Feature.SCREEN_RECORD`
`boolean`	`supportsFeature(IDevice.HardwareFeature arg0)` แสดงว่าอุปกรณ์นี้รองรับฟีเจอร์ฮาร์ดแวร์ที่ระบุหรือไม่
`boolean`	`supportsFeature(IDevice.Feature feature)` แสดงว่าอุปกรณ์นี้รองรับฟีเจอร์ซอฟต์แวร์ที่ระบุหรือไม่
`String`	`syncPackageToDevice(String localFilePath)` ส่งไฟล์ไปยังอุปกรณ์
`String`	`uninstallApp(String applicationID, String... extraArgs)` ถอนการติดตั้งแอปจากอุปกรณ์
`String`	`uninstallPackage(String packageName)` ถอนการติดตั้งแพ็กเกจจากอุปกรณ์

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

StubDevice

public StubDevice (String serial)

พารามิเตอร์
`serial`	`String`

StubDevice

public StubDevice (String serial, 
                boolean isEmulator)

พารามิเตอร์
`serial`	`String`
`isEmulator`	`boolean`

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

arePropertiesSet

public boolean arePropertiesSet ()

แสดง true หากมีการแคชพร็อพเพอร์ตี้

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

createForward

public void createForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

สร้างการเปลี่ยนเส้นทางพอร์ระหว่างพอร์ต TCP ในเครื่องกับซ็อกเก็ตโดเมน Unix ระยะไกล

พารามิเตอร์
`localPort`	`int`: พอร์ตในเครื่องที่จะส่งต่อ
`remoteSocketName`	`String`: ชื่อของ Unix Domain Socket ที่สร้างในอุปกรณ์
`namespace`	`IDevice.DeviceUnixSocketNamespace`: เนมสเปซที่สร้าง Unix Domain Socket

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

createForward

public void createForward (int localPort, 
                int remotePort)

สร้างการส่งต่อพอร์ระหว่างพอร์ตในเครื่องกับพอร์ตระยะไกล

พารามิเตอร์
`localPort`	`int`: พอร์ตในเครื่องที่จะส่งต่อ
`remotePort`	`int`: พอร์ตระยะไกล

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

createReverse

public void createReverse (int remotePort, 
                int localPort)

สร้างการย้อนกลับพอร์ระหว่างพอร์ตระยะไกลกับพอร์ตภายใน

พารามิเตอร์
`remotePort`	`int`: พอร์ตระยะไกลที่จะย้อนกลับ
`localPort`	`int`: พอร์ตในเครื่อง

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

เรียกใช้คำสั่งเชลล์ในอุปกรณ์และส่งผลลัพธ์ไปยัง receiver

maxTimeToOutputResponse ใช้เป็นเวลาสูงสุดที่รอเมื่อคาดหวังเอาต์พุตคำสั่ง จากอุปกรณ์
หากคำสั่งเชลล์ไม่แสดงผลใดๆ เป็นระยะเวลานานกว่า maxTimeToOutputResponse วิธีการจะส่ง ShellCommandUnresponsiveException

สำหรับคำสั่งต่างๆ เช่น เอาต์พุตบันทึก ควรใช้maxTimeToOutputResponseที่มีค่าเป็น 0 ซึ่งหมายความว่าเมธอดจะไม่แสดงข้อผิดพลาดและจะบล็อกจนกว่า IShellOutputReceiver.isCancelled() ของตัวรับจะแสดงผล true

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

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

เรียกใช้คำสั่งเชลล์ในอุปกรณ์ และส่งผลลัพธ์ไปยัง receiver

ซึ่งคล้ายกับการเรียกใช้ executeShellCommand(command, receiver, DdmPreferences.getTimeOut())

พารามิเตอร์
`command`	`String`: คำสั่งเชลล์ที่จะดำเนินการ
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` ที่จะรับเอาต์พุตของคำสั่งเชลล์

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                int maxTimeToOutputResponse)

เลิกใช้เมธอดนี้แล้ว
ใช้ executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)

พารามิเตอร์
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

เรียกใช้คำสั่งเชลล์ในอุปกรณ์และส่งผลลัพธ์ไปยัง receiver

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

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getAbis

public  getAbis ()

แสดง ABI ที่อุปกรณ์นี้รองรับ ระบบจะจัดเรียง ABI ตามลำดับที่ต้องการ โดย ABI แรกจะเป็น ABI ที่ต้องการมากที่สุด

คิกรีเทิร์น
	รายการ ABI

getAvdName

public String getAvdName ()

แสดงผลชื่อของ AVD ที่โปรแกรมจำลองกำลังทำงานอยู่

ค่านี้จะใช้ได้ก็ต่อเมื่อ isEmulator() แสดงผลเป็น "จริง"

หากโปรแกรมจำลองไม่ได้เรียกใช้ AVD ใดๆ (เช่น เรียกใช้จากบิลด์ของโครงสร้างแหล่งที่มาของ Android ) เมธอดนี้จะแสดงผล "<build>"

หมายเหตุ: ขอแนะนำให้ใช้ getAvdData() หากต้องการควบคุมการหมดเวลา

คิกรีเทิร์น
`String`	ชื่อของ AVD หรือ `null` หากไม่มี

getAvdPath

public String getAvdPath ()

แสดงผลเส้นทางสัมบูรณ์ไปยังอุปกรณ์เสมือนในระบบไฟล์ เส้นทางจะขึ้นอยู่กับระบบปฏิบัติการ โดยจะมีตัวคั่นชื่อเป็น / ใน Linux และตัวคั่นเป็น \ ใน Windows

หมายเหตุ: ขอแนะนำให้ใช้ getAvdData() หากต้องการควบคุมการหมดเวลา

คิกรีเทิร์น
`String`	เส้นทาง AVD หรือ null หากเป็นอุปกรณ์จริง, คำสั่งย่อยของคอนโซลโปรแกรมจำลอง ล้มเหลว หรือโปรแกรมจำลองมีเวอร์ชันเก่ากว่า 30.0.18

getBattery

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์

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

พารามิเตอร์
`freshnessTime`	`long`: ความใหม่ของระดับแบตเตอรี่ที่ต้องการ
`timeUnit`	`TimeUnit`: `ERROR(/TimeUnit)` ของเวลาความใหม่

คิกรีเทิร์น
	`ERROR(/Future)` ที่ใช้เพื่อค้นหาระดับแบตเตอรี่ได้ Future จะแสดงผล `ERROR(/ExecutionException)` หากดึงข้อมูลระดับแบตเตอรี่ไม่ได้

getBattery

public  getBattery ()

แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์

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

คิกรีเทิร์น
	`ERROR(/Future)` ที่ใช้เพื่อค้นหาระดับแบตเตอรี่ได้ Future จะแสดงผล `ERROR(/ExecutionException)` หากดึงข้อมูลระดับแบตเตอรี่ไม่ได้

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

เลิกใช้เมธอดนี้แล้ว
โปรดใช้ getBattery(long, TimeUnit) แทน

แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์

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

คิกรีเทิร์น
`Integer`	ระดับแบตเตอรี่หรือ `null` หากดึงข้อมูลไม่ได้

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getBatteryLevel

public Integer getBatteryLevel ()

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

แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์

คิกรีเทิร์น
`Integer`	ระดับแบตเตอรี่หรือ `null` หากดึงข้อมูลไม่ได้

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getClient

public Client getClient (String applicationName)

แสดง Client ตามชื่อแอปพลิเคชัน

พารามิเตอร์
`applicationName`	`String`: ชื่อแอปพลิเคชัน

คิกรีเทิร์น
`Client`	ออบเจ็กต์ `Client` หรือ `null` หากไม่พบรายการที่ตรงกัน

getClientName

public String getClientName (int pid)

แสดงผลชื่อไคลเอ็นต์ตาม pid หรือ null หากไม่ทราบ pid

พารามิเตอร์
`pid`	`int`: pid ของไคลเอ็นต์

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

getClients

public Client[] getClients ()

แสดงผลอาร์เรย์ของไคลเอ็นต์

คิกรีเทิร์น
`Client[]`

getDensity

public int getDensity ()

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

คิกรีเทิร์น
`int`	ความหนาแน่น หรือ -1 หากระบุไม่ได้

getFileListingService

public FileListingService getFileListingService ()

แสดง FileListingService สำหรับอุปกรณ์นี้

คิกรีเทิร์น
`FileListingService`

getLanguage

public String getLanguage ()

แสดงผลภาษาของผู้ใช้

คิกรีเทิร์น
`String`	ภาษาของผู้ใช้ หรือ null หากไม่ทราบ

getMountPoint

public String getMountPoint (String name)

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

พารามิเตอร์
`name`	`String`: ชื่อของจุดต่อเชื่อมที่จะแสดง

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

getName

public String getName ()

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

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

getProperties

public  getProperties ()

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

แสดงพร็อพเพอร์ตี้ของอุปกรณ์ที่แคชไว้ ซึ่งมีเอาต์พุตทั้งหมดของ "getprop"

คิกรีเทิร์น

getProperty

public String getProperty (String name)

เมธอดอำนวยความสะดวกที่พยายามดึงข้อมูลพร็อพเพอร์ตี้ผ่าน IShellEnabledDevice.getSystemProperty(String) โดยมีเวลารอที่สั้นมาก และไม่สนใจข้อยกเว้น

หมายเหตุ: เราขอแนะนำให้ใช้ IShellEnabledDevice.getSystemProperty(String) หากต้องการควบคุม การหมดเวลา

พารามิเตอร์
`name`	`String`: ชื่อของค่าที่จะแสดง

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

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

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

ชุดค่าผสมของ getProperty(String) และ getPropertySync(String) ที่จะ พยายามดึงข้อมูลพร็อพเพอร์ตี้จากแคช หากไม่พบ จะพยายาม ค้นหาอุปกรณ์โดยตรงพร้อมกันและสร้างแคชใหม่หากสำเร็จ

พารามิเตอร์
`name`	`String`: ชื่อของค่าที่จะแสดง

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

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getPropertyCount

public int getPropertyCount ()

เลิกใช้เมธอดนี้แล้ว
เลิกใช้งานใน ddmlib โดยมีเหตุผลเป็น "รายละเอียดการใช้งาน"

แสดงผลจำนวนพร็อพเพอร์ตี้สำหรับอุปกรณ์นี้

คิกรีเทิร์น
`int`

getPropertySync

public String getPropertySync (String name)

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

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

พารามิเตอร์
`name`	`String`: ชื่อของค่าที่จะแสดง

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

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getRegion

public String getRegion ()

แสดงผลภูมิภาคของผู้ใช้

คิกรีเทิร์น
`String`	ภูมิภาคของผู้ใช้ หรือ null หากไม่ทราบ

getScreenshot

public RawImage getScreenshot ()

ถ่ายภาพหน้าจอของอุปกรณ์และส่งกลับเป็น RawImage

คิกรีเทิร์น
`RawImage`	ภาพหน้าจอเป็น `RawImage` หรือ `null` หากเกิดข้อผิดพลาด ขึ้น

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

พารามิเตอร์
`timeout`	`long`
`unit`	`TimeUnit`

คิกรีเทิร์น
`RawImage`

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

แสดงหมายเลขซีเรียลของอุปกรณ์

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

getState

public IDevice.DeviceState getState ()

แสดงสถานะของอุปกรณ์

คิกรีเทิร์น
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

แสดงออบเจ็กต์ SyncService เพื่อพุช / ดึงไฟล์ไปยังและจากอุปกรณ์

คิกรีเทิร์น
`SyncService`	`null` หากสร้าง SyncService ไม่ได้ กรณีนี้อาจเกิดขึ้นหาก adb ปฏิเสธที่จะเปิดการเชื่อมต่อเนื่องจาก `IDevice` ไม่ถูกต้อง (หรือถูก ยกเลิกการเชื่อมต่อ)

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

ทำการค้นหาแบบอะซิงโครนัสที่เป็นไปได้สำหรับพร็อพเพอร์ตี้ของระบบ

พารามิเตอร์
`name`	`String`: ชื่อของค่าที่จะแสดง

คิกรีเทิร์น
`ListenableFuture<String>`	`ListenableFuture.` `ERROR(get/Future#get() get)` อาจแสดงผลเป็น null

hasClients

public boolean hasClients ()

แสดงผลว่า IDevice มี Client หรือไม่

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

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์ นี่คือเมธอดตัวช่วยที่รวมขั้นตอน syncPackageToDevice, installRemotePackage และ removePackage

พารามิเตอร์
`packageFilePath`	`String`: เส้นทางระบบไฟล์สัมบูรณ์ไปยังไฟล์ในโฮสต์ภายในที่จะติดตั้ง
`reinstall`	`boolean`: ตั้งค่าเป็น `true` หากควรติดตั้งแอปอีกครั้ง
`receiver`	`InstallReceiver`: `InstallReceiver`ที่จะใช้ตรวจสอบการติดตั้งและรับสถานะสุดท้าย
`maxTimeout`	`long`: ระยะหมดเวลาสูงสุดสำหรับคำสั่งที่จะส่งคืน ค่า 0 หมายความว่าจะไม่มีการใช้การหมดเวลาสูงสุด
`maxTimeToOutputResponse`	`long`: ระยะเวลาสูงสุดที่อนุญาตให้คำสั่งไม่ต้องแสดงเอาต์พุตใดๆ ค่า 0 หมายความว่าเมธอดจะรอต่อไปเรื่อยๆ (จนกว่า `receiver` จะยกเลิกการดำเนินการ) สำหรับเอาต์พุตคำสั่งและจะไม่เกิดข้อผิดพลาด
`maxTimeUnits`	`TimeUnit`: หน่วยสำหรับค่าที่ไม่ใช่ 0 ของ `maxTimeout` และ `maxTimeToOutputResponse`
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

การขว้าง
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

พารามิเตอร์
`packageFilePath`	`String`: เส้นทางระบบไฟล์สัมบูรณ์ไปยังไฟล์ในโฮสต์ภายในที่จะติดตั้ง
`reinstall`	`boolean`: ตั้งค่าเป็น `true` หากควรติดตั้งแอปอีกครั้ง
`receiver`	`InstallReceiver`: `InstallReceiver`ที่จะใช้ตรวจสอบการติดตั้งและรับสถานะสุดท้าย
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

การขว้าง
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                String... extraArgs)

พารามิเตอร์
`packageFilePath`	`String`: เส้นทางระบบไฟล์สัมบูรณ์ไปยังไฟล์ในโฮสต์ภายในที่จะติดตั้ง
`reinstall`	`boolean`: ตั้งค่าเป็น `true` หากควรติดตั้งแอปอีกครั้ง
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

การขว้าง
`InstallException`

installPackages

public void installPackages ( apkFilePaths, 
                boolean reinstall, 
                 extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลัก 1 รายการและแพ็กเกจแยก 0..n รายการ)

พารามิเตอร์
`apkFilePaths`	: รายการ APK ที่จะติดตั้ง (APK หลัก 1 รายการ + APK แยก 0..n รายการ)
`reinstall`	`boolean`: ตั้งค่าเป็น `true` หากควรติดตั้งแอปอีกครั้ง
`extraArgs`	: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"
`timeOutInMs`	`long`: หมดเวลาการติดตั้ง
`timeunit`	`TimeUnit`: `ERROR(/TimeUnit)` ที่สอดคล้องกับพารามิเตอร์การหมดเวลา

การขว้าง
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

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

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ไปยังไฟล์แพ็กเกจในอุปกรณ์
`reinstall`	`boolean`: ตั้งค่าเป็น `true` หากควรติดตั้งแอปอีกครั้ง
`receiver`	`InstallReceiver`: `InstallReceiver`ที่จะใช้ตรวจสอบการติดตั้งและรับสถานะสุดท้าย
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

การขว้าง
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

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

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ไปยังไฟล์แพ็กเกจในอุปกรณ์
`reinstall`	`boolean`: ตั้งค่าเป็น `true` หากควรติดตั้งแอปอีกครั้ง
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

การขว้าง
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

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

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ไปยังไฟล์แพ็กเกจในอุปกรณ์
`reinstall`	`boolean`: ตั้งค่าเป็น `true` หากควรติดตั้งแอปอีกครั้ง
`receiver`	`InstallReceiver`: `InstallReceiver`ที่จะใช้ตรวจสอบการติดตั้งและรับสถานะสุดท้าย
`maxTimeout`	`long`: ระยะหมดเวลาสูงสุดสำหรับคำสั่งที่จะส่งคืน ค่า 0 หมายความว่าจะไม่มีการใช้การหมดเวลาสูงสุด
`maxTimeToOutputResponse`	`long`: ระยะเวลาสูงสุดที่อนุญาตให้คำสั่งไม่ต้องแสดงเอาต์พุตใดๆ ค่า 0 หมายความว่าเมธอดจะรอต่อไปเรื่อยๆ (จนกว่า `receiver` จะยกเลิกการดำเนินการ) สำหรับเอาต์พุตคำสั่งและจะไม่เกิดข้อผิดพลาด
`maxTimeUnits`	`TimeUnit`: หน่วยสำหรับค่าที่ไม่ใช่ 0 ของ `maxTimeout` และ `maxTimeToOutputResponse`
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

การขว้าง
`InstallException`

isBootLoader

public boolean isBootLoader ()

แสดงว่าอุปกรณ์อยู่ในโหมด Bootloader หรือไม่

คิกรีเทิร์น
`boolean`	`true` หาก `getState()` แสดงผล `DeviceState.BOOTLOADER`

isEmulator

public boolean isEmulator ()

แสดง true หากอุปกรณ์เป็นโปรแกรมจำลอง

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

isOffline

public boolean isOffline ()

แสดงว่าอุปกรณ์ออฟไลน์หรือไม่

คิกรีเทิร์น
`boolean`	`true` หาก `getState()` แสดงผล `DeviceState.OFFLINE`

isOnline

public boolean isOnline ()

แสดงว่าอุปกรณ์พร้อมหรือไม่

คิกรีเทิร์น
`boolean`	`true` หาก `getState()` แสดงผล `DeviceState.ONLINE`

isRoot

public boolean isRoot ()

ค้นหาสถานะรูทปัจจุบันของอุปกรณ์ ดูข้อมูลเพิ่มเติมได้ที่ "adb root"

คิกรีเทิร์น
`boolean`	เป็นจริงหาก daemon ของ adb ทำงานในฐานะรูท มิเช่นนั้นจะเป็นเท็จ

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

pullFile

public void pullFile (String remote, 
                String local)

ดึงไฟล์เดียว

พารามิเตอร์
`remote`	`String`: เส้นทางแบบเต็มไปยังไฟล์ระยะไกล
`local`	`String`: ปลายทางในพื้นที่

การขว้าง
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

ส่งไฟล์เดียว

พารามิเตอร์
`local`	`String`: เส้นทางไฟล์ในเครื่อง
`remote`	`String`: เส้นทางไฟล์ระยะไกล

การขว้าง
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

รีบูต

public void reboot (String into)

รีบูตอุปกรณ์

พารามิเตอร์
`into`	`String`: ชื่อ Bootloader ที่จะรีบูต หรือ null เพื่อรีบูตอุปกรณ์

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

นำการส่งต่อพอร์ตระหว่างพอร์ตในเครื่องและพอร์ตระยะไกลออก

พารามิเตอร์
`localPort`	`int`: พอร์ตในเครื่องที่จะส่งต่อ

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort, 
                int remotePort)

พารามิเตอร์
`localPort`	`int`
`remotePort`	`int`

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

พารามิเตอร์
`localPort`	`int`
`remoteSocketName`	`String`
`namespace`	`IDevice.DeviceUnixSocketNamespace`

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

นำไฟล์ออกจากอุปกรณ์

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางในอุปกรณ์ของไฟล์ที่จะนำออก

การขว้าง
`InstallException`

removeReverse

public void removeReverse (int remotePort)

นำการสลับพอร์ตระหว่างพอร์ตระยะไกลและพอร์ตภายในออก

พารามิเตอร์
`remotePort`	`int`: พอร์ตระยะไกล

การขว้าง
`AdbCommandRejectedException`
`TimeoutException`

รูท

public boolean root ()

ขอให้ daemon ของ adb กลายเป็นรูทในอุปกรณ์ การดำเนินการนี้อาจล้มเหลวโดยไม่มีการแจ้งเตือน และจะสำเร็จได้ ในบิลด์สำหรับนักพัฒนาแอปเท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ "adb root"

คิกรีเทิร์น
`boolean`	เป็นจริงหาก daemon ของ adb ทำงานในฐานะรูท มิเช่นนั้นจะเป็นเท็จ

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

setSerial

public void setSerial (String serial)

พารามิเตอร์
`serial`	`String`

startScreenRecorder

public void startScreenRecorder (String remoteFilePath, 
                ScreenRecorderOptions options, 
                IShellOutputReceiver receiver)

เริ่มการบันทึกหน้าจอบนอุปกรณ์หากอุปกรณ์รองรับ IDevice.Feature.SCREEN_RECORD

พารามิเตอร์
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`
`receiver`	`IShellOutputReceiver`

การขว้าง
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature arg0)

แสดงว่าอุปกรณ์นี้รองรับฟีเจอร์ฮาร์ดแวร์ที่ระบุหรือไม่

พารามิเตอร์
`arg0`	`IDevice.HardwareFeature`

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

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

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

พารามิเตอร์
`feature`	`IDevice.Feature`

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

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

ส่งไฟล์ไปยังอุปกรณ์

พารามิเตอร์
`localFilePath`	`String`: เส้นทางแบบเต็มไปยังไฟล์ในโฮสต์ภายใน

คิกรีเทิร์น
`String`	`String` เส้นทางปลายทางในอุปกรณ์สำหรับไฟล์

การขว้าง
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

uninstallApp

public String uninstallApp (String applicationID, 
                String... extraArgs)

ถอนการติดตั้งแอปจากอุปกรณ์

พารามิเตอร์
`applicationID`	`String`: รหัสแอปพลิเคชัน Android ที่จะถอนการติดตั้ง
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

คิกรีเทิร์น
`String`	`String` พร้อมรหัสข้อผิดพลาด หรือ `null` หากสำเร็จ

การขว้าง
`InstallException`

uninstallPackage

public String uninstallPackage (String packageName)

ถอนการติดตั้งแพ็กเกจจากอุปกรณ์

พารามิเตอร์
`packageName`	`String`: รหัสแอปพลิเคชัน Android ที่จะถอนการติดตั้ง

คิกรีเทิร์น
`String`	`String` พร้อมรหัสข้อผิดพลาด หรือ `null` หากสำเร็จ

การขว้าง
`InstallException`