Urządzenie natywne

public class NativeDevice
extends Object implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver

Obiekt Java.lang.Object
com.android.tradefed.device.NativeDevice


Domyślna implementacja urządzeń z systemem Android ITestDevice , które nie obsługują pełnego stosu.

Streszczenie

Zagnieżdżone klasy

class NativeDevice.AdbAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) podczas uruchamiania polecenia „adb…” systemu operacyjnego.

class NativeDevice.AdbShellAction

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) ponownego uruchomienia urządzenia.

Stałe

int INVALID_USER_ID

Wartość zwrócona w przypadku nieprawidłowego/nieodnalezionego 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

Pola

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Konstruktorzy publiczni

NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Tworzy TestDevice .

Metody publiczne

void batchPrefetchStartupBuildProps ()

Mikrooptymalizacja (około 400 milinów) poprzez wstępne pobieranie wszystkich potrzebnych rekwizytów zamiast wywoływania „adb getprop” dla każdego z nich.

boolean canSwitchToHeadlessSystemUser ()

Zwraca informację, czy można przełączyć się na użytkownika bezgłowego SYSTEM.

boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Sprawdź, czy dana funkcja jest obecnie obsługiwana, biorąc pod uwagę minimalnie obsługiwany poziom.

boolean checkConnectivity ()

Sprawdź, czy urządzenie ma łączność sieciową.

boolean clearErrorDialogs ()

Spróbuj odrzucić wszelkie okna dialogowe o błędach wyświetlane obecnie w interfejsie użytkownika urządzenia.

void clearLastConnectedWifiNetwork ()

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

void clearLogcat ()

Usuwa wszelkie zgromadzone dane logcat.

boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

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

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

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

boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

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

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

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

boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

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

boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

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

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

Utwórz użytkownika o podanej nazwie i podanych flagach

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

Utwórz użytkownika o podanej nazwie i podanych flagach

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.

void deleteFile (String deviceFilePath)

Metoda pomocnicza służąca 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 uruchomione miękko, porównując bieżący serwer systemowy z poprzednim ProcessInfo serwera systemowego.

boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało uruchomione miękko od czasu UTC od epoki z urządzenia i jego ERROR(/TimeUnit) .

boolean disableAdbRoot ()

Wyłącza root adb.

void disableKeyguard ()

Próba 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 służąca do ustalenia, czy dla danego użytkownika istnieje plik na urządzeniu.

boolean doesFileExist (String deviceFilePath)

Metoda pomocnicza służąca do ustalenia, czy plik na urządzeniu istnieje.

File dumpHeap (String process, String devicePath)

Spróbuj zrzucić stertę z serwera systemowego.

boolean enableAdbRoot ()

Włącza root adb.

boolean enableNetworkMonitor ()

Umożliwia monitorowanie sieci na urządzeniu.

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

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

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

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

String executeAdbCommand (String... cmdArgs)

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

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ługo działające polecenie fastboot jako polecenie systemowe.

CommandResult executeLongFastbootCommand ( envVarMap, String... cmdArgs) executeLongFastbootCommand ( envVarMap, String... cmdArgs)

Metoda pomocnicza, która wykonuje długo działające polecenie fastboot jako polecenie systemowe z systemowymi zmiennymi środowiskowymi.

String executeShellCommand (String command)

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

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów kontrolujących zachowanie poleceń.

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów kontrolujących zachowanie poleceń.

void executeShellCommand (String command, IShellOutputReceiver receiver)

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

CommandResult executeShellV2Command (String cmd)

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

CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)

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

CommandResult executeShellV2Command (String cmd, File pipeAsInput)

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

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów kontrolujących zachowanie poleceń.

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów kontrolujących zachowanie poleceń.

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów kontrolujących zachowanie poleceń.

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów kontrolujących zachowanie poleceń.

CommandResult fastbootWipePartition (String partition)

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

getActiveApexes ()

Pobierz informacje o APEXach aktywowanych na urządzeniu.

getAllSettings (String namespace)

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

DeviceAllocationState getAllocationState ()

Zwróć bieżący stan alokacji urządzenia

String getAndroidId (int userId)

Znajdź i zwróć identyfikator Androida powiązany z identyfikatorem użytkownika, null, jeśli nie zostanie znaleziony.

getAndroidIds ()

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

int getApiLevel ()

Uzyskaj poziom interfejsu API urządzenia.

PackageInfo getAppPackageInfo (String packageName)

Pobierz informacje o pakiecie zainstalowanym na urządzeniu.

getAppPackageInfos ()

Pobierz informacje o pakietach zainstalowanych na urządzeniu.

String getBasebandVersion ()

Wygodna metoda uzyskania wersji tego urządzenia w paśmie podstawowym (radiowym).

Integer getBattery ()

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

boolean getBooleanProperty (String name, boolean defaultValue)

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

getBootHistory ()

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

getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

Metoda pomocnicza zbiera mapę historii rozruchu z czasem rozruchu i powodem rozruchu od podanego czasu od epoki z urządzenia i określoną jednostką czasu.

String getBootloaderVersion ()

Wygodna metoda uzyskania wersji bootloadera tego urządzenia.

InputStreamSource getBugreport ()

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

InputStreamSource getBugreportz ()

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

String getBuildAlias ()

Pobierz alias kompilacji aktualnie uruchomionej na urządzeniu.

String getBuildFlavor ()

Pobierz wersję kompilacji urządzenia.

String getBuildId ()

Pobierz wersję aktualnie uruchomioną na urządzeniu.

String getBuildSigningKeys ()

Zwraca typ klucza używany do podpisania obrazu urządzenia

Zazwyczaj urządzenia z Androidem mogą być podpisane kluczami testowymi (jak w AOSP) lub kluczami wydania (kontrolowanymi przez poszczególnych producentów urządzeń)

DeviceDescriptor getCachedDeviceDescriptor ()

Zwraca buforowany DeviceDescriptor jeśli urządzenie jest przydzielone, w przeciwnym razie zwraca bieżący DeviceDescriptor .

DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Zwraca buforowany DeviceDescriptor jeśli urządzenie jest przydzielone, w przeciwnym razie zwraca bieżący DeviceDescriptor .

String[] getChildren (String path)

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

AbstractConnection getConnection ()

Bieżące połączenie powiązane z urządzeniem.

DeviceFoldableState getCurrentFoldableState ()

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

int getCurrentUser ()

Zwróć identyfikator bieżącego uruchomionego użytkownika.

String getDeviceClass ()

Pobierz klasę urządzenia.

long getDeviceDate ()

Zwróć datę urządzenia w milisekundach od epoki.

DeviceDescriptor getDeviceDescriptor ()

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

DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

TestDeviceState getDeviceState ()

Uzyskaj stan urządzenia.

long getDeviceTimeOffset (Date date)

Pomocnik do uzyskania różnicy czasu między urządzeniem a danym ERROR(/Date) .

InputStreamSource getEmulatorOutput ()

Pobierz strumień emulatora stdout i stderr

Process getEmulatorProcess ()

Zwróć Process odpowiadający temu emulatorowi.

final File getExecuteShellCommandLog ()

Dziennik zawierający wszystkie dzienniki executeShellCommand(String) .

long getExternalStoreFreeSpace ()

Metoda pomocnicza określająca ilość wolnego miejsca w pamięci zewnętrznej urządzenia.

String getFastbootPath ()

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

String getFastbootProductType ()

Wygodna metoda uzyskania typu produktu tego urządzenia, gdy jest ono w trybie szybkiego uruchamiania.

String getFastbootProductVariant ()

Wygodna metoda uzyskania typu produktu tego urządzenia, gdy jest ono w trybie szybkiego uruchamiania.

String getFastbootSerialNumber ()

Zwraca numer seryjny trybu fastboot.

String getFastbootVariable (String variableName)

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

String getFastbootVersion ()

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

IFileEntry getFileEntry (String path)

Pobierz odwołanie do zdalnego pliku na urządzeniu.

IFileEntry getFileEntry (FileListingService.FileEntry entry)

Nieoficjalny pomocnik do uzyskania FileEntry ze ścieżki innej niż root.

getFoldableStates ()

Zwraca listę składanych stanów na urządzeniu.

IDevice getIDevice ()

Zwraca odwołanie do powiązanego ddmlib IDevice .

getInstalledPackageNames ()

Pobierz nazwy pakietów aplikacji obecne 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 ()

Zwróć obiekt, aby uzyskać bieżący stan blokady klawiatury lub null, jeśli nie jest obsługiwany.

long getLastExpectedRebootTimeMillis ()

Zwraca ostatni raz, kiedy interfejsy API Tradefed wyzwoliły ponowne uruchomienie w milisekundach od czasu EPOCH, zgodnie z wartością zwróconą przez System.currentTimeMillis() .

int getLaunchApiLevel ()

Uzyskaj pierwszy uruchomiony poziom API urządzenia.

InputStreamSource getLogcat ()

Pobiera strumień migawki danych logcat.

InputStreamSource getLogcat (int maxBytes)

Pobiera strumień migawki ostatnich maxBytes przechwyconych danych logcat.

InputStreamSource getLogcatDump ()

Pobierz zrzut bieżącego logcat dla urządzenia.

InputStreamSource getLogcatSince (long date)

Pobiera strumień migawki przechwyconych danych logcat, począwszy od podanej daty.

String getMacAddress ()

Zwraca adres MAC urządzenia; wartość null, jeśli zapytanie z urządzenia nie powiedzie się.

Integer getMainUserId ()

Zwraca główny identyfikator użytkownika.

getMainlineModuleInfo ()

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

int getMaxNumberOfRunningUsersSupported ()

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

int getMaxNumberOfUsersSupported ()

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

Process getMicrodroidProcess ()
IDeviceStateMonitor getMonitor ()

Zwróć 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łączenia lub null , jeśli na tej ścieżce nic nie jest zamontowane lub w inny sposób nie pojawia się w /proc/mounts jako punkt montowania.

getMountPointInfo ()

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

TestDeviceOptions getOptions ()

Pobierz opcje testowe dla urządzenia.

long getPartitionFreeSpace (String partition)

Metoda pomocnicza określająca ilość wolnego miejsca na partycji urządzenia.

Integer getPrimaryUserId ()

Zwraca podstawowy identyfikator użytkownika.

ProcessInfo getProcessByName (String processName)

Metoda pomocnicza uruchamia komendy "pidof" i "stat" i zwraca obiekt ProcessInfo z PID i czasem rozpoczęcia danego procesu.

String getProcessPid (String process)

Zwraca pid usługi lub null, jeśli coś poszło nie tak.

String getProductType ()

Wygodna metoda uzyskania typu produktu tego urządzenia.

String getProductVariant ()

Wygodna metoda uzyskania wariantu produktu tego urządzenia.

String getProperty (String name)

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

ITestDevice.RecoveryMode getRecoveryMode ()

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

InputStreamSource getScreenshot (String format)

Pobiera zrzut ekranu z urządzenia.

InputStreamSource getScreenshot (long displayId)

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

InputStreamSource getScreenshot (String format, boolean rescale)

Pobiera zrzut ekranu z urządzenia.

InputStreamSource getScreenshot ()

Pobiera zrzut ekranu z urządzenia.

String getSerialNumber ()

Wygodna metoda uzyskania numeru seryjnego tego urządzenia.

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

Zwróć wartość żądanego ustawienia.

String getSetting (String namespace, String key)

Zobacz getSetting(int, String, String) i wykonywane na użytkowniku systemowym.

String getSimOperator ()

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

String getSimState ()

Zwróć stan karty SIM lub null, jeśli nie jest dostępny lub urządzenie nie jest dostępne.

getTombstones ()

Pobierz i zwróć listę nagrobków z urządzeń.

long getTotalMemory ()

Zwraca całkowity rozmiar pamięci fizycznej w bajtach lub -1 w przypadku błędu wewnętrznego

getUninstallablePackageNames ()

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

boolean getUseFastbootErase ()

Dowiedz się, czy do czyszczenia partycji na urządzeniu ma być używany format fastboot lub fastboot.

int getUserFlags (int userId)

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

getUserInfos ()

Pobiera mapę useId do UserInfo na urządzeniu.

int getUserSerialNumber (int userId)

Jeśli zostanie znaleziony, zwróć numer seryjny powiązany z identyfikatorem użytkownika, w pozostałych przypadkach -10000.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Przetwórz podane zdarzenie DeviceEvent.

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

boolean hasFeature (String feature)

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

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

Zainstaluj pakiet Android na urządzeniu.

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

Zainstaluj pakiet Android na urządzeniu.

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

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

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

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

void invalidatePropertyCache ()
boolean isAdbRoot ()

boolean isAdbTcp ()
boolean isAppEnumerationSupported ()

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

boolean isBypassLowTargetSdkBlockSupported ()

Sprawdź, czy platforma na urządzeniu obsługuje omijanie niskiego docelowego bloku SDK podczas instalacji aplikacji

boolean isDebugfsMounted ()

Sprawdź, czy debugfs jest zamontowany.

boolean isDeviceEncrypted ()

Zwraca, jeśli urządzenie jest zaszyfrowane.

boolean isDirectory (String path)

Zwróć True, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie false.

boolean isEnableAdbRoot ()
boolean isEncryptionSupported ()

Zwraca, jeśli urządzenie obsługuje szyfrowanie.

boolean isExecutable (String fullPath)

Zwraca wartość True, jeśli ścieżka pliku na urządzeniu jest plikiem wykonywalnym, w przeciwnym razie zwraca wartość false.

boolean isFastbootEnabled ()

Wróć, jeśli dla urządzenia dostępna jest funkcja fastboot.

boolean isHeadless ()

Zwróć wartość true, jeśli urządzenie jest bezgłowe (bez ekranu), w przeciwnym razie wartość false.

boolean isHeadlessSystemUserMode ()

Zwraca informację, czy urządzenie korzysta z trybu użytkownika systemu bezgłowego.

boolean isMainUserPermanentAdmin ()

Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani zmienić na inny niż administrator.

boolean isMultiUserSupported ()

Określa, czy obsługiwanych jest wielu użytkowników.

boolean isPackageInstalled (String packageName, String userId)

Zapytaj urządzenie o podaną nazwę pakietu i podany identyfikator użytkownika, aby sprawdzić, czy jest ono aktualnie zainstalowane dla tego użytkownika.

boolean isPackageInstalled (String packageName)

Zapytaj urządzenie o podaną nazwę pakietu, aby sprawdzić, czy jest on aktualnie zainstalowany, czy nie.

boolean isRuntimePermissionSupported ()

Sprawdź, czy platforma na urządzeniu obsługuje nadawanie uprawnień w czasie wykonywania

boolean isStateBootloaderOrFastbootd ()

Zwraca wartość true, jeśli urządzenie znajduje się w stanie TestDeviceState#FASTBOOT lub TestDeviceState.FASTBOOTD .

boolean isUserRunning (int userId)

Sprawdź, czy dany użytkownik jest uruchomiony.

boolean isUserSecondary (int userId)

Zwraca informację, czy określony użytkownik jest użytkownikiem dodatkowym zgodnie z jego flagami.

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, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

boolean isVisibleBackgroundUsersSupported ()

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

boolean isWifiEnabled ()

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

listDisplayIds ()

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

listDisplayIdsForStartingVisibleBackgroundUsers ()

Pobiera listę ekranów, których można użyć do start a user visible in the background .

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 umożliwiająca przyjęcie raportu o błędzie i zalogowanie go do reporterów.

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

Zarejestruj wiadomość w logcat urządzenia.

void mountDebugfs ()

Zamontuj debugfs.

void nonBlockingReboot ()

Wydaje polecenie ponownego uruchomienia urządzenia i powraca po zakończeniu polecenia i 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 rootowaniu adb i zanim urządzenie wróci do trybu online.

void postAdbUnrootAction ()

Zastąp, jeśli urządzenie wymaga podjęcia określonych działań po unrootowaniu adb i zanim urządzenie wróci do trybu online.

void postBootSetup ()

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

void postInvocationTearDown (Throwable exception)

Dodatkowe kroki dotyczące wymaganego czyszczenia specyficznego dla urządzenia, które zostaną wykonane po zakończeniu wywołania.

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

Dodatkowe kroki wymaganej konfiguracji specyficznej dla urządzenia, które zostaną wykonane na urządzeniu przed przepływem wywołania.

boolean pullDir (String deviceFilePath, File localDir)

Rekursywnie pobieraj zawartość katalogu 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, przechowuje go w lokalnym tymczasowym ERROR(/File) i zwraca ten File .

File pullFile (String remoteFilePath)

Pobiera plik z urządzenia, przechowuje go w lokalnym tymczasowym ERROR(/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 zewnętrznej pamięci urządzenia, przechowywania go w lokalnym tymczasowym ERROR(/File) i zwracania odniesienia do tego File .

boolean pushDir (File localFileDir, String deviceFilePath, excludedDirectories) pushDir (File localFileDir, String deviceFilePath, excludedDirectories)

Rekursywnie przesyłaj zawartość katalogu do urządzenia, wykluczając niektóre filtrowane katalogi.

boolean pushDir (File localFileDir, String deviceFilePath)

Rekursywnie wypychaj zawartość katalogu na urządzenie.

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

Wariant pushFile(File, String) , który opcjonalnie może uwzględniać ocenę zapotrzebowania na dostawcę treści.

boolean pushFile (File localFile, String remoteFilePath)

Prześlij plik na urządzenie.

boolean pushString (String contents, String remoteFilePath)

Prześlij plik utworzony z ciągu znaków do urządzenia

void reboot (String reason)

Ponownie uruchamia urządzenie w trybie adb z podanego reason który ma być utrzymywany po ponownym uruchomieniu.

void reboot ()

Ponownie uruchamia urządzenie w trybie adb.

void rebootIntoBootloader ()

Ponownie uruchamia urządzenie w trybie bootloadera.

void rebootIntoFastbootd ()

Ponownie uruchamia urządzenie w trybie fastbootd.

void rebootIntoRecovery ()

Ponownie uruchamia urządzenie w trybie odzyskiwania adb.

void rebootIntoSideload ()

Ponownie uruchamia urządzenie w trybie adb sideload (pamiętaj, że jest to specjalny tryb w trakcie odzyskiwania)

Blokuje, dopóki urządzenie nie przejdzie w tryb sideload

void rebootIntoSideload (boolean autoReboot)

Ponownie uruchamia urządzenie w trybie adb sideload (pamiętaj, że jest to specjalny tryb w trakcie odzyskiwania)

Blokuje, dopóki urządzenie nie przejdzie w tryb sideload

void rebootUntilOnline ()

Alternatywa dla reboot() , która blokuje tylko do czasu, aż urządzenie będzie online, tj. będzie widoczne dla adb.

void rebootUntilOnline (String reason)

Alternatywa dla reboot() , która blokuje tylko do czasu, aż urządzenie będzie online, tj. będzie widoczne dla adb.

void rebootUserspace ()

Uruchamia ponownie tylko część urządzenia stanowiącą przestrzeń użytkownika.

void rebootUserspaceUntilOnline ()

Alternatywa dla rebootUserspace() ()}, która blokuje tylko do czasu, aż urządzenie będzie online, tj. Widoczne dla adb.

boolean recoverDevice ()

Próbuje odzyskać komunikację z urządzeniem.

void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver dla tego urządzenia.

void remountSystemReadOnly ()

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

void remountSystemWritable ()

Ustaw partycję systemową na urządzeniu jako nadającą się do zapisu.

void remountVendorReadOnly ()

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

void remountVendorWritable ()

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

boolean removeAdmin (String componentName, int userId)

Usuń danego administratora urządzenia dla danego użytkownika i zwróć wartość true , jeśli się powiedzie, false w przeciwnym razie.

void removeOwners ()

Usuń wszystkich istniejących właścicieli profili urządzeń, dokładając wszelkich starań.

boolean removeUser (int userId)

Usuń danego użytkownika z urządzenia.

void resetContentProviderSetup ()

Zresetuj flagę konfiguracji dostawcy treści, aby uruchomić ją ponownie.

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

Wygodna metoda wykonywania ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z jednym lub większą liczbą detektorów przekazanych jako parametry.

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

Przeprowadza testy oprzyrządowania i zapewnia odzyskiwanie urządzenia.

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

Taki sam jak ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) ale uruchamia test dla danego użytkownika.

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

To samo co ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) ale uruchamia test dla danego użytkownika.

void setConfiguration ( IConfiguration configuration)

Wstrzykuje używaną IConfiguration .

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

Ustawia datę na urządzeniu

Uwaga: ustawienie daty na urządzeniu wymaga rootowania

boolean setDeviceOwner (String componentName, int userId)

Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika.

void setDeviceState ( TestDeviceState deviceState)

Zaktualizuj stan urządzenia.

void setEmulatorOutputStream ( SizeLimitedOutputStream output)

W przypadku emulatora ustaw SizeLimitedOutputStream aby logować dane wyjściowe

void setEmulatorProcess (Process p)

Ustawia Process , gdy to 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 powinien zostać użyty.

void setIDevice (IDevice newDevice)

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

void setLogStartDelay (int delay)

Ustawia czas oczekiwania w ms przed rozpoczęciem przechwytywania logcat dla urządzenia online.

void setOptions ( TestDeviceOptions options)

Ustaw opcję TestDeviceOptions dla urządzenia

boolean setProperty (String propKey, String propValue)

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

void setRecovery ( IDeviceRecovery recovery)

Ustaw IDeviceRecovery do użycia dla tego urządzenia.

void setRecoveryMode ( ITestDevice.RecoveryMode mode)

Ustaw bieżący tryb odzyskiwania, który będzie używany na urządzeniu.

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

Zobacz setSetting(int, String, String, String) i wykonaj na użytkowniku systemowym.

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 setUseFastbootErase (boolean useFastbootErase)

Określ, czy do czyszczenia partycji na urządzeniu ma być używany format Fastboot, czy format Fastboot.

void startLogcat ()

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

boolean startUser (int userId)

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

boolean startUser (int userId, boolean waitFlag)

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

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

Uruchamia danego użytkownika w tle, widocznym na danym ekranie (tzn. umożliwiając użytkownikowi uruchomienie działań na tym ekranie).

void stopEmulatorOutput ()

Zamknij i usuń wyjście emulatora.

void stopLogcat ()

Zatrzymaj przechwytywanie danych wyjściowych logcat z urządzenia i odrzuć aktualnie zapisane dane logcat.

boolean stopUser (int userId)

Zatrzymuje danego użytkownika.

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

Zatrzymaj danego użytkownika.

String switchToAdbTcp ()

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

boolean switchToAdbUsb ()

Przełącz urządzenie na tryb adb przez USB.

boolean switchUser (int userId)

Przełącz na inny identyfikator użytkownika z domyślnym limitem czasu.

boolean switchUser (int userId, long timeout)

Przełącz na inny identyfikator użytkownika z podanym limitem czasu jako ostatecznym terminem.

boolean syncFiles (File localFileDir, String deviceFilePath)

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

Bugreport takeBugreport ()

Weź raport o błędzie i zwróć go do obiektu 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 ()

Odmontuj debugfs.

boolean waitForBootComplete (long timeOut)

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

boolean waitForDeviceAvailable ()

Czeka, aż urządzenie zacznie reagować i będzie dostępne do testów.

boolean waitForDeviceAvailable (long waitTime)

Czeka, aż urządzenie zacznie reagować i będzie dostępne do testów.

boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Czeka, aż urządzenie zacznie reagować i będzie dostępne, bez uwzględniania ścieżki odzyskiwania.

void waitForDeviceBootloader ()

Blokuje, dopóki urządzenie nie będzie widoczne poprzez fastboot.

boolean waitForDeviceInRecovery (long waitTime)

Blokuje, aby urządzenie znajdowało się w stanie „odzyskiwania adb” (należy pamiętać, że różni się to od IDeviceRecovery ).

boolean waitForDeviceInSideload (long waitTime)

Blokuje, aby urządzenie znajdowało się w stanie „adb sideload”.

boolean waitForDeviceNotAvailable (long waitTime)

Bloki dla urządzenia, które mają być niedostępne, tj. Brakuje w adb

void waitForDeviceOnline ()

Blokuje, dopóki urządzenie nie będzie widoczne przez adb.

void waitForDeviceOnline (long waitTime)

Blokuje, dopóki urządzenie nie będzie widoczne przez adb.

boolean waitForDeviceShell (long waitTime)

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

Metody chronione

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

Kompiluje polecenie systemu operacyjnego dla danej sesji poleceń powłoki adb i argumentów

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

Utwórz RebootDeviceAction , która będzie używana podczas wykonywania akcji ponownego uruchomienia.

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

Wykonaj ponowne uruchomienie adb.

void ensureRuntimePermissionSupported ()

metoda pomocnicza, aby zgłosić wyjątek, jeśli uprawnienia środowiska wykonawczego nie są obsługiwane

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

Pobierz instancję RunUtil do użycia.

void initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes)
String internalGetProperty (String propName, String fastbootVar, String description)

Pobierz właściwość urządzenia, domyślnie z pamięci podręcznej ddmlib i wróć do `adb Shell getprop` lub `fastboot getvar`, w zależności od tego, czy urządzenie znajduje się w trybie Fastboot, czy nie.

boolean isInRebootCallback ()

Zwraca informację, czy aktualnie wykonywane jest wywołanie zwrotne ponownego uruchomienia, czy nie.

boolean isNewer (File localFile, IFileEntry entry)

Zwróć wartość true , jeśli plik lokalny jest nowszy niż plik zdalny.

void notifyRebootEnded ()

Powiadamia wszystkie IDeviceActionReceiver o zdarzeniu końcowym ponownego uruchomienia.

void notifyRebootStarted ()

Powiadamia wszystkie IDeviceActionReceiver o zdarzeniu startu ponownego uruchomienia.

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

Wykonuje akcję na tym urządzeniu.

void postAdbReboot ()

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

void prePostBootSetup ()

Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w przypadku określonej konfiguracji po rozruchu.

boolean pullFileInternal (String remoteFilePath, File localFile)
void setClock (Clock clock)

Ustaw instancję Clock do użycia.

void setMicrodroidProcess (Process process)

Oznacza urządzenie testowe jako mikrodroid i ustawia jego identyfikator CID.

void setTestDeviceOptions ( deviceOptions) setTestDeviceOptions ( deviceOptions)
CommandResult simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd)

Wykonuje proste polecenie fastboot ze zmiennymi środowiskowymi i raportuje stan polecenia.

CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)

Wykonuje proste polecenie fastboot i raportuje stan polecenia.

boolean waitForDeviceNotAvailable (String operationDesc, long time)

Poczekaj, aż urządzenie stanie się niedostępne (przestań raportować do adb).

Stałe

NIEPRAWIDŁOWY IDENTYFIKATOR UŻYTKOWNIKA

public static final int INVALID_USER_ID

Wartość zwrócona w przypadku nieprawidłowego/nieodnalezionego 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)

Pola

DEBUGFS_PATH

public static final String DEBUGFS_PATH

KARTA SD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOpcje

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Konstruktorzy publiczni

Urządzenie natywne

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

Tworzy TestDevice .

Parametry
device IDevice : powiązane IDevice

stateMonitor IDeviceStateMonitor : mechanizm IDeviceStateMonitor do użycia

allocationMonitor IDeviceMonitor : IDeviceMonitor informujący o zmianach stanu alokacji. Może mieć wartość zerową

Metody publiczne

BatchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Mikrooptymalizacja (około 400 milinów) poprzez wstępne pobieranie wszystkich potrzebnych rekwizytów zamiast wywoływania „adb getprop” dla każdego z nich. tzn. pobranie wszystkich właściwości jest równie szybkie, jak pobranie jednej. Rzeczy takie jak Device.getApiLevel(), checkApiLevelAgainstNextRelease i getBuildAlias ​​wywołują pod maską `adb getprop`. Pobieramy je w jednym wywołaniu i wywołujemy NativeDevice.setProperty. Nawet jeśli tego nie zrobimy, NativeDevice samo wywoła setProperty i zapisze wynik w pamięci podręcznej dla przyszłych wywołań. Po prostu robimy to nieco wcześniej. Jeśli urządzenie jest w trakcie odzyskiwania lub występują inne błędy podczas pobierania rekwizytów, po prostu je ignorujemy.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Zwraca informację, czy można przełączyć się na użytkownika bezgłowego SYSTEM.

Zwroty
boolean

Rzuca
DeviceNotAvailableException

sprawdźApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Sprawdź, czy dana funkcja jest obecnie obsługiwana, biorąc pod uwagę minimalnie obsługiwany poziom. Ta metoda uwzględnia niepublikowane jeszcze funkcje, zanim zostanie podniesiony poziom API.

Parametry
strictMinLevel int : Ścisły minimalny możliwy poziom obsługujący tę funkcję.

Zwroty
boolean Prawda, jeśli poziom jest obsługiwany. Inaczej nieprawda.

Rzuca
DeviceNotAvailableException

sprawdź Łączność

public boolean checkConnectivity ()

Sprawdź, czy urządzenie ma łączność sieciową.

Zwroty
boolean true , jeśli urządzenie ma działające połączenie sieciowe, false w przeciwnym razie.

Rzuca
DeviceNotAvailableException

wyczyść okno dialogowe błędów

public boolean clearErrorDialogs ()

Spróbuj odrzucić wszelkie okna dialogowe o błędach wyświetlane obecnie w interfejsie użytkownika urządzenia.

Zwroty
boolean true , jeśli nie było żadnych okien dialogowych lub okna dialogowe zostały pomyślnie usunięte. inaczej false .

Rzuca
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

wyczyśćLogcat

public void clearLogcat ()

Usuwa wszelkie zgromadzone dane logcat.

Jest to przydatne w przypadkach, gdy chcesz mieć pewność, że ITestDevice#getLogcat() zwraca tylko dane dziennika utworzone po pewnym momencie (np. po flashowaniu nowej wersji urządzenia itp.).

połącz się z siecią Wi-Fi

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

Włącza Wi-Fi i blokuje do czasu pomyślnego nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie Wi-FiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania funkcji ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .

Parametry
wifiSsidToPsk : Mapa identyfikatorów SSID Wi-Fi na hasła.

scanSsid boolean : czy skanować w poszukiwaniu ukrytych identyfikatorów SSID dla tej sieci.

Zwroty
boolean true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

Rzuca
DeviceNotAvailableException

połącz się z siecią Wi-Fi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

Włącza Wi-Fi i blokuje do momentu pomyślnego nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania funkcji ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .

Parametry
wifiSsid String : identyfikator SSID Wi-Fi, z którym można się połączyć

wifiPsk String : hasło PSK lub wartość null, jeśli nie jest szyfrowana

Zwroty
boolean true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

Rzuca
DeviceNotAvailableException

połącz się z siecią Wi-Fi

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

Włącza Wi-Fi i blokuje do czasu pomyślnego nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie Wi-FiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork()

Parametry
wifiSsidToPsk : Mapa identyfikatorów SSID Wi-Fi na hasła.

Zwroty
boolean true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

Rzuca
DeviceNotAvailableException

połącz się z siecią Wi-Fi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

Włącza Wi-Fi i blokuje do momentu pomyślnego nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania funkcji ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .

Parametry
wifiSsid String : identyfikator SSID Wi-Fi, z którym można się połączyć

wifiPsk String : hasło PSK lub wartość null, jeśli nie jest szyfrowana

scanSsid boolean : czy skanować w poszukiwaniu ukrytego identyfikatora SSID dla tej sieci.

Zwroty
boolean true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

Rzuca
DeviceNotAvailableException

połącz się z siecią Wifi w razie potrzeby

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

Parametry
scanSsid boolean : czy skanować w poszukiwaniu ukrytego identyfikatora SSID dla tej sieci

Zwroty
boolean true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

Rzuca
DeviceNotAvailableException

połącz się z siecią Wifi w razie potrzeby

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Zwroty
boolean true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

Rzuca
DeviceNotAvailableException

Stwórz użytkownika

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

Utwórz użytkownika o podanej nazwie i podanych flagach

Parametry
name String : użytkownika, który ma zostać utworzony na urządzeniu

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

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

Zwroty
int identyfikator utworzonego użytkownika

Rzuca
DeviceNotAvailableException

Stwórz użytkownika

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

Utwórz użytkownika o podanej nazwie i podanych flagach

Parametry
name String : użytkownika, który ma zostać utworzony 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

Zwroty
int identyfikator utworzonego użytkownika

Rzuca
DeviceNotAvailableException

Stwórz użytkownika

public int createUser (String name)

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

Parametry
name String : użytkownika, który ma zostać utworzony na urządzeniu

Zwroty
int liczba całkowita dla utworzonego identyfikatora użytkownika

Rzuca
DeviceNotAvailableException

utwórzUserNoThrow

public int createUserNoThrow (String name)

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

Parametry
name String : użytkownika, który ma zostać utworzony na urządzeniu

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

Rzuca
DeviceNotAvailableException

usunąć plik

public void deleteFile (String deviceFilePath)

Metoda pomocnicza służąca do usuwania pliku lub katalogu na urządzeniu.

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

Rzuca
DeviceNotAvailableException

wyrejestruj urządzenieActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver .

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

urządzenieSoft uruchomiono ponownie

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało uruchomione miękko, porównując bieżący serwer systemowy z poprzednim ProcessInfo serwera systemowego. Użyj getProcessByName(String) , aby uzyskać ProcessInfo .

Parametry
prevSystemServerProcess ProcessInfo : poprzedni proces serwera_systemowego ProcessInfo .

Zwroty
boolean true , jeśli urządzenie zostało zrestartowane programowo

Rzuca
DeviceNotAvailableException

urządzenieSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało uruchomione miękko od czasu UTC od epoki z urządzenia i jego ERROR(/TimeUnit) . Miękki restart odnosi się do serwera_systemowego uruchomionego ponownie poza twardym ponownym uruchomieniem urządzenia (na przykład: żądanie ponownego uruchomienia). Bieżące urządzenie utcEpochTime w milisekcondach można uzyskać metodą getDeviceDate() .

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

timeUnit TimeUnit : jednostka czasu TimeUnit dla danego utcEpochTime.

Zwroty
boolean true , jeśli urządzenie zostało zrestartowane programowo

Rzuca
DeviceNotAvailableException

wyłączAdbRoot

public boolean disableAdbRoot ()

Wyłącza root adb.

Wyłączenie roota adb może spowodować rozłączenie urządzenia z adb. Ta metoda będzie blokowana do czasu udostępnienia urządzenia.

Zwroty
boolean true , jeśli się powiedzie.

Rzuca
DeviceNotAvailableException

wyłącz Keyguarda

public void disableKeyguard ()

Próba 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ż w bieżącej implementacji frameworka czasami zdarzają się wyścigi. Następnie wysyłane jest polecenie zwolnienia klawiatury (działa tylko na niezabezpieczonych)

Rzuca
DeviceNotAvailableException

wyłącz NetworkMonitor

public boolean disableNetworkMonitor ()

Wyłącza monitorowanie sieci na urządzeniu.

Zwroty
boolean true , jeśli monitorowanie zostało pomyślnie wyłączone. false jeśli się nie udało.

Rzuca
DeviceNotAvailableException

rozłącz się z Wi-Fi

public boolean disconnectFromWifi ()

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

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

Zwroty
boolean true , jeśli pomyślnie rozłączono się z siecią Wi-Fi. false , jeśli rozłączenie nie powiodło się.

Rzuca
DeviceNotAvailableException

czy plik istnieje

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Metoda pomocnicza służąca do ustalenia, czy dla danego użytkownika istnieje plik na urządzeniu.

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

userId int : Identyfikator użytkownika, według którego sprawdzane jest istnienie pliku

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

Rzuca
DeviceNotAvailableException

czy plik istnieje

public boolean doesFileExist (String deviceFilePath)

Metoda pomocnicza służąca do ustalenia, czy plik na urządzeniu istnieje.

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

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

Rzuca
DeviceNotAvailableException

sterta zrzutu

public File dumpHeap (String process, 
                String devicePath)

Spróbuj zrzucić stertę z serwera systemowego. Oczyszczenie zrzuconego pliku jest obowiązkiem dzwoniącego.

Parametry
process String : nazwa procesu urządzenia, na którym ma zostać zrzucony plik.

devicePath String : ścieżka na urządzeniu, gdzie umieścić zrzut. Musi to być lokalizacja, w której pozwalają na to uprawnienia.

Zwroty
File ERROR(/File) zawierający raport. Null, jeśli coś się nie udało.

Rzuca
DeviceNotAvailableException

włączAdbRoot

public boolean enableAdbRoot ()

Włącza root adb. Jeśli ustawienie „enable-root” ma wartość „false”, zarejestruje wiadomość i powróci bez włączania roota.

Włączenie roota adb może spowodować rozłączenie urządzenia z adb. Ta metoda będzie blokowana do czasu udostępnienia urządzenia.

Zwroty
boolean true , jeśli się powiedzie.

Rzuca
DeviceNotAvailableException

włączMonitor sieci

public boolean enableNetworkMonitor ()

Umożliwia monitorowanie sieci na urządzeniu.

Zwroty
boolean true , jeśli monitorowanie zostało pomyślnie włączone. false jeśli się nie udało.

Rzuca
DeviceNotAvailableException

wykonaj polecenie Adb

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

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

Zamiast tego należy używać executeShellCommand(String) tam, gdzie to możliwe, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i lepszą wydajność.

Parametry
timeout long : czas w milisekundach, po którym urządzenie zostanie uznane za niereagujące, 0L w przypadku braku limitu czasu

cmdArgs String : polecenie adb i argumenty do uruchomienia

Zwroty
String standardowe wyjście z polecenia. null , jeśli polecenie nie zostało wykonane.

Rzuca
DeviceNotAvailableException

wykonaj polecenie Adb

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

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

Zamiast tego należy używać executeShellCommand(String) tam, gdzie to możliwe, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i lepszą wydajność.

Parametry
timeout long : czas w milisekundach, po którym urządzenie zostanie uznane za niereagujące, 0L w przypadku braku limitu czasu

envMap : środowisko do ustawienia dla polecenia

cmdArgs String : polecenie adb i argumenty do uruchomienia

Zwroty
String standardowe wyjście z polecenia. null , jeśli polecenie nie zostało wykonane.

Rzuca
DeviceNotAvailableException

wykonaj polecenie Adb

public String executeAdbCommand (String... cmdArgs)

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

Zamiast tego należy używać executeShellCommand(String) tam, gdzie to możliwe, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i lepszą wydajność.

Parametry
cmdArgs String : polecenie adb i argumenty do uruchomienia

Zwroty
String standardowe wyjście z polecenia. null , jeśli polecenie nie zostało wykonane.

Rzuca
DeviceNotAvailableException

wykonaj polecenie Fastboot

public CommandResult executeFastbootCommand (String... cmdArgs)

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

Oczekuje się, że będzie używany, gdy urządzenie jest już w trybie szybkiego uruchamiania.

Parametry
cmdArgs String : polecenie fastboot i argumenty do uruchomienia

Zwroty
CommandResult CommandResult zawierający dane wyjściowe polecenia

Rzuca
DeviceNotAvailableException

wykonaj polecenie Fastboot

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

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

Oczekuje się, że będzie używany, gdy urządzenie jest już w trybie szybkiego uruchamiania.

Parametry
timeout long : czas w milisekundach przed wygaśnięciem polecenia

cmdArgs String : polecenie fastboot i argumenty do uruchomienia

Zwroty
CommandResult CommandResult zawierający dane wyjściowe polecenia

Rzuca
DeviceNotAvailableException

wykonaj polecenie LongFastboot

public CommandResult executeLongFastbootCommand (String... cmdArgs)

Metoda pomocnicza, która wykonuje długo działające polecenie fastboot jako polecenie systemowe.

Identyczne z executeFastbootCommand(String) z tą różnicą, że używa dłuższego limitu czasu.

Parametry
cmdArgs String : polecenie fastboot i argumenty do uruchomienia

Zwroty
CommandResult CommandResult zawierający dane wyjściowe polecenia

Rzuca
DeviceNotAvailableException

wykonaj polecenie LongFastboot

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

Metoda pomocnicza, która wykonuje długo działające polecenie fastboot jako polecenie systemowe z systemowymi zmiennymi środowiskowymi.

Identyczne z executeFastbootCommand(String) z tą różnicą, że używa dłuższego limitu czasu.

Parametry
envVarMap : zmienne środowiskowe systemu, z którymi uruchamiane jest polecenie fastboot

cmdArgs String : polecenie fastboot i argumenty do uruchomienia

Zwroty
CommandResult CommandResult zawierający dane wyjściowe polecenia

Rzuca
DeviceNotAvailableException

wykonaj polecenie Shell

public String executeShellCommand (String command)

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

Parametry
command String : polecenie powłoki adb do uruchomienia

Zwroty
String wyjście powłoki

Rzuca
DeviceNotAvailableException

wykonaj polecenie Shell

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów kontrolujących zachowanie poleceń.

Parametry
command String : polecenie powłoki adb do uruchomienia

receiver IShellOutputReceiver : IShellOutputReceiver do bezpośredniego wyjścia powłoki do.

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

timeUnit TimeUnit : Jednostka dla maxTimeToOutputShellResponse

retryAttempts int : Maksymalna liczba razy do ponownego ponownego wypowiedzi polecenia, jeśli zawiedzie z powodu wyjątku. DeviceNotRespentiveException zostanie wyrzucone, jeśli ponowne retryAttempts zostanie wykonywane.

Rzuca
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 do kontrolowania zachowania poleceń.

Parametry
command String : Polecenie powłoki ADB do uruchomienia

receiver IShellOutputReceiver : IShellOutputReceiver do bezpośredniego wyjścia powłoki do.

maxTimeoutForCommand long : maksymalny limit czasu, w którym polecenie może się ukończyć; jednostka określona w timeUnit

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

timeUnit TimeUnit : Jednostka dla maxTimeToOutputShellResponse

retryAttempts int : Maksymalna liczba razy do ponownego ponownego wypowiedzi polecenia, jeśli zawiedzie z powodu wyjątku. DeviceNotRespentiveException zostanie wyrzucone, jeśli ponowne retryAttempts zostanie wykonywane.

Rzuca
DeviceNotAvailableException

ExecuteShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Wykonuje podane polecenie ADB Shell, ponosząc wiele razy, jeśli polecenie się nie powiedzie.

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

Parametry
command String : Polecenie powłoki ADB do uruchomienia

receiver IShellOutputReceiver : IShellOutputReceiver do bezpośredniego wyjścia powłoki do.

Rzuca
DeviceNotAvailableException

ExecuteShellv2Command

public CommandResult executeShellV2Command (String cmd)

Metoda pomocnicza, która wykonuje polecenie powłoki ADB i zwraca wyniki jako CommandResult odpowiednio zaludnione z wyjściem stanu polecenia, StDout i Stderr.

Parametry
cmd String : Polecenie, które powinno być uruchomione.

Zwroty
CommandResult Wynik CommandResult .

Rzuca
DeviceNotAvailableException

ExecuteShellv2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Metoda pomocnicza, która wykonuje polecenie powłoki ADB i zwraca wyniki jako CommandResult odpowiednio zaludnione z wyjściem stanu polecenia i STDDERR. StDout jest skierowany do określonego strumienia.

Parametry
cmd String : Polecenie, które powinno być uruchomione.

pipeToOutput OutputStream : ERROR(/OutputStream) , gdzie wyjście STD zostanie przekierowane lub zerowe.

Zwroty
CommandResult Wynik CommandResult .

Rzuca
DeviceNotAvailableException

ExecuteShellv2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Metoda pomocnicza, która wykonuje polecenie ADB Shell i zwraca wyniki jako CommandResult odpowiednio zaludnione z wyjściem stanu polecenia, stdout i stderr.

Parametry
cmd String : Polecenie, które powinno być uruchomione.

pipeAsInput File : ERROR(/File) , który będzie rurowy jako wejście do polecenia lub null.

Zwroty
CommandResult Wynik CommandResult .

Rzuca
DeviceNotAvailableException

ExecuteShellv2Command

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

Wykonuje polecenie ADB Shell, z większą liczbą parametrów do kontrolowania zachowania poleceń.

Parametry
cmd String : Polecenie powłoki ADB do uruchomienia

maxTimeoutForCommand long : maksymalny limit czasu, w którym polecenie może się ukończyć; jednostka określona w timeUnit

timeUnit TimeUnit : Jednostka dla maxTimeToOutputShellResponse

retryAttempts int : Maksymalna liczba razy do ponownego ponownego wypowiedzi polecenia, jeśli zawiedzie z powodu wyjątku. DeviceNotRespentiveException zostanie wyrzucone, jeśli ponowne retryAttempts zostanie wykonywane.

Zwroty
CommandResult

Rzuca
DeviceNotAvailableException

ExecuteShellv2Command

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

Wykonuje polecenie ADB Shell, z większą liczbą parametrów do kontrolowania zachowania poleceń.

Parametry
cmd String : Polecenie powłoki ADB do uruchomienia

maxTimeoutForCommand long : maksymalny limit czasu, w którym polecenie może się ukończyć; jednostka określona w timeUnit

timeUnit TimeUnit : Jednostka dla maxTimeToOutputShellResponse

Zwroty
CommandResult

Rzuca
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 do kontrolowania zachowania poleceń.

Parametry
cmd String : Polecenie powłoki ADB do uruchomienia

pipeAsInput File : ERROR(/File) , który będzie rurowy jako wejście do polecenia lub null.

pipeToOutput OutputStream : ERROR(/OutputStream) , gdzie wyjście STD zostanie przekierowane lub zerowe.

maxTimeoutForCommand long : maksymalny limit czasu, w którym polecenie może się ukończyć; jednostka określona w timeUnit

timeUnit TimeUnit : Jednostka dla maxTimeToOutputShellResponse

retryAttempts int : Maksymalna liczba razy do ponownego ponownego wypowiedzi polecenia, jeśli zawiedzie z powodu wyjątku. DeviceNotRespentiveException zostanie wyrzucone, jeśli ponowne retryAttempts zostanie wykonywane.

Zwroty
CommandResult

Rzuca
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 do kontrolowania zachowania poleceń.

Parametry
cmd String : Polecenie powłoki ADB do uruchomienia

pipeAsInput File : ERROR(/File) , który będzie rurowy jako wejście do polecenia lub null.

pipeToOutput OutputStream : ERROR(/OutputStream) , gdzie wyjście STD zostanie przekierowane lub zerowe.

pipeToError OutputStream : ERROR(/OutputStream) , gdzie błąd STD zostanie przekierowany lub zerowy.

maxTimeoutForCommand long : maksymalny limit czasu, w którym polecenie może się ukończyć; jednostka określona w timeUnit

timeUnit TimeUnit : Jednostka dla maxTimeToOutputShellResponse

retryAttempts int : Maksymalna liczba razy do ponownego ponownego wypowiedzi polecenia, jeśli zawiedzie z powodu wyjątku. DeviceNotRespentiveException zostanie wyrzucone, jeśli ponowne retryAttempts zostanie wykonywane.

Zwroty
CommandResult

Rzuca
DeviceNotAvailableException

FastbootwipEpartition

public CommandResult fastbootWipePartition (String partition)

Metoda pomocnicza, która usuwa partycję urządzenia.

Jeśli getUseFastbootErase() jest true , do wycierania partycji zostanie użyte Fastboot Erase. Urządzenie musi następnie utworzyć system plików następnym razem, gdy urządzenie. W przeciwnym razie używany jest format Fastboot, który utworzy nowy system plików na urządzeniu.

Oczekiwano, że będzie używany, gdy urządzenie jest już w trybie Fastboot.

Parametry
partition String : partycja do wycierania

Zwroty
CommandResult CommandResult zawierający dane wyjściowe poleceń

Rzuca
DeviceNotAvailableException

getactiveapexes

public  getActiveApexes ()

Pobierz informacje o wierzchołkach aktywowanych na urządzeniu.

Zwroty
ERROR(/Set) ApexInfo obecnie aktywowany na urządzeniu

Rzuca
DeviceNotAvailableException

getallSettings

public  getAllSettings (String namespace)

Zwracaj pary wartości kluczowych żądanych przestrzeni nazw.

Parametry
namespace String : Musi być jednym z {„system”, „bezpieczny”, „globalny”}

Zwroty
Mapa par kluczowych. NULL Jeśli przestrzeń nazw nie jest obsługiwana.

Rzuca
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

Zwróć obecny stan alokacji urządzenia

Zwroty
DeviceAllocationState

getandroidid

public String getAndroidId (int userId)

Znajdź i zwróć android-ID powiązane z użytkownikiem, null, jeśli nie znaleziono.

Parametry
userId int

Zwroty
String

Rzuca
DeviceNotAvailableException

GetAndroidids

public  getAndroidIds ()

Utwórz mapę identyfikatorów Androida znalezionych pasujących identyfikatorów użytkowników. Nie ma ubezpieczenia, że ​​każdy identyfikator użytkownika znalazł identyfikator Androida powiązany w tej funkcji, więc niektóre identyfikatory użytkowników mogą pasować do NULL.

Zwroty
Mapa identyfikatorów Androida znalazła pasujące identyfikatory użytkowników.

Rzuca
DeviceNotAvailableException

Getapilevel

public int getApiLevel ()

Uzyskaj poziom interfejsu API urządzenia. Domyślnie do UNKNOWN_API_LEVEL .

Zwroty
int liczba całkowita wskazująca poziom API urządzenia

Rzuca
DeviceNotAvailableException

GetAppPackageinfo

public PackageInfo getAppPackageInfo (String packageName)

Pobierz informacje o pakiecie zainstalowanym na urządzeniu.

Parametry
packageName String

Zwroty
PackageInfo PackageInfo lub null , jeśli nie można go było odzyskać

Rzuca
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Pobierz informacje o pakietach zainstalowanych na urządzeniu.

Zwroty
ERROR(/List) PackageInfo Instalowane na urządzeniu.

Rzuca
DeviceNotAvailableException

getBaseBandVersion

public String getBasebandVersion ()

Metoda wygody otrzymywania pasma podstawowego (radiowego) wersji tego urządzenia. Uzyskanie wersji radiowej jest specyficzne dla urządzenia, więc może nie zwrócić prawidłowych informacji dla wszystkich urządzeń. Ta metoda opiera się na GSM.Version.baseBand Propery, aby zwrócić prawidłowe informacje o wersji. Nie jest to dokładne dla niektórych urządzeń CDMA, a powrót wersji może nie pasować do wersji zgłoszonej z Fastboot i może nie zwracać wersji dla radia CDMA. TL; DR Ta metoda zgłasza dokładną wersję, jeśli właściwość gsm.version.baseBand jest taka sama jak wersja zwrócona przez fastboot getvar version-baseband .

Zwroty
String String BaseAband Wersja lub null , jeśli nie można go ustalić (urządzenie nie można odczytać Radio ani wersji)

Rzuca
DeviceNotAvailableException

GetBattery

public Integer getBattery ()

Zwraca obecny poziom baterii urządzenia lub zerowy, jeśli poziom baterii jest niedostępny.

Zwroty
Integer

GetBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

Parametry
name String : nazwa właściwości

defaultValue boolean : Wartość domyślna do zwrócenia, jeśli właściwość jest pusta lub nie istnieje.

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

Rzuca
DeviceNotAvailableException

Getboothistory

public  getBootHistory ()

Metoda pomocnika zbiera mapę historii rozruchu z czasem rozruchu i rozumem.

Zwroty
Mapa czasu rozruchu (czas UTC na sekundę od epoki) i rozum rozruchowy

Rzuca
DeviceNotAvailableException

GetboothistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Metoda pomocnika zbiera mapę historii rozruchu z czasem rozruchu i rozruchu, ponieważ dany czas od epoki z urządzenia i określono jednostkę czasu. Obecne urządzenie Utcepsime w milisekundach można uzyskać metodą getDeviceDate() .

Parametry
utcEpochTime long : czas urządzenia od epoki.

timeUnit TimeUnit : Time Unit TimeUnit .

Zwroty
Mapa czasu rozruchu (czas UTC na sekundę od epoki) i rozum rozruchowy

Rzuca
DeviceNotAvailableException

getbootloaderversion

public String getBootloaderVersion ()

Metoda wygody, aby uzyskać wersję Bootloader tego urządzenia.

Spróbuje pobrać wersję Bootloader z bieżącego stanu urządzenia. (IE Jeśli urządzenie jest w trybie Fastboot, będzie próbowało odzyskać wersję z Fastboot)

Zwroty
String String Bootloader wersja lub null , jeśli nie można go znaleźć

Rzuca
DeviceNotAvailableException

GetBugreport

public InputStreamSource getBugreport ()

Pobiera raport z urządzenia.

Wdrożenie tego gwarantuje, że będzie kontynuować pracę na urządzeniu bez karty SD (lub gdzie SDCard nie jest jeszcze zamontowany).

Zwroty
InputStreamSource InputStreamSource , który wytworzy zawartość Bugreport na żądanie. W przypadku awarii InputStreamSource wytworzy pusty ERROR(/InputStream) .

GetBugreportz

public InputStreamSource getBugreportz ()

Pobiera Bugreportz z urządzenia. Zip Format Bugreport zawiera główny raport Bugreport i inne pliki dziennika, które są przydatne do debugowania.

Obsługiwane tylko dla „wersji ADB”> 1.0.36

Zwroty
InputStreamSource InputStreamSource pliku ZIP zawierającego BugReportz, zwróć NULL w przypadku awarii.

getBuildalias

public String getBuildAlias ()

Odzyskaj alias kompilacji, którą obecnie działa urządzenie.

Alias ​​kompilacji jest zwykle bardziej czytelnym ciągiem niż identyfikator kompilacji (zazwyczaj liczba dla kompilacji Nexus). Na przykład ostateczna wersja Android 4.2 ma alias JDQ39 i kompilację ID 573038

Zwroty
String kompilacja alias lub spadek do budowania identyfikatora, jeśli nie można go odzyskać

Rzuca
DeviceNotAvailableException

GetBuildflavor

public String getBuildFlavor ()

Odzyskaj smak kompilacji urządzenia.

Zwroty
String Smak lub null, jeśli nie można go odzyskać

Rzuca
DeviceNotAvailableException

GetBuildid

public String getBuildId ()

Odzyskaj kompilację, który obecnie działa.

Zwroty
String Identyfikator kompilacji lub IBuildInfo#UNKNOWN_BUILD_ID jeśli nie można go odzyskać

Rzuca
DeviceNotAvailableException

GetBuildsigningKeys

public String getBuildSigningKeys ()

Zwraca typ klucza używany do podpisywania obrazu urządzenia

Zazwyczaj urządzenia z Androidem mogą być podpisywane z Key Test (jak w AOSP) lub keys (kontrolowane przez poszczególnych producentów urządzeń)

Zwroty
String Klucz podpisania, jeśli zostanie znaleziony, inaczej null.

Rzuca
DeviceNotAvailableException

getCachedDeviceDeScriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Zwraca buforowany DeviceDescriptor Jeśli urządzenie jest przydzielone, w przeciwnym razie zwraca bieżący DeviceDescriptor .

Zwroty
DeviceDescriptor

getCachedDeviceDeScriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Zwraca buforowany DeviceDescriptor Jeśli urządzenie jest przydzielone, w przeciwnym razie zwraca bieżący DeviceDescriptor .

Parametry
shortDescriptor boolean : czy ograniczyć deskryptor do absolutnych minimalnych informacji

Zwroty
DeviceDescriptor

zdobądź dzieci

public String[] getChildren (String path)

Alternatywa dla korzystania IFileEntry , która czasami nie będzie działać z powodu uprawnień.

Parametry
path String : jest ścieżką na urządzeniu, gdzie wyszukiwać

Zwroty
String[] Tablica ciągu zawierająca cały plik na ścieżce na urządzeniu.

Rzuca
DeviceNotAvailableException

GetConnection

public AbstractConnection getConnection ()

Bieżące połączenie związane z urządzeniem.

Zwroty
AbstractConnection

GetCurrentFoldablestate

public DeviceFoldableState getCurrentFoldableState ()

Zwraca obecny składany stan urządzenia lub zerowy, jeśli wystąpiły pewne problemy.

Zwroty
DeviceFoldableState

Rzuca
DeviceNotAvailableException

pobierz bieżącego użytkownika

public int getCurrentUser ()

Zwróć identyfikator bieżącego uruchomionego użytkownika. W przypadku błędu zwrot -10000.

Zwroty
int

Rzuca
DeviceNotAvailableException

GetDeviceClass

public String getDeviceClass ()

Zdobądź klasę urządzenia.

Zwroty
String klasa urządzenia String .

getdevicedate

public long getDeviceDate ()

Zwróć datę urządzenia w milisekundach od epoki.

Zwroty
long Data urządzenia w formacie epoki.

Rzuca
DeviceNotAvailableException

getDevicedescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

Zwroty
DeviceDescriptor

getDevicedescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

Parametry
shortDescriptor boolean : czy ograniczyć deskryptor do absolutnych minimalnych informacji

Zwroty
DeviceDescriptor

getdevicestate

public TestDeviceState getDeviceState ()

Zdobądź stan urządzenia.

Zwroty
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Pomocnik, aby uzyskać różnicę czasu między urządzeniem a danym ERROR(/Date) . Używaj czasu EPOCH wewnętrznie.

Parametry
date Date

Zwroty
long Różnica w milisekundach

Rzuca
DeviceNotAvailableException

getEmulatoroutput

public InputStreamSource getEmulatorOutput ()

Zdobądź strumień emulatora stdout i stderr

Zwroty
InputStreamSource Wyjście emulatora

getEmulatorProcess

public Process getEmulatorProcess ()

Zwróć Process odpowiadający temu emulatorowi.

Zwroty
Process Process lub null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Dziennik zawierający wszystkie dzienniki executeShellCommand(String) .

Zwroty
File

getExternalStorefreespace

public long getExternalStoreFreeSpace ()

Metoda pomocnicza do określenia ilości wolnej przestrzeni na zewnętrznym miejscu urządzenia.

Zwroty
long ilość wolnej przestrzeni w KB

Rzuca
DeviceNotAvailableException

Getfastbootpath

public String getFastbootPath ()

Zwraca ścieżkę używanego binarnego fastboot. Nadal wymaga isFastbootEnabled() , aby być prawdą, aby włączyć funkcje fastboot.

Zwroty
String

GetFastbootProductType

public String getFastbootProductType ()

Metoda wygody, aby uzyskać rodzaj produktu tego urządzenia, gdy jest w trybie Fastboot.

Ta metoda powinna być używana tylko wtedy, gdy urządzenie powinno znajdować się w Fastboot. Jest to nieco bezpieczniejszy wariant niż ogólna metoda getProductType() w tym przypadku, ponieważ ItestDevice będzie wiedziała, że ​​odzyska urządzenie do fastboot, jeśli urządzenie jest w niepoprawnym stanie lub nie reaguje.

Zwroty
String Nazwa typu String lub null , jeśli nie można go określić

Rzuca
DeviceNotAvailableException

GetFastbootProductVariant

public String getFastbootProductVariant ()

Metoda wygody, aby uzyskać rodzaj produktu tego urządzenia, gdy jest w trybie Fastboot.

Ta metoda powinna być używana tylko wtedy, gdy urządzenie powinno znajdować się w Fastboot. Jest to nieco bezpieczniejszy wariant niż ogólna metoda getProductType() w tym przypadku, ponieważ ItestDevice będzie wiedziała, że ​​odzyska urządzenie do fastboot, jeśli urządzenie jest w niepoprawnym stanie lub nie reaguje.

Zwroty
String Nazwa typu String lub null , jeśli nie można go określić

Rzuca
DeviceNotAvailableException

GetFastbootserialNumber

public String getFastbootSerialNumber ()

Zwraca numer seryjny trybu Fastboot.

Zwroty
String

GetFastbootVariable

public String getFastbootVariable (String variableName)

Odzyskaj podaną wartość zmiennej Fastboot z urządzenia.

Parametry
variableName String : nazwa zmiennej

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

Rzuca
DeviceNotAvailableException

GetFastbootversion

public String getFastbootVersion ()

Zwraca ciąg wersji używanego binarnego binarnego. Lub null, jeśli coś pójdzie nie tak.

Zwroty
String

GetfileEntry

public IFileEntry getFileEntry (String path)

Odzyskaj odniesienie do zdalnego pliku na urządzeniu.

Parametry
path String : Ścieżka pliku do odzyskania. Może być bezwzględną ścieżką lub ścieżką względem „/”. (tj. Zarówno podtrzymuje się składnia „/system”, jak i „system”)

Zwroty
IFileEntry nie można znaleźć pliku IFileEntry lub null , jeśli plik na danej path

Rzuca
DeviceNotAvailableException

GetfileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Nieoficjalny pomocnik, aby uzyskać FileEntry z ścieżki nie-root. FixMe: Refaktor System FileEntry, aby był dostępny na dowolnej ścieżce. (nawet nie root).

Parametry
entry FileListingService.FileEntry : FileEntry niekoniecznie root, jak wymaga DDMLIB.

Zwroty
IFileEntry FileEntryWrapper reprezentujący FileEntry.

Rzuca
com.android.tradefed.device.deviceNotavailableException
DeviceNotAvailableException

Get FoldableStates

public  getFoldableStates ()

Zwraca listę składanych stanów na urządzeniu. Można uzyskać za pomocą „CMD Device_State Print States”.

Zwroty

Rzuca
DeviceNotAvailableException

getidevice

public IDevice getIDevice ()

Zwraca odniesienie do powiązanego DDMLIB IDevice .

Nowe IDevice może być przydzielane przez DDM za każdym razem, gdy urządzenie odłącza się i łączy od ADB. Zatem dzwoniący nie powinni prowadzić odniesienia do IDevice , ponieważ odniesienie to może stać się przestarzałe.

Zwroty
IDevice IDevice

GetInstalledPackagenames

public  getInstalledPackageNames ()

Pobierz nazwy pakietów aplikacji obecne na urządzeniu.

Zwroty
ERROR(/Set) nazw pakietów String aktualnie zainstalowanych na urządzeniu.

Rzuca
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 właściwości

defaultValue long : Wartość domyślna do zwrócenia, jeśli właściwość jest pusta lub nie istnieje.

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

Rzuca
DeviceNotAvailableException

Getipaddress

public String getIpAddress ()

Pobiera adres IP urządzenia.

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

Rzuca
DeviceNotAvailableException

GetKeyguardState

public KeyguardControllerState getKeyguardState ()

Zwróć obiekt, aby uzyskać bieżący stan Keyguard lub Null, jeśli nie jest to obsługiwane.

Zwroty
KeyguardControllerState KeyguardControllerState zawierający migawkę stanu Keyguard i zwraca Null, jeśli zapytanie Keyguard nie jest obsługiwane.

Rzuca
DeviceNotAvailableException

getLastexpecedReboottimemillis

public long getLastExpectedRebootTimeMillis ()

Zwraca ostatnim razem, gdy API handlowe wywołały ponowne uruchomienie w milisekundach od czasu epoków, zgodnie z System.currentTimeMillis() .

Zwroty
long

GetLaunchapilevel

public int getLaunchApiLevel ()

Uzyskaj pierwszy uruchomiony poziom API urządzenia. Domyślnie do UNKNOWN_API_LEVEL .

Zwroty
int liczba całkowita wskazująca pierwszy uruchomiony poziom urządzenia API

Rzuca
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Pobiera strumień migawki danych logCAT.

Działa w dwóch trybach:

  • Jeśli logcat jest obecnie przechwytywany w tle, powróci do TestDeviceOptions.getMaxLogcatDataSize() bajty bieżącej zawartości przechwytywania logowania tła
  • W przeciwnym razie zwróci statyczny zrzut danych logCAT, jeśli urządzenie obecnie odpowiada

    Zwroty
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

    Pobiera strumień migawki ostatnich maxBytes danych logcat.

    Przydatne w przypadkach, gdy chcesz przechwycić częste migawki przechwyconych danych logcat bez ponoszenia potencjalnie dużej kary w przestrzeni dysku za uzyskanie całej migawki getLogcat() .

    Parametry
    maxBytes int : Maksymalna ilość danych do zwrócenia. Powinna być ilością, która może wygodnie pasować do pamięci

    Zwroty
    InputStreamSource

    GetLogcatdump

    public InputStreamSource getLogcatDump ()

    Zdobądź zrzut bieżącego logcatu dla urządzenia. W przeciwieństwie do getLogcat() , ta metoda zawsze zwraca statyczny zrzut logcata.

    Ma wadę, że nic nie zostanie zwrócone, jeśli urządzenie nie jest możliwe do osiągnięcia.

    Zwroty
    InputStreamSource InputStreamSource danych logCat. Pusty strumień jest zwracany, jeśli nie przechwytuje danych logCAT.

    GetLogcatsince

    public InputStreamSource getLogcatSince (long date)

    Pobiera strumień migawek przechwyconych danych logCAT, począwszy od podanej daty. Czas na urządzeniu powinien być używany getDeviceDate() .

    Parametry
    date long : w milisekundach od formatu epoki, kiedy rozpocząć migawkę do chwili obecnej. (Można uzyskać za pomocą „Data +%s”)

    Zwroty
    InputStreamSource

    GetMacaddress

    public String getMacAddress ()

    Zwraca adres MAC urządzenia, NULL, jeśli nie będzie zapytać z urządzenia.

    Zwroty
    String

    GetMainuserid

    public Integer getMainUserId ()

    Zwraca główny identyfikator użytkownika.

    Zwroty
    Integer Userid głównego użytkownika, jeśli taki jest, i NULL, jeśli nie ma głównego użytkownika.

    Rzuca
    DeviceNotAvailableException

    getMainlinemoduleInfo

    public  getMainlineModuleInfo ()

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

    Zwroty
    ERROR(/Set) modułów głównych String aktualnie zainstalowanych na urządzeniu.

    Rzuca
    DeviceNotAvailableException

    GetMaxNumberOfRunningUsersSSSSUPPORTE

    public int getMaxNumberOfRunningUsersSupported ()

    Uzyskaj maksymalną liczbę obsługiwanych jednocześnie uruchamiających użytkowników. Wartość domyślna to 0.

    Zwroty
    int liczba całkowita wskazująca liczbę jednocześnie uruchomionych użytkowników

    Rzuca
    DeviceNotAvailableException

    GetMaxNumberOfUsersSSSPORTED

    public int getMaxNumberOfUsersSupported ()

    Uzyskaj maksymalną liczbę obsługiwanych użytkowników. Wartość domyślna to 0.

    Zwroty
    int liczba całkowita wskazująca liczbę obsługiwanych użytkowników

    Rzuca
    DeviceNotAvailableException

    GetMicrodroidProcess

    public Process getMicrodroidProcess ()

    Zwroty
    Process Zwraca proces VM Microdroid. Jeśli TestDevice nie jest mikrodroidem, zwraca Null.

    GetMonitor

    public IDeviceStateMonitor getMonitor ()

    Zwróć IDeviceStateMonitor powiązany z urządzeniem.

    Zwroty
    IDeviceStateMonitor

    GetMountpoint

    public String getMountPoint (String mountName)

    Zwraca punkt mocowania.

    Zapytają urządzenie bezpośrednio, jeśli buforowane informacje w IDevice nie są dostępne.

    TODO: przenieś to zachowanie do IDevice#getMountPoint(String)

    Parametry
    mountName String : Nazwa punktu montażu

    Zwroty
    String punkt montażowy lub null

    GetMountpointinfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Zwraca MountPointInfo odpowiadające określonej ścieżce Mountpoint lub null , jeśli ta ścieżka ma nic nie zamontowanego lub w inny sposób nie pojawia się w /Proc /Mounts jako punkt MountPoint.

    Parametry
    mountpoint String

    Zwroty
    ITestDevice.MountPointInfo ERROR(/List) MountPointInfo zawierający informacje w „/Proc/Mounts”

    Rzuca
    DeviceNotAvailableException

    GetMountpointinfo

    public  getMountPointInfo ()

    Zwraca przeanalizowaną wersję informacji w /proc /mocowania na urządzeniu

    Zwroty
    ERROR(/List) MountPointInfo zawierający informacje w „/Proc/Mounts”

    Rzuca
    DeviceNotAvailableException

    getoptions

    public TestDeviceOptions getOptions ()

    Pobierz opcje testowe urządzenia.

    Zwroty
    TestDeviceOptions TestDeviceOptions związane z badanym urządzeniem.

    GetPartitionFreespace

    public long getPartitionFreeSpace (String partition)

    Metoda pomocnicza do określenia ilości wolnej przestrzeni na partycji urządzeń.

    Parametry
    partition String

    Zwroty
    long ilość wolnej przestrzeni w KB

    Rzuca
    DeviceNotAvailableException

    GetPrimaryuserid

    public Integer getPrimaryUserId ()

    Zwraca podstawowy identyfikator użytkownika.

    Zwroty
    Integer Użytkownik głównego użytkownika, jeśli taki jest, i NULL, jeśli nie ma głównego użytkownika.

    Rzuca
    DeviceNotAvailableException

    GetProcessbyName

    public ProcessInfo getProcessByName (String processName)

    Metoda pomocnika uruchamia polecenie „PIDOF” i „STAT” i zwraca obiekt ProcessInfo z PID i czas rozpoczęcia procesu danego procesu.

    Parametry
    processName String : String nazwy Procesa.

    Zwroty
    ProcessInfo ProcessInfo danej nazwy procesów

    Rzuca
    DeviceNotAvailableException

    getProcesSpid

    public String getProcessPid (String process)

    Zwraca PID usługi lub NULL, jeśli coś poszło nie tak.

    Parametry
    process String : String nazwy Procesa.

    Zwroty
    String

    Rzuca
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

    Metoda wygody, aby uzyskać rodzaj produktu tego urządzenia.

    Ta metoda będzie działać, jeśli urządzenie znajduje się w trybie ADB lub Fastboot.

    Zwroty
    String Nazwa typu produktu String . Nie będzie null

    Rzuca
    DeviceNotAvailableException

    GetProductVariant

    public String getProductVariant ()

    Metoda wygody w celu uzyskania wariantu produktu tego urządzenia.

    Ta metoda będzie działać, jeśli urządzenie znajduje się w trybie ADB lub Fastboot.

    Zwroty
    String Nazwa String produktu lub null , jeśli nie można go określić

    Rzuca
    DeviceNotAvailableException

    pobierzWłaściwość

    public String getProperty (String name)

    Odzyskać daną wartość właściwości z urządzenia.

    Parametry
    name String : nazwa właściwości

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

    Rzuca
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

    Uzyskaj obecny tryb odzyskiwania używany dla urządzenia.

    Zwroty
    ITestDevice.RecoveryMode Obecny tryb odzyskiwania używany dla urządzenia.

    pobierz zrzut ekranu

    public InputStreamSource getScreenshot (String format)

    Chwyta zrzut ekranu z urządzenia. Zalecane do użycia getscreenshot (format) zamiast kodowania JPEG dla mniejszych rozmiarów

    Parametry
    format String : obsługiwany PNG, JPEG

    Zwroty
    InputStreamSource InputStreamSource zrzutu zrzutowego w formacie lub null , jeśli zrzut ekranu nie był powodzeniem.

    Rzuca
    DeviceNotAvailableException

    pobierz zrzut ekranu

    public InputStreamSource getScreenshot (long displayId)

    Chwyta zrzut ekranu z urządzenia podanego identyfikatora wyświetlania. Format to PNG.

    TODO: Rozszerz powyższe wdrożenia, aby obsługiwać „format” i „przeskok”

    Parametry
    displayId long : identyfikator wyświetlania ekranu, z którego można uzyskać zrzut ekranu.

    Zwroty
    InputStreamSource InputStreamSource zrzutu zrzutowego w formacie lub null , jeśli zrzut ekranu nie był powodzeniem.

    Rzuca
    DeviceNotAvailableException

    pobierz zrzut ekranu

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    Chwyta zrzut ekranu z urządzenia. Zaleca się użycie getScreenshot(String) zamiast kodowania JPEG dla mniejszego rozmiaru.

    Parametry
    format String : obsługiwany PNG, JPEG

    rescale boolean : Jeśli zrzut ekranu powinien zostać przeskalowany w celu zmniejszenia wielkości powstałego obrazu

    Zwroty
    InputStreamSource InputStreamSource zrzutu zrzutowego w formacie lub null , jeśli zrzut ekranu nie był powodzeniem.

    Rzuca
    DeviceNotAvailableException

    pobierz zrzut ekranu

    public InputStreamSource getScreenshot ()

    Chwyta zrzut ekranu z urządzenia.

    Zwroty
    InputStreamSource InputStreamSource zrzutu ekranu w formacie PNG, lub null jeśli zrzut ekranu nie był skuteczny.

    Rzuca
    DeviceNotAvailableException

    GetSerialNumber

    public String getSerialNumber ()

    Metoda wygody uzyskania numeru seryjnego tego urządzenia.

    Zwroty
    String String Numer seryjny

    Getsetting

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

    Zwróć wartość żądanego ustawienia. Przestrzeń nazw musi być jednym z: {„system”, „bezpieczny”, „globalny”}

    Parametry
    userId int

    namespace String

    key String

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

    Rzuca
    DeviceNotAvailableException

    Getsetting

    public String getSetting (String namespace, 
                    String key)

    Zobacz getSetting(int, String, String) i wykonany na użytkowniku systemu.

    Parametry
    namespace String

    key String

    Zwroty
    String

    Rzuca
    DeviceNotAvailableException

    getSimoperator

    public String getSimOperator ()

    Zwróć operator karty SIM lub NULL, jeśli nie jest dostępny lub jeśli urządzenie nie jest dostępne.

    Zwroty
    String

    GetimState

    public String getSimState ()

    Zwróć stan karty SIM lub null, jeśli nie jest dostępne lub urządzenie nie jest dostępne.

    Zwroty
    String

    GetTombstones

    public  getTombstones ()

    Przyprzyj i zwróć listę nagrobków z urządzeń. Wymaga roota.

    Metoda jest najlepsza, więc jeśli jeden nagrobek nie zostanie wyciągnięty z jakiegokolwiek powodu, którego brakuje na liście. Tylko DeviceNotAvailableException wcześniej zakończy metodę.

    Zwroty
    Lista plików nagrobka, pusta, jeśli nie ma nagrobka.

    Rzuca
    DeviceNotAvailableException

    gettotalmemory

    public long getTotalMemory ()

    Zwraca całkowity rozmiar pamięci fizycznej w bajtach lub -1 w przypadku błędu wewnętrznego

    Zwroty
    long

    GetUninstallablePackageNames

    public  getUninstallablePackageNames ()

    Przyprzyj nazwom pakietów aplikacji, które można odinstalować. Jest to obecnie definiowane jako pakiety inne niż systemy i zaktualizowane pakiety systemowe.

    Zwroty
    ERROR(/Set) niezaznażenia nazw opakowań String aktualnie zainstalowanych na urządzeniu.

    Rzuca
    DeviceNotAvailableException

    GetuseSfastbooterase

    public boolean getUseFastbootErase ()

    Uzyskaj, czy użyć Fastboot Erase, czy Fastboot Format, aby wytrzeć partycję na urządzeniu.

    Zwroty
    boolean true , jeśli zostanie użyte usuwanie fastboot lub false , jeśli zostanie użyty format fastboot.

    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

    Zwroty
    int Flagi powiązane z UserID dostarczone, jeśli zostaną znalezione, -10000 w jakichkolwiek innych przypadkach.

    Rzuca
    DeviceNotAvailableException

    getuserinfos

    public  getUserInfos ()

    Pobiera mapę użytkowania do UserInfo na urządzeniu. Wyrzuci DeviceRuntimeException , jeśli wyjście z urządzenia nie jest zgodne z oczekiwaniami.

    Zwroty
    Lista obiektów UserInfo.

    Rzuca
    DeviceNotAvailableException

    GetuserSerialNumber

    public int getUserSerialNumber (int userId)

    Zwróć numer seryjny powiązany do użytkownika, jeśli zostanie znaleziony -10000 w jakichkolwiek innych przypadkach.

    Parametry
    userId int

    Zwroty
    int

    Rzuca
    DeviceNotAvailableException

    HandleallocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Przetworzyć podany deviceEvent. Może przejść urządzenie do nowego stanu. Poinformuje IDeviceMonitor o dowolnych przejściach państwowych.

    Przetwarzaj DeviceEvent, który może, ale nie musi przejść tego urządzenia do nowego stanu alokacji.

    Parametry
    event DeviceEvent

    Zwroty
    IManagedTestDevice.DeviceEventResponse

    Hasfeature

    public boolean hasFeature (String feature)

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

    Parametry
    feature String : Który format powinien być „Funkcja: " Lub " „bezpośrednio.

    Zwroty
    boolean Prawda, jeśli zostanie znaleziona funkcja, w przeciwnym razie fałszywe.

    Rzuca
    DeviceNotAvailableException

    instalacja

    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 wykonać ponowną instalację

    extraArgs String : Opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdują się w „ADB Shell PM -H”.

    Zwroty
    String String z kodem błędu lub null , jeśli sukces.

    Rzuca
    DeviceNotAvailableException

    instalacja

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

    Zainstaluj pakiet Androida na urządzeniu.

    Uwaga: Tylko przypadki użycia, które wymagają wyraźnej kontroli przyznania uprawnień do wykonania w czasie instalacji, powinny wywołać tę funkcję.

    Parametry
    packageFile File : plik APK do zainstalowania

    reinstall boolean : true , jeśli należy wykonać ponowną instalację

    grantPermissions boolean : Jeśli wszystkie uprawnienia do wykonania powinny zostać przyznane w czasie instalacji

    extraArgs String : Opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdują się w „ADB Shell PM -H”.

    Zwroty
    String String z kodem błędu lub null , jeśli sukces.

    Rzuca
    DeviceNotAvailableException

    instaltPackageForuser

    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 wykonać ponowną instalację

    userId int : Identyfikator użytkownika Integer do zainstalowania.

    extraArgs String : Opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdują się w „ADB Shell PM -H”.

    Zwroty
    String String z kodem błędu lub null , jeśli sukces.

    Rzuca
    DeviceNotAvailableException

    instaltPackageForuser

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

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

    Uwaga: Tylko przypadki użycia, które wymagają wyraźnej kontroli przyznania uprawnień do wykonania w czasie instalacji, powinny wywołać tę funkcję.

    Parametry
    packageFile File : plik APK do zainstalowania

    reinstall boolean : true , jeśli należy wykonać ponowną instalację

    grantPermissions boolean : Jeśli wszystkie uprawnienia do wykonania powinny zostać przyznane w czasie instalacji

    userId int : Identyfikator użytkownika Integer do zainstalowania.

    extraArgs String : Opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdują się w „ADB Shell PM -H”.

    Zwroty
    String String z kodem błędu lub null , jeśli sukces.

    Rzuca
    DeviceNotAvailableException

    InvalidatePropertyCache

    public void invalidatePropertyCache ()

    Isadbroot

    public boolean isAdbRoot ()

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    ISADBTCP

    public boolean isAdbTcp ()

    Zwroty
    boolean

    Isappenumerations poparte

    public boolean isAppEnumerationSupported ()

    Sprawdź, czy platforma na urządzeniu obsługuje wyliczenie aplikacji

    Zwroty
    boolean Prawda Jeśli wyliczenie aplikacji jest obsługiwane, w przeciwnym razie Fałsz inaczej

    Rzuca
    DeviceNotAvailableException

    ISBYPASSLOWTARGETSDKBLOCKSUPPORTED

    public boolean isBypassLowTargetSdkBlockSupported ()

    Sprawdź, czy platforma na urządzeniu obsługuje omijanie niskiego docelowego bloku SDK w instalacjach aplikacji

    Zwroty
    boolean Prawda Jeśli obsługiwana jest pomostanie bloku SDK docelowego, Fałsz inaczej

    Rzuca
    DeviceNotAvailableException

    isdebugfsmounted

    public boolean isDebugfsMounted ()

    Sprawdź, czy debugfs jest zamontowany.

    Zwroty
    boolean true , że ​​debugfs jest zamontowany

    Rzuca
    DeviceNotAvailableException

    isdeviceEncrypted

    public boolean isDeviceEncrypted ()

    Zwraca, jeśli urządzenie jest zaszyfrowane.

    Zwroty
    boolean true , jeśli urządzenie jest zaszyfrowane.

    Rzuca
    DeviceNotAvailableException

    isdirectory

    public boolean isDirectory (String path)

    Zwróć true, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie Fałsz.

    Parametry
    path String

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    Isenableadbroot

    public boolean isEnableAdbRoot ()

    Zwroty
    boolean true , jeśli root ADB powinien być włączony na urządzeniu

    isEncryptionSupport

    public boolean isEncryptionSupported ()

    Zwraca, jeśli szyfrowanie jest obsługiwane na urządzeniu.

    Zwroty
    boolean true , jeśli urządzenie obsługuje szyfrowanie.

    Rzuca
    DeviceNotAvailableException

    jest wykonywalny

    public boolean isExecutable (String fullPath)

    Zwraca true, jeśli ścieżka pliku na urządzeniu jest plikiem wykonywalnym, w przeciwnym razie False.

    Parametry
    fullPath String

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    isfastbootenabled

    public boolean isFastbootEnabled ()

    Zwróć, jeśli fastboot jest dostępny dla urządzenia.

    Zwroty
    boolean

    Isheadless

    public boolean isHeadless ()

    Zwróć true, jeśli urządzenie jest bezgłowe (bez ekranu), w przeciwnym razie fałszywe.

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    isheadSsystemSermode

    public boolean isHeadlessSystemUserMode ()

    Zwraca, czy urządzenie używa trybu użytkownika systemu bezgłowego.

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    IsmainuserPerManentAdmin

    public boolean isMainUserPermanentAdmin ()

    Zwraca, czy głównym użytkownikiem jest stały administrator i nie można go usunąć ani obniżyć do statusu bez admin.

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    IsmultiuseSersed

    public boolean isMultiUserSupported ()

    Określa, czy obsługiwany jest wielu użytkowników.

    Zwroty
    boolean Prawda, jeśli obsługiwane jest wielu użytkowników, w przeciwnym razie Fałsz inaczej

    Rzuca
    DeviceNotAvailableException

    ISPACKAGEINSTALLED

    public boolean isPackageInstalled (String packageName, 
                    String userId)

    Zapytaj urządzenie pod kątem nazwy pakietu i podanego identyfikatora użytkownika, aby sprawdzić, czy jest on obecnie zainstalowany, czy nie dla tego użytkownika.

    Parametry
    packageName String : Pakiet, który sprawdzamy, czy jest zainstalowany.

    userId String : Identyfikator użytkownika, dla którego sprawdzamy pakiet, jest zainstalowany. Jeśli NULL, zostanie użyty zero podstawowego użytkownika.

    Zwroty
    boolean To prawda, że ​​pakiet jest zgłaszany jako zainstalowany. Fałsz inaczej.

    Rzuca
    DeviceNotAvailableException

    ISPACKAGEINSTALLED

    public boolean isPackageInstalled (String packageName)

    Zapytaj urządzenie pod daną nazwą pakietu, aby sprawdzić, czy jest on aktualnie zainstalowany, czy nie.

    Parametry
    packageName String

    Zwroty
    boolean To prawda, że ​​pakiet jest zgłaszany jako zainstalowany. Fałsz inaczej.

    Rzuca
    DeviceNotAvailableException

    IsruntimePermissionsionsed

    public boolean isRuntimePermissionSupported ()

    Sprawdź, czy platforma na urządzeniu obsługuje pozwolenie na wykonanie czasu wykonywania

    Zwroty
    boolean To prawda, że ​​uprawnienie czasu wykonawczego jest obsługiwane, w przeciwnym razie Fałsz.

    Rzuca
    DeviceNotAvailableException

    isStateBootloaderORORFastbootd

    public boolean isStateBootloaderOrFastbootd ()

    Zwraca prawdziwie, jeśli urządzenie jest w TestDeviceState#FASTBOOT lub TestDeviceState.FASTBOOTD .

    Zwroty
    boolean

    isuserrunning

    public boolean isUserRunning (int userId)

    Sprawdź, czy uruchomiony jest dany użytkownik.

    Parametry
    userId int

    Zwroty
    boolean To prawda, że ​​użytkownik działa, fałszywy w każdym innym przypadku.

    Rzuca
    DeviceNotAvailableException

    Isusersecondary

    public boolean isUserSecondary (int userId)

    Zwróć, czy określony użytkownik jest użytkownikiem wtórnym zgodnie z jego flagami.

    Parametry
    userId int

    Zwroty
    boolean To prawda, że ​​użytkownik jest drugorzędny, w przeciwnym razie fałsz.

    Rzuca
    DeviceNotAvailableException

    isuservivible

    public boolean isUserVisible (int userId)

    Sprawdź, czy dany użytkownik jest widoczny.

    „Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z użytkownikiem „ludzkim”, a zatem może uruchomić działania uruchamiające (zazwyczaj na domyślnym wyświetlaczu).

    Parametry
    userId int

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    IsUservisibleondisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

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

    „Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z użytkownikiem „ludzkim”, a zatem może uruchomić działania uruchamiające na tym wyświetlaczu.

    Parametry
    userId int

    displayId int

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    IsvisibleBackgroundUsSondefaultDisPlaysported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

    Zwraca, czy urządzenie pozwala użytkownikom być widocznym w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

    Jeśli tak, możesz zadzwonić do startVisibleBackgroundUser(int, int, boolean) , przekazanie wyświetlacza zwróconego przez listDisplayIdsForStartingVisibleBackgroundUsers() (który powinien zawierać ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    IsvisibleBackgroundUsersSsuse

    public boolean isVisibleBackgroundUsersSupported ()

    Zwraca, czy urządzenie pozwala użytkownikom być widocznym w tle.

    Jeśli tak, możesz zadzwonić do startVisibleBackgroundUser(int, int, boolean) , przekazując wyświetlacz zwrócony przez listDisplayIdsForStartingVisibleBackgroundUsers() .

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    Iswifienabled

    public boolean isWifiEnabled ()

    Test, jeśli WIFI jest włączone.

    Sprawdza, czy Wi -Fi jest włączone na urządzeniu. Przydatne do stwierdzenia statusu Wi -Fi przed testami, które nie powinny działać z Wi -Fi, np. Mobile Data Tests.

    Zwroty
    boolean true , jeśli WIFI jest włączone. false , jeśli wyłączony

    Rzuca
    DeviceNotAvailableException

    ListDisplayids

    public  listDisplayIds ()

    Zbierz listę dostępnych wyświetlaczy na urządzeniu, jak podano „DUMPSYS SurfaceFlinger”.

    Zwroty
    Lista wyświetlaczy. Domyślnie zawsze zwraca domyślny wyświetlacz 0.

    Rzuca
    DeviceNotAvailableException

    ListDisplayidsforStartingVisibleBackgroundusers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    Zwroty

    Rzuca
    DeviceNotAvailableException

    Listusers

    public  listUsers ()

    Pobiera listę użytkowników na urządzeniu. Wyrzuci DeviceRuntimeException , jeśli wyjście z urządzenia nie jest zgodne z oczekiwaniami.

    Zwroty
    Lista identyfikatorów użytkowników.

    Rzuca
    DeviceNotAvailableException

    Loganrs

    public boolean logAnrs (ITestLogger logger)

    Zbiera i rejestruje ANR z urządzenia.

    Parametry
    logger ITestLogger : ITestLogger do rejestrowania ANR.

    Zwroty
    boolean To prawda, że ​​jeśli rejestrowanie zakończyło się powodzeniem, w przeciwnym razie fałsz.

    Rzuca
    DeviceNotAvailableException

    Logbugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Metoda pomocnicza, aby wziąć raport błędu i zalogować go do reporterów.

    Parametry
    dataName String : Nazwa, pod którą raport Bugreport zostanie zgłoszony.

    listener ITestLogger : ITestLogger do rejestrowania raportu Bugreport.

    Zwroty
    boolean To prawda, że ​​jeśli rejestrowanie zakończyło się powodzeniem, w przeciwnym razie fałsz.

    logondevice

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

    Zaloguj komunikat w logucie urządzenia. Jest to bezpieczne połączenie, które nie rzuci się, nawet jeśli logowanie się nie powiedzie.

    Parametry
    tag String : Tag, pod którym rejestrujemy nasz komunikat w logCat.

    level Log.LogLevel : Poziom debugowania wiadomości w logCat.

    format String : Format wiadomości.

    args Object : Args, który ma zostać zastąpiony przez String.Format ().

    mountDebugfs

    public void mountDebugfs ()

    Mount DeBugfs.

    Rzuca
    DeviceNotAvailableException

    Non -BlockingReboot

    public void nonBlockingReboot ()

    Wydają polecenie ponownego uruchomienia urządzenia i zwraca na polecenie, a gdy urządzenie nie jest już widoczne dla ADB.

    Rzuca
    DeviceNotAvailableException

    PostAdbrootaction

    public void postAdbRootAction ()

    Zastąp, jeśli urządzenie potrzebuje określonych działań, które należy podjąć po korzeni ADB i zanim urządzenie wróci do Internetu. Domyślna implementacja nie obejmuje żadnych działań dodatkowych. Korzeń ADB nie gwarantuje włączenia na tym etapie.

    Rzuca
    com.android.tradefed.device.deviceNotavailableException
    DeviceNotAvailableException

    PostAdbunrootAction

    public void postAdbUnrootAction ()

    Zastąp, jeśli urządzenie potrzebuje określonych działań, które należy podjąć po ADB UNOROT i zanim urządzenie wróci do Internetu. Domyślna implementacja nie obejmuje żadnych dodatkowych działań. Na tym etapie nie gwarantuje, że root ADB nie jest wyłączony.

    Rzuca
    com.android.tradefed.device.deviceNotavailableException
    DeviceNotAvailableException

    Postbootstetup

    public void postBootSetup ()

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

    Należy wywołać po tym, jak urządzenie jest w pełni uruchomione/dostępne

    W normalnych okolicznościach ta metoda nie musi być nazywana jawnie, ponieważ implementacje powinny wykonywać te kroki automatycznie podczas wykonania ponownego uruchomienia.

    Tam, gdzie konieczne jest wywołanie, gdy urządzenie uruchom ponownie z powodu innych zdarzeń (np. Po zakończeniu polecenia aktualizacji Fastboot)

    Rzuca
    DeviceNotAvailableException

    PostinvocationTowndown

    public void postInvocationTearDown (Throwable exception)

    Dodatkowe kroki dla wymaganego oczyszczania dla urządzenia, które zostaną wykonane po zakończeniu.

    Parametry
    exception Throwable : Jeśli w ogóle, ostateczny wyjątek podniesiony przez awarię wywołania.

    PreinvocationsEtup

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

    Dodatkowe kroki dla wymaganej konfiguracji dla urządzenia, które zostaną wykonane na urządzeniu przed przepływem wywołania.

    Parametry
    info IBuildInfo : IBuildInfo urządzenia.

    attributes MultiMap : atrybuty przechowywane w kontekście inwokacji

    Rzuca
    DeviceNotAvailableException
    TargetSetupError

    pulldir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Rekurencyjnie ciągnij zawartość katalogu z urządzenia.

    Parametry
    deviceFilePath String : bezwzględna ścieżka pliku zdalnego źródła

    localDir File : lokalny katalog do pobrania plików

    Zwroty
    boolean true , że ​​plik został pomyślnie pobrany. inaczej false .

    Rzuca
    DeviceNotAvailableException

    Pullfile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Pobiera plik z urządzenia.

    Parametry
    remoteFilePath String : Bezwzględna ścieżka do pliku na urządzeniu.

    localFile File : Lokalny plik do przechowywania zawartości. Jeśli nie jest puste, zawartość zostanie zastąpiona.

    Zwroty
    boolean true , jeśli plik został pomyślnie pobrany. inaczej false .

    Rzuca
    DeviceNotAvailableException

    Pullfile

    public File pullFile (String remoteFilePath, 
                    int userId)

    Pobiera plik z urządzenia, przechowuje go w lokalnym ERROR(/File) i zwraca ten File .

    Parametry
    remoteFilePath String : Bezwzględna ścieżka do pliku na urządzeniu.

    userId int : identyfikator użytkownika, z którego można wyciągnąć

    Zwroty
    File ERROR(/File) zawierający zawartość pliku urządzenia lub null , jeśli kopia nie powiodła się z jakiegokolwiek powodu (w tym problemy z systemem plików hosta)

    Rzuca
    DeviceNotAvailableException

    Pullfile

    public File pullFile (String remoteFilePath)

    Pobiera plik z urządzenia, przechowuje go w lokalnym ERROR(/File) i zwraca ten File .

    Parametry
    remoteFilePath String : Bezwzględna ścieżka do pliku na urządzeniu.

    Zwroty
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Rzuca
    DeviceNotAvailableException

    pullFile

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

    Retrieves a file off device.

    Parametry
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    userId int : The user id to pull from

    Zwroty
    boolean true if file was retrieved successfully. inaczej false .

    Rzuca
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    Parametry
    remoteFilePath String : the absolute path to file on device.

    Zwroty
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Rzuca
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    Parametry
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    Zwroty
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Rzuca
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    Recursively push directory contents to device while excluding some directories that are filtered.

    Parametry
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    Zwroty
    boolean true if file was pushed successfully. inaczej false .

    Rzuca
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    Parametry
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    Zwroty
    boolean true if file was pushed successfully. inaczej false .

    Rzuca
    DeviceNotAvailableException

    pushFile

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

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    Parametry
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    evaluateContentProviderNeeded boolean : whether to check if we need the content provider

    Zwroty
    boolean true if file was pushed successfully. inaczej false .

    Rzuca
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Push a file to device. By default using a content provider.

    Parametry
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    Zwroty
    boolean true if file was pushed successfully. inaczej false .

    Rzuca
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Push file created from a string to device

    Parametry
    contents String : the contents of the file to push

    remoteFilePath String : the remote destination absolute file path

    Zwroty
    boolean true if string was pushed successfully. inaczej false .

    Rzuca
    DeviceNotAvailableException

    ponowne uruchomienie

    public void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    Blocks until device becomes available.

    Last reboot reason can be obtained by querying sys.boot.reason propety.

    Parametry
    reason String : a reason for this reboot, or null if no reason is specified.

    Rzuca
    DeviceNotAvailableException

    ponowne uruchomienie

    public void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    Rzuca
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    Rzuca
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    Rzuca
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    Rzuca
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Rzuca
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Parametry
    autoReboot boolean : whether to automatically reboot the device after sideload

    Rzuca
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Rzuca
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Parametry
    reason String : a reason for this reboot, or null if no reason is specified.

    Rzuca
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    OSTRZEŻENIE. Userspace reboot is currently under active development, use it on your own risk.

    Rzuca
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    Rzuca
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Attempts to recover device communication.

    Zwroty
    boolean True if recovery attempted and successful, returns False if recovery was skipped

    Rzuca
    DeviceNotAvailableException if device is no longer available

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registers a IDeviceActionReceiver for this device.

    All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

    Parametry
    deviceActionReceiver IDeviceActionReceiver : A IDeviceActionReceiver which will be registered.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    Make the system partition on the device read-only. May reboot the device.

    Rzuca
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    Make the system partition on the device writable. May reboot the device.

    Rzuca
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

    Make the vendor partition on the device read-only. May reboot the device.

    Rzuca
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Make the vendor partition on the device writable. May reboot the device.

    Rzuca
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

    Remove given device admin in given user and return true if it is successful, false otherwise.

    Parametry
    componentName String : of device admin to be removed.

    userId int : of user that the device admin lives in.

    Zwroty
    boolean True if it is successful, false otherwise.

    Rzuca
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Remove all existing device profile owners with the best effort.

    Rzuca
    DeviceNotAvailableException

    usuń użytkownika

    public boolean removeUser (int userId)

    Remove a given user from the device.

    Parametry
    userId int : of the user to remove

    Zwroty
    boolean true if we were successful in removing the user, false otherwise.

    Rzuca
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

    Reset the flag for content provider setup in order to trigger it again.

    runInstrumentationTests

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

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    Parametry
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    Zwroty
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    Rzuca
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Runs instrumentation tests, and provides device recovery.

    If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

    If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

    Parametry
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    Zwroty
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    Rzuca
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                     listeners)

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    ustaw konfigurację

    public void setConfiguration (IConfiguration configuration)

    Wstrzykuje używaną IConfiguration .

    Parametry
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parametry
    avdInfo GceAvdInfo

    ustawić datę

    public void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    Parametry
    date Date : specify a particular date; will use host date if null

    Rzuca
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

    Set a device admin component as device owner in given user.

    Parametry
    componentName String : of device admin to be device owner.

    userId int : of the user that the device owner lives in.

    Zwroty
    boolean True if it is successful, false otherwise.

    Rzuca
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Update the device's state.

    Parametry
    deviceState TestDeviceState : the TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    For emulator set SizeLimitedOutputStream to log output

    Parametry
    output SizeLimitedOutputStream : to log the output

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Sets the Process , when this device is an emulator.

    Parametry
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Set the fastboot option for the device. Should be set when device is first allocated.

    Parametry
    fastbootEnabled boolean : whether fastboot is available for the device or not

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled() to be true, to have fastboot functions enabled.

    Parametry
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

    Update the IDevice associated with this ITestDevice.

    The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDevice

    Parametry
    newDevice IDevice : the IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Sets the time in ms to wait before starting logcat capture for a online device.

    Parametry
    delay int : the delay in ms

    ustawOpcje

    public void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    Parametry
    options TestDeviceOptions

    ustawWłaściwość

    public boolean setProperty (String propKey, 
                    String propValue)

    Sets the given property value on the device. Requires adb root is true.

    Parametry
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    Zwroty
    boolean returns True if the setprop command was successful, False otherwise.

    Rzuca
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

    Parametry
    recovery IDeviceRecovery : the IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

    Parametry
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setSetting

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

    See setSetting(int, String, String, String) and performed on system user.

    Parametry
    namespace String

    key String

    value String

    Rzuca
    DeviceNotAvailableException

    setSetting

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

    Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

    Parametry
    userId int

    namespace String

    key String

    value String

    Rzuca
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Injects the ITestLogger instance

    Parametry
    testLogger ITestLogger

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    Parametry
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    startLogcat

    public void startLogcat ()

    Start capturing logcat output from device in the background.

    Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

    When the device is no longer in use, stopLogcat() must be called.

    startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

    startUser

    public boolean startUser (int userId)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

    Parametry
    userId int : of the user to start in the background

    Zwroty
    boolean true if the user was successfully started in the background.

    Rzuca
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

    Parametry
    userId int : of the user to start in the background

    waitFlag boolean : will make the command wait until user is started and unlocked.

    Zwroty
    boolean true if the user was successfully started in the background.

    Rzuca
    DeviceNotAvailableException

    startVisibleBackgroundUser

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

    Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

    NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

    Parametry
    userId int : of the user to start in the background

    displayId int : display to start user visible on

    waitFlag boolean : will make the command wait until user is started and unlocked.

    Zwroty
    boolean true if the user was successfully started visible in the background.

    Rzuca
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat

    public void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    Will have no effect if logcat output is not being captured.

    stopUser

    public boolean stopUser (int userId)

    Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

    Parametry
    userId int : of the user to stop.

    Zwroty
    boolean true if the user was successfully stopped.

    Rzuca
    DeviceNotAvailableException

    stopUser

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

    Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

    Parametry
    userId int : of the user to stop.

    waitFlag boolean : will make the command wait until user is stopped.

    forceFlag boolean : will force stop the user.

    Zwroty
    boolean true if the user was successfully stopped.

    Rzuca
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    Zwroty
    String the tcp serial number or null if device could not be switched

    Rzuca
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    Zwroty
    boolean true if switch was successful, false otherwise.

    Rzuca
    DeviceNotAvailableException

    Zmień użytkownika

    public boolean switchUser (int userId)

    Switch to another userId with a default timeout. switchUser(int, long) .

    Parametry
    userId int

    Zwroty
    boolean True if the new userId matches the userId provider. False otherwise.

    Rzuca
    DeviceNotAvailableException

    Zmień użytkownika

    public boolean switchUser (int userId, 
                    long timeout)

    Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

    Parametry
    userId int

    timeout long : to wait before returning false for switch-user failed.

    Zwroty
    boolean True if the new userId matches the userId provider. False otherwise.

    Rzuca
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

    Hidden files (with names starting with ".") will be ignored.

    Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

    Parametry
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    Zwroty
    boolean true if files were synced successfully. inaczej false .

    Rzuca
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

    Zwroty
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Uninstall an Android package from device.

    Parametry
    packageName String : the Android package to uninstall

    Zwroty
    String a String with an error code, or null if success.

    Rzuca
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Uninstall an Android package from device for a given user.

    Parametry
    packageName String : the Android package to uninstall

    userId int : the integer user id to uninstall for.

    Zwroty
    String a String with an error code, or null if success.

    Rzuca
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    Zwroty
    boolean true if successful or if the device is unencrypted.

    Rzuca
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Unmount debugfs.

    Rzuca
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    Parametry
    timeOut long : time in msecs to wait for the flag to be set

    Zwroty
    boolean true if device's boot complete flag is set within the timeout

    Rzuca
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing. Uses default timeout.

    Zwroty
    boolean True if device is available, False if recovery is disabled and unavailable.

    Rzuca
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    Parametry
    waitTime long : the time in ms to wait

    Zwroty
    boolean True if device is available, False if recovery is disabled and unavailable.

    Rzuca
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Waits for the device to be responsive and available without considering recovery path.

    Parametry
    waitTime long

    Zwroty
    boolean True if device is available, False if unavailable.

    Rzuca
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot. Use default timeout.

    Rzuca
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    Parametry
    waitTime long : the time in ms to wait

    Zwroty
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    Parametry
    waitTime long : the time in ms to wait

    Zwroty
    boolean true if device boots into sideload before time expires. false otherwise

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    Parametry
    waitTime long : the time in ms to wait

    Zwroty
    boolean true if device becomes not available before time expires. false otherwise

    waitForDeviceOnline

    public void waitForDeviceOnline ()

    Blocks until device is visible via adb. Uses default timeout

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Rzuca
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Parametry
    waitTime long : the time in ms to wait

    Rzuca
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    Parametry
    waitTime long : the time in ms to wait

    Zwroty
    boolean true if device becomes responsive before waitTime elapses.

    Metody chronione

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parametry
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

    protected String[] buildAdbShellCommand (String command, 
                    boolean forceExitStatusDetection)

    Builds the OS command for the given adb shell command session and args

    Parametry
    command String

    forceExitStatusDetection boolean

    Zwroty
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Parametry
    feature String

    strictMinLevel int

    createRebootDeviceAction

    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Create a RebootDeviceAction to be used when performing a reboot action.

    Parametry
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    Zwroty
    NativeDevice.RebootDeviceAction the created RebootDeviceAction .

    createRunUtil

    protected IRunUtil createRunUtil ()

    Zwroty
    IRunUtil

    doAdbReboot

    protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Perform a adb reboot.

    Parametry
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    Rzuca
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    helper method to throw exception if runtime permission isn't supported

    Rzuca
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Zwroty
    int

    getLogger

    protected ITestLogger getLogger ()

    Zwroty
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    Get the RunUtil instance to use.

    Zwroty
    IRunUtil

    initializeConnection

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

    Parametry
    info IBuildInfo

    attributes MultiMap

    Rzuca
    DeviceNotAvailableException
    TargetSetupError

    internalGetProperty

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

    Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.

    Parametry
    propName String : The name of the device property as returned by `adb shell getprop`

    fastbootVar String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted

    description String : A simple description of the variable. First letter should be capitalized.

    Zwroty
    String A string, possibly null or empty, containing the value of the given property

    Rzuca
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

    Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.

    Zwroty
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Return true if local file is newer than remote file. IFileEntry being accurate to the minute, in case of equal times, the file will be considered newer.

    Parametry
    localFile File

    entry IFileEntry

    Zwroty
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    Notifies all IDeviceActionReceiver about reboot end event.

    Rzuca
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

    Notifies all IDeviceActionReceiver about reboot start event.

    Rzuca
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    performDeviceAction

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

    Performs an action on this device. Attempts to recover device and optionally retry command if action fails.

    Parametry
    actionDescription String : a short description of action to be performed. Used for logging purposes only.

    action NativeDevice.DeviceAction : the action to be performed

    retryAttempts int : the retry attempts to make for action if it fails but recovery succeeds

    Zwroty
    boolean true if action was performed successfully

    Rzuca
    DeviceNotAvailableException if recovery attempt fails or max attempts done without success

    postAdbReboot

    protected void postAdbReboot ()

    Possible extra actions that can be taken after a reboot.

    Rzuca
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

    Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.

    Rzuca
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Parametry
    remoteFilePath String

    localFile File

    Zwroty
    boolean

    Rzuca
    DeviceNotAvailableException

    Ustaw zegarek

    protected void setClock (Clock clock)

    Set the Clock instance to use.

    Parametry
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Marks the TestDevice as microdroid and sets its CID.

    Parametry
    process Process : Process of the Microdroid VM.

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    Parametry
    deviceOptions

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                     envVarMap, 
                    String[] fullCmd)

    Executes a simple fastboot command with environment variables and report the status of the command.

    Parametry
    timeout long

    envVarMap

    fullCmd String

    Zwroty
    CommandResult

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                    String[] fullCmd)

    Executes a simple fastboot command and report the status of the command.

    Parametry
    timeout long

    fullCmd String

    Zwroty
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    Wait to see the device going unavailable (stop reporting to adb).

    Parametry
    operationDesc String : The name of the operation that is waiting for unavailable.

    time long : The time to wait for unavailable to occur.

    Zwroty
    boolean True if device did become unavailable.