W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

Konstruktory publiczne
`DeviceImpl(String serialNumber, IDevice.DeviceState deviceState)`

Metody publiczne
`boolean`	`arePropertiesSet()` Zwraca wartość `true`, jeśli właściwości 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`	`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())`.
`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`	`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.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, 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.
`List<String>`	`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.
`Future<Integer>`	`getBattery(long freshnessTime, TimeUnit timeUnit)` Zwraca poziom baterii urządzenia w procentach (od 0 do 100).
`Future<Integer>`	`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).
`int`	`getDensity()` Zwraca przedział 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.
`Map<String, String>`	`getProperties()` Zwraca właściwości urządzenia zapisane w pamięci podręcznej.
`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.
`String`	`getPropertyCacheOrSync(String name)` Połączenie wartości `getProperty(String)` i `getPropertySync(String)`, które spowoduje próbę pobrania właściwości z pamięci podręcznej.
`int`	`getPropertyCount()` Zwraca liczbę usług dla tego urządzenia.
`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` do przesyłania plików na urządzenie i z urządzenia.
`ListenableFuture<String>`	`getSystemProperty(String name)` Wykonywanie potencjalnego zapytania asynchronicznego dotyczącego właściwości systemu.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Instaluje aplikację na Androida na urządzeniu.
`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, String... extraArgs)` Instaluje aplikację na Androida na urządzeniu.
`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).
`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.
`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(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.
`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.
`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 pojedynczy plik.
`void`	`push(String[] local, String remote)` Wysyła kilka plików lub katalogów.
`void`	`pushFile(String local, String remote)` Wysyła pojedynczy plik.
`SocketChannel`	`rawBinder(String service, String[] parameters)` Wywoływanie usługi 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 portów 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 `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.

Konstruktory publiczne

DeviceImpl

public DeviceImpl (String serialNumber, 
                IDevice.DeviceState deviceState)

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

Metody publiczne

arePropertiesSet

public boolean arePropertiesSet ()

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

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

executeShellCommand

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

executeShellCommand

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

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

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

maxTimeToOutputResponse jest używany jako maksymalny czas oczekiwania, gdy oczekiwane jest wyjście 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 dane wyjściowe dziennika należy używać wartości maxTimeToOutputResponse 0, co oznacza, że metoda nigdy nie zgłosi wyjątku i będzie blokować działanie 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
`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.

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`

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.

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ść (do momentu, gdy `receiver` anuluje wykonanie) 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`
`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 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 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 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 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 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 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.

Zwraca
`Integer`	poziom 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. 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ć.

getDensity

public 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 FileListingService getFileListingService ()

Zwraca FileListingService dla tego urządzenia.

Zwraca
`FileListingService`

getLanguage

public 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 String getMountPoint (String name)

Zwraca punkt podłączenia.

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

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

Zwraca
`String`

getProperties

public Map<String, String> getProperties ()

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

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

getPropertyCount

public int getPropertyCount ()

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

Zwraca
`int`

getPropertySync

public String getPropertySync (String name)

Wariant funkcji getProperty(String), który próbuje pobrać podaną 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.

getRegion

public String getRegion ()

Zwraca region użytkownika.

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

Zwraca
`String`

getScreenshot

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

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

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

Zwraca
`RawImage`

Zgłasza
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

Zwraca numer seryjny urządzenia.

Zwraca
`String`

getState

public IDevice.DeviceState getState ()

Zwraca stan urządzenia.

Zwraca
`IDevice.DeviceState`

getSyncService

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

Zwraca
`ListenableFuture<String>`	`ListenableFuture.` `get` może zwracać wartość null.

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

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

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`

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ść (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`

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`

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`

isBootLoader

public 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 boolean isEmulator ()

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

Zwraca
`boolean`

isOffline

public boolean isOffline ()

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

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

isOnline

public boolean isOnline ()

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

Zwraca
`boolean`	`true` jeśli `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”.

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

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

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

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

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

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

poziom główny

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

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

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

startScreenRecorder

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

toString

public String toString ()

Zwraca
`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”.

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

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

Zgłasza
`InstallException`