IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

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

สรุป

ค่าคงที่

int CHANGE_BUILD_INFO

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

int CHANGE_STATE

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

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 call หรือ abb_exec: ที่เร็วกว่า หากทั้งระบบปฏิบัติการของอุปกรณ์และเซิร์ฟเวอร์ ADB ของโฮสต์ รองรับฟีเจอร์การเรียกใช้ Android Binder Bridge

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

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

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

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

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

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

default void forceStop(String applicationName)

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

abstract List<String> getAbis()

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

default ListenableFuture<AvdData> getAvdData()

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

abstract String getAvdName()

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

abstract String getAvdPath()

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

abstract Future<Integer> getBattery(long freshnessTime, TimeUnit timeUnit)

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

abstract Future<Integer> getBattery()

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

abstract Integer getBatteryLevel(long freshnessMs)

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

abstract Integer getBatteryLevel()

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

abstract int getDensity()

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

abstract FileListingService getFileListingService()

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

default Set<String> getHardwareCharacteristics()

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

abstract String getLanguage()

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

default InstallMetrics getLastInstallMetrics()

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

abstract String getMountPoint(String name)

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

abstract Map<String, String> getProperties()

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

abstract String getProperty(String name)

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

abstract String getPropertyCacheOrSync(String name)

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

abstract int getPropertyCount()

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

abstract String getPropertySync(String name)

เลิกใช้เมธอดนี้แล้ว ใช้ 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 void installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)

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

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, String... extraArgs)

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

abstract void installPackages(List<File> apks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)

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

default void installPackages(List<File> apks, boolean reinstall, List<String> installOptions)

ติดตั้งแอปพลิเคชัน 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(List<String> remoteApks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)

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

default void installRemotePackages(List<String> remoteApks, boolean reinstall, List<String> installOptions)

ติดตั้งแอปพลิเคชัน 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)

เริ่มการบันทึกหน้าจอบนอุปกรณ์หากอุปกรณ์รองรับ 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_STATE

public static final int CHANGE_STATE

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

ค่าคงที่ 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
ส่ง
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
IOException ในกรณีที่เกิดข้อผิดพลาดเกี่ยวกับ I/O ในการเชื่อมต่อ

createForward

public abstract void createForward (int localPort, 
                int remotePort)

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

พารามิเตอร์
localPort int: พอร์ตในเครื่องที่จะส่งต่อ
remotePort int: พอร์ตระยะไกล
ส่ง
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
IOException ในกรณีที่เกิดข้อผิดพลาดเกี่ยวกับ I/O ในการเชื่อมต่อ

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

พารามิเตอร์
remotePort int: พอร์ตระยะไกลที่จะย้อนกลับ
localPort int: พอร์ตในเครื่อง
ส่ง
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
IOException ในกรณีที่เกิดข้อผิดพลาดเกี่ยวกับ I/O ในการเชื่อมต่อ

executeBinderCommand

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

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

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

พารามิเตอร์
parameters String: คำสั่ง Binder ที่จะเรียกใช้
receiver IShellOutputReceiver: IShellOutputReceiver ที่จะรับเอาต์พุตของคำสั่ง Binder

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

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

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

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

executeShellCommand

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

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

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

receiver IShellOutputReceiver

maxTimeToOutputResponse int

ส่ง
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

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
IOException
ShellCommandUnresponsiveException
TimeoutException

forceStop

public void forceStop (String applicationName)

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

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

getAbis

public abstract List<String> getAbis ()

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

การคืนสินค้า
List<String> รายการ 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 Future<Integer> getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

พารามิเตอร์
freshnessTime long: ความใหม่ของระดับแบตเตอรี่ที่ต้องการ
timeUnit TimeUnit: TimeUnit ของ freshnessTime
การคืนสินค้า
Future<Integer> Future ที่ใช้เพื่อค้นหาระดับแบตเตอรี่ได้ Future จะแสดงผล ExecutionException หากดึงข้อมูลระดับแบตเตอรี่ไม่ได้

getBattery

public abstract Future<Integer> getBattery ()

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

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

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

getBatteryLevel

public abstract Integer getBatteryLevel (long freshnessMs)

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

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

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

การคืนสินค้า
Integer ระดับแบตเตอรี่หรือ null หากดึงข้อมูลไม่ได้
ส่ง
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract Integer getBatteryLevel ()

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

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

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

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

getDensity

public abstract int getDensity ()

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

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

getFileListingService

public abstract FileListingService getFileListingService ()

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

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

getHardwareCharacteristics

public Set<String> getHardwareCharacteristics ()

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

การคืนสินค้า
Set<String>

ส่ง
Exception

getLanguage

public abstract String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

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

getMountPoint

public abstract String getMountPoint (String name)

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

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

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

getProperties

public abstract Map<String, String> getProperties ()

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

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

การคืนสินค้า
Map<String, String>

getProperty

public abstract String getProperty (String name)

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

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

พารามิเตอร์
name String: ชื่อของค่าที่จะแสดง
การคืนสินค้า
String ค่าหรือ null หากค่าพร็อพเพอร์ตี้ไม่พร้อมใช้งานในทันที

getPropertyCacheOrSync

public abstract String getPropertyCacheOrSync (String name)

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

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

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

getPropertyCount

public abstract int getPropertyCount ()

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

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

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

getPropertySync

public abstract String getPropertySync (String name)

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

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

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

getRegion

public abstract String getRegion ()

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

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

getScreenshot

public abstract RawImage getScreenshot ()

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

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

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

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

unit TimeUnit

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

ส่ง
AdbCommandRejectedException
IOException
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 ไม่ถูกต้อง (หรือถูก ยกเลิกการเชื่อมต่อ)
ส่ง
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
IOException หากเชื่อมต่อกับ adb ไม่สำเร็จ

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, 
                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: หน่วยสำหรับค่า maxTimeout และ maxTimeToOutputResponse ที่ไม่ใช่ 0
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 abstract void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

พารามิเตอร์
apks List: รายการ APK ที่จะติดตั้ง (APK หลัก 1 รายการ + APK แยก 0..n รายการ)
reinstall boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง
installOptions List: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ 'adb shell pm install --help'

timeout long: หมดเวลาการติดตั้ง
timeoutUnit TimeUnit: TimeUnit ที่สอดคล้องกับพารามิเตอร์การหมดเวลา
ส่ง
InstallException หากการติดตั้งไม่สำเร็จ

installPackages

public void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions)

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

พารามิเตอร์
apks List: รายการ APK ที่จะติดตั้ง (APK หลัก 1 รายการ + APK แยก 0..n รายการ)
reinstall boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง
installOptions List: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ 'adb shell pm install --help'

ส่ง
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: หน่วยสำหรับค่า maxTimeout และ maxTimeToOutputResponse ที่ไม่ใช่ 0
extraArgs String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ 'adb shell pm install --help'

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

installRemotePackages

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

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

timeout long: หมดเวลาการติดตั้ง
timeoutUnit TimeUnit: TimeUnit ที่สอดคล้องกับพารามิเตอร์การหมดเวลา
ส่ง
InstallException หากการติดตั้งไม่สำเร็จ

installRemotePackages

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions)

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

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

ส่ง
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 ทำงานในฐานะรูท มิเช่นนั้นจะเป็นเท็จ
ส่ง
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
IOException
ShellCommandUnresponsiveException

ปิด

public void kill (String applicationName)

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

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

pullFile

public abstract void pullFile (String remote, 
                String local)

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

พารามิเตอร์
remote String: เส้นทางแบบเต็มไปยังไฟล์ระยะไกล
local String: ปลายทางในพื้นที่
ส่ง
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
SyncException ในกรณีที่เกิดข้อยกเว้นในการซิงค์
TimeoutException ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่สำเร็จเนื่องจากหมดเวลา
IOException ในกรณีที่เกิดข้อยกเว้น IO

พุช

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

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

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

pushFile

public abstract void pushFile (String local, 
                String remote)

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

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

rawBinder

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

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

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

พารามิเตอร์
service String: ชื่อของบริการ Android ที่จะเชื่อมต่อ
parameters String: พารามิเตอร์ของคำสั่ง Binder
การคืนสินค้า
SocketChannel SocketChannel ที่เชื่อมต่อกับกระบวนการที่ดำเนินการในอุปกรณ์หลังจากใช้งาน
ส่ง
AdbCommandRejectedException
IOException
TimeoutException

rawExec

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

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

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

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

parameters String

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

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

public abstract void reboot (String into)

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

พารามิเตอร์
into String: ชื่อ Bootloader ที่จะรีบูต หรือ null เพื่อรีบูตอุปกรณ์
ส่ง
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
java.io.IOException
IOException

removeForward

public void removeForward (int localPort)

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

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

removeForward

public void removeForward (int localPort, 
                int remotePort)

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

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

remotePort int

ส่ง
AdbCommandRejectedException
IOException
TimeoutException

removeForward

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

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

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

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

ส่ง
AdbCommandRejectedException
IOException
TimeoutException

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

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

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

removeReverse

public void removeReverse (int remotePort)

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

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

รูท

public abstract boolean root ()

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

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

startScreenRecorder

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

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

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

options ScreenRecorderOptions

receiver IShellOutputReceiver

ส่ง
AdbCommandRejectedException
IOException
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 เส้นทางปลายทางในอุปกรณ์สำหรับไฟล์
ส่ง
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
SyncException หากเกิดข้อผิดพลาดระหว่างการพุชแพ็กเกจในอุปกรณ์
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
IOException ในกรณีที่เกิดข้อผิดพลาดเกี่ยวกับ I/O ในการเชื่อมต่อ

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