IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice


อุปกรณ์ ซึ่งอาจเป็นอุปกรณ์จริงหรือโปรแกรมจำลองก็ได้

สรุป

ค่าคงที่

int CHANGE_BUILD_INFO

มาสก์บิตการเปลี่ยนแปลงอุปกรณ์: การเปลี่ยนแปลงข้อมูลเวอร์ชัน

int CHANGE_CLIENT_LIST

บิตมาสก์การเปลี่ยนแปลงอุปกรณ์: Client การเปลี่ยนแปลงรายการ

int CHANGE_PROFILEABLE_CLIENT_LIST

มาสก์บิตการเปลี่ยนแปลงอุปกรณ์: ProfileableClient การเปลี่ยนแปลงรายการ

int CHANGE_STATE

บิตมาสก์การเปลี่ยนแปลงอุปกรณ์: DeviceState change

String FIRST_EMULATOR_SN

หมายเลขซีเรียลของโปรแกรมจำลองที่เชื่อมต่อเครื่องแรก

String MNT_DATA

String MNT_EXTERNAL_STORAGE

String MNT_ROOT

String PROP_BUILD_API_LEVEL

String PROP_BUILD_CHARACTERISTICS

String PROP_BUILD_CODENAME

String PROP_BUILD_TAGS

String PROP_BUILD_TYPE

String PROP_BUILD_VERSION

String PROP_BUILD_VERSION_NUMBER

ค่าคงที่นี้เลิกใช้งานแล้ว ใช้ PROP_BUILD_API_LEVEL

String PROP_DEBUGGABLE

String PROP_DEVICE_CPU_ABI

String PROP_DEVICE_CPU_ABI2

String PROP_DEVICE_CPU_ABI_LIST

String PROP_DEVICE_DENSITY

String PROP_DEVICE_EMULATOR_DENSITY

String PROP_DEVICE_LANGUAGE

String PROP_DEVICE_MANUFACTURER

String PROP_DEVICE_MODEL

String PROP_DEVICE_REGION

String RE_EMULATOR_SN

นิพจน์ทั่วไปของหมายเลขซีเรียลของโปรแกรมจำลอง

String UNKNOWN_PACKAGE

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

abstract boolean arePropertiesSet()

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

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

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

abstract void createForward(int localPort, int remotePort)

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

default void createReverse(int remotePort, int localPort)

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

default void executeBinderCommand(String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)

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

ซึ่งจะใช้การเรียก exec:cmd หรือ abb_exec: ที่เร็วกว่า หากทั้งระบบปฏิบัติการของอุปกรณ์และเซิร์ฟเวอร์ ADB ของโฮสต์ รองรับฟีเจอร์การเรียกใช้ Android Binder Bridge

default void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)

คำสั่ง executeShell เวอร์ชันที่รับสตรีมอินพุตเพื่อส่งผ่าน stdin ได้

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

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

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

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

default void forceStop(String applicationName)

บังคับให้แอปพลิเคชันหยุดทำงานตามชื่อแอปพลิเคชัน

abstract getAbis()

แสดง ABI ที่อุปกรณ์นี้รองรับ

default ListenableFuture<AvdData> getAvdData()

แสดงข้อมูลเกี่ยวกับ AVD ที่โปรแกรมจำลองกำลังเรียกใช้

abstract String getAvdName()

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

abstract String getAvdPath()

แสดงผลเส้นทางสัมบูรณ์ไปยังอุปกรณ์เสมือนในระบบไฟล์

abstract getBattery(long freshnessTime, TimeUnit timeUnit)

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

abstract getBattery()

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

abstract Integer getBatteryLevel(long freshnessMs)

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

abstract Integer getBatteryLevel()

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

abstract Client getClient(String applicationName)

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

abstract String getClientName(int pid)

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

abstract Client[] getClients()

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

abstract int getDensity()

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

abstract FileListingService getFileListingService()

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

default getHardwareCharacteristics()

แสดงฟีเจอร์ที่ได้จากการอ่านพร็อพเพอร์ตี้ลักษณะการสร้าง

abstract String getLanguage()

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

default InstallMetrics getLastInstallMetrics()

รับข้อมูลเกี่ยวกับการติดตั้งล่าสุดในอุปกรณ์นี้

abstract String getMountPoint(String name)

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

default ProfileableClient[] getProfileableClients()

แสดงผลอาร์เรย์ของไคลเอ็นต์ที่สร้างโปรไฟล์ได้

abstract getProperties()

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

abstract String getProperty(String name)

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

abstract String getPropertyCacheOrSync(String name)

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

abstract int getPropertyCount()

เลิกใช้เมธอดนี้แล้ว รายละเอียดการใช้งาน

abstract String getPropertySync(String name)

เลิกใช้เมธอดนี้แล้ว ใช้ IShellEnabledDevice.getSystemProperty(String)

abstract String getRegion()

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

abstract RawImage getScreenshot()

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

abstract RawImage getScreenshot(long timeout, TimeUnit unit)
abstract String getSerialNumber()

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

abstract IDevice.DeviceState getState()

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

abstract SyncService getSyncService()

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

abstract boolean hasClients()

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

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

ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์

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

ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์

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

ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์

default void installPackages( apks, boolean reinstall, installOptions)

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

abstract void installPackages( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)

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

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

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

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

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

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

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

default void installRemotePackages( remoteApks, boolean reinstall, installOptions)

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ซึ่งอยู่ในอุปกรณ์โดยมี การหมดเวลาเริ่มต้น

default void installRemotePackages( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ซึ่งอยู่ในอุปกรณ์

abstract boolean isBootLoader()

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

abstract boolean isEmulator()

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

abstract boolean isOffline()

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

abstract boolean isOnline()

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

abstract boolean isRoot()

ค้นหาสถานะรูทปัจจุบันของอุปกรณ์

default void kill(String applicationName)

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

abstract void pullFile(String remote, String local)

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

default void push(String[] local, String remote)

ส่งไฟล์หรือไดเรกทอรีหลายรายการ

abstract void pushFile(String local, String remote)

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

default SocketChannel rawBinder(String service, String[] parameters)

เรียกใช้บริการ Android Binder Bridge ในอุปกรณ์ระยะไกล

default SocketChannel rawExec(String executable, String[] parameters)

เรียกใช้บริการ host:exec ในอุปกรณ์ระยะไกล

abstract void reboot(String into)

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

default void removeForward(int localPort)

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

default void removeForward(int localPort, int remotePort)

เลิกใช้เมธอดนี้แล้ว ใช้ removeForward(int)

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

เลิกใช้เมธอดนี้แล้ว ใช้ removeForward(int)

abstract void removeRemotePackage(String remoteFilePath)

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

default void removeReverse(int remotePort)

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

abstract boolean root()

ขอให้ daemon ของ adb กลายเป็นรูทในอุปกรณ์

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

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

abstract boolean supportsFeature(IDevice.HardwareFeature feature)

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

abstract boolean supportsFeature(IDevice.Feature feature)

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

abstract String syncPackageToDevice(String localFilePath)

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

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

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

abstract String uninstallPackage(String packageName)

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

ค่าคงที่

CHANGE_BUILD_INFO

public static final int CHANGE_BUILD_INFO

มาสก์บิตการเปลี่ยนแปลงอุปกรณ์: การเปลี่ยนแปลงข้อมูลเวอร์ชัน

ค่าคงที่ 4 (0x00000004)

CHANGE_CLIENT_LIST

public static final int CHANGE_CLIENT_LIST

มาสก์บิตการเปลี่ยนแปลงอุปกรณ์: Client การเปลี่ยนแปลงรายการ

ค่าคงที่ 2 (0x00000002)

CHANGE_PROFILEABLE_CLIENT_LIST

public static final int CHANGE_PROFILEABLE_CLIENT_LIST

มาสก์บิตการเปลี่ยนแปลงอุปกรณ์: ProfileableClient การเปลี่ยนแปลงรายการ

ค่าคงที่ 8 (0x00000008)

CHANGE_STATE

public static final int CHANGE_STATE

บิตมาสก์การเปลี่ยนแปลงอุปกรณ์: DeviceState change

ค่าคงที่ 1 (0x00000001)

FIRST_EMULATOR_SN

public static final String FIRST_EMULATOR_SN

หมายเลขซีเรียลของโปรแกรมจำลองที่เชื่อมต่อเครื่องแรก

ค่าคงที่: "emulator-5554"

MNT_DATA

public static final String MNT_DATA

ค่าคงที่: "ANDROID_DATA"

MNT_EXTERNAL_STORAGE

public static final String MNT_EXTERNAL_STORAGE

ค่าคงที่: "EXTERNAL_STORAGE"

MNT_ROOT

public static final String MNT_ROOT

ค่าคงที่ "ANDROID_ROOT"

PROP_BUILD_API_LEVEL

public static final String PROP_BUILD_API_LEVEL

ค่าคงที่: "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS

public static final String PROP_BUILD_CHARACTERISTICS

ค่าคงที่: "ro.build.characteristics"

PROP_BUILD_CODENAME

public static final String PROP_BUILD_CODENAME

ค่าคงที่ "ro.build.version.codename"

PROP_BUILD_TAGS

public static final String PROP_BUILD_TAGS

ค่าคงที่ "ro.build.tags"

PROP_BUILD_TYPE

public static final String PROP_BUILD_TYPE

ค่าคงที่: "ro.build.type"

PROP_BUILD_VERSION

public static final String PROP_BUILD_VERSION

ค่าคงที่: "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER

public static final String PROP_BUILD_VERSION_NUMBER

ค่าคงที่นี้เลิกใช้งานแล้ว
ใช้ PROP_BUILD_API_LEVEL

ค่าคงที่: "ro.build.version.sdk"

PROP_DEBUGGABLE

public static final String PROP_DEBUGGABLE

ค่าคงที่: "ro.debuggable"

PROP_DEVICE_CPU_ABI

public static final String PROP_DEVICE_CPU_ABI

ค่าคงที่ "ro.product.cpu.abi"

PROP_DEVICE_CPU_ABI2

public static final String PROP_DEVICE_CPU_ABI2

ค่าคงที่: "ro.product.cpu.abi2"

PROP_DEVICE_CPU_ABI_LIST

public static final String PROP_DEVICE_CPU_ABI_LIST

ค่าคงที่: "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY

public static final String PROP_DEVICE_DENSITY

ค่าคงที่: "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY

public static final String PROP_DEVICE_EMULATOR_DENSITY

ค่าคงที่: "qemu.sf.lcd_density"

PROP_DEVICE_LANGUAGE

public static final String PROP_DEVICE_LANGUAGE

ค่าคงที่: "persist.sys.language"

PROP_DEVICE_MANUFACTURER

public static final String PROP_DEVICE_MANUFACTURER

ค่าคงที่: "ro.product.manufacturer"

PROP_DEVICE_MODEL

public static final String PROP_DEVICE_MODEL

ค่าคงที่ "ro.product.model"

PROP_DEVICE_REGION

public static final String PROP_DEVICE_REGION

ค่าคงที่: "persist.sys.country"

RE_EMULATOR_SN

public static final String RE_EMULATOR_SN

นิพจน์ทั่วไปของหมายเลขซีเรียลของโปรแกรมจำลอง

ค่าคงที่ "จำลอง-(\d+)"

UNKNOWN_PACKAGE

public static final String UNKNOWN_PACKAGE

ค่าคงที่: ""

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

arePropertiesSet

public abstract boolean arePropertiesSet ()

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

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

createForward

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

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

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

remoteSocketName String: ชื่อของ Unix Domain Socket ที่สร้างในอุปกรณ์

namespace IDevice.DeviceUnixSocketNamespace: เนมสเปซที่สร้าง Unix Domain Socket

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

createForward

public abstract void createForward (int localPort, 
                int remotePort)

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

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

remotePort int: พอร์ตระยะไกล

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

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

localPort int: พอร์ตในเครื่อง

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

executeBinderCommand

public void executeBinderCommand (String[] parameters, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

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

ซึ่งจะใช้การเรียก exec:cmd หรือ abb_exec: ที่เร็วกว่า หากทั้งระบบปฏิบัติการของอุปกรณ์และเซิร์ฟเวอร์ ADB ของโฮสต์ รองรับฟีเจอร์การเรียกใช้ Android Binder Bridge

พารามิเตอร์
parameters String: คำสั่ง Binder ที่จะดำเนินการ

receiver IShellOutputReceiver: IShellOutputReceiver ที่จะรับเอาต์พุตของคำสั่ง Binder

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream: สตรีมอินพุตที่ไม่บังคับเพื่อส่งผ่าน stdin

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ShellCommandUnresponsiveException ในกรณีที่คำสั่ง Binder ไม่ส่งเอาต์พุตเป็นระยะเวลาหนึ่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

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

executeShellCommand

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

คำสั่ง executeShell เวอร์ชันที่รับสตรีมอินพุตเพื่อส่งผ่าน stdin ได้

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

receiver IShellOutputReceiver

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream

การขว้าง
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

receiver IShellOutputReceiver: IShellOutputReceiver ที่จะรับเอาต์พุตของคำสั่งเชลล์

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ShellCommandUnresponsiveException ในกรณีที่คำสั่งเชลล์ไม่ส่งเอาต์พุตเป็นระยะเวลาหนึ่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

executeShellCommand

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

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

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

receiver IShellOutputReceiver

maxTimeToOutputResponse int

การขว้าง
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

forceStop

public void forceStop (String applicationName)

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

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

getAbis

public abstract  getAbis ()

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

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

getAvdData

public ListenableFuture<AvdData> getAvdData ()

แสดงข้อมูลเกี่ยวกับ AVD ที่โปรแกรมจำลองกำลังเรียกใช้

AvdData.getName คือชื่อของ AVD หรือ null หากไม่มี

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

คิกรีเทิร์น
ListenableFuture<AvdData> AvdData ของอุปกรณ์

getAvdName

public abstract String getAvdName ()

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

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

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

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

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

getAvdPath

public abstract String getAvdPath ()

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

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

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

getBattery

public abstract  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

พารามิเตอร์
freshnessTime long: ความใหม่ของระดับแบตเตอรี่ที่ต้องการ

timeUnit TimeUnit: ERROR(/TimeUnit) ของเวลาความใหม่

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

getBattery

public abstract  getBattery ()

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

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

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

getBatteryLevel

public abstract Integer getBatteryLevel (long freshnessMs)

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

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

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

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

การขว้าง
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract Integer getBatteryLevel ()

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

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

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

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

การขว้าง
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getClient

public abstract Client getClient (String applicationName)

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

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

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

getClientName

public abstract String getClientName (int pid)

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

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

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

getClients

public abstract Client[] getClients ()

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

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

getDensity

public abstract int getDensity ()

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

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

getFileListingService

public abstract FileListingService getFileListingService ()

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

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

getHardwareCharacteristics

public  getHardwareCharacteristics ()

แสดงฟีเจอร์ที่ได้จากการอ่านพร็อพเพอร์ตี้ลักษณะการสร้าง

คิกรีเทิร์น

getLanguage

public abstract String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

รับข้อมูลเกี่ยวกับการติดตั้งล่าสุดในอุปกรณ์นี้

คิกรีเทิร์น
InstallMetrics InstallMetrics เมตริกที่อธิบายการติดตั้ง

getMountPoint

public abstract String getMountPoint (String name)

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

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

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

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

getProfileableClients

public ProfileableClient[] getProfileableClients ()

แสดงผลอาร์เรย์ของไคลเอ็นต์ที่สร้างโปรไฟล์ได้

คิกรีเทิร์น
ProfileableClient[]

getProperties

public abstract  getProperties ()

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

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

คิกรีเทิร์น

getProperty

public abstract String getProperty (String name)

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

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

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

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

getPropertyCacheOrSync

public abstract String getPropertyCacheOrSync (String name)

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

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

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

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

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ShellCommandUnresponsiveException ในกรณีที่คำสั่งเชลล์ไม่ส่งเอาต์พุตเป็นระยะเวลาหนึ่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

getPropertyCount

public abstract int getPropertyCount ()

เลิกใช้เมธอดนี้แล้ว
รายละเอียดการใช้งาน

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

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

getPropertySync

public abstract String getPropertySync (String name)

เลิกใช้เมธอดนี้แล้ว
ใช้ IShellEnabledDevice.getSystemProperty(String)

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

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

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

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ShellCommandUnresponsiveException ในกรณีที่คำสั่งเชลล์ไม่ส่งเอาต์พุตเป็นระยะเวลาหนึ่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

getRegion

public abstract String getRegion ()

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

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

getScreenshot

public abstract RawImage getScreenshot ()

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

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

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

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

unit TimeUnit

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

การขว้าง
AdbCommandRejectedException
TimeoutException

getSerialNumber

public abstract String getSerialNumber ()

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

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

getState

public abstract IDevice.DeviceState getState ()

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

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

getSyncService

public abstract SyncService getSyncService ()

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

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

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
หากเชื่อมต่อกับ adb ไม่สำเร็จ

hasClients

public abstract boolean hasClients ()

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

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

installPackage

public abstract 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 abstract void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

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

พารามิเตอร์
packageFilePath String: เส้นทางระบบไฟล์สัมบูรณ์ไปยังไฟล์ในโฮสต์ภายในที่จะติดตั้ง

reinstall boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง

receiver InstallReceiver: InstallReceiverที่จะใช้ตรวจสอบการติดตั้งและรับสถานะสุดท้าย

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

การขว้าง
InstallException หากการติดตั้งไม่สำเร็จ

installPackage

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

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

พารามิเตอร์
packageFilePath String: เส้นทางระบบไฟล์สัมบูรณ์ไปยังไฟล์ในโฮสต์ภายในที่จะติดตั้ง

reinstall boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง

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

การขว้าง
InstallException หากการติดตั้งไม่สำเร็จ

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions)

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

พารามิเตอร์
apks : รายการ APK ที่จะติดตั้ง (APK หลัก 1 รายการ + APK แยก 0..n รายการ)

reinstall boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง

installOptions : อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

การขว้าง
InstallException หากการติดตั้งไม่สำเร็จ

installPackages

public abstract void installPackages ( apks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

พารามิเตอร์
apks : รายการ APK ที่จะติดตั้ง (APK หลัก 1 รายการ + APK แยก 0..n รายการ)

reinstall boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง

installOptions : อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

timeout long: หมดเวลาการติดตั้ง

timeoutUnit TimeUnit: ERROR(/TimeUnit) ที่สอดคล้องกับพารามิเตอร์การหมดเวลา

การขว้าง
InstallException หากการติดตั้งไม่สำเร็จ

installRemotePackage

public abstract 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 abstract void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

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

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

reinstall boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง

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

การขว้าง
InstallException หากการติดตั้งไม่สำเร็จ

installRemotePackage

public abstract 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 หากการติดตั้งไม่สำเร็จ

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions)

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ซึ่งอยู่ในอุปกรณ์โดยมี การหมดเวลาเริ่มต้น

พารามิเตอร์
remoteApks : รายการเส้นทางไฟล์ APK ในอุปกรณ์ที่จะติดตั้ง

reinstall boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง

installOptions : อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

การขว้าง
InstallException หากการติดตั้งไม่สำเร็จ

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ซึ่งอยู่ในอุปกรณ์

พารามิเตอร์
remoteApks : รายการเส้นทางไฟล์ APK ที่อยู่ในอุปกรณ์เพื่อติดตั้ง

reinstall boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง

installOptions : อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help"

timeout long: หมดเวลาการติดตั้ง

timeoutUnit TimeUnit: ERROR(/TimeUnit) ที่สอดคล้องกับพารามิเตอร์การหมดเวลา

การขว้าง
InstallException หากการติดตั้งไม่สำเร็จ

isBootLoader

public abstract boolean isBootLoader ()

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

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

isEmulator

public abstract boolean isEmulator ()

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

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

isOffline

public abstract boolean isOffline ()

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

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

isOnline

public abstract boolean isOnline ()

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

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

isRoot

public abstract boolean isRoot ()

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

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

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ShellCommandUnresponsiveException

ปิด

public void kill (String applicationName)

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

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

pullFile

public abstract void pullFile (String remote, 
                String local)

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

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

local String: ปลายทางในพื้นที่

การขว้าง
ในกรณีที่เกิดข้อยกเว้น IO
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
TimeoutException ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่ทัน
SyncException ในกรณีที่เกิดข้อยกเว้นในการซิงค์

กด

public void push (String[] local, 
                String remote)

ส่งไฟล์หรือไดเรกทอรีหลายรายการ

พารามิเตอร์
local String: ไฟล์ในเครื่องที่จะพุช

remote String: เส้นทางระยะไกลที่แสดงถึงไดเรกทอรี

การขว้าง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
TimeoutException ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่สำเร็จเนื่องจากหมดเวลา
SyncException หากพุชบางไฟล์ไม่ได้

pushFile

public abstract void pushFile (String local, 
                String remote)

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

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

remote String: เส้นทางไฟล์ระยะไกล

การขว้าง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
TimeoutException ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่สำเร็จเนื่องจากหมดเวลา
SyncException หากพุชไฟล์ไม่ได้

rawBinder

public SocketChannel rawBinder (String service, 
                String[] parameters)

เรียกใช้บริการ Android Binder Bridge ในอุปกรณ์ระยะไกล แสดงช่องซ็อกเก็ตที่เชื่อมต่อกับคำสั่งตัวเชื่อมอุปกรณ์

การเป็นเจ้าของ SocketChannel จะส่งต่อให้ผู้เรียกใช้ และต้องปิดอย่างชัดแจ้ง หลังจากใช้งาน

พารามิเตอร์
service String: ชื่อของบริการ Android ที่จะเชื่อมต่อ

parameters String: พารามิเตอร์ของคำสั่ง Binder

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

การขว้าง
AdbCommandRejectedException
TimeoutException

rawExec

public SocketChannel rawExec (String executable, 
                String[] parameters)

เรียกใช้บริการ host:exec ในอุปกรณ์ระยะไกล แสดงผลแชแนลซ็อกเก็ตที่เชื่อมต่อกับ กระบวนการที่กำลังดำเนินการ โปรดทราบว่าบริการ exec ไม่ได้แยกความแตกต่างระหว่าง stdout และ stderr ดังนั้น สิ่งที่อ่านจากซ็อกเก็ตอาจมาจากเอาต์พุตใดก็ได้และอาจมีการสลับกัน

การเป็นเจ้าของ SocketChannel จะส่งต่อให้ผู้เรียกใช้ และต้องปิดอย่างชัดแจ้ง หลังจากใช้งาน

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

parameters String

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

การขว้าง
AdbCommandRejectedException
TimeoutException

รีบูต

public abstract void reboot (String into)

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

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

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
IOException

removeForward

public void removeForward (int localPort)

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

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

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

removeForward

public void removeForward (int localPort, 
                int remotePort)

เลิกใช้เมธอดนี้แล้ว
ใช้ removeForward(int)

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

remotePort int

การขว้าง
AdbCommandRejectedException
TimeoutException

removeForward

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

เลิกใช้เมธอดนี้แล้ว
ใช้ removeForward(int)

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

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

การขว้าง
AdbCommandRejectedException
TimeoutException

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

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

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

การขว้าง
InstallException หากการติดตั้งไม่สำเร็จ

removeReverse

public void removeReverse (int remotePort)

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

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

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

รูท

public abstract boolean root ()

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

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

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ShellCommandUnresponsiveException หากค้นหาสถานะรูทไม่ได้
IOException

startScreenRecorder

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

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

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

options ScreenRecorderOptions

receiver IShellOutputReceiver

การขว้าง
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

supportsFeature

public abstract boolean supportsFeature (IDevice.HardwareFeature feature)

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

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

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

supportsFeature

public abstract boolean supportsFeature (IDevice.Feature feature)

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

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

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

syncPackageToDevice

public abstract String syncPackageToDevice (String localFilePath)

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

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

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

การขว้าง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ
SyncException หากเกิดข้อผิดพลาดระหว่างการพุชแพ็กเกจในอุปกรณ์

uninstallApp

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

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

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

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

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

การขว้าง
InstallException หากถอนการติดตั้งไม่สำเร็จ

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

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

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

การขว้าง
InstallException หากถอนการติดตั้งไม่สำเร็จ