Urządzenie natywne

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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


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

Podsumowanie

Zagnieżdżone klasy

class NativeDevice.AdbAction

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

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

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

Stałe

String DEBUGFS_PATH

int INVALID_USER_ID

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

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

domyślna liczba ponownych prób wykonania polecenia,

String SD_CARD

String STORAGE_EMULATED

Fieldsem

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Publiczne konstruktory

NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Tworzy TestDevice.

Metody publiczne

void batchPrefetchStartupBuildProps()

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

boolean canSwitchToHeadlessSystemUser()

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

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

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

boolean checkConnectivity()

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

boolean clearErrorDialogs()

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

void clearLastConnectedWifiNetwork()

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

void clearLogcat()

Usuwa wszystkie zgromadzone dane logcat.

boolean 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)

Łą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 nie ma obecnie połączenia z siecią.

boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

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

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

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

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

int createUser(String name)

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

int createUserNoThrow(String name)

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

DeviceInspectionResult debugDeviceNotAvailable()

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

void deleteFile(String deviceFilePath, int userId)

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

void deleteFile(String deviceFilePath)

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

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

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

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

boolean disableAdbRoot()

Wyłącza uprawnienia roota adb.

void disableKeyguard()

próby wyłączenia ochrony klawiatury,

boolean disableNetworkMonitor()

Wyłącza monitorowanie sieci na urządzeniu.

boolean disconnectFromWifi()

rozłącza się z siecią Wi-Fi,

boolean doesFileExist(String deviceFilePath, int userId)

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

boolean doesFileExist(String deviceFilePath)

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

File dumpHeap(String process, String devicePath)

Spróbuj zrzucić stertę z procesu system_server.

boolean enableAdbRoot()

Włącza uprawnienia roota ADB.

boolean enableNetworkMonitor()

Włącza monitorowanie sieci na urządzeniu.

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

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

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

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

String executeAdbCommand(String... cmdArgs)

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

CommandResult executeAdbV2Command(String... cmdArgs)

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

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

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

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

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

CommandResult executeFastbootCommand(String... cmdArgs)

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

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

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

CommandResult executeLongFastbootCommand(String... cmdArgs)

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

CommandResult executeLongFastbootCommand( envVarMap, String... cmdArgs)

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

String executeShellCommand(String command)

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

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

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

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

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

void executeShellCommand(String command, IShellOutputReceiver receiver)

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

CommandResult executeShellV2Command(String cmd)

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

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

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

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

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

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

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

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

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

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

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

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

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

CommandResult fastbootWipePartition(String partition)

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

getActiveApexes()

Pobiera informacje o pakietach APEX aktywowanych na urządzeniu.

String getAdbPath()

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

getAllSettings(String namespace)

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

DeviceAllocationState getAllocationState()

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

String getAndroidId(int userId)

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

getAndroidIds()

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

int getApiLevel()

Pobierz poziom interfejsu API urządzenia.

PackageInfo getAppPackageInfo(String packageName)

Pobiera informacje o pakiecie zainstalowanym na urządzeniu.

getAppPackageInfos()

Pobieranie informacji o pakietach zainstalowanych na urządzeniu.

String getBasebandVersion()

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

Integer getBattery()

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

boolean getBooleanProperty(String name, boolean defaultValue)

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

getBootHistory()

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

getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

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

String getBootloaderVersion()

Wygodna metoda uzyskiwania wersji programu rozruchowego tego urządzenia.

InputStreamSource getBugreport()

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

InputStreamSource getBugreportz()

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

String getBuildAlias()

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

String getBuildFlavor()

Pobierz wersję kompilacji urządzenia.

String getBuildId()

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

String getBuildSigningKeys()

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

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

DeviceDescriptor getCachedDeviceDescriptor()

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

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

String[] getChildren(String path)

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

AbstractConnection getConnection()

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

ContentProviderHandler getContentProvider(int userId)

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

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

Zwraca identyfikator aktualnie zalogowanego użytkownika.

String getDeviceClass()

Pobierz klasę urządzenia.

long getDeviceDate()

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

DeviceDescriptor getDeviceDescriptor()

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

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

TestDeviceState getDeviceState()

Pobierz stan urządzenia.

long getDeviceTimeOffset(Date date)

Funkcja pomocnicza do uzyskiwania różnicy czasu między urządzeniem a podanym ERROR(/Date).

InputStreamSource getEmulatorOutput()

Pobieranie strumienia stdout i stderr emulatora

Process getEmulatorProcess()

Zwraca wartość Process odpowiadającą temu emulatorowi.

final File getExecuteShellCommandLog()

Dziennik zawierający wszystkie logi executeShellCommand(String).

long getExternalStoreFreeSpace()

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

String getFastbootPath()

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

String getFastbootProductType()

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

String getFastbootProductVariant()

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

String getFastbootSerialNumber()

Zwraca numer seryjny trybu fastboot.

String getFastbootVariable(String variableName)

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

String getFastbootVersion()

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

IFileEntry getFileEntry(String path)

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

IFileEntry getFileEntry(FileListingService.FileEntry entry)

Nieoficjalne narzędzie pomocnicze do pobierania FileEntry ze ścieżki niebędącej ścieżką główną.

getFoldableStates()

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

IDevice getIDevice()

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

getInstalledPackageNames()

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

long getIntProperty(String name, long defaultValue)

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

String getIpAddress()

Pobiera adres IP urządzenia.

KeyguardControllerState getKeyguardState()

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

long getLastExpectedRebootTimeMillis()

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

int getLaunchApiLevel()

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

InputStreamSource getLogcat()

Pobiera strumień zrzutu danych logcat.

InputStreamSource getLogcat(int maxBytes)

Pobiera strumień zrzutu ostatnich maxBytes danych logcat.

InputStreamSource getLogcatDump()

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

InputStreamSource getLogcatSince(long date)

Pobiera strumień zrzutu przechwyconych danych logcat od podanej daty.

String getMacAddress()

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

Integer getMainUserId()

Zwraca główny identyfikator użytkownika.

getMainlineModuleInfo()

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

int getMaxNumberOfRunningUsersSupported()

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

int getMaxNumberOfUsersSupported()

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

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

Zwraca IDeviceStateMonitor powiązany z urządzeniem.

String getMountPoint(String mountName)

Zwraca punkt podłączenia.

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

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

getMountPointInfo()

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

TestDeviceOptions getOptions()

Pobierz opcje testu dla urządzenia.

long getPartitionFreeSpace(String partition)

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

Integer getPrimaryUserId()

Zwraca podstawowy identyfikator użytkownika.

ProcessInfo getProcessByName(String processName)

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

String getProcessPid(String process)

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

String getProductType()

Wygodna metoda uzyskiwania typu produktu tego urządzenia.

String getProductVariant()

Wygodna metoda pobierania wersji produktu tego urządzenia.

String getProperty(String name)

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

ITestDevice.RecoveryMode getRecoveryMode()

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

InputStreamSource getScreenshot(long displayId)

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

InputStreamSource getScreenshot(String format)

Robi zrzut ekranu urządzenia.

InputStreamSource getScreenshot(String format, boolean rescale)

Robi zrzut ekranu urządzenia.

InputStreamSource getScreenshot()

Robi zrzut ekranu urządzenia.

String getSerialNumber()

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

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

Zwraca wartość żądanego ustawienia.

String getSetting(String namespace, String key)

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

String getSimOperator()

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

String getSimState()

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

getTombstones()

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

long getTotalMemory()

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

String getTrackingSerial()

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

getUninstallablePackageNames()

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

boolean getUseFastbootErase()

Sprawdza, czy do wyczyszczenia partycji na urządzeniu należy użyć polecenia fastboot erase czy fastboot format.

int getUserFlags(int userId)

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

getUserInfos()

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

int getUserSerialNumber(int userId)

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

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

Przetwarzanie danego zdarzenia DeviceEvent.

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

boolean hasFeature(String feature)

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

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

Zainicjuj połączenie z urządzeniem.

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

Zainstaluj pakiet Androida na urządzeniu.

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

Zainstaluj pakiet Androida na urządzeniu.

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

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

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

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

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

Instaluje pliki APK w trybie przyrostowym.

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

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

boolean isBypassLowTargetSdkBlockSupported()

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

boolean isDebugfsMounted()

Sprawdź, czy debugfs jest zamontowany.

boolean isDeviceEncrypted()

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

boolean isDirectory(String path)

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

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

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

boolean isExecutable(String fullPath)

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

boolean isFastbootEnabled()

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

boolean isHeadless()

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

boolean isHeadlessSystemUserMode()

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

boolean isMainUserPermanentAdmin()

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

boolean isMultiUserSupported()

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

boolean isPackageInstalled(String packageName, String userId)

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

boolean isPackageInstalled(String packageName)

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

boolean isRuntimePermissionSupported()

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

boolean isStateBootloaderOrFastbootd()

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

boolean isUserRunning(int userId)

Sprawdź, czy dany użytkownik jest aktywny.

boolean isUserSecondary(int userId)

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

boolean isUserVisible(int userId)

Sprawdza, czy dany użytkownik jest widoczny.

boolean isUserVisibleOnDisplay(int userId, int displayId)

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

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

boolean isVisibleBackgroundUsersSupported()

Zwraca informację, czy urządzenie zezwala na uruchamianie użytkownikom widocznym w tle.

boolean isWifiEnabled()

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

listDisplayIds()

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

listDisplayIdsForStartingVisibleBackgroundUsers()

Pobiera listę wyświetlaczy, których można używać 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 służąca do tworzenia raportu o błędzie i przesyłania go do osób zgłaszających.

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

Zapisz wiadomość w logcat urządzenia.

void mountDebugfs()

Podłącz debugfs.

void nonBlockingReboot()

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

void postAdbRootAction()

Zastąp, jeśli po uzyskaniu dostępu do roota za pomocą ADB i przed ponownym połączeniem urządzenia z siecią trzeba wykonać na nim określone działania.

void postAdbUnrootAction()

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

void postBootSetup()

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

void postInvocationTearDown(Throwable exception)

Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania.

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

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

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

Rekursywne pobieranie zawartości katalogu z urządzenia.

boolean pullDir(String deviceFilePath, File localDir)

Rekursywne pobieranie zawartości katalogu z urządzenia.

boolean pullFile(String remoteFilePath, File localFile)

Pobiera plik z urządzenia.

File pullFile(String remoteFilePath, int userId)

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

File pullFile(String remoteFilePath)

Pobiera plik z urządzenia, zapisuje 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 pamięci zewnętrznej urządzenia, zapisywania go w lokalnym pliku tymczasowym ERROR(/File) i zwracania odwołania do tego pliku File.

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

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

boolean pushDir(File localFileDir, String deviceFilePath)

Rekursywne przekazywanie zawartości katalogu na urządzenie.

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

Rekursywne przekazywanie zawartości katalogu na urządzenie.

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

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

boolean pushFile(File localFile, String remoteFilePath)

Przekazywanie pliku na urządzenie.

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

Przekazywanie pliku na urządzenie.

boolean pushString(String contents, String remoteFilePath)

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

void reboot(String reason)

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

void reboot()

Uruchamia ponownie urządzenie w trybie adb.

void rebootIntoBootloader()

Uruchamia ponownie urządzenie w trybie programu rozruchowego.

void rebootIntoFastbootd()

Uruchamia ponownie urządzenie w trybie fastbootd.

void rebootIntoRecovery()

Uruchamia ponownie urządzenie w trybie odzyskiwania adb.

void rebootIntoSideload()

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

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

void rebootIntoSideload(boolean autoReboot)

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

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

void rebootUntilOnline()

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

void rebootUntilOnline(String reason)

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

void rebootUserspace()

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

void rebootUserspaceUntilOnline()

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

boolean recoverDevice()

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

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver na tym urządzeniu.

void remountSystemReadOnly()

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

void remountSystemWritable()

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

void remountVendorReadOnly()

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

void remountVendorWritable()

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

boolean removeAdmin(String componentName, int userId)

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

void removeOwners()

Usuń wszystkich obecnych właścicieli profilu urządzenia, 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 ponownie ją wywołać.

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

Wygodna metoda wykonywania ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z co najmniej 1 odbiorcą przekazanym jako parametr.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

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

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)

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

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

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

void setAdbPath(String adbPath)

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

void setConfiguration(IConfiguration configuration)

Wstawia używany element IConfiguration.

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

Ustawia datę na urządzeniu

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

boolean setDeviceOwner(String componentName, int userId)

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 rejestrować dane wyjściowe.

void setEmulatorProcess(Process p)

Ustawia Process, gdy urządzenie jest emulatorem.

void setFastbootEnabled(boolean fastbootEnabled)

Ustaw opcję fastboot dla urządzenia.

void setFastbootPath(String fastbootPath)

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

void setIDevice(IDevice newDevice)

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

void setLogStartDelay(int delay)

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

void setOptions(TestDeviceOptions options)

Ustaw TestDeviceOptions na urządzeniu

boolean setProperty(String propKey, String propValue)

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

void setRecovery(IDeviceRecovery recovery)

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

void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

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

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

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

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

void setTestLogger(ITestLogger testLogger)

Wstrzykuje instancję ITestLogger

void setTrackingSerial(String trackingSerial)

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

void setUseFastbootErase(boolean useFastbootErase)

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

void startLogcat()

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

boolean startTradeInModeTesting(int timeoutMs)

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

boolean startUser(int userId)

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

boolean startUser(int userId, boolean waitFlag)

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

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

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

void stopEmulatorOutput()

Zamknij i usuń dane wyjściowe emulatora.

void stopLogcat()

Zatrzymuje rejestrowanie danych wyjściowych logcat z urządzenia i odrzuca aktualnie zapisane dane logcat.

void stopTradeInModeTesting()

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

boolean stopUser(int userId)

Zatrzymuje danego użytkownika.

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

Zatrzymanie danego użytkownika.

String switchToAdbTcp()

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

boolean switchToAdbUsb()

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

boolean switchUser(int userId)

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

boolean switchUser(int userId, long timeout)

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

boolean syncFiles(File localFileDir, String deviceFilePath)

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

Bugreport takeBugreport()

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

String uninstallPackage(String packageName)

Odinstaluj pakiet Androida z urządzenia.

String uninstallPackageForUser(String packageName, int userId)

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

boolean unlockDevice()

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

void unmountDebugfs()

Odłącz debugfs.

boolean waitForBootComplete(long timeOut)

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

boolean waitForDeviceAvailable()

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

boolean waitForDeviceAvailable(long waitTime)

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

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

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

void waitForDeviceBootloader()

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

void waitForDeviceFastbootD()
boolean waitForDeviceInRecovery(long waitTime)

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

boolean waitForDeviceInSideload(long waitTime)

Blokuje możliwość przejścia urządzenia w stan „adb sideload”

boolean waitForDeviceNotAvailable(long waitTime)

Blokuje urządzenie, aby było niedostępne, tzn. nie było widoczne 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 odpowie na podstawowe polecenie powłoki adb.

Metody chronione

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

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

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

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

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

Wykonaj ponowne uruchomienie za pomocą ADB.

void ensureRuntimePermissionSupported()

metoda pomocnicza do zgłaszania wyjątku, jeśli uprawnienia czasu działania nie są obsługiwane;

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

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

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

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

boolean isInRebootCallback()

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

boolean isNewer(File localFile, IFileEntry entry)

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

void notifyRebootEnded()

Wysyła powiadomienie o zakończeniu ponownego uruchamiania do wszystkich IDeviceActionReceiver.

void notifyRebootStarted()

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

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

wykonuje działanie na tym urządzeniu;

void postAdbReboot(NativeDevice.RebootMode rebootMode)

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

void prePostBootSetup()

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

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

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

void setMicrodroidProcess(Process process)

Oznacza TestDevice jako microdroid i ustawia jego identyfikator klienta.

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

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

CommandResult simpleFastbootCommand(long timeout, String[] fullCmd)

Wykonuje proste polecenie fastboot i zgłasza jego stan.

boolean waitForDeviceNotAvailable(String operationDesc, long time)

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

Stałe

DEBUGFS_PATH

public static final String DEBUGFS_PATH

Stała wartość: „/sys/kernel/debug”

INVALID_USER_ID

public static final int INVALID_USER_ID

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

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

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

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

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

domyślna liczba ponownych prób wykonania polecenia,

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

SD_CARD

protected static final String SD_CARD

Stała wartość: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

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

Fieldsem

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Publiczne konstruktory

Urządzenie natywne

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

Tworzy TestDevice.

Parametry
device IDevice: powiązany IDevice

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

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

Metody publiczne

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Zwroty
boolean

Zgłasza
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

Zwroty
boolean Wartość „prawda”, jeśli poziom jest obsługiwany. W przeciwnym razie ma wartość Fałsz.

Zgłasza
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

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

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

Zgłasza
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

Zgłasza
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

Usuwa wszystkie zgromadzone dane logcat.

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

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

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

Zwroty
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku

Zgłasza
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

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

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

Zwroty
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku

Zgłasza
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

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

Zwroty
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku

Zgłasza
DeviceNotAvailableException

connectToWifiNetwork

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

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

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

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

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

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

Zwroty
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku

Zgłasza
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

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

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

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

Zwroty
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku

Zgłasza
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Zwroty
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku

Zgłasza
DeviceNotAvailableException

createUser

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

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

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

Zgłasza
DeviceNotAvailableException

createUser

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

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

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

Zgłasza
DeviceNotAvailableException

createUser

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 utworzyć na urządzeniu

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

Zgłasza
DeviceNotAvailableException

createUserNoThrow

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 utworzyć na urządzeniu

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

Zgłasza
DeviceNotAvailableException

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

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

Zwroty
DeviceInspectionResult

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

userId int: identyfikator użytkownika, z którego chcesz usunąć dane.

Zgłasza
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath)

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

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

Zgłasza
DeviceNotAvailableException

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver.

Parametry
deviceActionReceiver IDeviceActionReceiver: IDeviceActionReceiver, która zostanie usunięta.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

Parametry
prevSystemServerProcess ProcessInfo: poprzedni proces system_server ProcessInfo.

Zwroty
boolean true – jeśli urządzenie zostało ponownie uruchomione.

Zgłasza
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

timeUnit TimeUnit: jednostka czasu TimeUnit dla danego parametru utcEpochTime.

Zwroty
boolean true – jeśli urządzenie zostało ponownie uruchomione.

Zgłasza
DeviceNotAvailableException

disableAdbRoot

public boolean disableAdbRoot ()

Wyłącza uprawnienia roota adb.

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

Zwroty
boolean true, jeśli się uda.

Zgłasza
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

próby wyłączenia ochrony klawiatury,

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

Zgłasza
DeviceNotAvailableException

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Wyłącza monitorowanie sieci na urządzeniu.

Zwroty
boolean true, jeśli monitorowanie zostało wyłączone. falsew przypadku niepowodzenia.

Zgłasza
DeviceNotAvailableException

disconnectFromWifi

public boolean disconnectFromWifi ()

rozłącza się z siecią Wi-Fi,

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

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

Zgłasza
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

Zgłasza
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

Zgłasza
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

Parametry
process String: nazwa procesu na urządzeniu, w którym ma zostać wykonany zrzę pamięci.

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

Zwroty
File ERROR(/File) zawierający raport. Wartość null, jeśli coś się nie powiodło.

Zgłasza
DeviceNotAvailableException

enableAdbRoot

public boolean enableAdbRoot ()

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

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

Zwroty
boolean true, jeśli się uda.

Zgłasza
DeviceNotAvailableException

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Włącza monitorowanie sieci na urządzeniu.

Zwroty
boolean true – jeśli monitorowanie zostało włączone. falsew przypadku niepowodzenia.

Zgłasza
DeviceNotAvailableException

executeAdbCommand

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

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

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

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

cmdArgs String: polecenie adb i argumenty do uruchomienia;

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

Zgłasza
DeviceNotAvailableException

executeAdbCommand

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

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

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

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

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

cmdArgs String: polecenie adb i argumenty do uruchomienia;

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

Zgłasza
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

Parametry
cmdArgs String: polecenie adb i argumenty do uruchomienia;

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

Zgłasza
DeviceNotAvailableException

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

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

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

Parametry
cmdArgs String: polecenie adb i argumenty do uruchomienia;

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

Zgłasza
DeviceNotAvailableException

executeAdbV2Command

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

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

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

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

cmdArgs String: polecenie adb i argumenty do uruchomienia;

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

Zgłasza
DeviceNotAvailableException

executeAdbV2Command

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

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

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

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

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

cmdArgs String: polecenie adb i argumenty do uruchomienia;

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

Zgłasza
DeviceNotAvailableException

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

Parametry
cmdArgs String: polecenie fastboot i argumenty do uruchomienia;

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

Zgłasza
DeviceNotAvailableException

executeFastbootCommand

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

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

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

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

cmdArgs String: polecenie fastboot i argumenty do uruchomienia;

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

Zgłasza
DeviceNotAvailableException

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

Parametry
cmdArgs String: polecenie fastboot i argumenty do uruchomienia;

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

Zgłasza
DeviceNotAvailableException

executeLongFastbootCommand

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

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

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

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

cmdArgs String: polecenie fastboot i argumenty do uruchomienia;

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

Zgłasza
DeviceNotAvailableException

executeShellCommand

public String executeShellCommand (String command)

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

Parametry
command String: polecenie adb shell do uruchomienia

Zwroty
String dane wyjściowe powłoki,

Zgłasza
DeviceNotAvailableException

executeShellCommand

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

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

Parametry
command String: polecenie adb shell do uruchomienia

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

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

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zgłasza
DeviceNotAvailableException

executeShellCommand

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

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

Parametry
command String: polecenie adb shell do uruchomienia

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

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

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

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zgłasza
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

Parametry
command String: polecenie adb shell do uruchomienia

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

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

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

Zwroty
CommandResult Wynik w języku: CommandResult.

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

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

Zwroty
CommandResult Wynik w języku: CommandResult.

Zgłasza
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

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

Zwroty
CommandResult Wynik w języku: CommandResult.

Zgłasza
DeviceNotAvailableException

executeShellV2Command

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

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

Parametry
cmd String: polecenie adb shell do uruchomienia

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

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zwroty
CommandResult

Zgłasza
DeviceNotAvailableException

executeShellV2Command

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

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

Parametry
cmd String: polecenie adb shell do uruchomienia

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

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

Zwroty
CommandResult

Zgłasza
DeviceNotAvailableException

executeShellV2Command

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

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

Parametry
cmd String: polecenie adb shell do uruchomienia

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

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

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

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zwroty
CommandResult

Zgłasza
DeviceNotAvailableException

executeShellV2Command

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

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

Parametry
cmd String: polecenie adb shell do uruchomienia

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

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

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

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

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zwroty
CommandResult

Zgłasza
DeviceNotAvailableException

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

Parametry
partition String: partycja do wyczyszczenia

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

Zgłasza
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Pobiera informacje o pakietach APEX aktywowanych na urządzeniu.

Zwroty
Obecnie na urządzeniu aktywowano ERROR(/Set)ApexInfo

Zgłasza
DeviceNotAvailableException

getAdbPath

public String getAdbPath ()

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

Zwroty
String

getAllSettings

public  getAllSettings (String namespace)

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

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

Zwroty
mapa par klucz-wartość. Wartość null, jeśli przestrzeń nazw nie jest obsługiwana.

Zgłasza
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

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

Zwroty
DeviceAllocationState

getAndroidId

public String getAndroidId (int userId)

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

Parametry
userId int

Zwroty
String

Zgłasza
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

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

Zwroty
Mapa identyfikatorów Androida pasujących do identyfikatorów użytkowników.

Zgłasza
DeviceNotAvailableException

getApiLevel

public int getApiLevel ()

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

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

Zgłasza
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Pobiera informacje o pakiecie zainstalowanym na urządzeniu.

Parametry
packageName String

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

Zgłasza
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Pobieranie informacji o pakietach zainstalowanych na urządzeniu.

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

Zgłasza
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

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

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

Zgłasza
DeviceNotAvailableException

getBattery

public Integer getBattery ()

Zwraca bieżący poziom naładowania baterii urządzenia lub wartość null, jeśli poziom naładowania 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 usługi

defaultValue boolean: wartość domyślna, która ma zostać zwrócona, 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; w przeciwnym razie.

Zgłasza
DeviceNotAvailableException

getBootHistory

public  getBootHistory ()

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

Zwroty
Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu

Zgłasza
DeviceNotAvailableException

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

timeUnit TimeUnit: jednostka czasu TimeUnit.

Zwroty
Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu

Zgłasza
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

Wygodna metoda uzyskiwania wersji programu rozruchowego tego urządzenia.

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

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

Zgłasza
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

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

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

getBuildAlias

public String getBuildAlias ()

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

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

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

Zgłasza
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

Pobierz wersję kompilacji urządzenia.

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

Zgłasza
DeviceNotAvailableException

getBuildId

public String getBuildId ()

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

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

Zgłasza
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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

Zgłasza
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Zwroty
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Parametry
shortDescriptor boolean: czy ograniczyć opis do minimum informacji

Zwroty
DeviceDescriptor

getChildren

public String[] getChildren (String path)

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

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

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

Zgłasza
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

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

Zwroty
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

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

Parametry
userId int: identyfikator użytkownika, za pomocą którego należy zainicjować dostawcę treści.

Zwroty
ContentProviderHandler

Zgłasza
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Zwroty
DeviceFoldableState

Zgłasza
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

Zwroty
int

Zgłasza
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Pobierz klasę urządzenia.

Zwroty
String klasa urządzenia String,

getDeviceDate

public long getDeviceDate ()

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

Zwroty
long datę urządzenia w formacie epoki;

Zgłasza
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

Zwroty
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

Parametry
shortDescriptor boolean: czy ograniczyć opis do minimum informacji

Zwroty
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

Pobierz stan urządzenia.

Zwroty
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Funkcja pomocnicza do uzyskiwania różnicy czasu między urządzeniem a podanym ERROR(/Date). wewnętrznie używać czasu epoki.

Parametry
date Date

Zwroty
long różnicę w milisekundach,

Zgłasza
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Pobieranie strumienia stdout i stderr emulatora

Zwroty
InputStreamSource dane wyjściowe emulatora,

getEmulatorProcess

public Process getEmulatorProcess ()

Zwraca wartość Process odpowiadającą temu emulatorowi.

Zwroty
Process Process lub null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Dziennik zawierający wszystkie logi executeShellCommand(String).

Zwroty
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

Zwroty
long ilość wolnego miejsca w KB,

Zgłasza
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

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

Zwroty
String

getFastbootProductType

public String getFastbootProductType ()

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

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

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

Zgłasza
DeviceNotAvailableException

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

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

Zgłasza
DeviceNotAvailableException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Zwraca numer seryjny trybu fastboot.

Zwroty
String

getFastbootVariable

public String getFastbootVariable (String variableName)

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

Parametry
variableName String: nazwa zmiennej;

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

Zgłasza
DeviceNotAvailableException

getFastbootVersion

public String getFastbootVersion ()

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

Zwroty
String

getFileEntry

public IFileEntry getFileEntry (String path)

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

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

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

Zgłasza
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

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

Zwroty
IFileEntry obiekt FileEntryWrapper reprezentujący obiekt FileEntry.

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

getFoldableStates

public  getFoldableStates ()

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

Zwroty

Zgłasza
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

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

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

Zwroty
IDevice IDevice

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

Zgłasza
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

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

Parametry
name String: nazwa usługi

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

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.

Zgłasza
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;

Zgłasza
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

Zgłasza
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

Zwroty
long

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

Zgłasza
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Pobiera strumień zrzutu danych logcat.

Działa w 2 trybach:

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

    Zwroty
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

    Pobiera strumień zrzutu ostatnich maxBytes danych logcat.

    Przydatne w sytuacjach, gdy chcesz często robić zrzuty przechwyconych danych logcat bez ponoszenia potencjalnie dużych kosztów związanych z zajmowaniem miejsca na dysku przez pełny zrzut getLogcat().

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

    Zwroty
    InputStreamSource

    getLogcatDump

    public InputStreamSource getLogcatDump ()

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

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

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

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

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

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

    Zwroty
    InputStreamSource

    getMacAddress

    public String getMacAddress ()

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

    Zwroty
    String

    getMainUserId

    public Integer getMainUserId ()

    Zwraca główny identyfikator użytkownika.

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

    Zgłasza
    DeviceNotAvailableException

    getMainlineModuleInfo

    public  getMainlineModuleInfo ()

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

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

    Zgłasza
    DeviceNotAvailableException

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

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

    Zwroty
    int liczbę całkowitą wskazującą liczbę użytkowników działających jednocześnie,

    Zgłasza
    DeviceNotAvailableException

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported ()

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

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

    Zgłasza
    DeviceNotAvailableException

    getMicrodroidProcess

    public Process getMicrodroidProcess ()

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

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    Zwraca IDeviceStateMonitor powiązany z urządzeniem.

    Zwroty
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

    Zwraca punkt podłączenia.

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

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

    Parametry
    mountName String: nazwa punktu podłączania

    Zwroty
    String punkt podłączenia lub null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Parametry
    mountpoint String

    Zwroty
    ITestDevice.MountPointInfo ERROR(/List)MountPointInfo zawierający informacje z pliku „/proc/mounts”.

    Zgłasza
    DeviceNotAvailableException

    getMountPointInfo

    public  getMountPointInfo ()

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

    Zwroty
    ERROR(/List)MountPointInfo zawierający informacje z pliku „/proc/mounts”.

    Zgłasza
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

    Pobierz opcje testu dla urządzenia.

    Zwroty
    TestDeviceOptions TestDeviceOptions powiązane z testowanym urządzeniem.

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

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

    Parametry
    partition String

    Zwroty
    long ilość wolnego miejsca w KB,

    Zgłasza
    DeviceNotAvailableException

    getPrimaryUserId

    public Integer getPrimaryUserId ()

    Zwraca podstawowy identyfikator użytkownika.

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

    Zgłasza
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

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

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

    Zwroty
    ProcessInfo ProcessInfo dla danego procesu o nazwie processName

    Zgłasza
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

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

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

    Zwroty
    String

    Zgłasza
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

    Wygodna metoda uzyskiwania typu produktu tego urządzenia.

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

    Zwroty
    String nazwę typu produktu String; Nie może mieć wartości null.

    Zgłasza
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

    Wygodna metoda pobierania wersji produktu tego urządzenia.

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

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

    Zgłasza
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

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

    Parametry
    name String: nazwa usługi

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

    Zgłasza
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

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

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

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

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

    Zgłasza
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format)

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

    Parametry
    format String: obsługiwane formaty PNG i JPEG

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

    Zgłasza
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

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

    Parametry
    format String: obsługiwane formaty PNG i JPEG

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

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

    Zgłasza
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot ()

    Robi zrzut ekranu urządzenia.

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

    Zgłasza
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

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

    Zwroty
    String numer seryjny String;

    getSetting

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

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

    Parametry
    userId int

    namespace String

    key String

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

    Zgłasza
    DeviceNotAvailableException

    getSetting

    public String getSetting (String namespace, 
                    String key)

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

    Parametry
    namespace String

    key String

    Zwroty
    String

    Zgłasza
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

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

    Zwroty
    String

    getSimState

    public String getSimState ()

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

    Zwroty
    String

    getTombstones

    public  getTombstones ()

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

    metoda działa w trybie „najlepsze starania”, więc jeśli z jakiegokolwiek powodu nie uda się pobrać znacznika usunięcia, nie będzie go na liście. Tylko instrukcja DeviceNotAvailableException spowoduje wcześniejsze zakończenie metody.

    Zwroty
    Lista plików tombstone. Jeśli nie ma plików tombstone, lista jest pusta.

    Zgłasza
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

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

    Zwroty
    long

    getTrackingSerial

    public String getTrackingSerial ()

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

    Zwroty
    String

    getUninstallablePackageNames

    public  getUninstallablePackageNames ()

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

    Zwroty
    ERROR(/Set) nazw pakietów, których nie można odinstalować, zainstalowanych obecnie na urządzeniu.String

    Zgłasza
    DeviceNotAvailableException

    getUseFastbootErase

    public boolean getUseFastbootErase ()

    Sprawdza, czy do wyczyszczenia partycji na urządzeniu należy użyć polecenia fastboot erase czy fastboot format.

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

    getUserFlags

    public int getUserFlags (int userId)

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

    Parametry
    userId int

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

    Zgłasza
    DeviceNotAvailableException

    getUserInfos

    public  getUserInfos ()

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

    Zwroty
    lista obiektów UserInfo.

    Zgłasza
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

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

    Parametry
    userId int

    Zwroty
    int

    Zgłasza
    DeviceNotAvailableException

    handleAllocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

    Parametry
    event DeviceEvent

    Zwroty
    IManagedTestDevice.DeviceEventResponse

    hasFeature

    public boolean hasFeature (String feature)

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

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

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

    Zgłasza
    DeviceNotAvailableException

    initializeConnection

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

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

    Parametry
    info IBuildInfo

    attributes MultiMap

    Zgłasza
    DeviceNotAvailableException
    TargetSetupError

    installPackage

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

    Zainstaluj pakiet Androida na urządzeniu.

    Parametry
    packageFile File: plik APK do zainstalowania

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

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

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

    Zgłasza
    DeviceNotAvailableException

    installPackage

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

    Zainstaluj pakiet Androida na urządzeniu.

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

    Parametry
    packageFile File: plik APK do zainstalowania

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

    grantPermissions boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane podczas instalacji.

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

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

    Zgłasza
    DeviceNotAvailableException

    installPackageForUser

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

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

    Parametry
    packageFile File: plik APK do zainstalowania

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

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

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

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

    Zgłasza
    DeviceNotAvailableException

    installPackageForUser

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

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

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

    Parametry
    packageFile File: plik APK do zainstalowania

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

    grantPermissions boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane podczas instalacji.

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

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

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

    Zgłasza
    DeviceNotAvailableException

    installPackageWithIncrementalMode

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

    Instaluje pliki APK w trybie przyrostowym.

    Parametry
    apkFiles File: pliki APK do zainstalowania.

    extraArgs String

    userId String

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    Zwroty
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

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

    Zwroty
    boolean Prawda, jeśli wyliczanie aplikacji jest obsługiwane, w przeciwnym razie fałsz.

    Zgłasza
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

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

    Zwroty
    boolean Wartość true, jeśli obejście blokady niskiego docelowego pakietu SDK jest obsługiwane, w przeciwnym razie wartość false.

    Zgłasza
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    Sprawdź, czy debugfs jest zamontowany.

    Zwroty
    boolean true, jeśli debugfs jest zamontowany

    Zgłasza
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

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

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

    Zgłasza
    DeviceNotAvailableException

    isDirectory

    public boolean isDirectory (String path)

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

    Parametry
    path String

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isEnableAdbRoot

    public boolean isEnableAdbRoot ()

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

    isEncryptionSupported

    public boolean isEncryptionSupported ()

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

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

    Zgłasza
    DeviceNotAvailableException

    isExecutable

    public boolean isExecutable (String fullPath)

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

    Parametry
    fullPath String

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

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

    Zwroty
    boolean

    isHeadless

    public boolean isHeadless ()

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

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

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

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

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

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isMultiUserSupported

    public boolean isMultiUserSupported ()

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

    Zwroty
    boolean wartość „true”, jeśli obsługiwanych jest wielu użytkowników, w przeciwnym razie „false”.

    Zgłasza
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

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

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

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

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

    Zgłasza
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName)

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

    Parametry
    packageName String

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

    Zgłasza
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

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

    Zwroty
    boolean Wartość true, jeśli uprawnienia czasu działania są obsługiwane. W przeciwnym razie wartość false.

    Zgłasza
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

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

    Zwroty
    boolean

    isUserRunning

    public boolean isUserRunning (int userId)

    Sprawdź, czy dany użytkownik jest aktywny.

    Parametry
    userId int

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

    Zgłasza
    DeviceNotAvailableException

    isUserSecondary

    public boolean isUserSecondary (int userId)

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

    Parametry
    userId int

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

    Zgłasza
    DeviceNotAvailableException

    isUserVisible

    public boolean isUserVisible (int userId)

    Sprawdza, czy dany użytkownik jest widoczny.

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

    Parametry
    userId int

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isUserVisibleOnDisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

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

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

    Parametry
    userId int

    displayId int

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

    Zwraca informację, czy urządzenie zezwala na uruchamianie użytkownikom widocznym w tle.

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

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isWifiEnabled

    public boolean isWifiEnabled ()

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

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

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

    Zgłasza
    DeviceNotAvailableException

    listDisplayIds

    public  listDisplayIds ()

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

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

    Zgłasza
    DeviceNotAvailableException

    listDisplayIdsForStartingVisibleBackgroundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    Zwroty

    Zgłasza
    DeviceNotAvailableException

    listUsers

    public  listUsers ()

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

    Zwroty
    lista identyfikatorów użytkowników;

    Zgłasza
    DeviceNotAvailableException

    logAnrs

    public boolean logAnrs (ITestLogger logger)

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

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

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

    Zgłasza
    DeviceNotAvailableException

    logBugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

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

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

    listener ITestLogger: ITestLogger, aby zarejestrować raport o błędzie.

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

    logOnDevice

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

    Zapisz wiadomość w logcat urządzenia. Jest to bezpieczne wywołanie, które nie spowoduje błędu nawet wtedy, gdy rejestrowanie się nie powiedzie.

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

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

    format String: format wiadomości.

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

    mountDebugfs

    public void mountDebugfs ()

    Podłącz debugfs.

    Zgłasza
    DeviceNotAvailableException

    nonBlockingReboot

    public void nonBlockingReboot ()

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

    Zgłasza
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

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

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

    postAdbUnrootAction

    public void postAdbUnrootAction ()

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

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

    postBootSetup

    public void postBootSetup ()

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

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

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

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

    Zgłasza
    DeviceNotAvailableException

    postInvocationTearDown

    public void postInvocationTearDown (Throwable exception)

    Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania.

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

    preInvocationSetup

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

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

    Parametry
    info IBuildInfo: IBuildInfo urządzenia.

    attributes MultiMap: atrybuty przechowywane w kontekście wywołania.

    Zgłasza
    DeviceNotAvailableException
    TargetSetupError

    pullDir

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

    Rekursywne pobieranie zawartości katalogu z urządzenia.

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

    localDir File: lokalny katalog, do którego mają być pobierane pliki.

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane

    Zwroty
    boolean true jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Rekursywne pobieranie zawartości katalogu z urządzenia.

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

    localDir File: lokalny katalog, do którego mają być pobierane pliki.

    Zwroty
    boolean true jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Pobiera plik z urządzenia.

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

    localFile File: lokalny plik, w którym będą przechowywane treści. Jeśli nie jest pusta, zawartość zostanie zastąpiona.

    Zwroty
    boolean true – jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                    int userId)

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

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

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane.

    Zwroty
    File ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

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

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

    Zwroty
    File ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException

    pullFile

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

    Pobiera plik z urządzenia.

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

    localFile File: lokalny plik, w którym będą przechowywane treści. Jeśli nie jest pusta, zawartość zostanie zastąpiona.

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane.

    Zwroty
    boolean true – jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

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

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

    Zwroty
    String String zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

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

    Parametry
    remoteFilePath String: ścieżka do pliku na urządzeniu, względna w stosunku do punktu montowania zewnętrznej pamięci masowej urządzenia

    Zwroty
    File ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException

    pushDir

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

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

    Parametry
    localFileDir File: katalog lokalny do wypychania

    deviceFilePath String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego

    excludedDirectories : Zestaw nazw wykluczonych katalogów, które nie powinny być przesyłane.

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Rekursywne przekazywanie zawartości katalogu na urządzenie.

    Parametry
    localFileDir File: katalog lokalny do wypychania

    deviceFilePath String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushDir

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

    Rekursywne przekazywanie zawartości katalogu na urządzenie.

    Parametry
    localFileDir File: katalog lokalny do wypychania

    deviceFilePath String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego

    userId int: identyfikator użytkownika, do którego ma zostać wysłane powiadomienie.

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushFile

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

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

    Parametry
    localFile File: plik lokalny do przesłania

    remoteFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    evaluateContentProviderNeeded boolean: czy sprawdzić, czy potrzebujemy dostawcy treści.

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Przekazywanie pliku na urządzenie. Domyślnie używa dostawcy treści.

    Parametry
    localFile File: plik lokalny do przesłania

    remoteFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushFile

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

    Przekazywanie pliku na urządzenie. Domyślnie używa dostawcy treści.

    Parametry
    localFile File: plik lokalny do przesłania

    remoteFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    userId int: identyfikator użytkownika, do którego ma zostać wysłane powiadomienie.

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

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

    Parametry
    contents String: zawartość pliku do przesłania,

    remoteFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    Zwroty
    boolean true, jeśli ciąg znaków został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    Uruchom ponownie

    public void reboot (String reason)

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

    Blokuje do momentu, aż urządzenie stanie się dostępne.

    Przyczynę ostatniego ponownego uruchomienia można uzyskać, wysyłając zapytanie o właściwość sys.boot.reason.

    Parametry
    reason String: przyczyna ponownego uruchomienia lub null, jeśli nie podano przyczyny.

    Zgłasza
    DeviceNotAvailableException

    Uruchom ponownie

    public void reboot ()

    Uruchamia ponownie urządzenie w trybie adb.

    Blokuje do momentu, aż urządzenie stanie się dostępne.

    Zgłasza
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Uruchamia ponownie urządzenie w trybie programu rozruchowego.

    Blokuje działanie do momentu przejścia urządzenia w tryb programu rozruchowego.

    Zgłasza
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Uruchamia ponownie urządzenie w trybie fastbootd.

    Blokuje działanie do momentu przejścia urządzenia w tryb fastbootd.

    Zgłasza
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    Uruchamia ponownie urządzenie w trybie odzyskiwania adb.

    Blokuje do momentu przejścia urządzenia w tryb odzyskiwania

    Zgłasza
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

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

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

    Zgłasza
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

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

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

    Parametry
    autoReboot boolean: czy po wgraniu aplikacji urządzenie ma się automatycznie uruchomić ponownie.

    Zgłasza
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

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

    Zgłasza
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

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

    Parametry
    reason String: przyczyna ponownego uruchomienia lub null, jeśli nie podano przyczyny.

    Zgłasza
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

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

    Blokuje do momentu, aż urządzenie stanie się dostępne.

    OSTRZEŻENIE. Ponowne uruchamianie w przestrzeni użytkownika jest obecnie w fazie rozwoju. Korzystasz z tej funkcji na własne ryzyko.

    Zgłasza
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

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

    Zgłasza
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

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

    Zwroty
    boolean Wartość true, jeśli próba odzyskania zakończyła się powodzeniem. Wartość false, jeśli odzyskiwanie zostało pominięte.

    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nie jest już dostępne;

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Rejestruje IDeviceActionReceiver na tym urządzeniu.

    Wszystkie zarejestrowane IDeviceActionReceiver zostaną powiadomione przed rozpoczęciem działania urządzenia i po jego zakończeniu.

    Parametry
    deviceActionReceiver IDeviceActionReceiver: IDeviceActionReceiver, który zostanie zarejestrowany.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    Ustaw partycję systemową na urządzeniu jako tylko do odczytu. Może ponownie uruchomić urządzenie.

    Zgłasza
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    Ustaw partycję systemową na urządzeniu jako zapisywalną. Może ponownie uruchomić urządzenie.

    Zgłasza
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

    Ustaw partycję dostawcy na urządzeniu jako tylko do odczytu. Może ponownie uruchomić urządzenie.

    Zgłasza
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Ustaw partycję dostawcy na urządzeniu jako zapisywalną. Może ponownie uruchomić urządzenie.

    Zgłasza
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

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

    Parametry
    componentName String: administratora urządzenia do usunięcia.

    userId int: użytkownika, w którego profilu znajduje się administrator urządzenia.

    Zwroty
    boolean Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”.

    Zgłasza
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Usuń wszystkich obecnych właścicieli profilu urządzenia, dokładając wszelkich starań.

    Zgłasza
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    Usuń danego użytkownika z urządzenia.

    Parametry
    userId int: użytkownika, który ma zostać usunięty.

    Zwroty
    boolean Wartość true, jeśli użytkownik został usunięty. W przeciwnym razie wartość false.

    Zgłasza
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

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

    runInstrumentationTests

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

    Wygodna metoda wykonywania ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z co najmniej 1 odbiorcą przekazanym jako parametr.

    Parametry
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy.

    listeners ITestLifeCycleReceiver: odbiorcy wyników testu

    Zwroty
    boolean true jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go ukończyć, ale przywracanie zakończyło się powodzeniem.

    Zgłasza
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

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

    Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a odzyskiwanie się powiedzie, wszyscy odbiorcy zostaną poinformowani o niepowodzeniu testu, a funkcja zwróci wartość „false”. Polecenie testowe nie zostanie ponownie uruchomione. W razie potrzeby rozmówcy mogą ponowić próbę.

    Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a odzyskiwanie się nie powiedzie, wszyscy odbiorcy zostaną poinformowani o niepowodzeniu testu (testRunFailed), a następnie zostanie zgłoszony wyjątek DeviceNotAvailableException.

    Parametry
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy.

    listeners : odbiorcy wyników testu

    Zwroty
    boolean true jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go ukończyć z powodu wyjątku w komunikacji z urządzeniem, ale przywracanie zakończyło się pomyślnie.

    Zgłasza
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

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

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

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

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    setAdbPath

    public void setAdbPath (String adbPath)

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

    Parametry
    adbPath String

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Wstawia używany element IConfiguration.

    Parametry
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parametry
    avdInfo GceAvdInfo

    setDate

    public void setDate (Date date)

    Ustawia datę na urządzeniu

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

    Parametry
    date Date: określ konkretną datę; jeśli null, użyje daty hosta.

    Zgłasza
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

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

    Parametry
    componentName String: administratora urządzenia na właściciela urządzenia.

    userId int: użytkownika, w którego kraju mieszka właściciel urządzenia.

    Zwroty
    boolean Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”.

    Zgłasza
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Zaktualizuj stan urządzenia.

    Parametry
    deviceState TestDeviceState: TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

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

    Parametry
    output SizeLimitedOutputStream: aby rejestrować dane wyjściowe.

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Ustawia Process, gdy urządzenie jest emulatorem.

    Parametry
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Ustaw opcję fastboot dla urządzenia. Należy go ustawić, gdy urządzenie zostanie po raz pierwszy przydzielone.

    Parametry
    fastbootEnabled boolean: czy na urządzeniu jest dostępny tryb fastboot

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Ustawia ścieżkę do pliku binarnego fastboot, który ma być używany. Wymaga to nadal, aby zasada isFastbootEnabled() miała wartość Prawda, aby włączyć funkcje fastboot.

    Parametry
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

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

    Nowy identyfikator IDevice musi odnosić się do tego samego urządzenia fizycznego co bieżące odniesienie. Ta metoda zostanie wywołana, jeśli DDMS przydzieli nowy obiekt IDevice.

    Parametry
    newDevice IDevice: IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

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

    Parametry
    delay int: opóźnienie w milisekundach

    setOptions

    public void setOptions (TestDeviceOptions options)

    Ustaw TestDeviceOptions na urządzeniu

    Parametry
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Ustawia na urządzeniu podaną wartość właściwości. Wymaga, aby adb root miało wartość true.

    Parametry
    propKey String: klucz, który ma zostać ustawiony.

    propValue String: wartość właściwości do ustawienia.

    Zwroty
    boolean zwraca True, jeśli polecenie setprop zostało wykonane prawidłowo, a w przeciwnym razie zwraca wartość False.

    Zgłasza
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Ustaw numer IDeviceRecovery, który ma być używany na tym urządzeniu. Należy go ustawić, gdy urządzenie zostanie po raz pierwszy przydzielone.

    Parametry
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Służy do określania metody odzyskiwania, która ma być używana w przypadku problemu z komunikacją z urządzeniem. Zalecamy używanie tej metody tylko w razie potrzeby (np. gdy platforma nie działa itp.).

    Parametry
    mode ITestDevice.RecoveryMode: czy tryb „przywracaj tylko do momentu połączenia z siecią” ma być włączony.

    setSetting

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

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

    Parametry
    namespace String

    key String

    value String

    Zgłasza
    DeviceNotAvailableException

    setSetting

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

    Dodaj wartość ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu. Przestrzeń nazw musi być jedną z tych wartości: {"system", "secure", "global"}

    Parametry
    userId int

    namespace String

    key String

    value String

    Zgłasza
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Wstrzykuje instancję ITestLogger

    Parametry
    testLogger ITestLogger

    setTrackingSerial

    public void setTrackingSerial (String trackingSerial)

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

    Parametry
    trackingSerial String

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

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

    Parametry
    useFastbootErase boolean: true, jeśli ma być użyte polecenie fastboot erase, lub false, jeśli ma być użyte polecenie fastboot format.

    startLogcat

    public void startLogcat ()

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

    Nie będzie to miało wpływu, jeśli dane wyjściowe logcat są już rejestrowane. Dane można później pobrać za pomocą funkcji getLogcat.

    Gdy urządzenie nie jest już używane, należy wywołać funkcję stopLogcat().

    Zwykle nie trzeba wywoływać funkcji startLogcat()stopLogcat() w kontekście wywołania TF, ponieważ framework TF uruchamia i zatrzymuje logcat.

    startTradeInModeTesting

    public boolean startTradeInModeTesting (int timeoutMs)

    Włącz tryb testowania wymiany za dopłatą. Urządzenie zostanie wyczyszczone i uruchomione ponownie.

    Parametry
    timeoutMs int

    Zwroty
    boolean Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”.

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

    startUser

    public boolean startUser (int userId)

    Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda nie wykonuje żadnej operacji.

    Parametry
    userId int: użytkownika, aby rozpocząć w tle

    Zwroty
    boolean Wartość true, jeśli użytkownik został uruchomiony w tle.

    Zgłasza
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

    Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda nie wykonuje żadnej operacji. Możesz podać dodatkową flagę, aby poczekać, aż operacja zacznie działać.

    Parametry
    userId int: użytkownika, aby rozpocząć w tle

    waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany.

    Zwroty
    boolean Wartość true, jeśli użytkownik został uruchomiony w tle.

    Zgłasza
    DeviceNotAvailableException

    startVisibleBackgroundUser

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

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

    UWAGA: to polecenie nie sprawdza, czy użytkownik istnieje, czy wyświetlacz jest dostępny, device supports such feature itp.

    Parametry
    userId int: użytkownika, aby rozpocząć w tle

    displayId int: wyświetlany użytkownikowi na początku

    waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany.

    Zwroty
    boolean true – jeśli użytkownikowi udało się uruchomić widoczną w tle aplikację.

    Zgłasza
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Zamknij i usuń dane wyjściowe emulatora.

    stopLogcat

    public void stopLogcat ()

    Zatrzymuje rejestrowanie danych wyjściowych logcat z urządzenia i odrzuca aktualnie zapisane dane logcat.

    Nie będzie mieć wpływu, jeśli dane wyjściowe logcat nie są rejestrowane.

    stopTradeInModeTesting

    public void stopTradeInModeTesting ()

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

    Zgłasza
    DeviceNotAvailableException

    stopUser

    public boolean stopUser (int userId)

    Zatrzymuje danego użytkownika. Jeśli użytkownik jest już zatrzymany, ta metoda nie wykonuje żadnych działań. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.

    Parametry
    userId int: użytkownika, którego chcesz zatrzymać.

    Zwroty
    boolean Wartość true, jeśli użytkownik został zatrzymany.

    Zgłasza
    DeviceNotAvailableException

    stopUser

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

    Zatrzymanie danego użytkownika. Można podać dodatkowe flagi, aby poczekać na wprowadzenie zmian, i wymusić zakończenie sesji użytkownika. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.

    Parametry
    userId int: użytkownika, którego chcesz zatrzymać.

    waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik się zatrzyma.

    forceFlag boolean: wymusi zatrzymanie użytkownika.

    Zwroty
    boolean Wartość true, jeśli użytkownik został zatrzymany.

    Zgłasza
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

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

    Zwroty
    String numer seryjny urządzenia TCP lub null, jeśli nie można było przełączyć urządzenia.

    Zgłasza
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

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

    Zwroty
    boolean true, jeśli przełączanie się powiodło, w przeciwnym razie false.

    Zgłasza
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId)

    Przełącz na inny identyfikator użytkownika z domyślnym czasem oczekiwania. switchUser(int, long).

    Parametry
    userId int

    Zwroty
    boolean Wartość „true”, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.

    Zgłasza
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId, 
                    long timeout)

    Przełącz na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem. Próba wyłączenia blokady ekranu po zmianie użytkownika zakończyła się powodzeniem.

    Parametry
    userId int

    timeout long: czas oczekiwania przed zwróceniem wartości false w przypadku niepowodzenia przełączania użytkownika.

    Zwroty
    boolean Wartość „true”, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.

    Zgłasza
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

    Decyduje, które pliki przesłać, porównując sygnatury czasowe plików lokalnych z ich zdalnymi odpowiednikami. Na urządzenie zostaną przesłane tylko „nowsze” lub nieistniejące pliki. Dlatego obciążenie powinno być stosunkowo małe, jeśli zestaw plików na urządzeniu jest już aktualny.

    Ukryte pliki (których nazwy zaczynają się od „.”) zostaną zignorowane.

    Przykład użycia: syncFiles("/tmp/files", "/sdcard") utworzy katalog /sdcard/files, jeśli jeszcze nie istnieje, i rekursywnie przeniesie zawartość /tmp/files do /sdcard/files.

    Parametry
    localFileDir File: lokalny katalog plików zawierający pliki do rekurencyjnego wypychania.

    deviceFilePath String: ścieżka bezwzględna do katalogu głównego zdalnego miejsca docelowego. Wszystkie katalogi w tej ścieżce pliku muszą być czytelne. Na przykład próba przesłania pliku do katalogu /data/local/tmp, gdy adb nie ma uprawnień roota, zakończy się niepowodzeniem.

    Zwroty
    boolean true, jeśli pliki zostały zsynchronizowane. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    Pobiera raport o błędzie i zwraca go w obiekcie Bugreport, aby go obsłużyć. W razie problemu zwraca wartość null. Plik, do którego odwołuje się obiekt Bugreport, musi zostać wyczyszczony za pomocą funkcji Bugreport.close().

    Zwroty
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Odinstaluj pakiet Androida z urządzenia.

    Parametry
    packageName String: pakiet na Androida do odinstalowania.

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

    Zgłasza
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

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

    Parametry
    packageName String: pakiet na Androida do odinstalowania.

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

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

    Zgłasza
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

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

    Ta metoda może ponownie uruchomić platformę, ale nie wywoła funkcji postBootSetup(). Dlatego urządzenie może nie być w pełni gotowe do testowania, gdy ta metoda zwróci wynik.

    Zwroty
    boolean true – jeśli operacja się powiedzie lub urządzenie nie jest zaszyfrowane.

    Zgłasza
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Odłącz debugfs.

    Zgłasza
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

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

    Parametry
    timeOut long: czas w milisekundach, przez jaki należy czekać na ustawienie flagi.

    Zwroty
    boolean wartość true, jeśli flaga zakończenia uruchamiania urządzenia jest ustawiona w okresie oczekiwania;

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania. Używa domyślnego limitu czasu.

    Zwroty
    boolean Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli przywracanie jest wyłączone i niedostępne.

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

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

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zwroty
    boolean Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli przywracanie jest wyłączone i niedostępne.

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Parametry
    waitTime long

    Zwroty
    boolean Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli jest niedostępne.

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Blokuje działanie, dopóki urządzenie nie będzie widoczne w trybie fastboot. Użyj domyślnego limitu czasu.

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceFastbootD

    public void waitForDeviceFastbootD ()

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

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

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zwroty
    boolean true jeśli urządzenie uruchomi się w trybie odzyskiwania przed upływem czasu. W innych przypadkach false

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blokuje możliwość przejścia urządzenia w stan „adb sideload”

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zwroty
    boolean true, jeśli urządzenie uruchomi się w trybie sideload przed upływem czasu. W innych przypadkach false

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

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

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zwroty
    boolean true, jeśli urządzenie stanie się niedostępne przed upływem czasu. W innych przypadkach false

    waitForDeviceOnline

    public void waitForDeviceOnline ()

    Blokuje, dopóki urządzenie nie będzie widoczne przez adb. Używa domyślnego limitu czasu

    Pamiętaj, że po zakończeniu procesu urządzenie może nie reagować na polecenia. Zamiast niej używaj zasady waitForDeviceAvailable().

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

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

    Pamiętaj, że po zakończeniu procesu urządzenie może nie reagować na polecenia. Zamiast niej używaj zasady waitForDeviceAvailable().

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zgłasza
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

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

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zwroty
    boolean true, jeśli urządzenie zacznie odpowiadać przed upływem czasu waitTime.

    Metody chronione

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parametry
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

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

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

    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)

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

    Parametry
    rebootMode NativeDevice.RebootMode: tryb ponownego uruchomienia.

    reason String: w przypadku tego ponownego uruchomienia.

    Zwroty
    NativeDevice.RebootDeviceAction utworzony RebootDeviceAction.

    createRunUtil

    protected IRunUtil createRunUtil ()

    Zwroty
    IRunUtil

    doAdbReboot

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

    Wykonaj ponowne uruchomienie za pomocą ADB.

    Parametry
    rebootMode NativeDevice.RebootMode: tryb ponownego uruchomienia.

    reason String: w przypadku tego ponownego uruchomienia.

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

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    metoda pomocnicza do zgłaszania wyjątku, jeśli uprawnienia czasu działania nie są obsługiwane;

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

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Zwroty
    int

    getLogger

    protected ITestLogger getLogger ()

    Zwroty
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

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

    Zwroty
    IRunUtil

    internalGetProperty

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

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

    Parametry
    propName String: nazwa właściwości urządzenia zwrócona przez polecenie `adb shell getprop`

    fastbootVar String: nazwa odpowiedniej zmiennej fastboot, o którą chcesz wysłać zapytanie. Jeśli null, zapytanie fastboot nie zostanie wysłane.

    description String: Prosty opis zmiennej. Pierwsza litera powinna być duża.

    Zwroty
    String Ciąg tekstowy, który może zawierać wartość null lub być pusty, zawierający wartość danej właściwości.

    Zgłasza
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

    Zwraca informację, czy wywołania zwrotne ponownego uruchomienia są obecnie wykonywane. Jeśli wartość jest prawdziwa, wszystkie publiczne interfejsy API do ponownego uruchamiania powinny być wyłączone.

    Zwroty
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Zwraca true, jeśli plik lokalny jest nowszy niż plik zdalny. IFileEntry dokładny co do minuty. W przypadku równych czasów plik zostanie uznany za nowszy.

    Parametry
    localFile File

    entry IFileEntry

    Zwroty
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    Wysyła powiadomienie do wszystkich IDeviceActionReceiver o zakończeniu ponownego uruchamiania.

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

    notifyRebootStarted

    protected void notifyRebootStarted ()

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

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

    performDeviceAction

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

    Wykonuje działanie na tym urządzeniu. Próbuje przywrócić urządzenie i opcjonalnie ponowić wykonanie polecenia, jeśli działanie się nie powiedzie.

    Parametry
    actionDescription String: krótki opis działania, które ma zostać wykonane. Służy tylko do rejestrowania.

    action NativeDevice.DeviceAction: działanie do wykonania

    retryAttempts int: ponowna próba wykonania działania w przypadku niepowodzenia, ale odzyskania danych

    Zwroty
    boolean true, jeśli działanie zostało wykonane

    Zgłasza
    DeviceNotAvailableException jeśli próba odzyskania się nie powiedzie lub osiągnięto maksymalną liczbę prób bez powodzenia;

    postAdbReboot

    protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

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

    Parametry
    rebootMode NativeDevice.RebootMode

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

    prePostBootSetup

    protected void prePostBootSetup ()

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

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

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Parametry
    remoteFilePath String

    localFile File

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    setClock

    protected void setClock (Clock clock)

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

    Parametry
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Oznacza urządzenie testowe jako microdroid i ustawia jego identyfikator klienta.

    Parametry
    process Process: proces maszyny wirtualnej Microdroid.

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    Parametry
    deviceOptions

    simpleFastbootCommand

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

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

    Parametry
    timeout long

    envVarMap

    fullCmd String

    Zwroty
    CommandResult

    simpleFastbootCommand

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

    Wykonuje proste polecenie fastboot i zgłasza jego stan.

    Parametry
    timeout long

    fullCmd String

    Zwroty
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

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

    Parametry
    operationDesc String: nazwa operacji, która oczekuje na niedostępność.

    time long: czas oczekiwania na wystąpienie stanu niedostępności.

    Zwroty
    boolean Wartość „prawda”, jeśli urządzenie stało się niedostępne.