IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

urządzenie, Może to być urządzenie fizyczne lub emulator.

Podsumowanie

Stałe

int CHANGE_BUILD_INFO

Maska bitowa zmiany urządzenia: zmiana informacji o kompilacji.

int CHANGE_STATE

Maska bitowa zmiany urządzenia: DeviceState zmiana.

String FIRST_EMULATOR_SN

Numer seryjny pierwszego podłączonego emulatora.

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

Ta stała została wycofana. Użyj konta 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

Wyrażenie regularne numeru seryjnego emulatora.

String UNKNOWN_PACKAGE

Metody publiczne

abstract boolean arePropertiesSet()

Zwraca wartość true, jeśli właściwości zostały zapisane w pamięci podręcznej.

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

Tworzy przekierowanie portów między lokalnym portem TCP a zdalnym gniazdem domeny Unix.

abstract void createForward(int localPort, int remotePort)

Tworzy przekierowanie portów między portem lokalnym a zdalnym.

default void createReverse(int remotePort, int localPort)

Tworzy odwrócenie portu między portem zdalnym a lokalnym.

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

Wykonuje polecenie Binder na urządzeniu i wysyła wynik do receiver.

Używa wywołania exec:cmd lub szybszego abb_exec:, jeśli system operacyjny urządzenia i serwer ADB hosta obsługują funkcję wykonywania Android Binder Bridge.

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

Wykonuje polecenie powłoki na urządzeniu i wysyła wynik do receiver.

Działa to podobnie jak wywołanie funkcji executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

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

Ta metoda została wycofana. Użyj konta executeShellCommand(String,IShellOutputReceiver,long,TimeUnit).

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

Wersja polecenia executeShell, która może przyjmować strumień wejściowy do wysłania przez stdin.

default void forceStop(String applicationName)

Wymuś zatrzymanie aplikacji według jej nazwy.

abstract List<String> getAbis()

Zwraca interfejsy ABI obsługiwane przez to urządzenie.

default ListenableFuture<AvdData> getAvdData()

Zwraca informacje o wirtualnym urządzeniu z Androidem, na którym działa emulator.

abstract String getAvdName()

Zwraca nazwę AVD, na którym działa emulator.

abstract String getAvdPath()

Zwraca ścieżkę bezwzględną do urządzenia wirtualnego w systemie plików.

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

Zwraca poziom baterii urządzenia w procentach (od 0 do 100).

abstract Future<Integer> getBattery()

Zwraca poziom baterii urządzenia w procentach (od 0 do 100).

abstract Integer getBatteryLevel(long freshnessMs)

Ta metoda została wycofana. używać getBattery(long,TimeUnit)

abstract Integer getBatteryLevel()

Ta metoda została wycofana. używać getBattery()

abstract int getDensity()

Zwraca przedział gęstości ekranu urządzenia, odczytując wartość właściwości systemu PROP_DEVICE_DENSITY.

abstract FileListingService getFileListingService()

Zwraca FileListingService dla tego urządzenia.

default Set<String> getHardwareCharacteristics()

Zwraca funkcje uzyskane przez odczytanie właściwości charakterystyki kompilacji.

abstract String getLanguage()

Zwraca język użytkownika.

default InstallMetrics getLastInstallMetrics()

Pobiera informacje o ostatniej instalacji na tym urządzeniu.

abstract String getMountPoint(String name)

Zwraca punkt podłączenia.

abstract Map<String, String> getProperties()

Ta metoda została wycofana. użyj w zamian getSystemProperty(String)

abstract String getProperty(String name)

Wygodna metoda, która próbuje pobrać właściwość za pomocą funkcji getSystemProperty(String) z bardzo krótkim czasem oczekiwania i ignoruje wyjątki.

abstract String getPropertyCacheOrSync(String name)

Ta metoda została wycofana. użyj w zamian getSystemProperty(String)

abstract int getPropertyCount()

Ta metoda została wycofana. szczegóły implementacji

abstract String getPropertySync(String name)

Ta metoda została wycofana. używać getSystemProperty(String)

abstract String getRegion()

Zwraca region użytkownika.

abstract RawImage getScreenshot()

Robi zrzut ekranu urządzenia i zwraca go jako RawImage.

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

Zwraca numer seryjny urządzenia.

abstract IDevice.DeviceState getState()

Zwraca stan urządzenia.

abstract SyncService getSyncService()

Zwraca obiekt SyncService do przesyłania plików na urządzenie i z urządzenia.

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

Instaluje aplikację na Androida na urządzeniu.

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

Instaluje aplikację na Androida na urządzeniu.

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

Instaluje aplikację na Androida na urządzeniu.

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

Instaluje aplikację na Androida składającą się z kilku plików APK (1 główny i 0–n pakietów dzielonych).

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

Instaluje aplikację na Androida składającą się z kilku plików APK (1 główny i 0–n pakietów dzielonych) z domyślnym czasem oczekiwania.

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

Instaluje pakiet aplikacji, który został przesłany do tymczasowej lokalizacji na urządzeniu.

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

Instaluje pakiet aplikacji, który został przesłany do tymczasowej lokalizacji na urządzeniu.

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

Instaluje pakiet aplikacji, który został przesłany do tymczasowej lokalizacji na urządzeniu.

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

Instaluje aplikację na Androida składającą się z kilku plików APK znajdujących się lokalnie na urządzeniu.

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

Instaluje aplikację na Androida składającą się z kilku plików APK znajdujących się lokalnie na urządzeniu z domyślnym czasem oczekiwania.

abstract boolean isBootLoader()

Wyświetla informację o tym, czy urządzenie jest w trybie programu rozruchowego.

abstract boolean isEmulator()

Zwraca wartość true, jeśli urządzenie jest emulatorem.

abstract boolean isOffline()

Wyświetla informację o tym, czy urządzenie jest offline.

abstract boolean isOnline()

Wyświetla informację o tym, czy urządzenie jest gotowe.

abstract boolean isRoot()

Wysyła zapytanie o bieżący stan roota urządzenia.

default void kill(String applicationName)

Zamyka aplikację według jej nazwy.

abstract void pullFile(String remote, String local)

Pobiera pojedynczy plik.

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

Wysyła kilka plików lub katalogów.

abstract void pushFile(String local, String remote)

Wysyła pojedynczy plik.

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

Wywoływanie usługi Android Binder Bridge na urządzeniu zdalnym.

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

Wywołaj usługę host:exec na urządzeniu zdalnym.

abstract void reboot(String into)

Zrestartuj urządzenie.

default void removeForward(int localPort)

Usuwa przekierowanie portów między portem lokalnym a zdalnym.

default void removeForward(int localPort, int remotePort)

Ta metoda została wycofana. Użyj removeForward(int)

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

Ta metoda została wycofana. Użyj removeForward(int)

abstract void removeRemotePackage(String remoteFilePath)

Usuwa plik z urządzenia.

default void removeReverse(int remotePort)

Usuwa odwrócenie portu między portem zdalnym a lokalnym.

abstract boolean root()

Poproś demona adb o uzyskanie uprawnień roota na urządzeniu.

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

Rozpoczyna nagrywanie ekranu na urządzeniu, jeśli obsługuje ono Feature.SCREEN_RECORD.

abstract boolean supportsFeature(IDevice.HardwareFeature feature)

Zwraca informację o tym, czy to urządzenie obsługuje daną funkcję sprzętową.

abstract boolean supportsFeature(IDevice.Feature feature)

Zwraca informację o tym, czy to urządzenie obsługuje daną funkcję oprogramowania.

abstract String syncPackageToDevice(String localFilePath)

Przesyła plik na urządzenie

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

Odinstalowuje aplikację z urządzenia.

abstract String uninstallPackage(String packageName)

Odinstalowuje pakiet z urządzenia.

Stałe

CHANGE_BUILD_INFO

public static final int CHANGE_BUILD_INFO

Maska bitowa zmiany urządzenia: zmiana informacji o kompilacji.

Constant Value: 4 (0x00000004)

CHANGE_STATE

public static final int CHANGE_STATE

Maska bitowa zmiany urządzenia: DeviceState zmiana.

Constant Value: 1 (0x00000001)

FIRST_EMULATOR_SN

public static final String FIRST_EMULATOR_SN

Numer seryjny pierwszego podłączonego emulatora.

Wartość stała: "emulator-5554"

MNT_DATA

public static final String MNT_DATA

Wartość stała: "ANDROID_DATA"

MNT_EXTERNAL_STORAGE

public static final String MNT_EXTERNAL_STORAGE

Wartość stała: "EXTERNAL_STORAGE"

MNT_ROOT

public static final String MNT_ROOT

Wartość stała: "ANDROID_ROOT"

PROP_BUILD_API_LEVEL

public static final String PROP_BUILD_API_LEVEL

Wartość stała: "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS

public static final String PROP_BUILD_CHARACTERISTICS

Wartość stała: "ro.build.characteristics"

PROP_BUILD_CODENAME

public static final String PROP_BUILD_CODENAME

Wartość stała: "ro.build.version.codename"

PROP_BUILD_TAGS

public static final String PROP_BUILD_TAGS

Wartość stała: "ro.build.tags"

PROP_BUILD_TYPE

public static final String PROP_BUILD_TYPE

Wartość stała: "ro.build.type"

PROP_BUILD_VERSION

public static final String PROP_BUILD_VERSION

Wartość stała: "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER

public static final String PROP_BUILD_VERSION_NUMBER

Ta stała została wycofana.
Użyj PROP_BUILD_API_LEVEL.

Wartość stała: "ro.build.version.sdk"

PROP_DEBUGGABLE

public static final String PROP_DEBUGGABLE

Wartość stała: "ro.debuggable"

PROP_DEVICE_CPU_ABI

public static final String PROP_DEVICE_CPU_ABI

Wartość stała: "ro.product.cpu.abi"

PROP_DEVICE_CPU_ABI2

public static final String PROP_DEVICE_CPU_ABI2

Wartość stała: "ro.product.cpu.abi2"

PROP_DEVICE_CPU_ABI_LIST

public static final String PROP_DEVICE_CPU_ABI_LIST

Wartość stała: "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY

public static final String PROP_DEVICE_DENSITY

Wartość stała: "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY

public static final String PROP_DEVICE_EMULATOR_DENSITY

Wartość stała: "qemu.sf.lcd_density"

PROP_DEVICE_LANGUAGE

public static final String PROP_DEVICE_LANGUAGE

Wartość stała: "persist.sys.language"

PROP_DEVICE_MANUFACTURER

public static final String PROP_DEVICE_MANUFACTURER

Wartość stała: "ro.product.manufacturer"

PROP_DEVICE_MODEL

public static final String PROP_DEVICE_MODEL

Wartość stała: "ro.product.model"

PROP_DEVICE_REGION

public static final String PROP_DEVICE_REGION

Wartość stała: "persist.sys.country"

RE_EMULATOR_SN

public static final String RE_EMULATOR_SN

Wyrażenie regularne numeru seryjnego emulatora.

Wartość stała: "emulator-(\d+)"

NIEZNANY_PAKIET

public static final String UNKNOWN_PACKAGE

Wartość stała: ""

Metody publiczne

arePropertiesSet

public abstract boolean arePropertiesSet ()

Zwraca wartość true, jeśli właściwości zostały zapisane w pamięci podręcznej.

Zwraca
boolean

createForward

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

Tworzy przekierowanie portów między lokalnym portem TCP a zdalnym gniazdem domeny Unix.

Parametry
localPort int: lokalny port do przekazywania dalej
remoteSocketName String: nazwa gniazda domeny systemu Unix utworzonego na urządzeniu
namespace IDevice.DeviceUnixSocketNamespace: przestrzeń nazw, w której utworzono gniazdo domeny UNIX
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

createForward

public abstract void createForward (int localPort, 
                int remotePort)

Tworzy przekierowanie portów między portem lokalnym a zdalnym.

Parametry
localPort int: lokalny port do przekazywania dalej
remotePort int: port zdalny.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

createReverse

public void createReverse (int remotePort, 
                int localPort)

Tworzy odwrócenie portu między portem zdalnym a lokalnym.

Parametry
remotePort int: port zdalny do odwrócenia.
localPort int: port lokalny,
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

executeBinderCommand

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

Wykonuje polecenie Binder na urządzeniu i wysyła wynik do receiver.

Używa wywołania exec:cmd lub szybszego abb_exec:, jeśli system operacyjny urządzenia i serwer ADB hosta obsługują funkcję wykonywania Android Binder Bridge.

Parametry
parameters String: polecenie bindera do wykonania
receiver IShellOutputReceiver: IShellOutputReceiver, który otrzyma wynik polecenia binder
maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream: opcjonalny strumień wejściowy do wysłania przez stdin
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
ShellCommandUnresponsiveException w przypadku, gdy polecenie bindera nie wysyła danych wyjściowych przez określony czas.
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Wykonuje polecenie powłoki na urządzeniu i wysyła wynik do receiver.

Działa to podobnie jak wywołanie funkcji executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

Parametry
command String: polecenie powłoki do wykonania
receiver IShellOutputReceiver: IShellOutputReceiver, który otrzyma wynik polecenia powłoki
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
ShellCommandUnresponsiveException w przypadku, gdy polecenie powłoki nie wysyła danych wyjściowych przez określony czas.
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

executeShellCommand

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

Ta metoda została wycofana.
Użyj executeShellCommand(String,IShellOutputReceiver,long,TimeUnit).

Parametry
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

Zgłasza
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

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

Wersja polecenia executeShell, która może przyjmować strumień wejściowy do wysłania przez stdin.

Parametry
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream

Zgłasza
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

forceStop

public void forceStop (String applicationName)

Wymuś zatrzymanie aplikacji według jej nazwy. Spowoduje to usunięcie wszystkich oczekujących alarmów i obliczeń w kolejce.

Parametry
applicationName String: nazwa aplikacji

getAbis

public abstract List<String> getAbis ()

Zwraca interfejsy ABI obsługiwane przez to urządzenie. Interfejsy ABI są posortowane w preferowanej kolejności, przy czym pierwszy interfejs ABI jest najbardziej preferowany.

Zwraca
List<String> listę interfejsów ABI,

getAvdData

public ListenableFuture<AvdData> getAvdData ()

Zwraca informacje o wirtualnym urządzeniu z Androidem, na którym działa emulator.

AvdData.getName to nazwa AVD lub null, jeśli nie ma żadnej nazwy.

AvdData.getPath to ścieżka AVD lub wartość null, jeśli jest to urządzenie fizyczne, podpolecenie konsoli emulatora nie powiodło się lub wersja emulatora jest starsza niż 30.0.18.

Zwraca
ListenableFuture<AvdData> AvdData urządzenia.

getAvdName

public abstract String getAvdName ()

Zwraca nazwę AVD, na którym działa emulator.

Jest to ważne tylko wtedy, gdy isEmulator() zwraca wartość Prawda.

Jeśli emulator nie uruchamia żadnego AVD (np. jest uruchamiany z kompilacji drzewa źródłowego Androida), ta metoda zwróci „<build>”.

Uwaga: jeśli chcesz mieć kontrolę nad czasem oczekiwania, użyj funkcji getAvdData().

Zwraca
String nazwę AVD lub null, jeśli nie ma żadnej nazwy.

getAvdPath

public abstract String getAvdPath ()

Zwraca ścieżkę bezwzględną do urządzenia wirtualnego w systemie plików. Ścieżka zależy od systemu operacyjnego. W systemie Linux separatory nazw to /, a w systemie Windows – \.

Uwaga: jeśli chcesz mieć kontrolę nad czasem oczekiwania, użyj funkcji getAvdData().

Zwraca
String ścieżkę AVD lub wartość null, jeśli jest to urządzenie fizyczne, podpolecenie konsoli emulatora nie powiodło się lub wersja emulatora jest starsza niż 30.0.18.

getBattery

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

Zwraca poziom baterii urządzenia w procentach (od 0 do 100).

Poziom baterii może być zapisany w pamięci podręcznej. Wysyła zapytanie o poziom baterii urządzenia tylko wtedy, gdy od ostatniego udanego zapytania minął okres ważności freshnessTime.

Parametry
freshnessTime long: pożądana aktualność poziomu baterii.
timeUnit TimeUnit: TimeUnit wartości freshnessTime
Zwraca
Future<Integer> Future, za pomocą którego można sprawdzić poziom baterii. Funkcja Future zwróci wartość ExecutionException, jeśli nie można było pobrać poziomu baterii.

getBattery

public abstract Future<Integer> getBattery ()

Zwraca poziom baterii urządzenia w procentach (od 0 do 100).

Poziom baterii może być zapisany w pamięci podręcznej. Wysyła zapytanie o poziom baterii urządzenia tylko wtedy, gdy od ostatniego udanego zapytania minęło 5 minut.

Zwraca
Future<Integer> Future, za pomocą którego można sprawdzić poziom baterii. Funkcja Future zwróci wartość ExecutionException, jeśli nie można było pobrać poziomu baterii.

getBatteryLevel

public abstract Integer getBatteryLevel (long freshnessMs)

Ta metoda została wycofana.
użyj getBattery(long,TimeUnit)

Zwraca poziom baterii urządzenia w procentach (od 0 do 100).

Poziom baterii może być zapisany w pamięci podręcznej. Wysyła do urządzenia zapytanie o poziom baterii tylko wtedy, gdy od ostatniego udanego zapytania minęło freshnessMs ms.

Zwraca
Integer poziom baterii lub null, jeśli nie udało się go pobrać.
Zgłasza
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract Integer getBatteryLevel ()

Ta metoda została wycofana.
użyj getBattery()

Zwraca poziom baterii urządzenia w procentach (od 0 do 100).

Poziom baterii może być zapisany w pamięci podręcznej. Wysyła zapytanie o poziom baterii urządzenia tylko wtedy, gdy od ostatniego udanego zapytania minęło 5 minut.

Zwraca
Integer poziom baterii lub null, jeśli nie udało się go pobrać.
Zgłasza
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

getDensity

public abstract int getDensity ()

Zwraca przedział gęstości ekranu urządzenia, odczytując wartość właściwości systemu PROP_DEVICE_DENSITY.

Zwraca
int gęstość lub -1, jeśli nie można jej określić.

getFileListingService

public abstract FileListingService getFileListingService ()

Zwraca FileListingService dla tego urządzenia.

Zwraca
FileListingService

getHardwareCharacteristics

public Set<String> getHardwareCharacteristics ()

Zwraca funkcje uzyskane przez odczytanie właściwości charakterystyki kompilacji.

Zwraca
Set<String>

Zgłasza
Exception

getLanguage

public abstract String getLanguage ()

Zwraca język użytkownika.

Zwraca
String język użytkownika lub wartość null, jeśli jest nieznany;

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

Pobiera informacje o ostatniej instalacji na tym urządzeniu.

Zwraca
InstallMetrics InstallMetrics dane opisujące instalację.

getMountPoint

public abstract String getMountPoint (String name)

Zwraca punkt podłączenia.

Parametry
name String: nazwa punktu podłączania do zwrócenia
Zwraca
String

getProperties

public abstract Map<String, String> getProperties ()

Ta metoda została wycofana.
użyj getSystemProperty(String)

Zwraca właściwości urządzenia zapisane w pamięci podręcznej. Zawiera pełne dane wyjściowe polecenia „getprop”.

Zwraca
Map<String, String>

getProperty

public abstract String getProperty (String name)

Wygodna metoda, która próbuje pobrać właściwość za pomocą funkcji getSystemProperty(String) z bardzo krótkim czasem oczekiwania i ignoruje wyjątki.

Uwaga: jeśli chcesz mieć kontrolę nad czasem oczekiwania, użyj funkcji getSystemProperty(String).

Parametry
name String: nazwa wartości do zwrócenia.
Zwraca
String wartość lub null, jeśli wartość właściwości nie była od razu dostępna.

getPropertyCacheOrSync

public abstract String getPropertyCacheOrSync (String name)

Ta metoda została wycofana.
użyj getSystemProperty(String)

Połączenie wartości getProperty(String) i getPropertySync(String), które będzie próbować pobrać właściwość z pamięci podręcznej. Jeśli nie zostanie znaleziony, synchronicznie spróbuje wysłać zapytanie bezpośrednio do urządzenia i w razie powodzenia ponownie wypełnić pamięć podręczną.

Parametry
name String: nazwa wartości do zwrócenia.
Zwraca
String wartość lub null, jeśli właściwość nie istnieje.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
ShellCommandUnresponsiveException w przypadku, gdy polecenie powłoki nie wysyła danych wyjściowych przez określony czas.
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

getPropertyCount

public abstract int getPropertyCount ()

Ta metoda została wycofana.
szczegóły implementacji

Zwraca liczbę usług dla tego urządzenia.

Zwraca
int

getPropertySync

public abstract String getPropertySync (String name)

Ta metoda została wycofana.
użyj getSystemProperty(String)

Wariant funkcji getProperty(String), który próbuje pobrać daną właściwość bezpośrednio z urządzenia, bez użycia pamięci podręcznej. Tej metody należy używać (tylko) w przypadku usług, w których dane często się zmieniają.

Parametry
name String: nazwa wartości do zwrócenia.
Zwraca
String wartość lub null, jeśli właściwość nie istnieje.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
ShellCommandUnresponsiveException w przypadku, gdy polecenie powłoki nie wysyła danych wyjściowych przez określony czas.
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

getRegion

public abstract String getRegion ()

Zwraca region użytkownika.

Zwraca
String region użytkownika lub wartość null, jeśli jest nieznany;

getScreenshot

public abstract RawImage getScreenshot ()

Robi zrzut ekranu urządzenia i zwraca go jako RawImage.

Zwraca
RawImage zrzut ekranu jako RawImage lub null, jeśli coś poszło nie tak.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Parametry
timeout long

unit TimeUnit

Zwraca
RawImage

Zgłasza
AdbCommandRejectedException
IOException
TimeoutException

getSerialNumber

public abstract String getSerialNumber ()

Zwraca numer seryjny urządzenia.

Zwraca
String

getState

public abstract IDevice.DeviceState getState ()

Zwraca stan urządzenia.

Zwraca
IDevice.DeviceState

getSyncService

public abstract SyncService getSyncService ()

Zwraca obiekt SyncService do przesyłania plików na urządzenie i z urządzenia.

Zwraca
SyncService null, jeśli nie udało się utworzyć usługi SyncService. Może się tak zdarzyć, jeśli adb odmówi otwarcia połączenia, ponieważ IDevice jest nieprawidłowy (lub został odłączony).
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException jeśli nie udało się nawiązać połączenia z adb.

installPackage

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

Instaluje aplikację na Androida na urządzeniu. Jest to metoda pomocnicza, która łączy kroki syncPackageToDevice, installRemotePackage i removePackage.

Parametry
packageFilePath String: bezwzględna ścieżka w systemie plików do pliku na hoście lokalnym, który ma zostać zainstalowany.
reinstall boolean: ustaw wartość true, jeśli aplikacja ma zostać ponownie zainstalowana.
receiver InstallReceiver: InstallReceiver, który będzie używany do monitorowania instalacji i uzyskiwania ostatecznego stanu.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

installPackage

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

Instaluje aplikację na Androida na urządzeniu. Jest to metoda pomocnicza, która łączy kroki syncPackageToDevice, installRemotePackage i removePackage.

Parametry
packageFilePath String: bezwzględna ścieżka w systemie plików do pliku na hoście lokalnym, który ma zostać zainstalowany.
reinstall boolean: ustaw wartość true, jeśli aplikacja ma zostać ponownie zainstalowana.
receiver InstallReceiver: InstallReceiver, który będzie używany do monitorowania instalacji i uzyskiwania ostatecznego stanu.
maxTimeout long: maksymalny czas oczekiwania na zwrócenie polecenia. Wartość 0 oznacza, że nie zostanie zastosowany maksymalny czas oczekiwania.
maxTimeToOutputResponse long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi. Wartość 0 oznacza, że metoda będzie czekać w nieskończoność (do momentu, gdy receiver anuluje wykonanie) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
maxTimeUnits TimeUnit: jednostki dla wartości maxTimeout i maxTimeToOutputResponse innych niż zero.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

installPackage

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

Instaluje aplikację na Androida na urządzeniu. Jest to metoda pomocnicza, która łączy kroki syncPackageToDevice, installRemotePackage i removePackage.

Parametry
packageFilePath String: bezwzględna ścieżka w systemie plików do pliku na hoście lokalnym, który ma zostać zainstalowany.
reinstall boolean: ustaw wartość true, jeśli aplikacja ma zostać ponownie zainstalowana.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

installPackages

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

Instaluje aplikację na Androida składającą się z kilku plików APK (1 główny i 0–n pakietów dzielonych).

Parametry
apks List: lista plików APK do zainstalowania (1 główny plik APK + 0–n dzielonych plików APK)
reinstall boolean: ustaw wartość true, jeśli aplikacja ma zostać ponownie zainstalowana.
installOptions List: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
timeout long: limit czasu instalacji
timeoutUnit TimeUnit: TimeUnit odpowiadający parametrowi limitu czasu.
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

installPackages

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

Instaluje aplikację na Androida składającą się z kilku plików APK (1 główny i 0–n pakietów dzielonych) z domyślnym czasem oczekiwania.

Parametry
apks List: lista plików APK do zainstalowania (1 główny plik APK + 0–n dzielonych plików APK)
reinstall boolean: ustaw wartość true, jeśli aplikacja ma zostać ponownie zainstalowana.
installOptions List: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

installRemotePackage

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

Instaluje pakiet aplikacji, który został przesłany do tymczasowej lokalizacji na urządzeniu.

Parametry
remoteFilePath String: bezwzględna ścieżka do pliku pakietu na urządzeniu
reinstall boolean: ustaw wartość true, jeśli aplikacja ma zostać ponownie zainstalowana.
receiver InstallReceiver: InstallReceiver, który będzie używany do monitorowania instalacji i uzyskiwania ostatecznego stanu.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

installRemotePackage

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

Instaluje pakiet aplikacji, który został przesłany do tymczasowej lokalizacji na urządzeniu.

Parametry
remoteFilePath String: bezwzględna ścieżka do pliku pakietu na urządzeniu
reinstall boolean: ustaw wartość true, jeśli aplikacja ma zostać ponownie zainstalowana.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

installRemotePackage

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

Instaluje pakiet aplikacji, który został przesłany do tymczasowej lokalizacji na urządzeniu.

Parametry
remoteFilePath String: bezwzględna ścieżka do pliku pakietu na urządzeniu
reinstall boolean: ustaw wartość true, jeśli aplikacja ma zostać ponownie zainstalowana.
receiver InstallReceiver: InstallReceiver, który będzie używany do monitorowania instalacji i uzyskiwania ostatecznego stanu.
maxTimeout long: maksymalny czas oczekiwania na zwrócenie polecenia. Wartość 0 oznacza, że nie zostanie zastosowany maksymalny czas oczekiwania.
maxTimeToOutputResponse long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi. Wartość 0 oznacza, że metoda będzie czekać w nieskończoność (do momentu, gdy receiver anuluje wykonanie) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
maxTimeUnits TimeUnit: jednostki dla wartości maxTimeout i maxTimeToOutputResponse innych niż zero.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

installRemotePackages

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

Instaluje aplikację na Androida składającą się z kilku plików APK znajdujących się lokalnie na urządzeniu.

Parametry
remoteApks List: lista ścieżek do plików APK na urządzeniu, które mają zostać zainstalowane.
reinstall boolean: ustaw wartość true, jeśli aplikacja ma zostać ponownie zainstalowana.
installOptions List: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
timeout long: limit czasu instalacji
timeoutUnit TimeUnit: TimeUnit odpowiadający parametrowi limitu czasu.
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

installRemotePackages

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

Instaluje aplikację na Androida składającą się z kilku plików APK znajdujących się lokalnie na urządzeniu z domyślnym czasem oczekiwania.

Parametry
remoteApks List: lista ścieżek do plików APK na urządzeniu, które mają zostać zainstalowane
reinstall boolean: ustaw wartość true, jeśli aplikacja ma zostać ponownie zainstalowana.
installOptions List: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

isBootLoader

public abstract boolean isBootLoader ()

Wyświetla informację o tym, czy urządzenie jest w trybie programu rozruchowego.

Zwraca
boolean true jeśli getState() zwraca DeviceState.BOOTLOADER.

isEmulator

public abstract boolean isEmulator ()

Zwraca wartość true, jeśli urządzenie jest emulatorem.

Zwraca
boolean

isOffline

public abstract boolean isOffline ()

Wyświetla informację o tym, czy urządzenie jest offline.

Zwraca
boolean true jeśli getState() zwraca DeviceState.OFFLINE.

isOnline

public abstract boolean isOnline ()

Wyświetla informację o tym, czy urządzenie jest gotowe.

Zwraca
boolean true jeśli getState() zwraca DeviceState.ONLINE.

isRoot

public abstract boolean isRoot ()

Wysyła zapytanie o bieżący stan roota urządzenia. Więcej informacji znajdziesz w sekcji „adb root”.

Zwraca
boolean Wartość true, jeśli demon adb działa jako root, w przeciwnym razie wartość false.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie.
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException
ShellCommandUnresponsiveException

zabijać,

public void kill (String applicationName)

Zamyka aplikację według jej nazwy. Spowoduje to tylko zniszczenie aktywności, a jej stan pozostanie w systemie Android.

Parametry
applicationName String: nazwa aplikacji

pullFile

public abstract void pullFile (String remote, 
                String local)

Pobiera pojedynczy plik.

Parametry
remote String: pełna ścieżka do pliku zdalnego
local String: lokalne miejsce docelowe.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
SyncException w przypadku wyjątku synchronizacji.
TimeoutException w przypadku przekroczenia limitu czasu odczytywania odpowiedzi z urządzenia.
IOException w przypadku wyjątku wejścia/wyjścia.

push | wypychanie [in descriptive contexts]

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

Wysyła kilka plików lub katalogów.

Parametry
local String: pliki lokalne do przesłania
remote String: ścieżka zdalna reprezentująca katalog.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
SyncException jeśli nie udało się przesłać niektórych plików.
TimeoutException w przypadku przekroczenia limitu czasu odczytywania odpowiedzi z urządzenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu;

pushFile

public abstract void pushFile (String local, 
                String remote)

Wysyła pojedynczy plik.

Parametry
local String: lokalna ścieżka do pliku.
remote String: zdalna ścieżka do pliku
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
SyncException jeśli nie udało się przesłać pliku.
TimeoutException w przypadku przekroczenia limitu czasu odczytywania odpowiedzi z urządzenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu;

rawBinder

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

Wywoływanie usługi Android Binder Bridge na urządzeniu zdalnym. Zwraca kanał gniazda, który jest połączony z poleceniem urządzenia wiążącego.

Własność SocketChannel jest przekazywana do wywołującego, po użyciu musi zostać jawnie zamknięta.

Parametry
service String: nazwa usługi Androida, z którą chcesz się połączyć
parameters String: parametry polecenia narzędzia do łączenia;
Zwraca
SocketChannel Kanał SocketChannel połączony z procesem wykonywanym na urządzeniu. po użyciu.
Zgłasza
AdbCommandRejectedException
IOException
TimeoutException

rawExec

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

Wywołaj usługę host:exec na urządzeniu zdalnym. Zwraca kanał gniazda połączony z procesem wykonawczym. Pamiętaj, że usługa exec nie rozróżnia stdout i stderr, więc wszystko, co jest odczytywane z gniazda, może pochodzić z dowolnego wyjścia i być przeplatane.

Własność SocketChannel jest przekazywana do wywołującego, po użyciu musi zostać jawnie zamknięta.

Parametry
executable String

parameters String

Zwraca
SocketChannel Kanał SocketChannel połączony z procesem wykonywanym na urządzeniu. po użyciu.
Zgłasza
AdbCommandRejectedException
IOException
TimeoutException

uruchomić ponownie|zrestartować

public abstract void reboot (String into)

Zrestartuj urządzenie.

Parametry
into String: nazwa programu rozruchowego, do którego ma zostać uruchomione urządzenie, lub wartość null, jeśli urządzenie ma zostać tylko zrestartowane.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
java.io.IOException
IOException

removeForward

public void removeForward (int localPort)

Usuwa przekierowanie portów między portem lokalnym a zdalnym.

Parametry
localPort int: lokalny port do przekazywania dalej
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

removeForward

public void removeForward (int localPort, 
                int remotePort)

Ta metoda została wycofana.
Użyj removeForward(int)

Parametry
localPort int

remotePort int

Zgłasza
AdbCommandRejectedException
IOException
TimeoutException

removeForward

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

Ta metoda została wycofana.
Użyj removeForward(int)

Parametry
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

Zgłasza
AdbCommandRejectedException
IOException
TimeoutException

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

Usuwa plik z urządzenia.

Parametry
remoteFilePath String: ścieżka do pliku na urządzeniu, który ma zostać usunięty
Zgłasza
InstallException jeśli instalacja się nie powiedzie.

removeReverse

public void removeReverse (int remotePort)

Usuwa odwrócenie portu między portem zdalnym a lokalnym.

Parametry
remotePort int: port zdalny.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

poziom główny

public abstract boolean root ()

Poproś demona adb o uzyskanie uprawnień roota na urządzeniu. Może to się nie udać bez powiadomienia i działa tylko w przypadku wersji deweloperskich. Więcej informacji znajdziesz w sekcji „adb root”.

Zwraca
boolean Wartość true, jeśli demon adb działa jako root, w przeciwnym razie wartość false.
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie.
ShellCommandUnresponsiveException jeśli nie można wysłać zapytania o stan głównego elementu.
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
java.io.IOException
IOException

startScreenRecorder

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

Rozpoczyna nagrywanie ekranu na urządzeniu, jeśli obsługuje ono Feature.SCREEN_RECORD.

Parametry
remoteFilePath String

options ScreenRecorderOptions

receiver IShellOutputReceiver

Zgłasza
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

supportsFeature

public abstract boolean supportsFeature (IDevice.HardwareFeature feature)

Zwraca informację o tym, czy to urządzenie obsługuje daną funkcję sprzętową.

Parametry
feature IDevice.HardwareFeature

Zwraca
boolean

supportsFeature

public abstract boolean supportsFeature (IDevice.Feature feature)

Zwraca informację o tym, czy to urządzenie obsługuje daną funkcję oprogramowania.

Parametry
feature IDevice.Feature

Zwraca
boolean

syncPackageToDevice

public abstract String syncPackageToDevice (String localFilePath)

Przesyła plik na urządzenie

Parametry
localFilePath String: ścieżka bezwzględna do pliku na hoście lokalnym,
Zwraca
String String ścieżka docelowa pliku na urządzeniu;
Zgłasza
AdbCommandRejectedException jeśli adb odrzuci polecenie;
SyncException jeśli podczas przesyłania pakietu na urządzenie wystąpi błąd.
TimeoutException w przypadku upłynięcia limitu czasu połączenia.
IOException w przypadku błędu wejścia/wyjścia w połączeniu.

uninstallApp

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

Odinstalowuje aplikację z urządzenia.

Parametry
applicationID String: identyfikator aplikacji na Androida do odinstalowania
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
InstallException jeśli odinstalowanie się nie powiedzie.

uninstallPackage

public abstract String uninstallPackage (String packageName)

Odinstalowuje pakiet z urządzenia.

Parametry
packageName String: identyfikator aplikacji na Androida do odinstalowania
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
InstallException jeśli odinstalowanie się nie powiedzie.