NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

java.lang.Object
   ↳ com.android.tradefed.device.NativeDevice


Domyślna implementacja na ITestDevice urządzeniach z Androidem, które nie obsługują pełnego stosu.

Podsumowanie

Zagnieżdżone klasy

class NativeDevice.AdbAction

Wystąpił błąd ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) podczas uruchamiania polecenia systemowego „adb ....”. 

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) – ponowne uruchomienie urządzenia. 

Stałe

String DEBUGFS_PATH

int INVALID_USER_ID

Wartość zwracana w przypadku nieprawidłowego lub nieznalezionego identyfikatora użytkownika: UserHandle zdefiniował wartość -10000

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

domyślna liczba ponownych prób wykonania polecenia,

String SD_CARD

String STORAGE_EMULATED

Pola

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Konstruktory publiczne

NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Tworzy TestDevice.

Metody publiczne

String adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)

Zainstaluj pakiet Androida na urządzeniu za pomocą polecenia adb.

String adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Zainstaluj pakiet Androida na urządzeniu za pomocą polecenia adb.

void batchPrefetchStartupBuildProps()

Mikrooptymalizacja (ok. 400 milisekund) polegająca na wstępnym pobieraniu wszystkich potrzebnych właściwości zamiast wywoływania polecenia „adb getprop” dla każdej z nich.

boolean canSwitchToHeadlessSystemUser()

Zwraca informację, czy można przełączyć się na użytkownika SYSTEM bez interfejsu graficznego.

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Sprawdź, czy funkcja jest obecnie obsługiwana na minimalnym obsługiwanym poziomie.

boolean checkConnectivity()

Sprawdź, czy urządzenie ma połączenie z siecią.

boolean clearErrorDialogs()

Próba zamknięcia wszystkich okien dialogowych z błędami, które są obecnie wyświetlane w interfejsie urządzenia.

void clearLastConnectedWifiNetwork()

Usuwa ostatnią połączoną sieć Wi-Fi.

void clearLogcat()

Usuwa wszystkie zgromadzone dane logcat.

IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)

Wariant connectToWifiNetwork(String,String), który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z siecią.

IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk)

Wariant connectToWifiNetwork(String,String), który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z siecią.

IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)

Łączy się z siecią Wi-Fi.

IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)

Łączy się z siecią Wi-Fi.

IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)

Łączy się z siecią Wi-Fi.

IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)

Łączy się z siecią Wi-Fi.

int createUser(String name, boolean guest, boolean ephemeral)

Utwórz użytkownika o podanej nazwie i z podanymi flagami.

int createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)

Utwórz użytkownika o podanej nazwie i z podanymi flagami.

int createUser(String name)

Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.

int createUserNoThrow(String name)

Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.

DeviceInspectionResult debugDeviceNotAvailable()

sprawdzanie urządzenia i zwracanie szczegółowych informacji, gdy urządzenie staje się niedostępne;

void deleteFile(String deviceFilePath, int userId)

Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.

void deleteFile(String deviceFilePath)

Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione przez porównanie bieżącego serwera systemowego z poprzednim serwerem systemowym ProcessInfo.

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione od czasu UTC od początku epoki z urządzenia i jego TimeUnit.

boolean disableAdbRoot()

Wyłącza uprawnienia roota ADB.

void disableKeyguard()

próby wyłączenia blokady klawiatury,

boolean disableNetworkMonitor()

Wyłącza monitorowanie sieci na urządzeniu.

boolean disconnectFromWifi()

Rozłącza się z siecią Wi-Fi.

boolean doesFileExist(String deviceFilePath, int userId)

Metoda pomocnicza do określania, czy plik na urządzeniu istnieje dla danego użytkownika.

boolean doesFileExist(String deviceFilePath)

Metoda pomocnicza do sprawdzania, czy plik istnieje na urządzeniu.

File dumpHeap(String process, String devicePath)

Spróbuj zrzucić stertę z system_server.

boolean enableAdbRoot()

Włącza uprawnienia roota ADB.

boolean enableNetworkMonitor()

Włącza monitorowanie sieci na urządzeniu.

String executeAdbCommand(long timeout, String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

String executeAdbCommand(String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.

String executeAdbCommand(long timeout, Map<String, String> envMap, String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

CommandResult executeAdbV2Command(String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.

CommandResult executeAdbV2Command(long timeout, String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

CommandResult executeAdbV2Command(long timeout, Map<String, String> envMap, String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

CommandResult executeAdbV2Command(long timeout, Map<String, String> envMap, int retryAttempts, String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

CommandResult executeFastbootCommand(String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty.

CommandResult executeFastbootCommand(long timeout, String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe.

CommandResult executeLongFastbootCommand(String... cmdArgs)

Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe.

CommandResult executeLongFastbootCommand(Map<String, String> envVarMap, String... cmdArgs)

Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe ze zmiennymi środowiskowymi systemu.

String executeShellCommand(String command)

Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca dane wyjściowe jako String.

void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

void executeShellCommand(String command, IShellOutputReceiver receiver)

Wykonuje podane polecenie powłoki adb, ponawiając je wielokrotnie, jeśli się nie powiedzie.

CommandResult executeShellV2Command(String cmd)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.

CommandResult executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

CommandResult executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.

CommandResult executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia i stderr.

CommandResult executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

CommandResult executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie powłoki adb z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

CommandResult executeShellV2Command(String cmd, IShellOutputReceiver receiver)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.

CommandResult fastbootOemRamdumpNow()

Metoda pomocnicza, która wywołuje zrzut pamięci RAM w trybie fastboot.

CommandResult fastbootWipePartition(String partition)

Metoda pomocnicza, która czyści partycję urządzenia.

Set<ITestDevice.ApexInfo> getActiveApexes()

Pobiera informacje o pakietach APEX aktywowanych na urządzeniu.

String getAdbPath()

Zwraca ścieżkę używanego pliku binarnego adb.

Map<String, String> getAllSettings(String namespace)

Zwraca pary klucz-wartość żądanej przestrzeni nazw.

DeviceAllocationState getAllocationState()

Zwraca bieżący stan przydziału urządzenia.

String getAndroidId(int userId)

Znajduje i zwraca identyfikator Androida powiązany z identyfikatorem użytkownika. Jeśli nie znajdzie identyfikatora, zwraca wartość null.

Map<Integer, String> getAndroidIds()

Utwórz mapę identyfikatorów Androida pasujących do identyfikatorów użytkowników.

int getApiLevel()

Pobierz poziom interfejsu API urządzenia.

int getApiLevelFull()

Podobna do funkcji getApiLevel(), ale zwraca pełną wersję.

PackageInfo getAppPackageInfo(String packageName)

Pobiera informacje o pakiecie zainstalowanym na urządzeniu.

List<PackageInfo> getAppPackageInfos()

Pobieranie informacji o pakietach zainstalowanych na urządzeniu.

String getBasebandVersion()

Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia.

Integer getBattery()

Zwraca bieżący poziom baterii urządzenia lub wartość null, jeśli poziom baterii jest niedostępny.

boolean getBooleanProperty(String name, boolean defaultValue)

Zwraca wartość logiczną danej właściwości.

Map<Long, String> getBootHistory()

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem uruchamiania i przyczyną uruchomienia.

Map<Long, String> getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem uruchamiania i przyczyną uruchamiania od podanego czasu od początku epoki na urządzeniu oraz określoną jednostką czasu.

String getBootloaderVersion()

Wygodna metoda uzyskiwania wersji programu rozruchowego tego urządzenia.

InputStreamSource getBugreport()

Pobiera raport o błędzie z urządzenia.

InputStreamSource getBugreportz()

Pobiera z urządzenia raport o błędzie.

String getBuildAlias()

Pobierz alias kompilacji, na której obecnie działa urządzenie.

String getBuildFlavor()

Pobierz wersję kompilacji urządzenia.

String getBuildId()

Pobierz kompilację, na której obecnie działa urządzenie.

String getBuildSigningKeys()

Zwraca typ klucza użytego do podpisania obrazu urządzenia.

Urządzenia z Androidem są zwykle podpisywane kluczami testowymi (jak w AOSP) lub kluczami wersji (kontrolowanymi przez poszczególnych producentów urządzeń).

DeviceDescriptor getCachedDeviceDescriptor()

Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przydzielone, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przydzielone, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

String[] getChildren(String path)

Alternatywa dla używania IFileEntry, która czasami nie działa z powodu uprawnień.

AbstractConnection getConnection()

Aktualne połączenie powiązane z urządzeniem.

ContentProviderHandler getContentProvider(int userId)

Zwraca wartość ContentProviderHandler lub wartość null, jeśli nie jest dostępna.

DeviceFoldableState getCurrentFoldableState()

Zwraca bieżący stan urządzenia składanego lub wartość null, jeśli wystąpiły problemy.

int getCurrentUser()

Zwraca identyfikator aktualnie zalogowanego użytkownika.

String getDeviceClass()

Pobierz klasę urządzenia.

long getDeviceDate()

Zwraca datę urządzenia w milisekundach od początku epoki.

DeviceDescriptor getDeviceDescriptor()

Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o nim bez przekazywania rzeczywistego obiektu urządzenia.

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o nim bez przekazywania rzeczywistego obiektu urządzenia.

TestDeviceState getDeviceState()

Pobierz stan urządzenia.

long getDeviceTimeOffset(Date date)

Pomaga w określaniu różnicy czasu między urządzeniem a danym Date.

InputStreamSource getEmulatorOutput()

Pobieranie strumienia stdout i stderr emulatora

Process getEmulatorProcess()

Zwraca Process odpowiadający temu emulatorowi.

final File getExecuteShellCommandLog()

Dziennik zawierający wszystkie logi executeShellCommand(String).

long getExternalStoreFreeSpace()

Metoda pomocnicza do określania ilości wolnego miejsca w pamięci zewnętrznej urządzenia.

String getFastbootPath()

Zwraca ścieżkę używanego pliku binarnego fastboot.

String getFastbootProductType()

Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.

String getFastbootProductVariant()

Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.

String getFastbootSerialNumber()

Zwraca numer seryjny trybu fastboot.

String getFastbootVariable(String variableName)

Pobierz z urządzenia wartość podanej zmiennej fastboot.

String getFastbootVersion()

Zwraca ciąg znaków wersji używanego pliku binarnego fastboot.

IFileEntry getFileEntry(String path)

Pobieranie odwołania do pliku zdalnego na urządzeniu.

IFileEntry getFileEntry(FileListingService.FileEntry entry)

Nieoficjalne narzędzie pomocnicze do pobierania FileEntry ze ścieżki bez uprawnień roota.

Set<DeviceFoldableState> getFoldableStates()

Zwraca listę stanów urządzenia składanego.

IDevice getIDevice()

Zwraca odwołanie do powiązanej biblioteki ddmlib IDevice.

Set<String> getInstalledPackageNames()

Pobierz nazwy pakietów aplikacji znajdujących się na urządzeniu.

long getIntProperty(String name, long defaultValue)

Zwraca wartość całkowitą danej właściwości z urządzenia.

String getIpAddress()

Pobiera adres IP urządzenia.

KeyguardControllerState getKeyguardState()

Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest obsługiwany.

long getLastExpectedRebootTimeMillis()

Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie, w milisekundach od EPOCH, zgodnie z wartością zwracaną przez System.currentTimeMillis().

int getLaunchApiLevel()

Pobierz poziom API, na którym urządzenie zostało uruchomione po raz pierwszy.

InputStreamSource getLogcat()

Pobiera strumień zrzutu danych logcat.

InputStreamSource getLogcat(int maxBytes)

Pobiera strumień zrzutu ostatnich maxBytes danych logcat.

InputStreamSource getLogcatDump()

Pobierz zrzut bieżącego dziennika logcat z urządzenia.

InputStreamSource getLogcatSince(long date)

Pobiera strumień zrzutu przechwyconych danych logcat od podanej daty.

String getMacAddress()

Zwraca adres MAC urządzenia lub wartość null, jeśli nie można go pobrać z urządzenia.

Integer getMainUserId()

Zwraca główny identyfikator użytkownika.

Set<String> getMainlineModuleInfo()

Pobiera informacje o modułach głównych zainstalowanych na urządzeniu.

int getMaxNumberOfRunningUsersSupported()

Uzyskaj maksymalną liczbę obsługiwanych jednocześnie użytkowników.

int getMaxNumberOfUsersSupported(String userType)

Pobierz maksymalną liczbę obsługiwanych użytkowników danego typu.

int getMaxNumberOfUsersSupported()

Uzyskaj maksymalną liczbę obsługiwanych użytkowników, których można przełączać, z wyłączeniem gości.

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

Zwraca IDeviceStateMonitor powiązany z urządzeniem.

String getMountPoint(String mountName)

Zwraca punkt podłączenia.

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

Zwraca wartość MountPointInfo odpowiadającą określonej ścieżce punktu podłączania lub null, jeśli w tej ścieżce nic nie jest podłączone lub w inny sposób nie pojawia się w /proc/mounts jako punkt podłączania.

List<ITestDevice.MountPointInfo> getMountPointInfo()

Zwraca przeanalizowaną wersję informacji z pliku /proc/mounts na urządzeniu.

TestDeviceOptions getOptions()

Pobierz opcje testowania urządzenia.

long getPartitionFreeSpace(String partition)

Metoda pomocnicza do określania ilości wolnego miejsca na partycji urządzenia.

Integer getPrimaryUserId()

Zwraca identyfikator głównego użytkownika.

ProcessInfo getProcessByName(String processName)

Metoda pomocnicza uruchamia polecenia „pidof” i „stat” i zwraca obiekt ProcessInfo z identyfikatorem PID i czasem rozpoczęcia danego procesu.

String getProcessPid(String process)

Zwraca identyfikator procesu usługi lub wartość null, jeśli wystąpił błąd.

String getProductType()

Wygodna metoda uzyskiwania typu produktu tego urządzenia.

String getProductVariant()

Metoda ułatwiająca uzyskanie wersji produktu tego urządzenia.

String getProperty(String name)

Pobierz z urządzenia wartość danej właściwości.

ITestDevice.RecoveryMode getRecoveryMode()

Pobierz bieżący tryb odzyskiwania używany na urządzeniu.

int getRemainingCreatableUserCount(String userType)

Zwraca liczbę użytkowników danego typu, których można utworzyć na tym urządzeniu.

InputStreamSource getScreenshot(Long displayId, String format, boolean rescale)

Wykonuje zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza w obsługiwanym formacie.

InputStreamSource getScreenshot(String format)

Robi zrzut ekranu urządzenia.

InputStreamSource getScreenshot(long displayId)

Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza.

InputStreamSource getScreenshot(String format, boolean rescale)

Robi zrzut ekranu urządzenia.

InputStreamSource getScreenshot()

Robi zrzut ekranu urządzenia.

String getSerialNumber()

Wygodny sposób na uzyskanie numeru seryjnego tego urządzenia.

String getSetting(int userId, String namespace, String key)

Zwraca wartość żądanego ustawienia.

String getSetting(String namespace, String key)

Patrz getSetting(int,String,String) i wykonywane na użytkowniku systemu.

String getSimOperator()

Zwraca operatora karty SIM lub wartość null, jeśli nie jest dostępny lub urządzenie nie jest dostępne.

String getSimState()

Zwraca stan karty SIM lub wartość null, jeśli karta SIM jest niedostępna lub urządzenie jest niedostępne.

List<File> getTombstones()

Pobierz i zwróć listę znaczników usunięcia z urządzeń.

long getTotalMemory()

Zwraca łączny rozmiar pamięci fizycznej w bajtach lub -1 w przypadku błędu wewnętrznego.

String getTrackingSerial()

Na potrzeby zarządzania urządzeniem pobierz numer seryjny używany do śledzenia urządzenia.

Set<String> getUninstallablePackageNames()

Pobierz nazwy pakietów aplikacji, które można odinstalować.

boolean getUseFastbootErase()

Określa, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie fastboot erase czy fastboot format.

int getUserFlags(int userId)

Znajdź i zwróć flagi danego użytkownika.

Map<Integer, UserInfo> getUserInfos()

Pobiera mapę identyfikatorów użycia do UserInfo na urządzeniu.

int getUserSerialNumber(int userId)

Zwraca numer seryjny powiązany z identyfikatorem userId, jeśli zostanie znaleziony, lub -10000 w innych przypadkach.

int getUserVisibleOnDisplay(int displayId)

Pobiera identyfikator użytkownika widocznego na danym wyświetlaczu.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

Przetwarzanie danego zdarzenia DeviceEvent.

Przetwórz zdarzenie DeviceEvent, które może, ale nie musi, przenieść to urządzenie do nowego stanu przydziału.

boolean hasFeature(String feature)

Sprawdź, czy funkcja jest dostępna na urządzeniu.

void initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)

Zainicjuj połączenie z urządzeniem.

String installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Zainstaluj pakiet Androida na urządzeniu.

String installPackage(File packageFile, boolean reinstall, String... extraArgs)

Zainstaluj pakiet Androida na urządzeniu.

String installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.

String installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)

Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.

boolean installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)

Instaluje pliki APK w trybie przyrostowym.

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczanie aplikacji

boolean isBypassLowTargetSdkBlockSupported()

Sprawdzanie, czy platforma na urządzeniu obsługuje omijanie blokady niskiego docelowego pakietu SDK podczas instalowania aplikacji

boolean isDebugfsMounted()

Sprawdź, czy debugfs jest zamontowany.

boolean isDeviceEncrypted()

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

boolean isDirectory(String path)

Zwraca wartość Prawda, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość Fałsz.

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

Wyświetla informację o tym, czy urządzenie obsługuje szyfrowanie.

boolean isExecutable(String fullPath)

Zwraca wartość Prawda, jeśli ścieżka pliku na urządzeniu prowadzi do pliku wykonywalnego, w przeciwnym razie zwraca wartość Fałsz.

boolean isFastbootEnabled()

Zwraca wartość, jeśli tryb Fastboot jest dostępny na urządzeniu.

boolean isHeadless()

Zwraca wartość „true”, jeśli urządzenie nie ma ekranu, w przeciwnym razie zwraca wartość „false”.

boolean isHeadlessSystemUserMode()

Zwraca informację o tym, czy urządzenie korzysta z trybu użytkownika systemu bez interfejsu graficznego.

boolean isMainUserPermanentAdmin()

Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani obniżyć jego uprawnień do poziomu użytkownika bez uprawnień administracyjnych.

boolean isMultiUserSupported()

Zwraca informację, czy to urządzenie obsługuje wielu użytkowników z możliwością przełączania, którzy mają własne loginy i konfigurowalne przestrzenie.

boolean isPackageInstalled(String packageName, String userId)

Wysyła zapytanie do urządzenia o daną nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana dla tego użytkownika.

boolean isPackageInstalled(String packageName)

Wysyłaj do urządzenia zapytania o daną nazwę pakietu, aby sprawdzić, czy jest on obecnie zainstalowany.

boolean isRuntimePermissionSupported()

Sprawdzanie, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie działania

boolean isShellV2Support()
boolean isStateBootloaderOrFastbootd()

Zwraca wartość „prawda”, jeśli urządzenie jest w stanie TestDeviceState.FASTBOOT lub TestDeviceState.FASTBOOTD.

boolean isUserRunning(int userId)

Sprawdź, czy dany użytkownik jest aktywny.

boolean isUserSecondary(int userId)

Zwraca informację, czy określony użytkownik jest użytkownikiem dodatkowym na podstawie jego flag.

boolean isUserVisible(int userId)

Sprawdza, czy dany użytkownik jest widoczny.

boolean isUserVisibleOnDisplay(int userId, int displayId)

Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

Zwraca informację, czy urządzenie zezwala na uruchamianie aplikacji w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

boolean isVisibleBackgroundUsersSupported()

Zwraca informację, czy urządzenie zezwala na uruchamianie użytkowników widocznych w tle.

boolean isWifiEnabled()

Sprawdź, czy Wi-Fi jest włączone.

Set<Long> listDisplayIds()

Zbierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, zgodnie z raportem „dumpsys SurfaceFlinger”.

Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers()

Pobiera listę wyświetlaczy, których można używać do start a user visible in the background.

ArrayList<Integer> listUsers()

Pobiera listę użytkowników na urządzeniu.

boolean logAnrs(ITestLogger logger)

Zbiera i rejestruje błędy ANR z urządzenia.

boolean logBugreport(String dataName, ITestLogger listener)

Metoda pomocnicza służąca do tworzenia raportu o błędzie i przesyłania go do osób zgłaszających.

void logOnDevice(String tag, Log.LogLevel level, String format, Object... args)

Zapisz wiadomość w logcat urządzenia.

void mountDebugfs()

Podłącz debugfs.

void nonBlockingReboot()

Wydaje polecenie ponownego uruchomienia urządzenia i zwraca wynik po zakończeniu polecenia oraz gdy urządzenie nie jest już widoczne dla adb.

void postAdbRootAction()

Zastąp, jeśli urządzenie wymaga podjęcia określonych działań po uzyskaniu dostępu do roota za pomocą adb i przed ponownym połączeniem z siecią.

void postAdbUnrootAction()

Zastąp, jeśli po odrootowaniu za pomocą narzędzia adb i przed ponownym połączeniem urządzenia z siecią trzeba wykonać na nim określone działania.

void postBootSetup()

Wykonaj instrukcje, aby skonfigurować urządzenie do testowania po każdym uruchomieniu.

void postInvocationTearDown(Throwable exception)

Dodatkowe czynności wymagane do zwolnienia miejsca na urządzeniu, które zostaną wykonane po zakończeniu wywołania.

void preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)

Dodatkowe czynności wymagane do skonfigurowania urządzenia, które zostaną wykonane na urządzeniu przed wywołaniem przepływu.

boolean pullDir(String deviceFilePath, File localDir, int userId)

Rekursywne pobieranie zawartości katalogu z urządzenia.

boolean pullDir(String deviceFilePath, File localDir)

Rekursywne pobieranie zawartości katalogu z urządzenia.

boolean pullDir(String deviceFilePath, File localDir, int userId, long timeout)

Rekursywne pobieranie zawartości katalogu z urządzenia.

boolean pullFile(String remoteFilePath, File localFile, int userId, long timeout)

Pobiera plik z urządzenia.

boolean pullFile(String remoteFilePath, File localFile)

Pobiera plik z urządzenia.

File pullFile(String remoteFilePath, int userId)

Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym File i zwraca ten File.

File pullFile(String remoteFilePath)

Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym File i zwraca ten File.

boolean pullFile(String remoteFilePath, File localFile, int userId)

Pobiera plik z urządzenia.

String pullFileContents(String remoteFilePath)

Pobiera plik z urządzenia i zwraca jego zawartość.

File pullFileFromExternal(String remoteFilePath)

Wygodna metoda pobierania pliku z pamięci zewnętrznej urządzenia, zapisywania go w lokalnym tymczasowym File i zwracania odwołania do tego File.

boolean pushDir(File localFileDir, String deviceFilePath, int userId)

Rekursywne przekazywanie zawartości katalogu na urządzenie.

boolean pushDir(File localFileDir, String deviceFilePath, Set<String> excludedDirectories)

Rekursywne przesyłanie zawartości katalogu na urządzenie z wykluczeniem niektórych katalogów, które są filtrowane.

boolean pushDir(File localFileDir, String deviceFilePath)

Rekursywne przekazywanie zawartości katalogu na urządzenie.

boolean pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)

Wariant funkcji pushFile(File,String), który może opcjonalnie uwzględniać ocenę potrzeb dostawcy treści.

boolean pushFile(File localFile, String remoteFilePath)

Przekaż plik na urządzenie.

boolean pushFile(File localFile, String remoteFilePath, int userId)

Przekaż plik na urządzenie.

boolean pushString(String contents, String remoteFilePath)

Przesyłanie na urządzenie pliku utworzonego z ciągu znaków

void reboot(String reason)

Uruchamia ponownie urządzenie w trybie adb z podanym parametrem reason, który będzie zachowywany po ponownym uruchomieniu.

String reboot(String command, String reason)

Ponownie uruchamia urządzenie za pomocą podanego parametru command.

void reboot()

Uruchamia ponownie urządzenie w trybie adb.

void rebootIntoBootloader()

Uruchamia ponownie urządzenie w trybie programu rozruchowego.

void rebootIntoFastbootd()

Uruchamia ponownie urządzenie w trybie fastbootd.

void rebootIntoRecovery()

Uruchamia ponownie urządzenie w trybie odzyskiwania adb.

void rebootIntoSideload()

Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach odzyskiwania).

Blokuje działanie do momentu przejścia urządzenia w tryb wczytywania z boku

void rebootIntoSideload(boolean autoReboot)

Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach odzyskiwania).

Blokuje działanie do momentu przejścia urządzenia w tryb wczytywania z boku

void rebootUntilOnline()

Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.

void rebootUntilOnline(String reason)

Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.

void rebootUserspace()

Ponowne uruchomienie tylko części urządzenia w przestrzeni użytkownika.

void rebootUserspaceUntilOnline()

Alternatywa dla rebootUserspace() ()}, która blokuje tylko do momentu, gdy urządzenie jest online, tzn. widoczne dla adb.

boolean recoverDevice()

Próbuje przywrócić komunikację z urządzeniem.

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver na tym urządzeniu.

void remountSystemReadOnly()

Ustaw partycję systemową na urządzeniu jako tylko do odczytu.

void remountSystemWritable()

Ustaw partycję systemową na urządzeniu jako zapisywalną.

void remountVendorReadOnly()

Ustaw partycję dostawcy na urządzeniu jako tylko do odczytu.

void remountVendorWritable()

Umożliwia zapisywanie na partycji dostawcy na urządzeniu.

boolean removeAdmin(String componentName, int userId)

Usuwa administratora danego urządzenia z konta danego użytkownika i zwraca true, jeśli operacja się uda, lub false w przeciwnym razie.

void removeOwners()

Usuń wszystkich obecnych właścicieli profilu urządzenia, korzystając z zasady możliwie najlepszej obsługi.

boolean removeUser(int userId)

Usuń danego użytkownika z urządzenia.

void resetContentProviderSetup()

Zresetuj flagę konfiguracji dostawcy treści, aby ponownie ją wywołać.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, Collection<ITestLifeCycleReceiver> listeners)

Uruchamia testy z instrumentacją i umożliwia przywracanie urządzeń.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

Wygodna metoda wykonywania runInstrumentationTests(IRemoteAndroidTestRunner,Collection) z co najmniej 1 odbiornikiem przekazanym jako parametr.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, Collection<ITestLifeCycleReceiver> listeners)

Podobnie jak ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection), ale przeprowadza test dla danego użytkownika.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

Tak samo jak ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,ITestLifeCycleReceiver...), ale uruchamia test dla danego użytkownika.

void setAdbPath(String adbPath)

Ustawia ścieżkę do pliku binarnego adb, który ma być używany.

void setConfiguration(IConfiguration configuration)

Wstawia używaną wartość IConfiguration.

final void setConnectionAvdInfo(GceAvdInfo avdInfo)
void setDate(Date date)

Ustawia datę na urządzeniu

Uwaga: ustawienie daty na urządzeniu wymaga dostępu do roota.

boolean setDeviceOwner(String componentName, int userId)

Ustawianie komponentu administratora urządzenia jako właściciela urządzenia w przypadku danego użytkownika.

void setDeviceState(TestDeviceState deviceState)

Zaktualizuj stan urządzenia.

void setEmulatorOutputStream(SizeLimitedOutputStream output)

W przypadku emulatora ustaw SizeLimitedOutputStream, aby rejestrować dane wyjściowe.

void setEmulatorProcess(Process p)

Ustawia Process, gdy urządzenie jest emulatorem.

void setFastbootEnabled(boolean fastbootEnabled)

Ustaw opcję fastboot dla urządzenia.

void setFastbootPath(String fastbootPath)

Ustawia ścieżkę do pliku binarnego fastboot, który ma być używany.

void setIDevice(IDevice newDevice)

Zaktualizuj urządzenie iDevice powiązane z tym urządzeniem ITestDevice.

void setLogStartDelay(int delay)

Określa czas (w milisekundach) oczekiwania przed rozpoczęciem przechwytywania logcat na urządzeniu online.

void setOptions(TestDeviceOptions options)

Ustaw TestDeviceOptions dla urządzenia

boolean setProperty(String propKey, String propValue)

Ustawia na urządzeniu podaną wartość właściwości.

void setRecovery(IDeviceRecovery recovery)

Ustaw numer IDeviceRecovery, który ma być używany na tym urządzeniu.

void setRecoveryMode(ITestDevice.RecoveryMode mode)

Ustaw bieżący tryb odzyskiwania, który ma być używany na urządzeniu.

void setSetting(String namespace, String key, String value)

Patrz setSetting(int,String,String,String) i wykonywane na użytkowniku systemu.

void setSetting(int userId, String namespace, String key, String value)

Dodaj wartość ustawienia do przestrzeni nazw danego użytkownika.

void setTestLogger(ITestLogger testLogger)

Wstrzykuje instancję ITestLogger

void setTrackingSerial(String trackingSerial)

Do celów zarządzania urządzeniami śledzimy numer seryjny, którego używamy do odwoływania się do urządzenia.

void setUseFastbootErase(boolean useFastbootErase)

Określ, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie fastboot erase czy fastboot format.

void startLogcat()

Rozpocznij przechwytywanie danych wyjściowych logcat z urządzenia w tle.

boolean startTradeInModeTesting(int timeoutMs)

Włącz tryb testowania wymiany za dopłatą.

boolean startUser(int userId)

Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany.

boolean startUser(int userId, boolean waitFlag)

Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany.

boolean startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)

Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli umożliwia użytkownikowi uruchamianie aktywności na tym wyświetlaczu).

void stopEmulatorOutput()

Zamknij i usuń dane wyjściowe emulatora.

void stopLogcat()

Przestań rejestrować dane wyjściowe logcat z urządzenia i odrzuć aktualnie zapisane dane logcat.

void stopTradeInModeTesting()

Zakończ testowanie trybu wymiany za dopłatą.

boolean stopUser(int userId)

Zatrzymuje danego użytkownika.

boolean stopUser(int userId, boolean waitFlag, boolean forceFlag)

Zatrzymanie danego użytkownika.

String switchToAdbTcp()

Przełącz urządzenie w tryb adb-over-tcp.

boolean switchToAdbUsb()

Przełącz urządzenie w tryb adb over usb.

boolean switchUser(int userId)

Przełącz na inny identyfikator użytkownika z domyślnym czasem oczekiwania.

boolean switchUser(int userId, long timeout)

Przełącza się na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem.

boolean syncFiles(File localFileDir, String deviceFilePath)

Przyrostowo synchronizuje zawartość lokalnego katalogu plików z urządzeniem.

Bugreport takeBugreport()

Pobiera raport o błędzie i zwraca go w obiekcie Bugreport, aby go obsłużyć.

String uninstallPackage(String packageName)

Odinstaluj pakiet Androida z urządzenia.

String uninstallPackageForUser(String packageName, int userId)

Odinstaluj pakiet Androida z urządzenia dla danego użytkownika.

boolean unlockDevice()

Odblokowuje urządzenie, jeśli jest ono zaszyfrowane.

void unmountDebugfs()

Odłącz debugfs.

boolean waitForBootComplete(long timeOut)

Blokuje do momentu ustawienia flagi zakończenia rozruchu urządzenia.

boolean waitForDeviceAvailable()

Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania.

boolean waitForDeviceAvailable(long waitTime)

Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania.

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Czeka na odpowiedź urządzenia i jego dostępność bez uwzględniania ścieżki przywracania.

void waitForDeviceBootloader()

Blokuje działanie, dopóki urządzenie nie będzie widoczne w trybie fastboot.

void waitForDeviceFastbootD()
boolean waitForDeviceInRecovery(long waitTime)

Blokuje możliwość przejścia urządzenia w stan „adb recovery” (uwaga: różni się od IDeviceRecovery).

boolean waitForDeviceInSideload(long waitTime)

Blokuje urządzenie w stanie „adb sideload”

boolean waitForDeviceNotAvailable(long waitTime)

Blokuje urządzenie, aby było niedostępne, np. nie było widoczne w adb.

void waitForDeviceOnline()

Blokuje do momentu, aż urządzenie będzie widoczne przez adb.

void waitForDeviceOnline(long waitTime)

Blokuje do momentu, aż urządzenie będzie widoczne przez adb.

boolean waitForDeviceShell(long waitTime)

Czeka, aż urządzenie odpowie na podstawowe polecenie powłoki adb.

Metody chronione

void addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
String[] buildAdbShellCommand(String command, boolean forceExitStatusDetection, boolean oldShellCommand)

Tworzy polecenie systemu operacyjnego dla danej sesji polecenia powłoki adb i argumentów.

void checkApiLevelAgainst(String feature, int strictMinLevel)
NativeDevice.RebootDeviceAction createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)

Utwórz RebootDeviceAction, który będzie używany podczas restartowania.

IRunUtil createRunUtil()
void doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)

Wykonaj ponowne uruchomienie za pomocą polecenia adb.

void ensureRuntimePermissionSupported()

metoda pomocnicza do zgłaszania wyjątku, jeśli uprawnienia w czasie działania (aplikacji) nie są obsługiwane

int getApiLevelSafe()
ITestLogger getLogger()
IRunUtil getRunUtil()

Uzyskaj instancję RunUtil, której chcesz użyć.

String internalGetProperty(String propName, String fastbootVar, String description)

Pobiera właściwość urządzenia z pamięci podręcznej ddmlib (domyślnie) lub z polecenia `adb shell getprop` albo `fastboot getvar` w zależności od tego, czy urządzenie jest w trybie Fastboot.

boolean isInRebootCallback()

Zwraca informację, czy wywołania zwrotne ponownego uruchomienia są obecnie wykonywane.

boolean isNewer(File localFile, IFileEntry entry)

Zwraca true, jeśli plik lokalny jest nowszy niż plik zdalny.

void notifyRebootEnded()

Powiadamia wszystkie IDeviceActionReceiver o zakończeniu ponownego uruchamiania.

void notifyRebootStarted()

Powiadamia wszystkie urządzenia IDeviceActionReceiver o rozpoczęciu ponownego uruchamiania.

boolean performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)

Wykonuje działanie na tym urządzeniu.

void postAdbReboot(NativeDevice.RebootMode rebootMode)

Możliwe dodatkowe działania, które można wykonać po ponownym uruchomieniu.

void prePostBootSetup()

Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w celu przeprowadzenia konfiguracji po uruchomieniu.

boolean pullFileWithAdbCommand(String remoteFilePath, File localFile, long timeout)
void setClock(Clock clock)

Ustaw instancję zegara, której chcesz używać.

void setMicrodroidProcess(Process process)

Oznacza TestDevice jako microdroid i ustawia jego ID klienta.

void setTestDeviceOptions(Map<String, String> deviceOptions)
CommandResult simpleFastbootCommand(long timeout, String[] fullCmd)

Wykonuje proste polecenie fastboot i zgłasza jego stan.

CommandResult simpleFastbootCommand(long timeout, Map<String, String> envVarMap, String[] fullCmd)

Wykonuje proste polecenie fastboot ze zmiennymi środowiskowymi i zgłasza stan polecenia.

boolean waitForDeviceNotAvailable(String operationDesc, long time)

Poczekaj, aż urządzenie stanie się niedostępne (przestanie przesyłać raporty do adb).

Stałe

DEBUGFS_PATH

public static final String DEBUGFS_PATH

Wartość stała: "/sys/kernel/debug"

INVALID_USER_ID

public static final int INVALID_USER_ID

Wartość zwracana w przypadku nieprawidłowego lub nieznalezionego identyfikatora użytkownika: UserHandle zdefiniował wartość -10000

Wartość stała: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Wartość stała: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

domyślna liczba ponownych prób wykonania polecenia,

Wartość stała: 2 (0x00000002)

SD_CARD

protected static final String SD_CARD

Wartość stała: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Wartość stała: "/storage/emulated/"

Pola

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Konstruktory publiczne

NativeDevice

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Tworzy TestDevice.

Parametry
device IDevice: powiązany IDevice

stateMonitor IDeviceStateMonitor: mechanizm IDeviceStateMonitor, którego chcesz użyć.

allocationMonitor IDeviceMonitor: IDeviceMonitor, aby informować o zmianach stanu przydziału. Może mieć wartość null

Metody publiczne

adbInstallPackage

public String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Zainstaluj pakiet Androida na urządzeniu za pomocą polecenia adb.

Parametry
packageFile File: plik APK do zainstalowania

reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.

extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.

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

Zgłasza
DeviceNotAvailableException

adbInstallPackage

public String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Zainstaluj pakiet Androida na urządzeniu za pomocą polecenia adb.

Uwaga: tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas instalacji.

Parametry
packageFile File: plik APK do zainstalowania

reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.

grantPermissions boolean: czy wszystkie uprawnienia czasu działania mają być przyznawane w momencie instalacji.

extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.

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

Zgłasza
DeviceNotAvailableException

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Mikrooptymalizacja (ok. 400 milisekund) dzięki wstępnemu pobieraniu wszystkich potrzebnych właściwości zamiast wywoływania polecenia „adb getprop” dla każdej z nich. Oznacza to, że pobranie wszystkich właściwości trwa tyle samo czasu co pobranie jednej. Funkcje takie jak device.getApiLevel(), checkApiLevelAgainstNextRelease i getBuildAlias wywołują w tle polecenie `adb getprop`. Pobieramy je w ramach jednego wywołania i wywołujemy NativeDevice.setProperty. Nawet jeśli tego nie zrobimy, NativeDevice sam wywoła setProperty i zapisze w pamięci podręcznej wynik na potrzeby przyszłych wywołań. Po prostu robimy to nieco wcześniej. Jeśli urządzenie jest w trybie odzyskiwania lub występują inne błędy pobierania właściwości, po prostu je ignorujemy.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Zwraca informację, czy można przełączyć się na użytkownika SYSTEM bez interfejsu graficznego.

Zwraca
boolean

Zgłasza
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Sprawdź, czy funkcja jest obecnie obsługiwana na minimalnym poziomie obsługi. Ta metoda uwzględnia jeszcze nieopublikowane funkcje, zanim poziom interfejsu API zostanie podniesiony.

Parametry
strictMinLevel int: najniższy możliwy poziom, który obsługuje tę funkcję.

Zwraca
boolean Prawda, jeśli poziom jest obsługiwany. W przeciwnym razie ma wartość Fałsz.

Zgłasza
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

Sprawdź, czy urządzenie ma połączenie z siecią.

Zwraca
boolean true jeśli urządzenie ma aktywne połączenie z siecią, false w przeciwnym razie.

Zgłasza
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

Próba zamknięcia wszystkich okien dialogowych z błędami, które są obecnie wyświetlane w interfejsie urządzenia.

Zwraca
boolean true – jeśli nie było żadnych okien lub zostały one pomyślnie zamknięte. false w przeciwnym razie.

Zgłasza
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Usuwa ostatnią połączoną sieć Wi-Fi. Tę metodę należy wywołać podczas rozpoczynania nowego wywołania, aby uniknąć łączenia się z siecią Wi-Fi używaną w poprzednim teście po ponownym uruchomieniu urządzenia.

clearLogcat

public void clearLogcat ()

Usuwa wszystkie zgromadzone dane logcat.

Jest to przydatne w sytuacjach, gdy chcesz mieć pewność, że ITestDevice.getLogcat() zwraca tylko dane logowania wygenerowane po określonym momencie (np. po wgraniu nowej wersji urządzenia).

connectToWifiNetworkIfNeededWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Wariant connectToWifiNetwork(String,String), który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z siecią.

Parametry
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.

Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.

Zgłasza
DeviceNotAvailableException

connectToWifiNetworkIfNeededWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk)

Wariant connectToWifiNetwork(String,String), który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z siecią.

Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.

Zgłasza
DeviceNotAvailableException

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Łączy się z siecią Wi-Fi.

Włącza Wi-Fi i blokuje działanie do czasu nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi() lub ITestDevice.clearLastConnectedWifiNetwork().

Parametry
wifiSsid String: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć.

wifiPsk String: hasło PSK lub wartość null, jeśli połączenie nie jest szyfrowane.

scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.

Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.

Zgłasza
DeviceNotAvailableException

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

Łączy się z siecią Wi-Fi.

Włącza Wi-Fi i blokuje połączenie do momentu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi() lub ITestDevice.clearLastConnectedWifiNetwork().

Parametry
wifiSsidToPsk Map: mapa identyfikatorów SSID sieci Wi-Fi do haseł.

Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.

Zgłasza
DeviceNotAvailableException

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

Łączy się z siecią Wi-Fi.

Włącza Wi-Fi i blokuje połączenie do momentu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi() lub ITestDevice.clearLastConnectedWifiNetwork().

Parametry
wifiSsidToPsk Map: mapa identyfikatorów SSID sieci Wi-Fi do haseł.

scanSsid boolean: czy skanować ukryte identyfikatory SSID w tej sieci.

Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.

Zgłasza
DeviceNotAvailableException

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk)

Łączy się z siecią Wi-Fi.

Włącza Wi-Fi i blokuje działanie do czasu nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi() lub ITestDevice.clearLastConnectedWifiNetwork().

Parametry
wifiSsid String: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć.

wifiPsk String: hasło PSK lub wartość null, jeśli połączenie nie jest szyfrowane.

Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.

Zgłasza
DeviceNotAvailableException

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Utwórz użytkownika o podanej nazwie i z podanymi flagami.

Parametry
name String: użytkownika na urządzeniu

guest boolean: włącz flagę użytkownika --guest podczas tworzenia.

ephemeral boolean: włącz flagę użytkownika --ephemeral podczas tworzenia

Zwraca
int identyfikator utworzonego użytkownika;

Zgłasza
DeviceNotAvailableException
IllegalStateException

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Utwórz użytkownika o podanej nazwie i z podanymi flagami.

Parametry
name String: użytkownika na urządzeniu

guest boolean: włącz flagę użytkownika --guest podczas tworzenia.

ephemeral boolean: włącz flagę użytkownika --ephemeral podczas tworzenia

forTesting boolean: włącz flagę testową --for-testing podczas tworzenia

Zwraca
int identyfikator utworzonego użytkownika;

Zgłasza
DeviceNotAvailableException
IllegalStateException

createUser

public int createUser (String name)

Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.

Parametry
name String: użytkownika na urządzeniu

Zwraca
int liczba całkowita utworzonego identyfikatora użytkownika.

Zgłasza
DeviceNotAvailableException
IllegalStateException

createUserNoThrow

public int createUserNoThrow (String name)

Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.

Parametry
name String: użytkownika na urządzeniu

Zwraca
int liczba całkowita identyfikatora utworzonego użytkownika lub -1 w przypadku błędu.

Zgłasza
DeviceNotAvailableException

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

sprawdzanie urządzenia i zwracanie szczegółowych informacji, gdy urządzenie staje się niedostępne;

Zwraca
DeviceInspectionResult

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.

Parametry
deviceFilePath String: ścieżka bezwzględna pliku na urządzeniu.

userId int: identyfikator użytkownika do usunięcia.

Zgłasza
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath)

Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.

Parametry
deviceFilePath String: ścieżka bezwzględna pliku na urządzeniu.

Zgłasza
DeviceNotAvailableException

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver.

Parametry
deviceActionReceiver IDeviceActionReceiver: IDeviceActionReceiver, który zostanie usunięty.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione przez porównanie bieżącego serwera systemowego z poprzednim serwerem systemowym ProcessInfo. Aby skorzystać z promocji ProcessInfo, użyj getProcessByName(String).

Parametry
prevSystemServerProcess ProcessInfo: poprzedni proces system_serverProcessInfo.

Zwraca
boolean true – jeśli urządzenie zostało zrestartowane programowo.

Zgłasza
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione od czasu UTC od początku epoki z urządzenia i jego TimeUnit. Miękkie ponowne uruchomienie oznacza ponowne uruchomienie system_server poza twardym ponownym uruchomieniem urządzenia (np. na żądanie). Bieżący czas utcEpochTime urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate().

Parametry
utcEpochTime long: czas urządzenia w sekundach od początku epoki.

timeUnit TimeUnit: jednostka czasu TimeUnit dla danego parametru utcEpochTime.

Zwraca
boolean true – jeśli urządzenie zostało zrestartowane programowo.

Zgłasza
DeviceNotAvailableException

disableAdbRoot

public boolean disableAdbRoot ()

Wyłącza uprawnienia roota ADB.

Wyłączenie uprawnień roota adb może spowodować odłączenie urządzenia od adb. Ta metoda będzie blokować działanie programu do momentu, aż urządzenie będzie dostępne.

Zwraca
boolean true, jeśli się uda.

Zgłasza
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

próby wyłączenia blokady klawiatury,

Najpierw poczekaj, aż wysyłanie danych wejściowych będzie gotowe. Dzieje się to mniej więcej w tym samym czasie, gdy urządzenie zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ bieżąca implementacja platformy czasami powoduje sytuację wyścigu. Następnie wysyłane jest polecenie zamknięcia ekranu blokady (działa tylko w przypadku niezabezpieczonych ekranów blokady).

Zgłasza
DeviceNotAvailableException

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Wyłącza monitorowanie sieci na urządzeniu.

Zwraca
boolean true, jeśli monitorowanie zostało wyłączone. false jeśli się nie powiodło.

Zgłasza
DeviceNotAvailableException

disconnectFromWifi

public boolean disconnectFromWifi ()

Rozłącza się z siecią Wi-Fi.

Usuwa wszystkie sieci z listy znanych sieci i wyłącza Wi-Fi.

Zwraca
boolean true, jeśli połączenie z siecią Wi-Fi zostało zakończone. false jeśli nie udało się odłączyć.

Zgłasza
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Metoda pomocnicza do określania, czy plik na urządzeniu istnieje dla danego użytkownika.

Parametry
deviceFilePath String: ścieżka bezwzględna do pliku na urządzeniu, który ma zostać sprawdzony

userId int: identyfikator użytkownika, względem którego należy sprawdzić istnienie pliku.

Zwraca
boolean true, jeśli plik istnieje, false w przeciwnym razie.

Zgłasza
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Metoda pomocnicza do sprawdzania, czy plik istnieje na urządzeniu.

Parametry
deviceFilePath String: ścieżka bezwzględna do pliku na urządzeniu, który ma zostać sprawdzony

Zwraca
boolean true, jeśli plik istnieje, false w przeciwnym razie.

Zgłasza
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Spróbuj zrzucić stertę z system_server. Za usunięcie zrzutu pliku odpowiada osoba wywołująca.

Parametry
process String: nazwa procesu na urządzeniu, dla którego chcesz utworzyć zrzut pamięci.

devicePath String: ścieżka na urządzeniu, w której ma się znaleźć zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia.

Zwraca
File File zawierający raport. Wartość null, jeśli coś się nie powiodło.

Zgłasza
DeviceNotAvailableException

enableAdbRoot

public boolean enableAdbRoot ()

Włącza uprawnienia roota ADB. Jeśli ustawienie „enable-root” ma wartość „false”, zostanie zarejestrowany komunikat i zwrócona wartość bez włączania dostępu do roota.

Włączenie adb root może spowodować odłączenie urządzenia od adb. Ta metoda będzie blokować działanie programu do momentu, aż urządzenie będzie dostępne.

Zwraca
boolean true, jeśli się uda.

Zgłasza
DeviceNotAvailableException

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Włącza monitorowanie sieci na urządzeniu.

Zwraca
boolean true, jeśli monitorowanie zostało włączone. false jeśli się nie powiodło.

Zgłasza
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu.

cmdArgs String: polecenie adb i argumenty do uruchomienia.

Zwraca
String standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia.

Zgłasza
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
cmdArgs String: polecenie adb i argumenty do uruchomienia.

Zwraca
String standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia.

Zgłasza
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (long timeout, 
                Map<String, String> envMap, 
                String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu.

envMap Map: środowisko, które ma być ustawione dla polecenia

cmdArgs String: polecenie adb i argumenty do uruchomienia.

Zwraca
String standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia.

Zgłasza
DeviceNotAvailableException

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
cmdArgs String: polecenie adb i argumenty do uruchomienia.

Zwraca
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia.

Zgłasza
DeviceNotAvailableException

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu.

cmdArgs String: polecenie adb i argumenty do uruchomienia.

Zwraca
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia.

Zgłasza
DeviceNotAvailableException

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu.

envMap Map: środowisko, które ma być ustawione dla polecenia

cmdArgs String: polecenie adb i argumenty do uruchomienia.

Zwraca
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia.

Zgłasza
DeviceNotAvailableException

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                int retryAttempts, 
                String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu.

envMap Map: środowisko, które ma być ustawione dla polecenia

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

cmdArgs String: polecenie adb i argumenty do uruchomienia.

Zwraca
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia.

Zgłasza
DeviceNotAvailableException

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty.

Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.

Parametry
cmdArgs String: polecenie fastboot i argumenty do uruchomienia.

Zwraca
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

Zgłasza
DeviceNotAvailableException
UnsupportedOperationException

executeFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe.

Oczekiwane użycie, gdy urządzenie jest już w trybie fastboot.

Parametry
timeout long: czas w milisekundach, po którym polecenie wygasa.

cmdArgs String: polecenie fastboot i argumenty do uruchomienia.

Zwraca
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

Zgłasza
DeviceNotAvailableException
UnsupportedOperationException

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe.

Identyczna z funkcją executeFastbootCommand(String...), ale używa dłuższego czasu oczekiwania.

Parametry
cmdArgs String: polecenie fastboot i argumenty do uruchomienia.

Zwraca
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

Zgłasza
DeviceNotAvailableException
UnsupportedOperationException

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (Map<String, String> envVarMap, 
                String... cmdArgs)

Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe ze zmiennymi środowiskowymi systemu.

Identyczna z funkcją executeFastbootCommand(String...), ale używa dłuższego czasu oczekiwania.

Parametry
envVarMap Map: zmienne środowiskowe systemu, z którymi uruchomiono polecenie fastboot

cmdArgs String: polecenie fastboot i argumenty do uruchomienia.

Zwraca
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

Zgłasza
DeviceNotAvailableException
UnsupportedOperationException

executeShellCommand

public String executeShellCommand (String command)

Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca dane wyjściowe jako String.

Parametry
command String: polecenie adb shell do uruchomienia

Zwraca
String dane wyjściowe powłoki,

Zgłasza
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
command String: polecenie adb shell do uruchomienia

receiver IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki.

maxTimeToOutputShellResponse long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli operacje retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zgłasza
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
command String: polecenie adb shell do uruchomienia

receiver IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki.

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

maxTimeToOutputShellResponse long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zgłasza
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Wykonuje podane polecenie powłoki adb, ponawiając je wielokrotnie, jeśli się nie powiedzie.

Prostsza forma funkcji executeShellCommand(String,IShellOutputReceiver,long,TimeUnit,int) z wartościami domyślnymi.

Parametry
command String: polecenie adb shell do uruchomienia

receiver IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki.

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.

Parametry
cmd String: polecenie, które ma zostać uruchomione.

Zwraca
CommandResult Wynik w języku: CommandResult.

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
cmd String: polecenie adb shell do uruchomienia

pipeAsInput File: File, który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.

pipeToOutput OutputStream: OutputStream miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null.

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zwraca
CommandResult

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
cmd String: polecenie adb shell do uruchomienia

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

Zwraca
CommandResult

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.

Parametry
cmd String: polecenie, które ma zostać uruchomione.

pipeAsInput File: File, który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.

Zwraca
CommandResult Wynik w języku: CommandResult.

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
cmd String: polecenie adb shell do uruchomienia

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zwraca
CommandResult

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia i stderr. stdout jest kierowany do określonego strumienia.

Parametry
cmd String: polecenie, które ma zostać uruchomione.

pipeToOutput OutputStream: OutputStream miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null.

Zwraca
CommandResult Wynik w języku: CommandResult.

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
cmd String: polecenie adb shell do uruchomienia

pipeAsInput File: File, który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.

pipeToOutput OutputStream: OutputStream miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null.

pipeToError OutputStream: OutputStream miejsce, do którego zostanie przekierowany standardowy błąd, lub wartość null.

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zwraca
CommandResult

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
cmd String: polecenie adb shell do uruchomienia

pipeAsInput File: File, który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.

pipeToOutput OutputStream: OutputStream miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null.

pipeToError OutputStream: OutputStream miejsce, do którego zostanie przekierowany standardowy błąd, lub wartość null.

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

maxTimeToOutputShellResponse long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zwraca
CommandResult

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                IShellOutputReceiver receiver)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.

Parametry
cmd String: polecenie, które ma zostać uruchomione.

receiver IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki.

Zwraca
CommandResult Wynik w języku: CommandResult.

Zgłasza
DeviceNotAvailableException

fastbootOemRamdumpNow

public CommandResult fastbootOemRamdumpNow ()

Metoda pomocnicza, która wywołuje zrzut pamięci RAM w trybie Fastboot.

Ta metoda wykonuje polecenie „oem ramdump now”. W przeciwieństwie do ERROR(/#executeFastbootCommand()) nie próbuje ponownie wykonać polecenia ani przywrócić urządzenia, jeśli polecenie się nie powiedzie lub stan jest nieprawidłowy, ponieważ zamierzonym wynikiem jest awaria urządzenia. Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.

Zwraca
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

Metoda pomocnicza, która czyści partycję urządzenia.

Jeśli getUseFastbootErase() ma wartość true, do wyczyszczenia partycji zostanie użyte polecenie fastboot erase. Przy następnym uruchomieniu urządzenia musi ono utworzyć system plików. W przeciwnym razie używany jest format fastboot, który tworzy nowy system plików na urządzeniu.

Oczekiwane użycie, gdy urządzenie jest już w trybie fastboot.

Parametry
partition String: partycja do wyczyszczenia

Zwraca
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

Zgłasza
DeviceNotAvailableException

getActiveApexes

public Set<ITestDevice.ApexInfo> getActiveApexes ()

Pobiera informacje o pakietach APEX aktywowanych na urządzeniu.

Zwraca
Set<ITestDevice.ApexInfo> SetApexInfo kart aktywowanych obecnie na urządzeniu

Zgłasza
DeviceNotAvailableException

getAdbPath

public String getAdbPath ()

Zwraca ścieżkę używanego pliku binarnego adb.

Zwraca
String

getAllSettings

public Map<String, String> getAllSettings (String namespace)

Zwraca pary klucz-wartość żądanej przestrzeni nazw.

Parametry
namespace String: musi mieć jedną z wartości: {"system", "secure", "global"}

Zwraca
Map<String, String> mapa par klucz-wartość. Wartość null, jeśli przestrzeń nazw nie jest obsługiwana.

Zgłasza
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

Zwraca bieżący stan przydziału urządzenia.

Zwraca
DeviceAllocationState

getAndroidId

public String getAndroidId (int userId)

Znajduje i zwraca identyfikator Androida powiązany z identyfikatorem użytkownika. Jeśli nie znajdzie identyfikatora, zwraca wartość null.

Parametry
userId int

Zwraca
String

Zgłasza
DeviceNotAvailableException

getAndroidIds

public Map<Integer, String> getAndroidIds ()

Utwórz mapę identyfikatorów Androida pasujących do identyfikatorów użytkowników. Nie ma gwarancji, że każdy identyfikator użytkownika znajdzie powiązany identyfikator Androida w tej funkcji, więc niektóre identyfikatory użytkowników mogą pasować do wartości null.

Zwraca
Map<Integer, String> Mapa identyfikatorów Androida pasujących do identyfikatorów użytkowników.

Zgłasza
DeviceNotAvailableException

getApiLevel

public int getApiLevel ()

Pobierz poziom interfejsu API urządzenia. Domyślna wartość to UNKNOWN_API_LEVEL.

Zwraca
int liczba całkowita wskazująca poziom interfejsu API urządzenia.

Zgłasza
DeviceNotAvailableException

getApiLevelFull

public int getApiLevelFull ()

Podobna do funkcji getApiLevel(), ale zwraca pełną wersję.

Zwraca
int liczba całkowita wskazująca pełny poziom interfejsu API urządzenia.

Zgłasza
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Pobiera informacje o pakiecie zainstalowanym na urządzeniu.

Parametry
packageName String

Zwraca
PackageInfo PackageInfo lub null, jeśli nie udało się pobrać informacji.

Zgłasza
DeviceNotAvailableException

getAppPackageInfos

public List<PackageInfo> getAppPackageInfos ()

Pobieranie informacji o pakietach zainstalowanych na urządzeniu.

Zwraca
List<PackageInfo> List z PackageInfo zainstalowanych na urządzeniu.

Zgłasza
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia. Pobieranie wersji radia jest zależne od urządzenia, więc może nie zwracać prawidłowych informacji na wszystkich urządzeniach. Ta metoda korzysta z właściwości gsm.version.baseband, aby zwracać prawidłowe informacje o wersji. W przypadku niektórych urządzeń CDMA ta informacja jest niedokładna, a wersja zwrócona w tym miejscu może nie być zgodna z wersją zgłoszoną przez fastboot i może nie zwracać wersji radia CDMA. W skrócie: ta metoda podaje dokładną wersję tylko wtedy, gdy właściwość gsm.version.baseband jest taka sama jak wersja zwracana przez fastboot getvar version-baseband.

Zwraca
String String wersja pasma podstawowego lub null, jeśli nie można jej określić (urządzenie nie ma radia lub nie można odczytać ciągu znaków wersji);

Zgłasza
DeviceNotAvailableException

getBattery

public Integer getBattery ()

Zwraca bieżący poziom baterii urządzenia lub wartość null, jeśli poziom baterii jest niedostępny.

Zwraca
Integer

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Zwraca wartość logiczną danej właściwości.

Parametry
name String: nazwa usługi

defaultValue boolean: wartość domyślna, która ma zostać zwrócona, jeśli właściwość jest pusta lub nie istnieje.

Zwraca
boolean true, jeśli właściwość ma wartość "1", "y", "yes", "on" lub "true"; false, jeśli właściwość ma wartość "0", "n", "no", "off", "false" lub defaultValue; w przeciwnym razie.

Zgłasza
DeviceNotAvailableException

getBootHistory

public Map<Long, String> getBootHistory ()

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchomienia.

Zwraca
Map<Long, String> Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu

Zgłasza
DeviceNotAvailableException

getBootHistorySince

public Map<Long, String> getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem uruchamiania i przyczyną uruchamiania od podanego czasu od początku epoki na urządzeniu oraz określoną jednostką czasu. Bieżący czas utcEpochTime urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate().

Parametry
utcEpochTime long: czas urządzenia od początku epoki.

timeUnit TimeUnit: jednostka czasu TimeUnit.

Zwraca
Map<Long, String> Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu

Zgłasza
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

Wygodna metoda uzyskiwania wersji programu rozruchowego tego urządzenia.

Spróbuje pobrać wersję programu rozruchowego z urządzenia w jego obecnym stanie. (np. jeśli urządzenie jest w trybie Fastboot Mode, spróbuje pobrać wersję z tego trybu).

Zwraca
String wersję String programu rozruchowego lub null, jeśli nie można jej znaleźć;

Zgłasza
DeviceNotAvailableException
UnsupportedOperationException

getBugreport

public InputStreamSource getBugreport ()

Pobiera raport o błędzie z urządzenia.

Gwarantujemy, że ta implementacja będzie nadal działać na urządzeniu bez karty SD (lub gdy karta SD nie jest jeszcze zamontowana).

Zwraca
InputStreamSource InputStreamSource, które na żądanie wygeneruje zawartość raportu o błędach. W przypadku niepowodzenia funkcja InputStreamSource zwróci pustą wartość InputStream.

getBugreportz

public InputStreamSource getBugreportz ()

Pobiera z urządzenia raport o błędzie. Raport o błędzie w formacie ZIP zawiera główny raport o błędzie i inne pliki dziennika przydatne do debugowania.

Obsługiwane tylko w przypadku wersji „adb version” > 1.0.36

Zwraca
InputStreamSource InputStreamSource pliku ZIP zawierającego raport o błędzie. W przypadku niepowodzenia zwraca wartość null.

getBuildAlias

public String getBuildAlias ()

Pobierz alias kompilacji, na której obecnie działa urządzenie.

Alias kompilacji jest zwykle bardziej czytelnym ciągiem znaków niż identyfikator kompilacji (zwykle numer w przypadku kompilacji na urządzenia Nexus). Na przykład ostateczna wersja Androida 4.2 ma alias kompilacji JDQ39 i identyfikator kompilacji 573038.

Zwraca
String alias kompilacji lub identyfikator kompilacji, jeśli nie można go pobrać.

Zgłasza
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

Pobierz wersję kompilacji urządzenia.

Zwraca
String wersja kompilacji lub wartość null, jeśli nie można jej pobrać.

Zgłasza
DeviceNotAvailableException

getBuildId

public String getBuildId ()

Pobierz kompilację, na której obecnie działa urządzenie.

Zwraca
String identyfikator kompilacji lub IBuildInfo.UNKNOWN_BUILD_ID, jeśli nie udało się go pobrać.

Zgłasza
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

Zwraca typ klucza użytego do podpisania obrazu urządzenia.

Urządzenia z Androidem są zwykle podpisywane kluczami testowymi (jak w AOSP) lub kluczami wersji (kontrolowanymi przez poszczególnych producentów urządzeń).

Zwraca
String Klucz podpisywania, jeśli został znaleziony, w przeciwnym razie wartość null.

Zgłasza
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przydzielone, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

Zwraca
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przydzielone, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

Parametry
shortDescriptor boolean: czy ograniczyć opis do minimum informacji

Zwraca
DeviceDescriptor

getChildren

public String[] getChildren (String path)

Alternatywa dla używania IFileEntry, która czasami nie działa z powodu uprawnień.

Parametry
path String: ścieżka na urządzeniu, w której ma się odbywać wyszukiwanie.

Zwraca
String[] Tablica ciągów znaków zawierająca wszystkie pliki w ścieżce na urządzeniu.

Zgłasza
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

Aktualne połączenie powiązane z urządzeniem.

Zwraca
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Zwraca wartość ContentProviderHandler lub wartość null, jeśli nie jest dostępna.

Dostawcę treści można ponownie wykorzystać, jeśli został wcześniej utworzony z tym samym parametrem userId.

Parametry
userId int: identyfikator użytkownika do zainicjowania dostawcy treści.

Zwraca
ContentProviderHandler

Zgłasza
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Zwraca bieżący stan urządzenia składanego lub wartość null, jeśli wystąpiły problemy.

Zwraca
DeviceFoldableState

Zgłasza
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Zwraca identyfikator aktualnie zalogowanego użytkownika. W przypadku błędu zwróć wartość -10000.

Zwraca
int

Zgłasza
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Pobierz klasę urządzenia.

Zwraca
String klasa urządzenia String,

getDeviceDate

public long getDeviceDate ()

Zwraca datę urządzenia w milisekundach od początku epoki.

Zwraca
long datę urządzenia w formacie epoki;

Zgłasza
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o nim bez przekazywania rzeczywistego obiektu urządzenia.

Zwraca
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o nim bez przekazywania rzeczywistego obiektu urządzenia.

Parametry
shortDescriptor boolean: czy ograniczyć opis do minimum informacji

Zwraca
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

Pobierz stan urządzenia.

Zwraca
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Pomaga w określaniu różnicy czasu między urządzeniem a danym Date. wewnętrznie używać czasu epoki.

Parametry
date Date

Zwraca
long różnica w milisekundach

Zgłasza
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Pobieranie strumienia stdout i stderr emulatora

Zwraca
InputStreamSource dane wyjściowe emulatora,

getEmulatorProcess

public Process getEmulatorProcess ()

Zwraca Process odpowiadający temu emulatorowi.

Zwraca
Process Process lub null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Dziennik zawierający wszystkie logi executeShellCommand(String).

Zwraca
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Metoda pomocnicza do określania ilości wolnego miejsca w pamięci zewnętrznej urządzenia.

Zwraca
long ilość wolnego miejsca w KB,

Zgłasza
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

Zwraca ścieżkę używanego pliku binarnego fastboot. Wymaga, aby zasada isFastbootEnabled() miała wartość Prawda, aby włączyć funkcje fastboot.

Zwraca
String

getFastbootProductType

public String getFastbootProductType ()

Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.

Tej metody należy używać tylko wtedy, gdy urządzenie ma być w trybie fastboot. Jest to nieco bezpieczniejsza odmiana ogólnej metody getProductType(), ponieważ w tym przypadku ITestDevice wie, jak przywrócić urządzenie do trybu fastboot, jeśli jest ono w nieprawidłowym stanie lub nie odpowiada.

Zwraca
String nazwę typu produktu String lub null, jeśli nie można jej określić;

Zgłasza
DeviceNotAvailableException
UnsupportedOperationException

getFastbootProductVariant

public String getFastbootProductVariant ()

Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.

Tej metody należy używać tylko wtedy, gdy urządzenie ma być w trybie fastboot. Jest to nieco bezpieczniejsza odmiana ogólnej metody getProductType(), ponieważ w tym przypadku interfejs ITestDevice wie, jak przywrócić urządzenie do trybu fastboot, jeśli jest ono w nieprawidłowym stanie lub nie odpowiada.

Zwraca
String nazwę typu produktu String lub null, jeśli nie można jej określić;

Zgłasza
DeviceNotAvailableException
UnsupportedOperationException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Zwraca numer seryjny trybu fastboot.

Zwraca
String

getFastbootVariable

public String getFastbootVariable (String variableName)

Pobierz z urządzenia wartość podanej zmiennej fastboot.

Parametry
variableName String: nazwa zmiennej;

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

Zgłasza
DeviceNotAvailableException
UnsupportedOperationException

getFastbootVersion

public String getFastbootVersion ()

Zwraca ciąg znaków wersji używanego pliku binarnego fastboot. lub wartość null, jeśli coś pójdzie nie tak.

Zwraca
String

getFileEntry

public IFileEntry getFileEntry (String path)

Pobieranie odwołania do pliku zdalnego na urządzeniu.

Parametry
path String: ścieżka pliku do pobrania. Może to być ścieżka bezwzględna lub ścieżka względna do „/” (np. obsługiwana jest składnia „/system” i „system”).

Zwraca
IFileEntry IFileEntry lub null, jeśli nie można znaleźć pliku pod podanym adresem path.

Zgłasza
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Nieoficjalne narzędzie pomocnicze do pobierania FileEntry ze ścieżki innej niż główna. FIXME: Zrefaktoryzuj system FileEntry, aby był dostępny z dowolnej ścieżki. (nawet bez uprawnień roota).

Parametry
entry FileListingService.FileEntry: FileEntry niekoniecznie musi być elementem głównym, jak wymaga tego biblioteka Ddmlib.

Zwraca
IFileEntry obiekt FileEntryWrapper reprezentujący obiekt FileEntry.

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public Set<DeviceFoldableState> getFoldableStates ()

Zwraca listę stanów urządzenia składanego. Można je uzyskać za pomocą polecenia „cmd device_state print-states”.

Zwraca
Set<DeviceFoldableState>

Zgłasza
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

Zwraca odwołanie do powiązanej biblioteki ddmlib IDevice.

Nowy IDevice może być przydzielany przez DDMS za każdym razem, gdy urządzenie zostanie odłączone od adb i ponownie połączone. Dlatego wywołujący nie powinni przechowywać odwołania do IDevice, ponieważ może ono stać się nieaktualne.

Zwraca
IDevice IDevice

getInstalledPackageNames

public Set<String> getInstalledPackageNames ()

Pobierz nazwy pakietów aplikacji znajdujących się na urządzeniu.

Zwraca
Set<String> Set z String nazw pakietów zainstalowanych obecnie na urządzeniu.

Zgłasza
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Zwraca wartość całkowitą danej właściwości z urządzenia.

Parametry
name String: nazwa usługi

defaultValue long: wartość domyślna, która ma zostać zwrócona, jeśli właściwość jest pusta lub nie istnieje.

Zwraca
long wartość właściwości lub defaultValue, jeśli właściwość jest pusta, nie istnieje lub nie ma wartości całkowitej.

Zgłasza
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

Pobiera adres IP urządzenia.

Zwraca
String adres IP urządzenia lub null, jeśli urządzenie nie ma adresu IP;

Zgłasza
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest obsługiwany.

Zwraca
KeyguardControllerState KeyguardControllerState zawierający zrzut stanu ekranu blokady i zwraca wartość Null, jeśli zapytanie dotyczące ekranu blokady nie jest obsługiwane.

Zgłasza
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie, w milisekundach od EPOCH, zgodnie z wartością zwracaną przez System.currentTimeMillis().

Zwraca
long

getLaunchApiLevel

public int getLaunchApiLevel ()

Pobierz poziom API, na którym urządzenie zostało uruchomione po raz pierwszy. Domyślna wartość to UNKNOWN_API_LEVEL.

Zwraca
int liczba całkowita wskazująca pierwszy uruchomiony poziom interfejsu API urządzenia.

Zgłasza
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Pobiera strumień zrzutu danych logcat.

Działa w 2 trybach:

  • Jeśli logcat jest obecnie rejestrowany w tle, funkcja zwróci maksymalnie TestDeviceOptions.getMaxLogcatDataSize() bajtów bieżącej zawartości rejestrowanego w tle logcatu.
  • W przeciwnym razie zwróci statyczny zrzut danych logcat, jeśli urządzenie odpowiada.

    Zwraca
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

    Pobiera strumień zrzutu ostatnich maxBytes danych logcat.

    Przydatne w sytuacjach, gdy chcesz często robić zrzuty przechwyconych danych logcat, nie ponosząc potencjalnie dużych kosztów związanych z zajętością miejsca na dysku, które wiążą się z uzyskaniem pełnego zrzutu getLogcat().

    Parametry
    maxBytes int: maksymalna ilość danych do zwrócenia. Powinna to być ilość, która zmieści się w pamięci.

    Zwraca
    InputStreamSource

    getLogcatDump

    public InputStreamSource getLogcatDump ()

    Pobierz zrzut bieżącego dziennika logcat z urządzenia. W przeciwieństwie do metody getLogcat() ta metoda zawsze zwraca statyczny zrzut logcat.

    Ma tę wadę, że jeśli urządzenie jest niedostępne, nic nie zostanie zwrócone.

    Zwraca
    InputStreamSource InputStreamSource danych logcat. Jeśli nie uda się przechwycić danych logcat, zwracany jest pusty strumień.

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

    Pobiera strumień zrzutu przechwyconych danych logcat od podanej daty. Należy używać czasu na urządzeniu getDeviceDate().

    Parametry
    date long: w milisekundach od początku epoki, kiedy rozpocząć zrzut, aż do chwili obecnej. (można go uzyskać za pomocą polecenia „date +%s”)

    Zwraca
    InputStreamSource

    getMacAddress

    public String getMacAddress ()

    Zwraca adres MAC urządzenia lub wartość null, jeśli nie można go pobrać z urządzenia.

    Zwraca
    String

    getMainUserId

    public Integer getMainUserId ()

    Zwraca główny identyfikator użytkownika.

    Zwraca
    Integer identyfikator użytkownika głównego, jeśli taki istnieje, lub wartość null, jeśli nie ma użytkownika głównego.

    Zgłasza
    DeviceNotAvailableException

    getMainlineModuleInfo

    public Set<String> getMainlineModuleInfo ()

    Pobiera informacje o modułach głównych zainstalowanych na urządzeniu.

    Zwraca
    Set<String> SetString modułów głównych zainstalowanych obecnie na urządzeniu.

    Zgłasza
    DeviceNotAvailableException

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

    Uzyskaj maksymalną liczbę obsługiwanych jednocześnie użytkowników. Domyślna wartość to 0.

    Zwraca
    int liczba całkowita wskazująca liczbę jednocześnie działających użytkowników;

    Zgłasza
    DeviceNotAvailableException

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported (String userType)

    Pobierz maksymalną liczbę obsługiwanych użytkowników danego typu. Domyślna wartość to 0.

    Parametry
    userType String: typ użytkownika zdefiniowany w klasie UserManager, np. „android.os.usertype.full.SECONDARY”.

    Zwraca
    int liczbę całkowitą wskazującą liczbę obsługiwanych użytkowników danego typu,

    Zgłasza
    DeviceNotAvailableException

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported ()

    Uzyskaj maksymalną liczbę obsługiwanych użytkowników, których można przełączać, z wyłączeniem gości. Po wersji interfejsu API 36 nie obejmuje użytkowników, których nie można przełączyć (np. profili). Domyślna wartość to 0.

    Zwraca
    int liczba całkowita wskazująca liczbę obsługiwanych użytkowników, między którymi można się przełączać.

    Zgłasza
    DeviceNotAvailableException

    getMicrodroidProcess

    public Process getMicrodroidProcess ()

    Zwraca
    Process Zwraca proces maszyny wirtualnej Microdroid. Jeśli TestDevice nie jest Microdroidem, zwraca wartość null.

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    Zwraca IDeviceStateMonitor powiązany z urządzeniem.

    Zwraca
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

    Zwraca punkt podłączenia.

    Wysyła zapytanie bezpośrednio do urządzenia, jeśli informacje w pamięci podręcznej w IDevice są niedostępne.

    DO ZROBIENIA: przenieś to działanie do IDevice.getMountPoint(String)

    Parametry
    mountName String: nazwa punktu podłączania

    Zwraca
    String punkt podłączania lub null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Zwraca wartość MountPointInfo odpowiadającą określonej ścieżce punktu podłączania lub null, jeśli w tej ścieżce nic nie jest podłączone lub w inny sposób nie pojawia się w /proc/mounts jako punkt podłączania.

    Parametry
    mountpoint String

    Zwraca
    ITestDevice.MountPointInfo List MountPointInfo zawierający informacje z pliku „/proc/mounts”.

    Zgłasza
    DeviceNotAvailableException

    getMountPointInfo

    public List<ITestDevice.MountPointInfo> getMountPointInfo ()

    Zwraca przeanalizowaną wersję informacji z pliku /proc/mounts na urządzeniu.

    Zwraca
    List<ITestDevice.MountPointInfo> List MountPointInfo zawierający informacje z pliku „/proc/mounts”.

    Zgłasza
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

    Pobierz opcje testowania urządzenia.

    Zwraca
    TestDeviceOptions TestDeviceOptions związane z testowanym urządzeniem.

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

    Metoda pomocnicza do określania ilości wolnego miejsca na partycji urządzenia.

    Parametry
    partition String

    Zwraca
    long ilość wolnego miejsca w KB,

    Zgłasza
    DeviceNotAvailableException

    getPrimaryUserId

    public Integer getPrimaryUserId ()

    Zwraca identyfikator głównego użytkownika.

    Zwraca
    Integer identyfikator użytkownika głównego, jeśli taki istnieje, lub wartość null, jeśli nie ma użytkownika głównego.

    Zgłasza
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

    Metoda pomocnicza uruchamia polecenia „pidof” i „stat” i zwraca obiekt ProcessInfo z identyfikatorem PID i czasem rozpoczęcia danego procesu.

    Parametry
    processName String: ciąg znaków z nazwą procesu.

    Zwraca
    ProcessInfo ProcessInfo dla danego procesu o nazwie processName

    Zgłasza
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

    Zwraca identyfikator procesu usługi lub wartość null, jeśli wystąpił błąd.

    Parametry
    process String: ciąg znaków z nazwą procesu.

    Zwraca
    String

    Zgłasza
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

    Wygodna metoda uzyskiwania typu produktu tego urządzenia.

    Ta metoda działa, gdy urządzenie jest w trybie adb lub fastboot.

    Zwraca
    String String nazwa typu produktu; Nie może mieć wartości null

    Zgłasza
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

    Metoda ułatwiająca uzyskanie wersji produktu tego urządzenia.

    Ta metoda działa, gdy urządzenie jest w trybie adb lub fastboot.

    Zwraca
    String String nazwę wersji produktu lub null, jeśli nie można jej określić.

    Zgłasza
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

    Pobierz z urządzenia wartość danej właściwości.

    Parametry
    name String: nazwa usługi

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

    Zgłasza
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

    Pobierz bieżący tryb odzyskiwania używany na urządzeniu.

    Zwraca
    ITestDevice.RecoveryMode bieżący tryb odzyskiwania używany na urządzeniu;

    getRemainingCreatableUserCount

    public int getRemainingCreatableUserCount (String userType)

    Zwraca liczbę użytkowników danego typu, których można utworzyć na tym urządzeniu.

    Parametry
    userType String: typ użytkownika zdefiniowany w klasie UserManager, np. „android.os.usertype.full.SECONDARY”.

    Zwraca
    int ile użytkowników danego typu można dodać,

    Zgłasza
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (Long displayId, 
                    String format, 
                    boolean rescale)

    Wykonuje zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza w obsługiwanym formacie. Zezwalanie na zmianę rozmiaru w celu obsługi mniejszych rozmiarów

    Parametry
    displayId Long: identyfikator wyświetlacza, z którego ma zostać zrobiony zrzut ekranu.

    format String: obsługiwane formaty PNG i JPEG

    rescale boolean: czy zrzut ekranu ma zostać przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu.

    Zwraca
    InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany.

    Zgłasza
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format)

    Robi zrzut ekranu urządzenia. Zamiast tego zalecamy użycie metody getScreenshot(format) z kodowaniem JPEG, aby uzyskać mniejszy rozmiar.

    Parametry
    format String: obsługiwane formaty PNG i JPEG

    Zwraca
    InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany.

    Zgłasza
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

    Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. Format to PNG.

    DO ZROBIENIA: rozszerzyć powyższe implementacje, aby obsługiwały „format” i „rescale”

    Parametry
    displayId long: identyfikator wyświetlacza, z którego ma zostać zrobiony zrzut ekranu.

    Zwraca
    InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany.

    Zgłasza
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    Robi zrzut ekranu urządzenia. Zalecamy używanie getScreenshot(String) zamiast tego formatu, ponieważ w przypadku kodowania JPEG rozmiar jest mniejszy.

    Parametry
    format String: obsługiwane formaty PNG i JPEG

    rescale boolean: czy zrzut ekranu ma zostać przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu.

    Zwraca
    InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany.

    Zgłasza
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot ()

    Robi zrzut ekranu urządzenia.

    Zwraca
    InputStreamSource InputStreamSource zrzutu ekranu w formacie PNG lub null, jeśli zrzut ekranu nie został wykonany.

    Zgłasza
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

    Wygodny sposób na uzyskanie numeru seryjnego tego urządzenia.

    Zwraca
    String numer seryjny String;

    getSetting

    public String getSetting (int userId, 
                    String namespace, 
                    String key)

    Zwraca wartość żądanego ustawienia. przestrzeń nazw musi być jedną z tych wartości: {"system", "secure", "global"}

    Parametry
    userId int

    namespace String

    key String

    Zwraca
    String wartość powiązana z przestrzenią nazw:klucz użytkownika. Wartość null, jeśli nie znaleziono.

    Zgłasza
    DeviceNotAvailableException

    getSetting

    public String getSetting (String namespace, 
                    String key)

    Patrz getSetting(int,String,String) i wykonywane na użytkowniku systemu.

    Parametry
    namespace String

    key String

    Zwraca
    String

    Zgłasza
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

    Zwraca operatora karty SIM lub wartość null, jeśli nie jest dostępny lub urządzenie nie jest dostępne.

    Zwraca
    String

    getSimState

    public String getSimState ()

    Zwraca stan karty SIM lub wartość null, jeśli karta SIM jest niedostępna lub urządzenie jest niedostępne.

    Zwraca
    String

    getTombstones

    public List<File> getTombstones ()

    Pobierz i zwróć listę znaczników usunięcia z urządzeń. Wymaga dostępu do roota.

    metoda jest wykonywana w miarę możliwości, więc jeśli z jakiegokolwiek powodu nie uda się pobrać znacznika usunięcia, nie będzie go na liście. Tylko DeviceNotAvailableException spowoduje wcześniejsze zakończenie metody.

    Zwraca
    List<File> Lista plików oznaczonych jako usunięte. Jeśli nie ma takich plików, lista jest pusta.

    Zgłasza
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

    Zwraca łączny rozmiar pamięci fizycznej w bajtach lub -1 w przypadku błędu wewnętrznego.

    Zwraca
    long

    getTrackingSerial

    public String getTrackingSerial ()

    Na potrzeby zarządzania urządzeniem pobierz numer seryjny używany do śledzenia urządzenia.

    Zwraca
    String

    getUninstallablePackageNames

    public Set<String> getUninstallablePackageNames ()

    Pobierz nazwy pakietów aplikacji, które można odinstalować. Obecnie są to pakiety inne niż systemowe i zaktualizowane pakiety systemowe.

    Zwraca
    Set<String> Set nazw pakietów, których nie można odinstalować, zainstalowanych obecnie na urządzeniu.String

    Zgłasza
    DeviceNotAvailableException

    getUseFastbootErase

    public boolean getUseFastbootErase ()

    Określa, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie fastboot erase czy fastboot format.

    Zwraca
    boolean true czy zostanie użyte polecenie fastboot erase, czy false polecenie fastboot format.

    getUserFlags

    public int getUserFlags (int userId)

    Znajdź i zwróć flagi danego użytkownika. Flagi są zdefiniowane w klasie „android.content.pm.UserInfo” w projekcie Android Open Source.

    Parametry
    userId int

    Zwraca
    int flagi powiązane z podanym identyfikatorem użytkownika, jeśli zostaną znalezione, lub -10000 w innych przypadkach.

    Zgłasza
    DeviceNotAvailableException

    getUserInfos

    public Map<Integer, UserInfo> getUserInfos ()

    Pobiera mapę identyfikatorów użycia do UserInfo na urządzeniu. Wyrzuci błąd DeviceRuntimeException, jeśli dane wyjściowe z urządzenia nie będą zgodne z oczekiwaniami.

    Zwraca
    Map<Integer, UserInfo> lista obiektów UserInfo.

    Zgłasza
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

    Zwraca numer seryjny powiązany z identyfikatorem userId, jeśli zostanie znaleziony, lub -10000 w innych przypadkach.

    Parametry
    userId int

    Zwraca
    int

    Zgłasza
    DeviceNotAvailableException

    getUserVisibleOnDisplay

    public int getUserVisibleOnDisplay (int displayId)

    Pobiera identyfikator użytkownika widocznego na danym wyświetlaczu.

    Parametry
    displayId int: identyfikator wyświetlacza.

    Zwraca
    int identyfikator użytkownika widocznego na danym wyświetlaczu. Nie rozróżnia użytkownika w tle, który jest widoczny, od użytkownika na pierwszym planie, ponieważ oba typy są widoczne. Aby odróżnić te przypadki, porównaj je z wynikiem funkcji getCurrentUser().

    Zgłasza
    DeviceNotAvailableException

    handleAllocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Przetwarzanie danego zdarzenia DeviceEvent. Może przełączyć urządzenie w nowy stan. będzie informować IDeviceMonitor o wszelkich zmianach stanu;

    Przetwórz zdarzenie DeviceEvent, które może, ale nie musi, spowodować przejście tego urządzenia do nowego stanu przydziału.

    Parametry
    event DeviceEvent

    Zwraca
    IManagedTestDevice.DeviceEventResponse

    hasFeature

    public boolean hasFeature (String feature)

    Sprawdź, czy funkcja jest dostępna na urządzeniu.

    Parametry
    feature String: format powinien mieć postać „feature:” lub bezpośrednio „”.

    Zwraca
    boolean Wartość true, jeśli funkcja została znaleziona. W przeciwnym razie wartość false.

    Zgłasza
    DeviceNotAvailableException

    initializeConnection

    public void initializeConnection (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Zainicjuj połączenie z urządzeniem. Jest ona wywoływana przez funkcję preInvocationSetup, ale w rzadkich przypadkach może być konieczne jej oddzielne wywołanie podczas tworzenia połączenia w trakcie konfigurowania urządzenia.

    Parametry
    info IBuildInfo

    attributes MultiMap

    Zgłasza
    DeviceNotAvailableException
    TargetSetupError

    installPackage

    public String installPackage (File packageFile, 
                    boolean reinstall, 
                    boolean grantPermissions, 
                    String... extraArgs)

    Zainstaluj pakiet Androida na urządzeniu.

    Uwaga: tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas instalacji.

    Parametry
    packageFile File: plik APK do zainstalowania

    reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.

    grantPermissions boolean: czy wszystkie uprawnienia czasu działania mają być przyznawane w momencie instalacji.

    extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.

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

    Zgłasza
    DeviceNotAvailableException

    installPackage

    public String installPackage (File packageFile, 
                    boolean reinstall, 
                    String... extraArgs)

    Zainstaluj pakiet Androida na urządzeniu.

    Parametry
    packageFile File: plik APK do zainstalowania

    reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.

    extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.

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

    Zgłasza
    DeviceNotAvailableException

    installPackageForUser

    public String installPackageForUser (File packageFile, 
                    boolean reinstall, 
                    boolean grantPermissions, 
                    int userId, 
                    String... extraArgs)

    Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.

    Uwaga: tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas instalacji.

    Parametry
    packageFile File: plik APK do zainstalowania

    reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.

    grantPermissions boolean: czy wszystkie uprawnienia czasu działania mają być przyznawane w momencie instalacji.

    userId int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać zainstalowana aplikacja.

    extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.

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

    Zgłasza
    DeviceNotAvailableException

    installPackageForUser

    public String installPackageForUser (File packageFile, 
                    boolean reinstall, 
                    int userId, 
                    String... extraArgs)

    Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.

    Parametry
    packageFile File: plik APK do zainstalowania

    reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.

    userId int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać zainstalowana aplikacja.

    extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.

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

    Zgłasza
    DeviceNotAvailableException

    installPackageWithIncrementalMode

    public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                    String[] extraArgs, 
                    String userId)

    Instaluje pliki APK w trybie przyrostowym.

    Parametry
    apkFiles File: pliki APK do zainstalowania.

    extraArgs String

    userId String

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    Zwraca
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

    Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczanie aplikacji

    Zwraca
    boolean Wartość „prawda”, jeśli wyliczanie aplikacji jest obsługiwane, w przeciwnym razie „fałsz”.

    Zgłasza
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

    Sprawdzanie, czy platforma na urządzeniu obsługuje omijanie blokady niskiego docelowego pakietu SDK podczas instalowania aplikacji

    Zwraca
    boolean Ma wartość true, jeśli obejście blokady niskiego docelowego pakietu SDK jest obsługiwane. W przeciwnym razie ma wartość false.

    Zgłasza
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    Sprawdź, czy debugfs jest zamontowany.

    Zwraca
    boolean true, jeśli debugfs jest zamontowany

    Zgłasza
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

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

    Zwraca
    boolean true – jeśli urządzenie jest zaszyfrowane.

    Zgłasza
    DeviceNotAvailableException

    isDirectory

    public boolean isDirectory (String path)

    Zwraca wartość Prawda, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość Fałsz.

    Parametry
    path String

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isEnableAdbRoot

    public boolean isEnableAdbRoot ()

    Zwraca
    boolean true czy na urządzeniu ma być włączony dostęp do roota za pomocą adb;

    isEncryptionSupported

    public boolean isEncryptionSupported ()

    Wyświetla informację o tym, czy urządzenie obsługuje szyfrowanie.

    Zwraca
    boolean true – jeśli urządzenie obsługuje szyfrowanie.

    Zgłasza
    DeviceNotAvailableException

    isExecutable

    public boolean isExecutable (String fullPath)

    Zwraca wartość Prawda, jeśli ścieżka pliku na urządzeniu jest plikiem wykonywalnym, w przeciwnym razie zwraca wartość Fałsz.

    Parametry
    fullPath String

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

    Zwraca wartość, jeśli tryb Fastboot jest dostępny na urządzeniu.

    Zwraca
    boolean

    isHeadless

    public boolean isHeadless ()

    Zwraca wartość „true”, jeśli urządzenie nie ma ekranu, w przeciwnym razie zwraca wartość „false”.

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

    Zwraca informację o tym, czy urządzenie korzysta z trybu użytkownika systemu bez interfejsu graficznego.

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

    Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani obniżyć jego uprawnień do poziomu użytkownika bez uprawnień administracyjnych.

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isMultiUserSupported

    public boolean isMultiUserSupported ()

    Zwraca informację, czy to urządzenie obsługuje wielu użytkowników z możliwością przełączania, którzy mają własne loginy i konfigurowalne przestrzenie.

    Pamiętaj, że nawet jeśli ta wartość jest fałszywa, może być możliwe zalogowanie wielu użytkowników, o ile nie jest wymagany interfejs logowania. Na przykład profile mogą być nadal obsługiwane, ponieważ nie wymagają interfejsu logowania.

    Sprawdza ona też config_enableMultiUserUI. Na żądanie możemy założyć, że urządzenia, w przypadku których ta zasada ma wartość Prawda, są skonfigurowane tak, aby zezwalać na dodawanie użytkowników dodatkowych za pomocą narzędzia ADB.

    Zwraca
    boolean czy urządzenie obsługuje wielu użytkowników, między którymi można się przełączać.

    Zgłasza
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

    Wysyła zapytanie do urządzenia o daną nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana dla tego użytkownika.

    Parametry
    packageName String: pakiet, który sprawdzamy pod kątem instalacji.

    userId String: identyfikator użytkownika, dla którego sprawdzamy, czy pakiet jest zainstalowany. Jeśli wartość to null, używany będzie główny użytkownik zero.

    Zwraca
    boolean Wartość true, jeśli pakiet jest zgłaszany jako zainstalowany. W przeciwnym razie ma wartość Fałsz.

    Zgłasza
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName)

    Wysyłaj do urządzenia zapytania o daną nazwę pakietu, aby sprawdzić, czy jest on obecnie zainstalowany.

    Parametry
    packageName String

    Zwraca
    boolean Wartość true, jeśli pakiet jest zgłaszany jako zainstalowany. W przeciwnym razie ma wartość Fałsz.

    Zgłasza
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

    Sprawdzanie, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie działania

    Zwraca
    boolean Wartość true, jeśli uprawnienia w czasie działania aplikacji są obsługiwane. W przeciwnym razie wartość false.

    Zgłasza
    DeviceNotAvailableException

    isShellV2Support

    public boolean isShellV2Support ()

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

    Zwraca wartość „prawda”, jeśli urządzenie jest w stanie TestDeviceState.FASTBOOT lub TestDeviceState.FASTBOOTD.

    Zwraca
    boolean

    isUserRunning

    public boolean isUserRunning (int userId)

    Sprawdź, czy dany użytkownik jest aktywny.

    Parametry
    userId int

    Zwraca
    boolean Wartość „prawda”, jeśli użytkownik biegnie. W innych przypadkach wartość „fałsz”.

    Zgłasza
    DeviceNotAvailableException

    isUserSecondary

    public boolean isUserSecondary (int userId)

    Zwraca informację, czy określony użytkownik jest użytkownikiem dodatkowym na podstawie jego flag.

    Parametry
    userId int

    Zwraca
    boolean Wartość „true”, jeśli użytkownik jest dodatkowy, w przeciwnym razie „false”.

    Zgłasza
    DeviceNotAvailableException

    isUserVisible

    public boolean isUserVisible (int userId)

    Sprawdza, czy dany użytkownik jest widoczny.

    „Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „prawdziwym” użytkownikiem i dlatego może uruchamiać działania (zwykle na domyślnym ekranie).

    Parametry
    userId int

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isUserVisibleOnDisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

    Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu.

    „Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „prawdziwym” użytkownikiem i dlatego może uruchamiać działania na tym wyświetlaczu.

    Parametry
    userId int

    displayId int

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

    Zwraca informację, czy urządzenie zezwala na uruchamianie aplikacji w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

    W takim przypadku możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean), przekazując wyświetlacz zwrócony przez funkcję listDisplayIdsForStartingVisibleBackgroundUsers() (który powinien zawierać ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

    Zwraca informację, czy urządzenie zezwala na uruchamianie użytkowników widocznych w tle.

    Jeśli tak, możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean), przekazując wyświetlacz zwrócony przez funkcję listDisplayIdsForStartingVisibleBackgroundUsers().

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isWifiEnabled

    public boolean isWifiEnabled ()

    Sprawdź, czy Wi-Fi jest włączone.

    Sprawdza, czy Wi-Fi jest włączone na urządzeniu. Przydatne do sprawdzania stanu Wi-Fi przed testami, które nie powinny być przeprowadzane przy włączonym Wi-Fi, np. testami danych komórkowych.

    Zwraca
    boolean true, jeśli Wi-Fi jest włączone. false, jeśli jest wyłączona

    Zgłasza
    DeviceNotAvailableException

    listDisplayIds

    public Set<Long> listDisplayIds ()

    Zbierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, zgodnie z raportem „dumpsys SurfaceFlinger”.

    Zwraca
    Set<Long> Lista wyświetlaczy. Funkcja Default zawsze zwraca domyślny wyświetlacz 0.

    Zgłasza
    DeviceNotAvailableException

    listDisplayIdsForStartingVisibleBackgroundUsers

    public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

    Pobiera listę wyświetlaczy, których można używać do start a user visible in the background.

    Zwraca
    Set<Integer>

    Zgłasza
    DeviceNotAvailableException

    listUsers

    public ArrayList<Integer> listUsers ()

    Pobiera listę użytkowników na urządzeniu. Wyrzuci wyjątek DeviceRuntimeException, jeśli dane wyjściowe z urządzenia nie będą zgodne z oczekiwaniami.

    Zwraca
    ArrayList<Integer> lista identyfikatorów użytkowników.

    Zgłasza
    DeviceNotAvailableException

    logAnrs

    public boolean logAnrs (ITestLogger logger)

    Zbiera i rejestruje błędy ANR z urządzenia.

    Parametry
    logger ITestLogger: ITestLogger do rejestrowania błędów ANR.

    Zwraca
    boolean Wartość true, jeśli rejestrowanie się powiodło. W przeciwnym razie wartość false.

    Zgłasza
    DeviceNotAvailableException

    logBugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Metoda pomocnicza służąca do tworzenia raportu o błędzie i przesyłania go do osób zgłaszających.

    Parametry
    dataName String: nazwa, pod którą zostanie zgłoszony raport o błędzie.

    listener ITestLogger: ITestLogger do zarejestrowania raportu o błędzie.

    Zwraca
    boolean Wartość true, jeśli rejestrowanie się powiodło. W przeciwnym razie wartość false.

    logOnDevice

    public void logOnDevice (String tag, 
                    Log.LogLevel level, 
                    String format, 
                    Object... args)

    Zapisz wiadomość w logcat urządzenia. Jest to bezpieczne wywołanie, które nie spowoduje błędu nawet w przypadku niepowodzenia rejestrowania.

    Parametry
    tag String: tag, pod którym rejestrujemy wiadomość w logcat.

    level Log.LogLevel: poziom debugowania wiadomości w logcat.

    format String: format wiadomości.

    args Object: argumenty, które mają zostać zastąpione za pomocą String.format().

    mountDebugfs

    public void mountDebugfs ()

    Podłącz debugfs.

    Zgłasza
    DeviceNotAvailableException

    nonBlockingReboot

    public void nonBlockingReboot ()

    Wydaje polecenie ponownego uruchomienia urządzenia i zwraca wynik po zakończeniu polecenia oraz gdy urządzenie nie jest już widoczne dla adb.

    Zgłasza
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

    Zastąp, jeśli urządzenie wymaga podjęcia określonych działań po uzyskaniu dostępu do roota za pomocą adb i przed ponownym połączeniem z siecią. Domyślna implementacja nie obejmuje żadnych dodatkowych działań. Na tym etapie nie ma gwarancji, że polecenie adb root będzie włączone.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postAdbUnrootAction

    public void postAdbUnrootAction ()

    Zastąp, jeśli po odrootowaniu za pomocą narzędzia adb i przed ponownym połączeniem urządzenia z siecią trzeba wykonać na nim określone działania. Domyślna implementacja nie obejmuje żadnych dodatkowych działań. Na tym etapie nie ma gwarancji, że dostęp do roota adb zostanie wyłączony.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public void postBootSetup ()

    Wykonaj instrukcje, aby skonfigurować urządzenie do testowania po każdym uruchomieniu.

    Powinien być wywoływany po pełnym uruchomieniu lub udostępnieniu urządzenia

    W normalnych okolicznościach nie trzeba wywoływać tej metody bezpośrednio, ponieważ implementacje powinny automatycznie wykonywać te czynności podczas ponownego uruchamiania.

    Może być konieczne wywołanie tej funkcji, gdy urządzenie uruchamia się ponownie z powodu innych zdarzeń (np. po zakończeniu polecenia aktualizacji fastboot).

    Zgłasza
    DeviceNotAvailableException

    postInvocationTearDown

    public void postInvocationTearDown (Throwable exception)

    Dodatkowe czynności wymagane do zwolnienia miejsca na urządzeniu, które zostaną wykonane po zakończeniu wywołania.

    Parametry
    exception Throwable: jeśli wystąpił błąd wywołania, jest to ostateczny wyjątek.

    preInvocationSetup

    public void preInvocationSetup (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Dodatkowe czynności wymagane do skonfigurowania urządzenia, które zostaną wykonane na urządzeniu przed wywołaniem przepływu.

    Parametry
    info IBuildInfo: IBuildInfo urządzenia.

    attributes MultiMap: atrybuty przechowywane w kontekście wywołania.

    Zgłasza
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir, 
                    int userId)

    Rekursywne pobieranie zawartości katalogu z urządzenia.

    Parametry
    deviceFilePath String: bezwzględna ścieżka pliku źródła zdalnego

    localDir File: lokalny katalog, do którego mają być pobierane pliki.

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane

    Zwraca
    boolean true – czy plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Rekursywne pobieranie zawartości katalogu z urządzenia.

    Parametry
    deviceFilePath String: bezwzględna ścieżka pliku źródła zdalnego

    localDir File: lokalny katalog, do którego mają być pobierane pliki.

    Zwraca
    boolean true – czy plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir, 
                    int userId, 
                    long timeout)

    Rekursywne pobieranie zawartości katalogu z urządzenia.

    Parametry
    deviceFilePath String: bezwzględna ścieżka pliku źródła zdalnego

    localDir File: lokalny katalog, do którego mają być pobierane pliki.

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane

    timeout long: limit czasu pobierania polecenia

    Zwraca
    boolean true – czy plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId, 
                    long timeout)

    Pobiera plik z urządzenia.

    Parametry
    remoteFilePath String: ścieżka bezwzględna do pliku na urządzeniu.

    localFile File: lokalny plik, w którym mają być przechowywane treści. Jeśli nie jest pusta, jej zawartość zostanie zastąpiona.

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane.

    timeout long: limit czasu polecenia pobierania pliku

    Zwraca
    boolean true – jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Pobiera plik z urządzenia.

    Parametry
    remoteFilePath String: ścieżka bezwzględna do pliku na urządzeniu.

    localFile File: lokalny plik, w którym mają być przechowywane treści. Jeśli nie jest pusta, jej zawartość zostanie zastąpiona.

    Zwraca
    boolean true – jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                    int userId)

    Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym File i zwraca ten File.

    Parametry
    remoteFilePath String: ścieżka bezwzględna do pliku na urządzeniu.

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane.

    Zwraca
    File File zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

    Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym File i zwraca ten File.

    Parametry
    remoteFilePath String: ścieżka bezwzględna do pliku na urządzeniu.

    Zwraca
    File File zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId)

    Pobiera plik z urządzenia.

    Parametry
    remoteFilePath String: ścieżka bezwzględna do pliku na urządzeniu.

    localFile File: lokalny plik, w którym mają być przechowywane treści. Jeśli nie jest pusta, jej zawartość zostanie zastąpiona.

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane.

    Zwraca
    boolean true – jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    Pobiera plik z urządzenia i zwraca jego zawartość.

    Parametry
    remoteFilePath String: ścieżka bezwzględna do pliku na urządzeniu.

    Zwraca
    String String zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

    Wygodna metoda pobierania pliku z pamięci zewnętrznej urządzenia, zapisywania go w lokalnym tymczasowym File i zwracania odwołania do tego File.

    Parametry
    remoteFilePath String: ścieżka do pliku na urządzeniu, względna w stosunku do punktu montowania zewnętrznej pamięci masowej urządzenia.

    Zwraca
    File File zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                    int userId)

    Rekursywne przekazywanie zawartości katalogu na urządzenie.

    Parametry
    localFileDir File: katalog lokalny do wypychania

    deviceFilePath String: bezwzględna ścieżka pliku do miejsca docelowego zdalnego

    userId int: identyfikator użytkownika, do którego ma zostać wysłane powiadomienie.

    Zwraca
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                    Set<String> excludedDirectories)

    Rekursywne przesyłanie zawartości katalogu na urządzenie z wykluczeniem niektórych katalogów, które są filtrowane.

    Parametry
    localFileDir File: katalog lokalny do wypychania

    deviceFilePath String: bezwzględna ścieżka pliku do miejsca docelowego zdalnego

    excludedDirectories Set: Zestaw nazw wykluczonych katalogów, które nie powinny być przesyłane.

    Zwraca
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Rekursywne przekazywanie zawartości katalogu na urządzenie.

    Parametry
    localFileDir File: katalog lokalny do wypychania

    deviceFilePath String: bezwzględna ścieżka pliku do miejsca docelowego zdalnego

    Zwraca
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    boolean evaluateContentProviderNeeded)

    Wariant funkcji pushFile(File,String), który może opcjonalnie uwzględniać ocenę potrzeb dostawcy treści.

    Parametry
    localFile File: plik lokalny do przesłania

    remoteFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    evaluateContentProviderNeeded boolean: czy sprawdzić, czy potrzebujemy dostawcy treści;

    Zwraca
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Przekaż plik na urządzenie. Domyślnie używa dostawcy treści.

    Parametry
    localFile File: plik lokalny do przesłania

    remoteFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    Zwraca
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    int userId)

    Przekaż plik na urządzenie. Domyślnie używa dostawcy treści.

    Parametry
    localFile File: plik lokalny do przesłania

    remoteFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    userId int: identyfikator użytkownika, do którego chcesz wysłać powiadomienie.

    Zwraca
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Przesyłanie na urządzenie pliku utworzonego z ciągu znaków

    Parametry
    contents String: zawartość pliku do przesłania,

    remoteFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    Zwraca
    boolean true, jeśli ciąg znaków został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    uruchomić ponownie|zrestartować

    public void reboot (String reason)

    Uruchamia ponownie urządzenie w trybie adb z podanym parametrem reason, który będzie zachowywany po ponownym uruchomieniu.

    Blokuje działanie do momentu, aż urządzenie będzie dostępne.

    Przyczynę ostatniego ponownego uruchomienia można uzyskać, wysyłając zapytanie o właściwość sys.boot.reason.

    Parametry
    reason String: przyczynę ponownego uruchomienia lub null, jeśli nie podano przyczyny.

    Zgłasza
    DeviceNotAvailableException

    uruchomić ponownie|zrestartować

    public String reboot (String command, 
                    String reason)

    Ponownie uruchamia urządzenie za pomocą podanego parametru command.

    Blokuje działanie do momentu, aż urządzenie będzie dostępne.

    Przyczynę ostatniego ponownego uruchomienia można uzyskać, wysyłając zapytanie o właściwość sys.boot.reason.

    Parametry
    command String: polecenie przekazane do `adb`. Zwróć uwagę, że jest ono przekazywane „w stanie nienaruszonym”, więc to wywołujący musi w razie potrzeby podać odpowiedni cudzysłów (zwłaszcza jeśli polecenie zawiera wiele części oddzielonych spacją).

    reason String: przyczynę ponownego uruchomienia lub null, jeśli nie podano przyczyny.

    Zwraca
    String

    Zgłasza
    DeviceNotAvailableException

    uruchomić ponownie|zrestartować

    public void reboot ()

    Uruchamia ponownie urządzenie w trybie adb.

    Blokuje działanie do momentu, aż urządzenie będzie dostępne.

    Zgłasza
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Uruchamia ponownie urządzenie w trybie programu rozruchowego.

    Blokuje działanie do momentu przejścia urządzenia w tryb programu rozruchowego.

    Zgłasza
    DeviceNotAvailableException
    UnsupportedOperationException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Uruchamia ponownie urządzenie w trybie fastbootd.

    Blokuje działanie, dopóki urządzenie nie przejdzie w tryb fastbootd.

    Zgłasza
    DeviceNotAvailableException
    UnsupportedOperationException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    Uruchamia ponownie urządzenie w trybie odzyskiwania adb.

    Blokuje do momentu przejścia urządzenia w tryb odzyskiwania

    Zgłasza
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

    Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach odzyskiwania).

    Blokuje działanie do momentu przejścia urządzenia w tryb wczytywania z boku

    Zgłasza
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach odzyskiwania).

    Blokuje działanie do momentu przejścia urządzenia w tryb wczytywania z boku

    Parametry
    autoReboot boolean: czy po instalacji z pliku urządzenie ma się automatycznie uruchomić ponownie.

    Zgłasza
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

    Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.

    Zgłasza
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

    Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.

    Parametry
    reason String: przyczynę ponownego uruchomienia lub null, jeśli nie podano przyczyny.

    Zgłasza
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

    Ponowne uruchomienie tylko części urządzenia w przestrzeni użytkownika.

    Blokuje działanie do momentu, aż urządzenie będzie dostępne.

    OSTRZEŻENIE. Ponowne uruchamianie w przestrzeni użytkownika jest obecnie w fazie rozwoju. Używasz go na własne ryzyko.

    Zgłasza
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

    Alternatywa dla rebootUserspace() ()}, która blokuje tylko do momentu, gdy urządzenie jest online, tzn. widoczne dla adb.

    Zgłasza
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Próbuje przywrócić komunikację z urządzeniem.

    Zwraca
    boolean Wartość true, jeśli próba odzyskania zakończyła się powodzeniem. Wartość false, jeśli odzyskiwanie zostało pominięte.

    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nie jest już dostępne;

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Rejestruje IDeviceActionReceiver na tym urządzeniu.

    Wszystkie zarejestrowane IDeviceActionReceiver zostaną powiadomione przed rozpoczęciem działania urządzenia i po jego zakończeniu.

    Parametry
    deviceActionReceiver IDeviceActionReceiver: IDeviceActionReceiver, który zostanie zarejestrowany.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    Ustaw partycję systemową na urządzeniu jako tylko do odczytu. Może ponownie uruchomić urządzenie.

    Zgłasza
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    Ustaw partycję systemową na urządzeniu jako zapisywalną. Może ponownie uruchomić urządzenie.

    Zgłasza
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

    Ustaw partycję dostawcy na urządzeniu jako tylko do odczytu. Może ponownie uruchomić urządzenie.

    Zgłasza
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Umożliwia zapisywanie na partycji dostawcy na urządzeniu. Może ponownie uruchomić urządzenie.

    Zgłasza
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

    Usuwa administratora danego urządzenia z konta danego użytkownika i zwraca true, jeśli operacja się uda, lub false w przeciwnym razie.

    Parametry
    componentName String: administratora urządzenia do usunięcia.

    userId int: użytkownika, w którego profilu znajduje się administrator urządzenia.

    Zwraca
    boolean Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”.

    Zgłasza
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Usuń wszystkich obecnych właścicieli profilu urządzenia, korzystając z zasady możliwie najlepszej obsługi.

    Zgłasza
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    Usuń danego użytkownika z urządzenia.

    Parametry
    userId int: użytkownika, który ma zostać usunięty

    Zwraca
    boolean Wartość „true”, jeśli użytkownik został usunięty. W przeciwnym razie „false”.

    Zgłasza
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

    Zresetuj flagę konfiguracji dostawcy treści, aby ponownie ją wywołać.

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    Collection<ITestLifeCycleReceiver> listeners)

    Uruchamia testy z instrumentacją i umożliwia przywracanie urządzeń.

    Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a odzyskiwanie się powiedzie, wszyscy odbiorcy zostaną poinformowani o niepowodzeniu testu, a funkcja zwróci wartość „false”. Polecenie testowe nie zostanie uruchomione ponownie. W razie potrzeby rozmówcy mogą spróbować ponownie.

    Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a odzyskiwanie się nie powiedzie, wszyscy odbiorcy zostaną poinformowani o niepowodzeniu testu, a wyjątek DeviceNotAvailableException zostanie zgłoszony.

    Parametry
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy

    listeners Collection: detektory wyników testu

    Zwraca
    boolean true jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go ukończyć z powodu wyjątku w komunikacji z urządzeniem, ale przywracanie zakończyło się pomyślnie.

    Zgłasza
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    ITestLifeCycleReceiver... listeners)

    Wygodna metoda wykonywania runInstrumentationTests(IRemoteAndroidTestRunner,Collection) z co najmniej 1 odbiornikiem przekazanym jako parametr.

    Parametry
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy

    listeners ITestLifeCycleReceiver: odbiorcy wyników testu

    Zwraca
    boolean true jeśli polecenie testowe zostało wykonane. false – jeśli nie udało się ukończyć operacji, ale przywracanie się powiodło.

    Zgłasza
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    Collection<ITestLifeCycleReceiver> listeners)

    Podobnie jak ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection), ale przeprowadza test dla danego użytkownika.

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners Collection

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    ITestLifeCycleReceiver... listeners)

    Tak samo jak ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,ITestLifeCycleReceiver...), ale uruchamia test dla danego użytkownika.

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    setAdbPath

    public void setAdbPath (String adbPath)

    Ustawia ścieżkę do pliku binarnego adb, który ma być używany.

    Parametry
    adbPath String

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Wstawia używaną wartość IConfiguration.

    Parametry
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parametry
    avdInfo GceAvdInfo

    setDate

    public void setDate (Date date)

    Ustawia datę na urządzeniu

    Uwaga: ustawienie daty na urządzeniu wymaga dostępu do roota.

    Parametry
    date Date: określ konkretną datę; jeśli null, użyje daty hosta.

    Zgłasza
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

    Ustawianie komponentu administratora urządzenia jako właściciela urządzenia w przypadku danego użytkownika.

    Parametry
    componentName String: administratora urządzenia na właściciela urządzenia.

    userId int: użytkownika, w którego kraju mieszka właściciel urządzenia.

    Zwraca
    boolean Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”.

    Zgłasza
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Zaktualizuj stan urządzenia.

    Parametry
    deviceState TestDeviceState: TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    W przypadku emulatora ustaw SizeLimitedOutputStream, aby rejestrować dane wyjściowe.

    Parametry
    output SizeLimitedOutputStream: aby rejestrować dane wyjściowe.

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Ustawia Process, gdy urządzenie jest emulatorem.

    Parametry
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Ustaw opcję fastboot dla urządzenia. Należy go ustawić, gdy urządzenie zostanie po raz pierwszy przydzielone.

    Parametry
    fastbootEnabled boolean: czy na urządzeniu jest dostępny tryb fastboot

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Ustawia ścieżkę do pliku binarnego fastboot, który ma być używany. Wymaga, aby isFastbootEnabled() miało wartość Prawda, aby włączyć funkcje fastboot.

    Parametry
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

    Zaktualizuj urządzenie iDevice powiązane z tym urządzeniem ITestDevice.

    Nowy identyfikator IDevice musi odnosić się do tego samego urządzenia fizycznego co bieżące odniesienie. Ta metoda zostanie wywołana, jeśli DDMS przydzieli nowe urządzenie IDevice.

    Parametry
    newDevice IDevice: IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Określa czas (w milisekundach) oczekiwania przed rozpoczęciem przechwytywania logcat na urządzeniu online.

    Parametry
    delay int: opóźnienie w milisekundach

    setOptions

    public void setOptions (TestDeviceOptions options)

    Ustaw TestDeviceOptions dla urządzenia

    Parametry
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Ustawia na urządzeniu podaną wartość właściwości. Wymaga, aby adb root miało wartość true.

    Parametry
    propKey String: klucz, który ma zostać ustawiony.

    propValue String: wartość właściwości do ustawienia.

    Zwraca
    boolean zwraca True, jeśli polecenie setprop zostało wykonane prawidłowo, a w przeciwnym razie zwraca wartość False.

    Zgłasza
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Ustaw numer IDeviceRecovery, który ma być używany na tym urządzeniu. Należy go ustawić, gdy urządzenie zostanie po raz pierwszy przydzielone.

    Parametry
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Ustaw bieżący tryb odzyskiwania, który ma być używany na urządzeniu.

    Służy do określania metody odzyskiwania, która ma być używana w przypadku problemów z komunikacją z urządzeniem. Zalecamy używanie tej metody tylko w razie potrzeby (np. gdy platforma nie działa itp.).

    Parametry
    mode ITestDevice.RecoveryMode: czy tryb „Odzyskuj tylko do momentu połączenia z siecią” ma być włączony.

    setSetting

    public void setSetting (String namespace, 
                    String key, 
                    String value)

    Patrz setSetting(int,String,String,String) i wykonywane na użytkowniku systemu.

    Parametry
    namespace String

    key String

    value String

    Zgłasza
    DeviceNotAvailableException

    setSetting

    public void setSetting (int userId, 
                    String namespace, 
                    String key, 
                    String value)

    Dodaj wartość ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu. przestrzeń nazw musi być jedną z tych wartości: {"system", "secure", "global"}

    Parametry
    userId int

    namespace String

    key String

    value String

    Zgłasza
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Wstrzykuje instancję ITestLogger

    Parametry
    testLogger ITestLogger

    setTrackingSerial

    public void setTrackingSerial (String trackingSerial)

    Do celów zarządzania urządzeniami śledzimy numer seryjny, którego używamy do odwoływania się do urządzenia.

    Parametry
    trackingSerial String

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

    Określ, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie fastboot erase czy fastboot format.

    Parametry
    useFastbootErase boolean: true, jeśli ma być użyte polecenie fastboot erase, lub false, jeśli ma być użyte polecenie fastboot format.

    startLogcat

    public void startLogcat ()

    Rozpocznij przechwytywanie danych wyjściowych logcat z urządzenia w tle.

    Nie będzie to miało wpływu, jeśli dane wyjściowe logcat są już rejestrowane. Dane można później pobrać za pomocą funkcji getLogcat.

    Gdy urządzenie nie jest już używane, należy wywołać funkcję stopLogcat().

    Zwykle nie trzeba wywoływać funkcji startLogcat()stopLogcat() w kontekście wywołania TF, ponieważ framework TF uruchamia i zatrzymuje logcat.

    startTradeInModeTesting

    public boolean startTradeInModeTesting (int timeoutMs)

    Włącz tryb testowania wymiany za dopłatą. Urządzenie zostanie wyczyszczone i uruchomione ponownie.

    Parametry
    timeoutMs int

    Zwraca
    boolean Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId)

    Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda nie wykonuje żadnej operacji.

    Parametry
    userId int: użytkownika, aby rozpocząć w tle.

    Zwraca
    boolean Wartość true, jeśli użytkownik został uruchomiony w tle.

    Zgłasza
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

    Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda nie wykonuje żadnej operacji. Możesz podać dodatkową flagę, aby poczekać na wprowadzenie zmian.

    Parametry
    userId int: użytkownika, aby rozpocząć w tle.

    waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany.

    Zwraca
    boolean Wartość true, jeśli użytkownik został uruchomiony w tle.

    Zgłasza
    DeviceNotAvailableException

    startVisibleBackgroundUser

    public boolean startVisibleBackgroundUser (int userId, 
                    int displayId, 
                    boolean waitFlag)

    Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli umożliwia użytkownikowi uruchamianie aktywności na tym wyświetlaczu).

    UWAGA: to polecenie nie sprawdza, czy użytkownik istnieje, czy wyświetlacz jest dostępny, device supports such feature itp.

    Parametry
    userId int: użytkownika, aby rozpocząć w tle.

    displayId int: wyświetlanie, aby rozpocząć widoczność użytkownika

    waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany.

    Zwraca
    boolean true – jeśli użytkownik został uruchomiony w tle.

    Zgłasza
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Zamknij i usuń dane wyjściowe emulatora.

    stopLogcat

    public void stopLogcat ()

    Przestań rejestrować dane wyjściowe logcat z urządzenia i odrzuć aktualnie zapisane dane logcat.

    Nie będzie mieć wpływu, jeśli dane wyjściowe logcat nie są rejestrowane.

    stopTradeInModeTesting

    public void stopTradeInModeTesting ()

    Zakończ testowanie trybu wymiany za dopłatą.

    Zgłasza
    DeviceNotAvailableException

    stopUser

    public boolean stopUser (int userId)

    Zatrzymuje danego użytkownika. Jeśli użytkownik jest już zatrzymany, ta metoda nie wykonuje żadnej operacji. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.

    Parametry
    userId int: użytkownika, którego chcesz zatrzymać.

    Zwraca
    boolean Wartość true, jeśli użytkownik został zatrzymany.

    Zgłasza
    DeviceNotAvailableException

    stopUser

    public boolean stopUser (int userId, 
                    boolean waitFlag, 
                    boolean forceFlag)

    Zatrzymanie danego użytkownika. Można podać dodatkowe flagi, aby poczekać na wprowadzenie zmian, i wymusić zakończenie sesji użytkownika. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.

    Parametry
    userId int: użytkownika, którego chcesz zatrzymać.

    waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik się zatrzyma.

    forceFlag boolean: wymusi zatrzymanie użytkownika.

    Zwraca
    boolean Wartość true, jeśli użytkownik został zatrzymany.

    Zgłasza
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

    Przełącz urządzenie w tryb adb-over-tcp.

    Zwraca
    String numer seryjny urządzenia TCP lub null, jeśli nie udało się przełączyć urządzenia.

    Zgłasza
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    Przełącz urządzenie w tryb adb over usb.

    Zwraca
    boolean true, jeśli przełączenie się powiodło, w przeciwnym razie false.

    Zgłasza
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId)

    Przełącz na inny identyfikator użytkownika z domyślnym czasem oczekiwania. switchUser(int, long).

    Parametry
    userId int

    Zwraca
    boolean Wartość „true”, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.

    Zgłasza
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId, 
                    long timeout)

    Przełącza się na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem. Próba wyłączenia blokady ekranu po zmianie użytkownika zakończyła się powodzeniem.

    Parametry
    userId int

    timeout long: czas oczekiwania przed zwróceniem wartości false w przypadku niepowodzenia przełączania użytkownika.

    Zwraca
    boolean Wartość „true”, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.

    Zgłasza
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Przyrostowo synchronizuje zawartość lokalnego katalogu plików z urządzeniem.

    Decyduje, które pliki przesłać, porównując sygnatury czasowe plików lokalnych z ich zdalnymi odpowiednikami. Na urządzenie zostaną przesłane tylko „nowsze” lub nieistniejące pliki. Dlatego obciążenie powinno być stosunkowo małe, jeśli zestaw plików na urządzeniu jest już aktualny.

    Ukryte pliki (których nazwy zaczynają się od „.”) zostaną zignorowane.

    Przykład użycia: syncFiles("/tmp/files", "/sdcard") utworzy katalog /sdcard/files, jeśli jeszcze nie istnieje, i rekursywnie przeniesie zawartość /tmp/files do /sdcard/files.

    Parametry
    localFileDir File: lokalny katalog plików zawierający pliki do rekurencyjnego wypychania.

    deviceFilePath String: bezwzględna ścieżka do katalogu głównego zdalnego miejsca docelowego. Wszystkie katalogi w tej ścieżce pliku muszą być czytelne. Na przykład próba przesłania pliku do katalogu /data/local/tmp, gdy adb nie ma uprawnień roota, zakończy się niepowodzeniem.

    Zwraca
    boolean true, jeśli pliki zostały zsynchronizowane. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    Pobiera raport o błędzie i zwraca go w obiekcie Bugreport, aby go obsłużyć. W przypadku problemu zwraca wartość null. Plik, do którego odwołuje się obiekt Bugreport, musi zostać wyczyszczony za pomocą funkcji Bugreport.close().

    Zwraca
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Odinstaluj pakiet Androida z urządzenia.

    Parametry
    packageName String: pakiet na Androida do odinstalowania.

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

    Zgłasza
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Odinstaluj pakiet Androida z urządzenia dla danego użytkownika.

    Parametry
    packageName String: pakiet na Androida do odinstalowania.

    userId int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać odinstalowana aplikacja.

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

    Zgłasza
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

    Odblokowuje urządzenie, jeśli jest ono zaszyfrowane.

    Ta metoda może ponownie uruchomić platformę, ale nie wywoła funkcji postBootSetup(). Dlatego urządzenie może nie być w pełni gotowe do testowania, gdy ta metoda zwróci wartość.

    Zwraca
    boolean true – jeśli operacja się powiodła lub urządzenie nie jest zaszyfrowane.

    Zgłasza
    DeviceNotAvailableException
    UnsupportedOperationException

    unmountDebugfs

    public void unmountDebugfs ()

    Odłącz debugfs.

    Zgłasza
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Blokuje do momentu ustawienia flagi zakończenia rozruchu urządzenia.

    Parametry
    timeOut long: czas w milisekundach, przez jaki należy czekać na ustawienie flagi.

    Zwraca
    boolean wartość true, jeśli flaga zakończenia uruchamiania urządzenia jest ustawiona w okresie oczekiwania;

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania. Używa domyślnego limitu czasu.

    Zwraca
    boolean Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli przywracanie jest wyłączone i niedostępne.

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania.

    Parametry
    waitTime long: czas oczekiwania w milisekundach.

    Zwraca
    boolean Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli przywracanie jest wyłączone i niedostępne.

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Czeka na odpowiedź urządzenia i jego dostępność bez uwzględniania ścieżki przywracania.

    Parametry
    waitTime long

    Zwraca
    boolean Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli jest niedostępne.

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Blokuje działanie, dopóki urządzenie nie będzie widoczne w trybie fastboot. Użyj domyślnego limitu czasu.

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceFastbootD

    public void waitForDeviceFastbootD ()

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Blokuje możliwość przejścia urządzenia w stan „adb recovery” (uwaga: różni się od IDeviceRecovery).

    Parametry
    waitTime long: czas oczekiwania w milisekundach.

    Zwraca
    boolean true jeśli urządzenie uruchomi się w trybie odzyskiwania przed upływem czasu. W innych przypadkach false

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blokuje urządzenie w stanie „adb sideload”

    Parametry
    waitTime long: czas oczekiwania w milisekundach.

    Zwraca
    boolean true, jeśli urządzenie uruchomi się w trybie sideload przed upływem czasu. W innych przypadkach false

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Blokuje urządzenie, aby było niedostępne, np. nie było widoczne w adb.

    Parametry
    waitTime long: czas oczekiwania w milisekundach.

    Zwraca
    boolean true, jeśli urządzenie stanie się niedostępne przed upływem czasu. W innych przypadkach false

    waitForDeviceOnline

    public void waitForDeviceOnline ()

    Blokuje do momentu, aż urządzenie będzie widoczne przez adb. Używa domyślnego limitu czasu

    Pamiętaj, że po zakończeniu procesu urządzenie może nie reagować na polecenia. Zamiast niej używaj zasady waitForDeviceAvailable().

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

    Blokuje do momentu, aż urządzenie będzie widoczne przez adb.

    Pamiętaj, że po zakończeniu procesu urządzenie może nie reagować na polecenia. Zamiast niej używaj zasady waitForDeviceAvailable().

    Parametry
    waitTime long: czas oczekiwania w milisekundach.

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    Czeka, aż urządzenie odpowie na podstawowe polecenie powłoki adb.

    Parametry
    waitTime long: czas oczekiwania w milisekundach.

    Zwraca
    boolean true jeśli urządzenie zacznie odpowiadać przed upływem czasu waitTime.

    Metody chronione

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parametry
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

    protected String[] buildAdbShellCommand (String command, 
                    boolean forceExitStatusDetection, 
                    boolean oldShellCommand)

    Tworzy polecenie systemu operacyjnego dla danej sesji polecenia powłoki adb i argumentów.

    Parametry
    command String

    forceExitStatusDetection boolean

    oldShellCommand boolean

    Zwraca
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Parametry
    feature String

    strictMinLevel int

    createRebootDeviceAction

    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Utwórz RebootDeviceAction, który będzie używany podczas restartowania.

    Parametry
    rebootMode NativeDevice.RebootMode: tryb ponownego uruchomienia.

    reason String: w przypadku tego ponownego uruchomienia.

    Zwraca
    NativeDevice.RebootDeviceAction utworzony RebootDeviceAction.

    createRunUtil

    protected IRunUtil createRunUtil ()

    Zwraca
    IRunUtil

    doAdbReboot

    protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Wykonaj ponowne uruchomienie za pomocą polecenia adb.

    Parametry
    rebootMode NativeDevice.RebootMode: tryb ponownego uruchomienia.

    reason String: w przypadku tego ponownego uruchomienia.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    metoda pomocnicza do zgłaszania wyjątku, jeśli uprawnienia w czasie działania (aplikacji) nie są obsługiwane

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Zwraca
    int

    getLogger

    protected ITestLogger getLogger ()

    Zwraca
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    Uzyskaj instancję RunUtil, której chcesz użyć.

    Zwraca
    IRunUtil

    internalGetProperty

    protected String internalGetProperty (String propName, 
                    String fastbootVar, 
                    String description)

    Pobiera właściwość urządzenia z pamięci podręcznej ddmlib (domyślnie) lub z polecenia `adb shell getprop` albo `fastboot getvar` w zależności od tego, czy urządzenie jest w trybie Fastboot.

    Parametry
    propName String: nazwa właściwości urządzenia zwrócona przez polecenie `adb shell getprop`

    fastbootVar String: nazwa odpowiedniej zmiennej fastboot, o którą chcesz wysłać zapytanie. Jeśli null, nie zostanie podjęta próba wysłania zapytania fastboot.

    description String: prosty opis zmiennej. Pierwsza litera powinna być duża.

    Zwraca
    String Ciąg tekstowy, który może zawierać wartość null lub być pusty, zawierający wartość danej właściwości.

    Zgłasza
    DeviceNotAvailableException
    UnsupportedOperationException

    isInRebootCallback

    protected boolean isInRebootCallback ()

    Zwraca informację, czy wywołania zwrotne ponownego uruchomienia są obecnie wykonywane. Jeśli ta wartość jest prawdziwa, wszystkie publiczne interfejsy API służące do ponownego uruchamiania powinny być wyłączone.

    Zwraca
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Zwraca true, jeśli plik lokalny jest nowszy niż plik zdalny. IFileEntry dokładny co do minuty. W przypadku równych czasów plik zostanie uznany za nowszy.

    Parametry
    localFile File

    entry IFileEntry

    Zwraca
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    Powiadamia wszystkie IDeviceActionReceiver o zakończeniu ponownego uruchamiania.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

    Powiadamia wszystkie urządzenia IDeviceActionReceiver o rozpoczęciu ponownego uruchamiania.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    performDeviceAction

    protected boolean performDeviceAction (String actionDescription, 
                    NativeDevice.DeviceAction action, 
                    int retryAttempts)

    Wykonuje działanie na tym urządzeniu. Próbuje odzyskać urządzenie i opcjonalnie ponowić wykonanie polecenia, jeśli działanie się nie powiedzie.

    Parametry
    actionDescription String: krótki opis działania, które ma zostać wykonane. Służy tylko do rejestrowania.

    action NativeDevice.DeviceAction: działanie do wykonania

    retryAttempts int: liczba ponownych prób wykonania działania, jeśli się nie powiedzie, ale odzyskiwanie się uda

    Zwraca
    boolean true, jeśli działanie zostało wykonane

    Zgłasza
    DeviceNotAvailableException jeśli próba odzyskania się nie powiedzie lub osiągnięto maksymalną liczbę prób bez powodzenia;

    postAdbReboot

    protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

    Możliwe dodatkowe działania, które można wykonać po ponownym uruchomieniu.

    Parametry
    rebootMode NativeDevice.RebootMode

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

    Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w celu przeprowadzenia konfiguracji po uruchomieniu.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileWithAdbCommand

    protected boolean pullFileWithAdbCommand (String remoteFilePath, 
                    File localFile, 
                    long timeout)

    Parametry
    remoteFilePath String

    localFile File

    timeout long

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    setClock

    protected void setClock (Clock clock)

    Ustaw instancję zegara, której chcesz używać.

    Parametry
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Oznacza TestDevice jako microdroid i ustawia jego ID klienta.

    Parametry
    process Process: proces maszyny wirtualnej Microdroida.

    setTestDeviceOptions

    protected void setTestDeviceOptions (Map<String, String> deviceOptions)

    Parametry
    deviceOptions Map

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                    String[] fullCmd)

    Wykonuje proste polecenie fastboot i zgłasza jego stan.

    Parametry
    timeout long

    fullCmd String

    Zwraca
    CommandResult

    Zgłasza
    UnsupportedOperationException

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                    Map<String, String> envVarMap, 
                    String[] fullCmd)

    Wykonuje proste polecenie fastboot ze zmiennymi środowiskowymi i zgłasza stan polecenia.

    Parametry
    timeout long

    envVarMap Map

    fullCmd String

    Zwraca
    CommandResult

    Zgłasza
    UnsupportedOperationException

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    Poczekaj, aż urządzenie stanie się niedostępne (przestanie przesyłać raporty do adb).

    Parametry
    operationDesc String: nazwa operacji, która oczekuje na niedostępność.

    time long: czas oczekiwania na wystąpienie stanu niedostępności.

    Zwraca
    boolean Wartość „prawda”, jeśli urządzenie stało się niedostępne.