Aby zachować zgodność z naszym modelem rozwoju gałęzi głównej i zapewnić stabilność platformy w ekosystemie, w II i IV kwartale 2026 r. opublikujemy kod źródłowy w AOSP. Do tworzenia i współtworzenia AOSP zalecamy używanie android-latest-release zamiast aosp-main. Gałąź android-latest-release manifestu zawsze będzie odnosić się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w sekcji Zmiany w AOSP.

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.server.DeviceImpl

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

Podsumowanie

Publiczne konstruktory
`DeviceImpl(ClientTracker clientTracer, String serialNumber, IDevice.DeviceState deviceState)`

Metody publiczne
`boolean`	`arePropertiesSet()` Zwraca wartość `true`, jeśli usługi zostały zapisane w pamięci podręcznej.
`void`	`createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` Tworzy przekierowanie portów między lokalnym portem TCP a zdalnym gniazdem domeny Unix.
`void`	`createForward(int localPort, int remotePort)` Tworzy przekierowanie portów między portem lokalnym a zdalnym.
`void`	`createReverse(int remotePort, int localPort)` Tworzy odwrócenie portu między portem zdalnym a lokalnym.
`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ę Android Binder Bridge.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Wykonuje polecenie powłoki na urządzeniu i wysyła wynik do `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` Wersja polecenia executeShell, która może przyjmować strumień wejściowy do wysyłania przez stdin.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Wykonuje polecenie powłoki na urządzeniu i wysyła wynik do `receiver`. Jest to podobne do wywołania funkcji `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Wykonuje polecenie powłoki na urządzeniu i wysyła wynik do `receiver`.
`void`	`forceStop(String applicationName)` Wymuś zatrzymanie aplikacji według jej nazwy.
	`getAbis()` Zwraca interfejsy ABI obsługiwane przez to urządzenie.
`ListenableFuture<AvdData>`	`getAvdData()` Zwraca informacje o wirtualnym urządzeniu z Androidem, na którym działa emulator.
`String`	`getAvdName()` Zwraca nazwę AVD, na którym działa emulator.
`String`	`getAvdPath()` Zwraca ścieżkę bezwzględną do urządzenia wirtualnego w systemie plików.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` Zwraca poziom baterii urządzenia w procentach (od 0 do 100).
	`getBattery()` Zwraca poziom baterii urządzenia w procentach (od 0 do 100).
`Integer`	`getBatteryLevel(long freshnessMs)` Zwraca poziom baterii urządzenia w procentach (od 0 do 100).
`Integer`	`getBatteryLevel()` Zwraca poziom baterii urządzenia w procentach (od 0 do 100).
`ClientImpl`	`getClient(String applicationName)` Zwraca `Client` na podstawie nazwy aplikacji.
`String`	`getClientName(int pid)` Zwraca nazwę klienta według identyfikatora klienta lub `null`, jeśli identyfikator klienta jest nieznany.
`ClientTracker`	`getClientTracker()`
`ClientImpl[]`	`getClients()` Zwraca tablicę klientów.
`int`	`getDensity()` Zwraca zakres gęstości ekranu urządzenia, odczytując wartość właściwości systemu `PROP_DEVICE_DENSITY`.
`FileListingService`	`getFileListingService()` Zwraca `FileListingService` dla tego urządzenia.
`String`	`getLanguage()` Zwraca język użytkownika.
`InstallMetrics`	`getLastInstallMetrics()` Pobiera informacje o ostatniej instalacji na tym urządzeniu.
`String`	`getMountPoint(String name)` Zwraca punkt podłączenia.
`String`	`getName()` Zwraca (zrozumiałą dla człowieka) nazwę tego urządzenia.
`ClientImpl[]`	`getNativeClients()`
`ClientImpl`	`getNativeClients(String applicationName)`
`ProfileableClientImpl[]`	`getProfileableClients()` Zwraca tablicę klientów, których profile można tworzyć.
	`getProperties()` Zwraca właściwości urządzenia zapisane w pamięci podręcznej.
`String`	`getProperty(String name)` Metoda pomocnicza, która próbuje pobrać właściwość za pomocą funkcji `IShellEnabledDevice.getSystemProperty(String)` z bardzo krótkim czasem oczekiwania i ignoruje wyjątki.
`String`	`getPropertyCacheOrSync(String name)` Połączenie wartości `getProperty(String)` i `getPropertySync(String)`, które będzie próbować pobrać właściwość z pamięci podręcznej.
`int`	`getPropertyCount()` Zwraca liczbę usług na tym urządzeniu.
`String`	`getPropertySync(String name)` 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.
`String`	`getRegion()` Zwraca region użytkownika.
`static String`	`getScreenRecorderCommand(String remoteFilePath, ScreenRecorderOptions options)`
`RawImage`	`getScreenshot()` Robi zrzut ekranu urządzenia i zwraca go jako `RawImage`.
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` Zwraca numer seryjny urządzenia.
`IDevice.DeviceState`	`getState()` Zwraca stan urządzenia.
`SyncService`	`getSyncService()` Zwraca obiekt `SyncService`, który umożliwia przesyłanie plików na urządzenie i pobieranie ich z niego.
`ListenableFuture<String>`	`getSystemProperty(String name)` Wykonywanie potencjalnego zapytania asynchronicznego dotyczącego właściwości systemu.
`boolean`	`hasClients()` Zwraca informację, czy `IDevice` ma `Client`.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Instaluje aplikację na Androida na urządzeniu.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Instaluje aplikację na Androida na urządzeniu.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` Instaluje aplikację na Androida na urządzeniu.
`void`	`installPackages( apks, boolean reinstall, 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.
`void`	`installPackages( apks, boolean reinstall, 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).
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Instaluje pakiet aplikacji, który został przesłany do tymczasowej lokalizacji na urządzeniu.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)` Instaluje pakiet aplikacji, który został przesłany do tymczasowej lokalizacji na urządzeniu.
`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.
`void`	`installRemotePackages( remoteApks, boolean reinstall, 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.
`void`	`installRemotePackages( remoteApks, boolean reinstall, 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.
`boolean`	`isBootLoader()` Wyświetla informację o tym, czy urządzenie jest w trybie programu rozruchowego.
`boolean`	`isEmulator()` Zwraca wartość `true`, jeśli urządzenie jest emulatorem.
`boolean`	`isOffline()` Wyświetla informację o tym, czy urządzenie jest offline.
`boolean`	`isOnline()` Wyświetla informację o tym, czy urządzenie jest gotowe.
`boolean`	`isRoot()` Wysyła zapytanie o bieżący stan roota urządzenia.
`void`	`kill(String applicationName)` Zamyka aplikację według jej nazwy.
`void`	`pullFile(String remote, String local)` Pobiera jeden plik.
`void`	`push(String[] local, String remote)` Przesyła kilka plików lub katalogów.
`void`	`pushFile(String local, String remote)` Wysyła pojedynczy plik.
`SocketChannel`	`rawBinder(String service, String[] parameters)` wywoływać usługę Android Binder Bridge na urządzeniu zdalnym;
`SocketChannel`	`rawExec(String executable, String[] parameters)` Wywołaj usługę host:exec na urządzeniu zdalnym.
`void`	`reboot(String into)` Zrestartuj urządzenie.
`void`	`removeForward(int localPort)` Usuwa przekierowanie portu między portem lokalnym a zdalnym.
`void`	`removeRemotePackage(String remoteFilePath)` Usuwa plik z urządzenia.
`void`	`removeReverse(int remotePort)` Usuwa odwrócenie portu między portem zdalnym a lokalnym.
`boolean`	`root()` Poproś demona adb o uzyskanie uprawnień roota na urządzeniu.
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` Rozpoczyna nagrywanie ekranu na urządzeniu, jeśli obsługuje ono funkcję `IDevice.Feature.SCREEN_RECORD`.
`boolean`	`supportsFeature(IDevice.HardwareFeature feature)` Zwraca informację o tym, czy to urządzenie obsługuje daną funkcję sprzętową.
`boolean`	`supportsFeature(IDevice.Feature feature)` Zwraca informację o tym, czy to urządzenie obsługuje daną funkcję oprogramowania.
`String`	`syncPackageToDevice(String localFilePath)` Przesyła plik na urządzenie
`String`	`toString()`
`String`	`uninstallApp(String applicationID, String... extraArgs)` Odinstalowuje aplikację z urządzenia.
`String`	`uninstallPackage(String packageName)` Odinstalowuje pakiet z urządzenia.

Publiczne konstruktory

DeviceImpl

public DeviceImpl (ClientTracker clientTracer, 
                String serialNumber, 
                IDevice.DeviceState deviceState)

Parametry
`clientTracer`	`ClientTracker`
`serialNumber`	`String`
`deviceState`	`IDevice.DeviceState`

Metody publiczne

arePropertiesSet

public boolean arePropertiesSet ()

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

Zwroty
`boolean`

createForward

public 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`
`TimeoutException`

createForward

public 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`
`TimeoutException`

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`
`TimeoutException`

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ę 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`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

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

maxTimeToOutputResponse jest używany jako maksymalny czas oczekiwania na dane wyjściowe polecenia z urządzenia.
Jeśli w dowolnym momencie polecenie powłoki nie wygeneruje żadnych danych wyjściowych przez okres dłuższy niż maxTimeToOutputResponse, metoda zgłosi wyjątek ShellCommandUnresponsiveException.

W przypadku poleceń takich jak log output należy używać wartości maxTimeToOutputResponse 0, co oznacza, że metoda nigdy nie zgłosi wyjątku i będzie blokować się do momentu, aż funkcja IShellOutputReceiver.isCancelled() odbiorcy zwróci wartość true.

Parametry
`command`	`String`: polecenie powłoki do wykonania
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver`, który otrzyma wynik polecenia powłoki.
`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ść (dopóki `receiver` nie anuluje wykonania) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
`maxTimeUnits`	`TimeUnit`: jednostki dla wartości `maxTimeToOutputResponse` innych niż zero.

Zgłasza
`AdbCommandRejectedException`
`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 wysyłania przez stdin.

Parametry
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	`InputStream`

Zgłasza
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

Jest to podobne do wywołania 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`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

Parametry
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

Zgłasza
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

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

Parametry
`command`	`String`: polecenie powłoki do wykonania
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver`, który otrzyma wynik polecenia powłoki.
`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ść (dopóki `receiver` nie anuluje wykonania) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
`maxTimeUnits`	`TimeUnit`: jednostki dla wartości innych niż zero w polach `maxTimeout` i `maxTimeToOutputResponse`.

Zgłasza
`AdbCommandRejectedException`
`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  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.

Zwroty
	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.

Zwroty
`ListenableFuture<AvdData>`	`AvdData` urządzenia.

getAvdName

public String getAvdName ()

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

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

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

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

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

getAvdPath

public 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 getAvdData().

Zwroty
`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  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`: `ERROR(/TimeUnit)` wartości freshnessTime

Zwroty
	`ERROR(/Future)`, za pomocą którego można sprawdzić poziom baterii. Funkcja Future zwróci wartość `ERROR(/ExecutionException)`, jeśli nie można było pobrać poziomu baterii.

getBattery

public  getBattery ()

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

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

Zwroty
	`ERROR(/Future)`, za pomocą którego można sprawdzić poziom baterii. Funkcja Future zwróci wartość `ERROR(/ExecutionException)`, jeśli nie można było pobrać poziomu baterii.

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

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.

Zwroty
`Integer`	poziom naładowania baterii lub `null`, jeśli nie udało się go pobrać;

getBatteryLevel

public Integer getBatteryLevel ()

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

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

Zwroty
`Integer`	poziom naładowania baterii lub `null`, jeśli nie udało się go pobrać;

getClient

public ClientImpl getClient (String applicationName)

Zwraca Client na podstawie nazwy aplikacji.

Parametry
`applicationName`	`String`: nazwa aplikacji

Zwroty
`ClientImpl`	obiekt `Client` lub `null`, jeśli nie znaleziono dopasowania.

getClientName

public String getClientName (int pid)

Zwraca nazwę klienta według identyfikatora klienta lub null, jeśli identyfikator klienta jest nieznany.

Parametry
`pid`	`int`: identyfikator procesu klienta.

Zwroty
`String`

getClientTracker

public ClientTracker getClientTracker ()

Zwroty
`ClientTracker`

getClients

public ClientImpl[] getClients ()

Zwraca tablicę klientów.

Zwroty
`ClientImpl[]`

getDensity

public int getDensity ()

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

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

getFileListingService

public FileListingService getFileListingService ()

Zwraca FileListingService dla tego urządzenia.

Zwroty
`FileListingService`

getLanguage

public String getLanguage ()

Zwraca język użytkownika.

Zwroty
`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.

Zwroty
`InstallMetrics`	`InstallMetrics` dane opisujące instalację.

getMountPoint

public String getMountPoint (String name)

Zwraca punkt podłączenia.

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

Zwroty
`String`

getName

public String getName ()

Zwraca (zrozumiałą dla człowieka) nazwę tego urządzenia. W przypadku AVD jest to zwykle nazwa AVD, a w przypadku urządzeń – połączenie nazwy producenta, nazwy modelu i numeru seryjnego.

Zwroty
`String`

getNativeClients

public ClientImpl[] getNativeClients ()

Zwroty
`ClientImpl[]`

getNativeClients

public ClientImpl getNativeClients (String applicationName)

Parametry
`applicationName`	`String`

Zwroty
`ClientImpl`

getProfileableClients

public ProfileableClientImpl[] getProfileableClients ()

Zwraca tablicę klientów, których profile można tworzyć.

Zwroty
`ProfileableClientImpl[]`

getProperties

public  getProperties ()

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

Zwroty

getProperty

public String getProperty (String name)

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

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

Parametry
`name`	`String`: nazwa wartości do zwrócenia.

Zwroty
`String`	wartość lub `null`, jeśli wartość właściwości nie była od razu dostępna.

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

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.

Zwroty
`String`	wartość lub `null`, jeśli właściwość nie istnieje.

getPropertyCount

public int getPropertyCount ()

Zwraca liczbę usług na tym urządzeniu.

Zwroty
`int`

getPropertySync

public String getPropertySync (String name)

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 wszystkich niestabilnych właściwości.

Parametry
`name`	`String`: nazwa wartości do zwrócenia.

Zwroty
`String`	wartość lub `null`, jeśli właściwość nie istnieje.

getRegion

public String getRegion ()

Zwraca region użytkownika.

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

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

Parametry
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`

Zwroty
`String`

getScreenshot

public RawImage getScreenshot ()

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

Zwroty
`RawImage`	zrzut ekranu jako `RawImage` lub `null`, jeśli coś poszło nie tak.

Zgłasza
`AdbCommandRejectedException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Parametry
`timeout`	`long`
`unit`	`TimeUnit`

Zwroty
`RawImage`

Zgłasza
`AdbCommandRejectedException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

Zwraca numer seryjny urządzenia.

Zwroty
`String`

getState

public IDevice.DeviceState getState ()

Zwraca stan urządzenia.

Zwroty
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

Zwraca obiekt SyncService, który umożliwia przesyłanie plików na urządzenie i pobieranie ich z niego.

Zwroty
`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`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

Wykonywanie potencjalnego zapytania asynchronicznego dotyczącego właściwości systemu.

Parametry
`name`	`String`: nazwa wartości do zwrócenia.

Zwroty
`ListenableFuture<String>`	`ListenableFuture.` `ERROR(get/Future#get() get)` może zwracać wartość null.

hasClients

public boolean hasClients ()

Zwraca informację, czy IDevice ma Client.

Zwroty
`boolean`

installPackage

public 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ść (dopóki `receiver` nie anuluje wykonania) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
`maxTimeUnits`	`TimeUnit`: jednostki dla wartości innych niż zero w polach `maxTimeout` i `maxTimeToOutputResponse`.
`extraArgs`	`String`: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.

Zgłasza
`InstallException`

installPackage

public 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`

installPackage

public 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`

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 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`	: 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`	: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.

Zgłasza
`InstallException`

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 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`	: 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`	: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
`timeout`	`long`: limit czasu instalacji
`timeoutUnit`	`TimeUnit`: `ERROR(/TimeUnit)` odpowiadający parametrowi limitu czasu.

Zgłasza
`InstallException`

installRemotePackage

public 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`

installRemotePackage

public 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`

installRemotePackage

public 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ść (dopóki `receiver` nie anuluje wykonania) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
`maxTimeUnits`	`TimeUnit`: jednostki dla wartości innych niż zero w polach `maxTimeout` i `maxTimeToOutputResponse`.
`extraArgs`	`String`: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.

Zgłasza
`InstallException`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 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`	: lista ścieżek do plików APK na urządzeniu do zainstalowania
`reinstall`	`boolean`: ustaw wartość `true`, jeśli aplikacja ma zostać ponownie zainstalowana.
`installOptions`	: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.

Zgłasza
`InstallException`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 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`	: 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`	: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm install --help”.
`timeout`	`long`: limit czasu instalacji
`timeoutUnit`	`TimeUnit`: `ERROR(/TimeUnit)` odpowiadający parametrowi limitu czasu.

Zgłasza
`InstallException`

isBootLoader

public boolean isBootLoader ()

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

Zwroty
`boolean`	`true` if `getState()` zwraca `DeviceState.BOOTLOADER`.

isEmulator

public boolean isEmulator ()

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

Zwroty
`boolean`

isOffline

public boolean isOffline ()

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

Zwroty
`boolean`	`true` if `getState()` zwraca `DeviceState.OFFLINE`.

isOnline

public boolean isOnline ()

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

Zwroty
`boolean`	`true` if `getState()` zwraca `DeviceState.ONLINE`.

isRoot

public boolean isRoot ()

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

Zwroty
`boolean`	Wartość true, jeśli demon adb działa jako root, w przeciwnym razie wartość false.

Zgłasza
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

zabijać,

public void kill (String applicationName)

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

Parametry
`applicationName`	`String`: nazwa aplikacji

pullFile

public void pullFile (String remote, 
                String local)

Pobiera jeden plik.

Parametry
`remote`	`String`: pełna ścieżka do pliku zdalnego
`local`	`String`: lokalne miejsce docelowe.

Zgłasza
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

przesuwać,

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

Przesył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`
`SyncException`
`TimeoutException`

pushFile

public 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`
`SyncException`
`TimeoutException`

rawBinder

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

wywoływać usługę 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 bindera

Zwroty
`SocketChannel`	Kanał SocketChannel połączony z procesem wykonywanym na urządzeniu. po użyciu.

Zgłasza
`AdbCommandRejectedException`
`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 wykonywania. 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`

Zwroty
`SocketChannel`	Kanał SocketChannel połączony z procesem wykonywanym na urządzeniu. po użyciu.

Zgłasza
`AdbCommandRejectedException`
`TimeoutException`

Uruchom ponownie

public void reboot (String into)

Zrestartuj urządzenie.

Parametry
`into`	`String`: nazwa programu rozruchowego, do którego ma nastąpić ponowne uruchomienie, lub wartość null, jeśli urządzenie ma zostać tylko zrestartowane.

Zgłasza
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

Usuwa przekierowanie portu między portem lokalnym a zdalnym.

Parametry
`localPort`	`int`: lokalny port do przekazywania dalej

Zgłasza
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public 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`

removeReverse

public void removeReverse (int remotePort)

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

Parametry
`remotePort`	`int`: port zdalny.

Zgłasza
`AdbCommandRejectedException`
`TimeoutException`

root

public 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”.

Zwroty
`boolean`	Wartość true, jeśli demon adb działa jako root, w przeciwnym razie wartość false.

Zgłasza
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

startScreenRecorder

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

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

Parametry
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`
`receiver`	`IShellOutputReceiver`

Zgłasza
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature feature)

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

Parametry
`feature`	`IDevice.HardwareFeature`

Zwroty
`boolean`

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

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

Parametry
`feature`	`IDevice.Feature`

Zwroty
`boolean`

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

Przesyła plik na urządzenie

Parametry
`localFilePath`	`String`: ścieżka bezwzględna do pliku na hoście lokalnym,

Zwroty
`String`	`String` ścieżka docelowa pliku na urządzeniu

Zgłasza
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

toString

public String toString ()

Zwroty
`String`

uninstallApp

public 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”.

Zwroty
`String`	`String` z kodem błędu lub `null` w przypadku powodzenia.

Zgłasza
`InstallException`

uninstallPackage

public String uninstallPackage (String packageName)

Odinstalowuje pakiet z urządzenia.

Parametry
`packageName`	`String`: identyfikator aplikacji na Androida do odinstalowania

Zwroty
`String`	`String` z kodem błędu lub `null` w przypadku powodzenia.

Zgłasza
`InstallException`