NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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


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

Podsumowanie

Zagnieżdżone klasy

class NativeDevice.AdbAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) do uruchamiania polecenia „adb…” w systemie operacyjnym. 

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) aby ponownie uruchomić urządzenie. 

Stałe

int INVALID_USER_ID

Wartość zwrócona w przypadku nieprawidłowego lub niewykrytego identyfikatora użytkownika: UserHandle zdefiniował wartość -10000

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

domyślna liczba prób ponownego wykonania polecenia,

Fieldsem

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Konstruktory publiczne

NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Tworzy TestDevice.

Metody publiczne

void batchPrefetchStartupBuildProps()

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

boolean canSwitchToHeadlessSystemUser()

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

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Sprawdź, czy dana funkcja jest obecnie obsługiwana z uwzględnieniem minimalnego poziomu obsługi.

boolean checkConnectivity()

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

boolean clearErrorDialogs()

Spróbuj zamknąć wszystkie okna z błędami wyświetlane obecnie w interfejsie urządzenia.

void clearLastConnectedWifiNetwork()

Czyści ostatnią połączoną sieć Wi-Fi.

void clearLogcat()

Usuwa wszystkie zgromadzone dane logcat.

boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

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

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

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

boolean connectToWifiNetwork( wifiSsidToPsk)

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

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

Połącza 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 internetem.

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

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

Utwórz użytkownika z danym imieniem i podanymi flagami

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

Utwórz użytkownika z danym imieniem i podanymi flagami

int createUser(String name)

Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.

int createUserNoThrow(String name)

Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.

void deleteFile(String deviceFilePath, int userId)

Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu.

void deleteFile(String deviceFilePath)

Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu.

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Metoda pomocnicza służąca do sprawdzania, czy urządzenie zostało zrestartowane, porównując bieżący system_server z poprzednim system_server ProcessInfo.

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Metoda pomocnicza służąca do sprawdzania, czy urządzenie zostało zrestartowane od czasu UTC od początku epoki na urządzeniu i jego ERROR(/TimeUnit).

boolean disableAdbRoot()

Wyłącza rootowanie adb.

void disableKeyguard()

Próbuje wyłączyć blokadę klawiatury.

boolean disableNetworkMonitor()

Wyłącza monitorowanie sieci na urządzeniu.

boolean disconnectFromWifi()

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

boolean doesFileExist(String deviceFilePath, int userId)

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

boolean doesFileExist(String deviceFilePath)

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

File dumpHeap(String process, String devicePath)

Spróbuj zrzucić stos z system_server.

boolean enableAdbRoot()

Włącza rootowanie adb.

boolean enableNetworkMonitor()

Umożliwia monitorowanie sieci na urządzeniu.

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

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym 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 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, aby kontrolować zachowanie 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, aby kontrolować zachowanie polecenia.

void executeShellCommand(String command, IShellOutputReceiver receiver)

Wykonuje podane polecenie adb shell, powtarzając próbę kilka razy, jeśli polecenie się nie powiedzie.

CommandResult executeShellV2Command(String cmd)

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

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako CommandResult wypełnione odpowiednimi danymi wyjściowymi polecenia i stderr.

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako obiekt CommandResult wypełniony odpowiednimi danymi wyjściowymi polecenia, tj. stdout i stderr.

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

Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie polecenia.

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

Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie 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, aby kontrolować zachowanie 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, aby kontrolować zachowanie polecenia.

CommandResult fastbootWipePartition(String partition)

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

getActiveApexes()

Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.

getAllSettings(String namespace)

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

DeviceAllocationState getAllocationState()

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

String getAndroidId(int userId)

Znajdź i zwróć identyfikator android-id powiązany z userId, null, jeśli nie znaleziono.

getAndroidIds()

Utwórz mapę identyfikatorów Androida, które pasują do identyfikatorów użytkowników.

int getApiLevel()

Pobierz poziom interfejsu API urządzenia.

PackageInfo getAppPackageInfo(String packageName)

Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.

getAppPackageInfos()

Pobierać informacje 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 jest niedostępny.

boolean getBooleanProperty(String name, boolean defaultValue)

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

getBootHistory()

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

getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchomienia od podanego czasu od epoki na urządzeniu i z określonej jednostki czasu.

String getBootloaderVersion()

Wygodna metoda uzyskania wersji programu rozruchowego tego urządzenia.

InputStreamSource getBugreport()

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

InputStreamSource getBugreportz()

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

String getBuildAlias()

Pobierz alias kompilacji, która jest obecnie używana na urządzeniu.

String getBuildFlavor()

Pobierz wersję kompilacji dla urządzenia.

String getBuildId()

Pobierz wersję, która jest obecnie uruchomiona na urządzeniu.

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 element DeviceDescriptor z pamięci podręcznej, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżący element DeviceDescriptor.

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Zwraca element DeviceDescriptor z pamięci podręcznej, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżący element DeviceDescriptor.

String[] getChildren(String path)

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

AbstractConnection getConnection()

Bieżące 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 lub wartość null, jeśli wystąpiły jakieś problemy.

int getCurrentUser()

Zwraca identyfikator bieżącego użytkownika.

String getDeviceClass()

Pobieranie klasy urządzenia.

long getDeviceDate()

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

DeviceDescriptor getDeviceDescriptor()

Zwracaj DeviceDescriptor z informacjami o urządzeniu, aby uzyskać informacje o nim bez przekazywania rzeczywistego obiektu urządzenia.

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Zwracaj DeviceDescriptor z informacjami o urządzeniu, aby uzyskać informacje o nim bez przekazywania rzeczywistego obiektu urządzenia.

TestDeviceState getDeviceState()

Pobierz stan urządzenia.

long getDeviceTimeOffset(Date date)

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

InputStreamSource getEmulatorOutput()

Pobieranie strumienia danych z wyjścia standardowego i błędów emulatora

Process getEmulatorProcess()

Zwraca Process odpowiadający temu emulatorowi.

final File getExecuteShellCommandLog()

Dziennik zawierający wszystkie logi executeShellCommand(String).

long getExternalStoreFreeSpace()

Metoda pomocnicza służąca do określenia ilości wolnego miejsca na zewnętrznej pamięci urządzenia.

String getFastbootPath()

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

String getFastbootProductType()

Wygodna metoda uzyskiwania typu urządzenia w trybie Fastboot.

String getFastbootProductVariant()

Wygodna metoda uzyskiwania typu urządzenia w trybie Fastboot.

String getFastbootSerialNumber()

Zwraca numer seryjny trybu fastboot.

String getFastbootVariable(String variableName)

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

String getFastbootVersion()

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

IFileEntry getFileEntry(String path)

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

IFileEntry getFileEntry(FileListingService.FileEntry entry)

Nieoficjalna pomoc w przypadku FileEntry z ścieżki niebędącej ścieżką główną.

getFoldableStates()

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

IDevice getIDevice()

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

getInstalledPackageNames()

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

long getIntProperty(String name, long defaultValue)

Zwraca wartość liczby całkowitej danej właściwości na urządzeniu.

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 on obsługiwany.

long getLastExpectedRebootTimeMillis()

Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie (w milisekundach od EPOCH), zwracany przez System.currentTimeMillis().

int getLaunchApiLevel()

Uzyskaj poziom interfejsu API, który został po raz pierwszy uruchomiony na urządzeniu.

InputStreamSource getLogcat()

Pobiera strumień zrzutów danych logcat.

InputStreamSource getLogcat(int maxBytes)

Pobiera strumień zrzutów ostatnich maxBytes zarchiwizowanych danych logcat.

InputStreamSource getLogcatDump()

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

InputStreamSource getLogcatSince(long date)

Pobiera strumień zrzutów z zapisanymi danymi logcat od podanej daty.

String getMacAddress()

Zwraca adres MAC urządzenia. Jeśli nie uda się wysłać zapytania do urządzenia, zwraca wartość null.

Integer getMainUserId()

Zwraca identyfikator głównego użytkownika.

getMainlineModuleInfo()

Pobieranie informacji o głównych modułach zainstalowanych na urządzeniu.

int getMaxNumberOfRunningUsersSupported()

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

int getMaxNumberOfUsersSupported()

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

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

Zwracaj IDeviceStateMonitor powiązany z urządzeniem.

String getMountPoint(String mountName)

Zwraca punkt podłączenia.

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

Zwraca MountPointInfo odpowiadający określonej ścieżce punktu podłączania lub null, jeśli ta ścieżka nie ma nic podłączonego lub w inny sposób nie pojawia się w /proc/mounts jako punkt podłączania.

getMountPointInfo()

Zwraca zanalizowaną wersję informacji w katalogu /proc/mounts na urządzeniu.

TestDeviceOptions getOptions()

Pobierz opcje testowania urządzenia.

long getPartitionFreeSpace(String partition)

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

Integer getPrimaryUserId()

Zwraca podstawowy identyfikator użytkownika.

ProcessInfo getProcessByName(String processName)

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

String getProcessPid(String process)

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

String getProductType()

Wygodna metoda uzyskiwania typu produktu na tym urządzeniu.

String getProductVariant()

Wygodna metoda uzyskiwania wersji produktu tego urządzenia.

String getProperty(String name)

Pobierać z urządzenia określoną wartość właściwości.

ITestDevice.RecoveryMode getRecoveryMode()

Uzyskaj informacje o bieżącym trybie odzyskiwania używanym na urządzeniu.

InputStreamSource getScreenshot(long displayId)

Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania.

InputStreamSource getScreenshot(String format)

Robi zrzut ekranu z urządzenia.

InputStreamSource getScreenshot(String format, boolean rescale)

Robi zrzut ekranu z urządzenia.

InputStreamSource getScreenshot()

Robi zrzut ekranu z urządzenia.

String getSerialNumber()

Wygodna metoda uzyskania numeru seryjnego tego urządzenia.

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

Zwraca wartość żądanego ustawienia.

String getSetting(String namespace, String key)

Zobacz getSetting(int, String, String) i wykonane przez użytkownika systemowego.

String getSimOperator()

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

String getSimState()

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

getTombstones()

Pobiera i zwraca z urządzeń listę nagrobków.

long getTotalMemory()

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

String getTrackingSerial()

Aby zarządzać urządzeniem, uzyskaj numer seryjny używany do śledzenia urządzenia.

getUninstallablePackageNames()

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

boolean getUseFastbootErase()

Określ, czy chcesz użyć fastboot erase czy fastboot format do wyczyszczenia partycji na urządzeniu.

int getUserFlags(int userId)

Znajdowanie i zwracanie flag danego użytkownika.

getUserInfos()

Pobiera mapę useId na urządzeniu do UserInfo.

int getUserSerialNumber(int userId)

W przeciwnym razie zwraca -10000.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

Przetwarzanie podanego zdarzenia DeviceEvent.

Przetwarzanie zdarzenia dotyczącego urządzenia, które może, ale nie musi spowodować przeniesienie urządzenia do nowego stanu alokacji.

boolean hasFeature(String feature)

Sprawdzanie, czy funkcja jest dostępna na urządzeniu

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

Zainstaluj na urządzeniu pakiet Androida.

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

Zainstaluj na urządzeniu pakiet Androida.

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

Instalowanie pakietu Androida na urządzeniu danego użytkownika.

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

Instalowanie pakietu Androida na urządzeniu danego użytkownika.

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

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

boolean isBypassLowTargetSdkBlockSupported()

Sprawdź, czy platforma na urządzeniu obsługuje pomijanie blokady niskiego docelowego poziomu interfejsu SDK podczas instalowania aplikacji

boolean isDebugfsMounted()

Sprawdź, czy debugfs jest zamontowany.

boolean isDeviceEncrypted()

Zwraca wartość wskazującą, czy urządzenie jest zaszyfrowane.

boolean isDirectory(String path)

Zwraca wartość „True”, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość „False”.

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

Zwraca wartość wskazującą, czy szyfrowanie jest obsługiwane na urządzeniu.

boolean isExecutable(String fullPath)

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

boolean isFastbootEnabled()

Zwracaj, jeśli na urządzeniu jest dostępny tryb Fastboot.

boolean isHeadless()

Zwraca wartość true, jeśli urządzenie jest bez głowicy (bez ekranu), w przeciwnym razie zwraca wartość false.

boolean isHeadlessSystemUserMode()

Zwraca informację, czy urządzenie używa trybu użytkownika systemu bez interfejsu graficznego.

boolean isMainUserPermanentAdmin()

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

boolean isMultiUserSupported()

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

boolean isPackageInstalled(String packageName, String userId)

Przesyłanie zapytania do urządzenia o określonej nazwie pakietu i określonym identyfikatorem użytkownika w celu sprawdzenia, czy aplikacja jest obecnie zainstalowana na tym urządzeniu.

boolean isPackageInstalled(String packageName)

Wyszukaj na urządzeniu daną nazwę pakietu, aby sprawdzić, czy jest on zainstalowany.

boolean isRuntimePermissionSupported()

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

boolean isStateBootloaderOrFastbootd()

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

boolean isUserRunning(int userId)

Sprawdź, czy dany użytkownik jest obecny.

boolean isUserSecondary(int userId)

Zwraca informację, czy podany 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 informacje o tym, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji w tle w konfiguracji ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

boolean isVisibleBackgroundUsersSupported()

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

boolean isWifiEnabled()

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

listDisplayIds()

Pobierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, jak podaje „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 na urządzeniu.

boolean logBugreport(String dataName, ITestLogger listener)

Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w raportach dla zgłaszających.

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

Zaloguj wiadomość w logcat urządzenia.

void mountDebugfs()

Zamontuj debugfs.

void nonBlockingReboot()

Wydając polecenie ponownego uruchomienia urządzenia, wraca po jego wykonaniu i gdy urządzenie nie jest już widoczne dla adb.

void postAdbRootAction()

Zastąpić, jeśli urządzenie wymaga wykonania określonych czynności po uzyskaniu uprawnień root w adb, zanim urządzenie będzie mogło ponownie połączyć się z internetem.

void postAdbUnrootAction()

Zastąpić, jeśli urządzenie wymaga wykonania określonych czynności po usunięciu uprawnień roota za pomocą adb, a przed przywróceniem urządzenia do trybu online.

void postBootSetup()

Postępuj zgodnie z instrukcjami, aby skonfigurować urządzenie do testowania po każdym uruchomieniu.

void postInvocationTearDown(Throwable exception)

Dodatkowe czynności związane z czyszczeniem, które są wymagane na urządzeniu, zostaną wykonane po zakończeniu wywołania.

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

Dodatkowe czynności wymagane na urządzeniu, które zostaną wykonane na urządzeniu przed rozpoczęciem procesu wywołania.

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

Rekursywnie pobieraj zawartość katalogu z urządzenia.

boolean pullDir(String deviceFilePath, File localDir)

Rekursywnie pobieraj zawartość katalogu z urządzenia.

boolean pullFile(String remoteFilePath, File localFile)

Pobiera plik z urządzenia.

File pullFile(String remoteFilePath, int userId)

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

File pullFile(String remoteFilePath)

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

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

Pobiera plik z urządzenia.

String pullFileContents(String remoteFilePath)

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

File pullFileFromExternal(String remoteFilePath)

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

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

Rekursywnie przesyłaj zawartość katalogu na urządzenie, wykluczając niektóre katalogi, które są filtrowane.

boolean pushDir(File localFileDir, String deviceFilePath)

Rekursywnie przesyłaj zawartość katalogu na urządzenie.

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

Rekursywnie przesyłaj zawartość katalogu na urządzenie.

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

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

boolean pushFile(File localFile, String remoteFilePath)

Przesyłanie pliku na urządzenie.

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

Przesyłanie pliku na urządzenie.

boolean pushString(String contents, String remoteFilePath)

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

void reboot(String reason)

Uruchom ponownie urządzenie w trybie adb z danymi reason, które mają być zachowane po ponownym uruchomieniu.

void reboot()

Uruchom ponownie urządzenie w trybie adb.

void rebootIntoBootloader()

Uruchamia ponownie urządzenie w trybie programu rozruchowego.

void rebootIntoFastbootd()

Uruchom ponownie urządzenie w trybie Fastboot.

void rebootIntoRecovery()

Uruchom ponownie urządzenie w trybie odzyskiwania adb.

void rebootIntoSideload()

Uruchom ponownie urządzenie w trybie ładowania bocznego adb (zauważ, że jest to specjalny tryb w ramach funkcji odzyskiwania).

Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload

void rebootIntoSideload(boolean autoReboot)

Uruchom ponownie urządzenie w trybie ładowania bocznego adb (zauważ, że jest to specjalny tryb w ramach funkcji odzyskiwania).

Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload

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

Uruchomi ponownie tylko część 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óby przywrócenia komunikacji 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 partycję do zapisu.

void remountVendorReadOnly()

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

void remountVendorWritable()

Ustaw partycję dostawcy na urządzeniu jako partycję do zapisu.

boolean removeAdmin(String componentName, int userId)

Usuń danego administratora urządzenia w danym użytkowniku i wróć true, jeśli operacja się powiedzie, w przeciwnym razie false.

void removeOwners()

Usuń wszystkich dotychczasowych właścicieli profilu urządzenia.

boolean removeUser(int userId)

usunąć danego użytkownika z urządzenia,

void resetContentProviderSetup()

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

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

Metoda ułatwiająca wykonywanie funkcji ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z jednym lub większą liczbą podsłuchujących przekazanych jako parametry.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

Uruchamia testy z instrumentacją i zapewnia odzyskiwanie urządzenia.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)

To samo co ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), ale test jest przeprowadzany w przypadku danego użytkownika.

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

To samo co ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), ale test jest przeprowadzany w przypadku danego użytkownika.

void setConfiguration(IConfiguration configuration)

Wstrzykuje IConfiguration w użyciu.

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

ustawia datę na urządzeniu;

Uwaga: ustawienie daty na urządzeniu wymaga uprawnień 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 emulatorze ustaw SizeLimitedOutputStream na rejestrowanie danych wyjściowych.

void setEmulatorProcess(Process p)

Ustawia Process, gdy to urządzenie jest emulatorem.

void setFastbootEnabled(boolean fastbootEnabled)

Ustaw opcję fastboot na urządzeniu.

void setFastbootPath(String fastbootPath)

Ustawia ścieżkę do binarnego pliku fastboot, którego należy użyć.

void setIDevice(IDevice newDevice)

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

void setLogStartDelay(int delay)

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

void setOptions(TestDeviceOptions options)

Ustaw TestDeviceOptions na urządzeniu

boolean setProperty(String propKey, String propValue)

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

void setRecovery(IDeviceRecovery recovery)

Ustaw IDeviceRecovery do użycia na tym urządzeniu.

void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

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

Zobacz setSetting(int, String, String, String) i wykonane przez użytkownika systemowego.

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

Dodanie wartości ustawienia do przestrzeni nazw danego użytkownika.

void setTestLogger(ITestLogger testLogger)

Wstrzykuje instancję ITestLogger

void setTrackingSerial(String trackingSerial)

W celu zarządzania urządzeniami śledź numer seryjny, którego używamy do identyfikowania urządzenia.

void setUseFastbootErase(boolean useFastbootErase)

Określ, czy chcesz użyć fastboot erase (szybkie kasowanie) czy fastboot format (szybkie formatowanie) do wyczyszczenia partycji na urządzeniu.

void startLogcat()

Rozpocznij przechwytywanie danych logcat z urządzenia w tle.

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 pozwala użytkownikowi uruchamiać na nim działania).

void stopEmulatorOutput()

Zamknij i usuń dane wyjściowe emulatora.

void stopLogcat()

Zatrzymaj przechwytywanie danych logcat z urządzenia i usuń zapisane dane logcat.

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

boolean switchUser(int userId)

Przełącz się na innego użytkownika o domyślnym czasie oczekiwania.

boolean switchUser(int userId, long timeout)

Przełącz się na innego użytkownika z podanym czasem oczekiwania jako terminem.

boolean syncFiles(File localFileDir, String deviceFilePath)

Synchronizuje stopniowo zawartość lokalnego katalogu plików na urządzeniu.

Bugreport takeBugreport()

Przyjmuje zgłoszenie o błędzie i zwraca je w obiekcie Bugreport, aby je 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 danego użytkownika.

boolean unlockDevice()

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

void unmountDebugfs()

Odmontuj debugfs.

boolean waitForBootComplete(long timeOut)

Blokuje do momentu ustawienia flagi „boot complete”.

boolean waitForDeviceAvailable()

Czeka, aż urządzenie będzie gotowe do testowania.

boolean waitForDeviceAvailable(long waitTime)

Czeka, aż urządzenie będzie gotowe do testowania.

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Czeka, aż urządzenie będzie gotowe do działania i dostępne, bez uwzględniania ścieżki odzyskiwania.

void waitForDeviceBootloader()

Blokuje, dopóki urządzenie nie będzie widoczne w Fastboot.

boolean waitForDeviceInRecovery(long waitTime)

Blokuje urządzenie w stanie „adb recovery” (uwaga: jest to stan inny niż IDeviceRecovery).

boolean waitForDeviceInSideload(long waitTime)

Blokuje urządzenie w stanie „adb sideload”.

boolean waitForDeviceNotAvailable(long waitTime)

Blokuje dostęp do urządzenia, np. uniemożliwia dostęp do adb.

void waitForDeviceOnline()

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

void waitForDeviceOnline(long waitTime)

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

boolean waitForDeviceShell(long waitTime)

Czeka, aż urządzenie zareaguje na podstawowe polecenie adb shell.

Chronione metody

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

Tworzy polecenie systemu operacyjnego dla danej sesji polecenia adb shell 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 wykonywania działania ponownego uruchamiania.

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

Uruchom ponownie urządzenie za pomocą adb.

void ensureRuntimePermissionSupported()

metoda pomocnicza do rzucania wyjątkiem, jeśli uprawnienia czasu działania nie są obsługiwane

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

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

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

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

boolean isInRebootCallback()

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

boolean isNewer(File localFile, IFileEntry entry)

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

void notifyRebootEnded()

Informuje wszystkie IDeviceActionReceiver o zdarzeniu zakończenia ponownego uruchamiania.

void notifyRebootStarted()

Informuje wszystkie IDeviceActionReceiver o zdarzeniu rozpoczęcia ponownego uruchamiania.

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

Wykonywanie czynności na tym urządzeniu.

void postAdbReboot()

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 przypadku określonej 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 ustala jego identyfikator CID.

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

Wykonuje proste polecenie fastboot z użyciem zmiennych środowiskowych i zgłasza stan tego 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

INVALID_USER_ID

public static final int INVALID_USER_ID

Wartość zwrócona w przypadku nieprawidłowego lub niewykrytego 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 prób ponownego wykonania polecenia,

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

Fieldsem

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Konstruktory publiczne

NativeDevice

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

Tworzy TestDevice.

Parametry
device IDevice: powiązany IDevice

stateMonitor IDeviceStateMonitor: mechanizm IDeviceStateMonitor do użycia

allocationMonitor IDeviceMonitor: IDeviceMonitor, aby poinformować o zmianach stanu alokacji. Może być puste

Metody publiczne

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Mikrooptymalizacja (około 400 ms) polegająca na pobieraniu w poprzednim etapie wszystkich potrzebnych nam obiektów zamiast wywoływania dla każdego z nich polecenia „adb getprop”. Oznacza to, że pobieranie wszystkich właściwości jest tak samo szybkie jak pobieranie jednej z nich. Funkcje takie jak device.getApiLevel(), checkApiLevelAgainstNextRelease i getBuildAlias wywołują w tle polecenie `adb getprop`. Pobieramy je w jednym wywołaniu i wywołujemy metodę NativeDevice.setProperty. Nawet jeśli tego nie zrobimy, NativeDevice sam wywoła metodę setProperty i zapisze wynik w pamięci podręcznej na potrzeby przyszłych wywołań. Robimy to tylko nieco wcześniej. Jeśli urządzenie jest w procesie przywracania lub występują inne błędy podczas pobierania rekwizytów, ignorujemy je.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Zwroty
boolean

Rzuty
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Sprawdź, czy dana funkcja jest obecnie obsługiwana z uwzględnieniem minimalnego poziomu obsługi. Ta metoda uwzględnia funkcje, które nie zostały jeszcze opublikowane, zanim podniesiesz poziom interfejsu API.

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

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

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

Rzuty
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

Spróbuj zamknąć wszystkie okna z błędami wyświetlane obecnie w interfejsie urządzenia.

Zwroty
boolean true, jeśli nie było żadnych dialogów lub zostały one usunięte. false w innych przypadkach.

Rzuty
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Czyści ostatnią połączoną sieć Wi-Fi. Należy go wywołać podczas uruchamiania nowego wywołania, aby uniknąć łączenia się z siecią Wi-Fi użytą w poprzednim teście po ponownym uruchomieniu urządzenia.

clearLogcat

public void clearLogcat ()

Usuwa wszystkie zgromadzone dane logcat.

Jest to przydatne, gdy chcesz mieć pewność, że ITestDevice.getLogcat() zwróci tylko dane dziennika utworzone po określonym momencie (np. po przeflashowaniu nowej wersji urządzenia).

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

Włącza Wi-Fi i blokuje 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 z hasłami.

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

Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku

Rzuty
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

Włącza Wi-Fi i blokuje 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: nazwa sieci Wi-Fi, z którą chcesz się połączyć

wifiPsk String: hasło PSK lub null, jeśli nie jest zaszyfrowane

Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku

Rzuty
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

Włącza Wi-Fi i blokuje 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 z hasłami.

Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku

Rzuty
DeviceNotAvailableException

connectToWifiNetwork

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

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

Włącza Wi-Fi i blokuje 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: nazwa sieci Wi-Fi, z którą chcesz się połączyć

wifiPsk String: hasło PSK lub null, jeśli nie jest zaszyfrowane

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

Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku

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

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

Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku

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

Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku

Rzuty
DeviceNotAvailableException

createUser

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

Utwórz użytkownika z danym imieniem i podanymi flagami

Parametry
name String: użytkownika, którego chcesz utworzyć na urządzeniu

guest boolean: włącz flagę użytkownika – gość podczas tworzenia.

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

Zwroty
int identyfikator utworzonego użytkownika.

Rzuty
DeviceNotAvailableException

createUser

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

Utwórz użytkownika z danym imieniem i podanymi flagami

Parametry
name String: użytkownika, którego chcesz utworzyć na urządzeniu

guest boolean: włącz flagę użytkownika – gość podczas tworzenia.

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

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

Zwroty
int identyfikator utworzonego użytkownika.

Rzuty
DeviceNotAvailableException

createUser

public int createUser (String name)

Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.

Parametry
name String: użytkownika, którego chcesz utworzyć na urządzeniu

Zwroty
int liczba całkowita identyfikatora użytkownika,

Rzuty
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.

Parametry
name String: użytkownika, którego chcesz utworzyć na urządzeniu

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

Rzuty
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu.

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

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

Rzuty
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath)

Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu.

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

Rzuty
DeviceNotAvailableException

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver.

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

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metoda pomocnicza służąca do sprawdzania, czy urządzenie zostało zrestartowane, przez porównanie bieżącego system_server z poprzednim system_server ProcessInfo. Aby skorzystać z promocji ProcessInfo, użyj getProcessByName(String).

Parametry
prevSystemServerProcess ProcessInfo: poprzedni proces system_serverProcessInfo.

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

Rzuty
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metoda pomocnicza służąca do sprawdzania, czy urządzenie zostało zrestartowane od czasu UTC od początku epoki na urządzeniu i jego ERROR(/TimeUnit). Miękki restart oznacza ponowne uruchomienie system_server poza twardym restartem urządzenia (np. żądany restart). Bieżący czas UTC urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate().

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

timeUnit TimeUnit: jednostka czasu TimeUnit dla podanego czasu utcEpochTime.

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

Rzuty
DeviceNotAvailableException

disableAdbRoot

public boolean disableAdbRoot ()

Wyłącza rootowanie adb.

Wyłączenie roota adb może spowodować rozłączenie urządzenia z adb. Ta metoda zablokuje urządzenie, dopóki nie będzie dostępne.

Zwroty
boolean true w przypadku powodzenia.

Rzuty
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

Próbuje wyłączyć blokadę klawiatury.

Najpierw zaczekaj, aż przesłanie danych wejściowych będzie gotowe. Stanie się to mniej więcej w tym samym czasie, gdy urządzenie zgłosi BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ obecna implementacja frameworku ma sporadyczne warunki wyścigu. Następnie wysyłane jest polecenie zamknięcia blokady ekranu (działa tylko w przypadku blokad niezabezpieczonych)

Rzuty
DeviceNotAvailableException

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Wyłącza monitorowanie sieci na urządzeniu.

Zwroty
boolean true, jeśli monitoring został wyłączony. false jeśli nie udało się.

Rzuty
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 utracone. false jeśli nie udało się zakończyć połączenia.

Rzuty
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int: identyfikator użytkownika, którego dotyczy sprawdzanie istnienia pliku

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

Rzuty
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

Rzuty
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Spróbuj zrzucić stos z system_server. Usuwanie zrzutu ekranu należy do osoby wywołującej.

Parametry
process String: nazwa procesu urządzenia, w którym ma zostać utworzony kopia pamięci podręcznej.

devicePath String: ścieżka na urządzeniu, na której ma się znajdować 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 udało.

Rzuty
DeviceNotAvailableException

enableAdbRoot

public boolean enableAdbRoot ()

Włącza rootowanie adb. Jeśli ustawienie „enable-root” ma wartość „false”, zostanie zarejestrowana wiadomość i zwrócona wartość bez włączania root.

Włączenie roota adb może spowodować rozłączenie urządzenia z adb. Ta metoda spowoduje zablokowanie urządzenia, dopóki nie będzie ono dostępne.

Zwroty
boolean true w przypadku powodzenia.

Rzuty
DeviceNotAvailableException

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Umożliwia monitorowanie sieci na urządzeniu.

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

Rzuty
DeviceNotAvailableException

executeAdbCommand

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

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

Zamiast tego, w miarę możliwości, należy używać funkcji executeShellCommand(String), ponieważ zapewnia ona lepszą skuteczność i wykrywanie błędów.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uważane za niedziałające. Wartość 0 oznacza brak limitu czasu.

cmdArgs String: polecenie adb i argumenty do uruchomienia

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

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

Zamiast tego, w miarę możliwości, należy używać funkcji executeShellCommand(String), ponieważ zapewnia ona lepszą skuteczność i wykrywanie błędów.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uważane za niedziałające. Wartość 0 oznacza brak limitu czasu.

envMap : środowisko do ustawienia dla polecenia

cmdArgs String: polecenie adb i argumenty do uruchomienia

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

Rzuty
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

Zamiast tego, w miarę możliwości, należy używać funkcji executeShellCommand(String), ponieważ zapewnia ona lepszą skuteczność i wykrywanie błędów.

Parametry
cmdArgs String: polecenie adb i argumenty do uruchomienia

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

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

Ma być używany, gdy urządzenie jest już w trybie fastboot.

Parametry
cmdArgs String: polecenie fastboot i argumenty do uruchomienia

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

Rzuty
DeviceNotAvailableException

executeFastbootCommand

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

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

Ma być używany, gdy urządzenie jest już w trybie fastboot.

Parametry
timeout long: czas w milisekundach do wygaśnięcia polecenia

cmdArgs String: polecenie fastboot i argumenty do uruchomienia

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

Rzuty
DeviceNotAvailableException

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

To samo co executeFastbootCommand(String), ale z dłuższym czasem oczekiwania.

Parametry
cmdArgs String: polecenie fastboot i argumenty do uruchomienia

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

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

To samo co executeFastbootCommand(String), ale z dłuższym czasem oczekiwania.

Parametry
envVarMap : zmienne środowiskowe systemu, z którymi działa polecenie fastboot

cmdArgs String: polecenie fastboot i argumenty do uruchomienia

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

Rzuty
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

Rzuty
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, aby kontrolować zachowanie polecenia.

Parametry
command String: polecenie adb shell do uruchomienia

receiver IShellOutputReceiver: IShellOutputReceiver, do którego ma być kierowane wyjście powłoki.

maxTimeToOutputShellResponse long: maksymalny czas, przez który komenda może nie generować odpowiedzi; jednostka podana w parametrze timeUnit

timeUnit TimeUnit: jednostka maxTimeToOutputShellResponse

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

Rzuty
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, aby kontrolować zachowanie polecenia.

Parametry
command String: polecenie adb shell do uruchomienia

receiver IShellOutputReceiver: IShellOutputReceiver, do którego ma być kierowane wyjście powłoki.

maxTimeoutForCommand long: maksymalny limit czasu wykonania polecenia; jednostka podana w parasm timeUnit

maxTimeToOutputShellResponse long: maksymalny czas, przez który komenda może nie generować odpowiedzi; jednostka podana w timeUnit

timeUnit TimeUnit: jednostka maxTimeToOutputShellResponse

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

Rzuty
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Wykonuje podane polecenie adb shell, powtarzając próbę kilka razy, jeśli polecenie się nie powiedzie.

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

Parametry
command String: polecenie adb shell do uruchomienia

receiver IShellOutputReceiver: IShellOutputReceiver, do którego ma być kierowane wyjście powłoki.

Rzuty
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako obiekt CommandResult wypełniony odpowiednimi danymi wyjściowymi polecenia, tj. stdout i stderr.

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

Zwroty
CommandResult Wynik w języku CommandResult.

Rzuty
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako CommandResult wypełnione prawidłowo danymi wyjściowymi polecenia i stderr. Dane wyjściowe stdout są kierowane do określonego strumienia.

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

pipeToOutput OutputStream: ERROR(/OutputStream), gdzie standardowe dane wyjściowe zostaną przekierowane lub będą miały wartość null.

Zwroty
CommandResult Wynik w języku CommandResult.

Rzuty
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako obiekt CommandResult wypełniony odpowiednimi danymi wyjściowymi polecenia, tj. stdout i stderr.

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

pipeAsInput File: ERROR(/File), który zostanie przesłany jako dane wejściowe do polecenia, lub null.

Zwroty
CommandResult Wynik w języku CommandResult.

Rzuty
DeviceNotAvailableException

executeShellV2Command

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

Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie polecenia.

Parametry
cmd String: polecenie adb shell do uruchomienia

maxTimeoutForCommand long: maksymalny limit czasu wykonania polecenia; jednostka podana w parasm trwania timeUnit

timeUnit TimeUnit: jednostka maxTimeToOutputShellResponse

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

Zwroty
CommandResult

Rzuty
DeviceNotAvailableException

executeShellV2Command

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

Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie polecenia.

Parametry
cmd String: polecenie adb shell do uruchomienia

maxTimeoutForCommand long: maksymalny limit czasu wykonania polecenia; jednostka podana w parasm trwania timeUnit

timeUnit TimeUnit: jednostka maxTimeToOutputShellResponse

Zwroty
CommandResult

Rzuty
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, aby kontrolować zachowanie polecenia.

Parametry
cmd String: polecenie adb shell do uruchomienia

pipeAsInput File: ERROR(/File), który zostanie przesłany jako dane wejściowe do polecenia, lub null.

pipeToOutput OutputStream: ERROR(/OutputStream), gdzie standardowe dane wyjściowe zostaną przekierowane lub będą miały wartość null.

maxTimeoutForCommand long: maksymalny limit czasu wykonania polecenia; jednostka podana w parasm timeUnit

timeUnit TimeUnit: jednostka maxTimeToOutputShellResponse

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

Zwroty
CommandResult

Rzuty
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, aby kontrolować zachowanie polecenia.

Parametry
cmd String: polecenie adb shell do uruchomienia

pipeAsInput File: ERROR(/File), który zostanie przesłany jako dane wejściowe do polecenia, lub null.

pipeToOutput OutputStream: ERROR(/OutputStream), gdzie standardowe dane wyjściowe zostaną przekierowane lub będą miały wartość null.

pipeToError OutputStream: ERROR(/OutputStream), gdzie błąd standardowy zostanie przekierowany lub ustawiony na null.

maxTimeoutForCommand long: maksymalny limit czasu wykonania polecenia; jednostka podana w parasm timeUnit

timeUnit TimeUnit: jednostka maxTimeToOutputShellResponse

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

Zwroty
CommandResult

Rzuty
DeviceNotAvailableException

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

Jeśli getUseFastbootErase() to true, partycja zostanie wyczyszczona za pomocą szybkiego formatowania. Przy następnym uruchomieniu urządzenie musi utworzyć system plików. W przeciwnym razie używany jest format fastboot, który tworzy nowy system plików na urządzeniu.

Ma być używany, gdy urządzenie jest już w trybie fastboot.

Parametry
partition String: partycja, którą chcesz wymazać

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

Rzuty
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.

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

Rzuty
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

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

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

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

Rzuty
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

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

Zwroty
DeviceAllocationState

getAndroidId

public String getAndroidId (int userId)

Znajdź i zwróć identyfikator android-id powiązany z userId, null, jeśli nie znaleziono.

Parametry
userId int

Zwroty
String

Rzuty
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

Utwórz mapę identyfikatorów Androida, które pasują do identyfikatorów użytkowników. Nie ma pewności, że w przypadku każdego identyfikatora użytkownika uda się znaleźć powiązany z nim identyfikator Androida, więc niektóre identyfikatory użytkowników mogą być równe null.

Zwroty
Mapa identyfikatorów Androida dopasowanych do identyfikatorów użytkowników.

Rzuty
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;

Rzuty
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.

Parametry
packageName String

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

Rzuty
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Pobierać informacje o pakietach zainstalowanych na urządzeniu.

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

Rzuty
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia. Uzyskiwanie wersji radiowej zależy od urządzenia, więc może nie zwracać prawidłowych informacji na wszystkich urządzeniach. Ta metoda polega na zwracaniu prawidłowej informacji o wersji za pomocą właściwości gsm.version.baseband. W przypadku niektórych urządzeń CDMA może to być nieprawidłowe, a zwrócona wersja może nie odpowiadać wersji zgłoszonej przez fastboot. Może też nie zwracać wersji dla radia CDMA. TL;DR: 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 wersję pasma podstawowego String lub null, jeśli nie można jej określić (urządzenie nie ma radia lub nie można odczytać ciągu wersji).

Rzuty
DeviceNotAvailableException

getBattery

public Integer getBattery ()

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

Zwroty
Integer

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

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

defaultValue boolean: wartość domyślna zwracana, 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 innym przypadku.

Rzuty
DeviceNotAvailableException

getBootHistory

public  getBootHistory ()

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

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

Rzuty
DeviceNotAvailableException

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchomienia od podanego czasu od epoki na urządzeniu i z określonej jednostki czasu. Bieżący czas UTC urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate().

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

timeUnit TimeUnit: jednostka czasu TimeUnit.

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

Rzuty
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

Wygodna metoda uzyskania wersji programu rozruchowego tego urządzenia.

Spróbuje pobrać wersję bootloadera z obecnego stanu urządzenia. (jeśli urządzenie jest w trybie fastboot, spróbuje pobrać wersję z fastboot)

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

Rzuty
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

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

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

Zwroty
InputStreamSource InputStreamSource, który będzie generował treści raportu o błędach na żądanie. W przypadku błędu funkcja InputStreamSource zwróci pusty ERROR(/InputStream).

getBugreportz

public InputStreamSource getBugreportz ()

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

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

Zwroty
InputStreamSource InputStreamSource pliku zip zawierającego raport o błędach, zwraca null w przypadku błędu.

getBuildAlias

public String getBuildAlias ()

Pobierz alias kompilacji, która jest obecnie używana na urządzeniu.

Alias kompilacji jest zwykle czytelniejszym ciągiem znaków niż identyfikator kompilacji (zwykle numer w przypadku kompilacji 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ć

Rzuty
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

Pobierz wersję kompilacji dla urządzenia.

Zwroty
String wersję kompilacji lub null, jeśli nie udało się jej pobrać

Rzuty
DeviceNotAvailableException

getBuildId

public String getBuildId ()

Pobierz wersję, która jest obecnie uruchomiona na urządzeniu.

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

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

Rzuty
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Zwraca z pamięci podręcznej 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 element DeviceDescriptor z pamięci podręcznej, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżący element DeviceDescriptor.

Parametry
shortDescriptor boolean: czy ograniczyć opis do niezbędnych informacji

Zwroty
DeviceDescriptor

getChildren

public String[] getChildren (String path)

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

Parametry
path String: ścieżka na urządzeniu, na której ma być przeprowadzone wyszukiwanie

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

Rzuty
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

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

Zwroty
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

Dostawca treści może być ponownie użyty, jeśli został utworzony wcześniej z tym samym userId.

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

Zwroty
ContentProviderHandler

Rzuty
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Zwroty
DeviceFoldableState

Rzuty
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Zwraca identyfikator bieżącego użytkownika. W przypadku błędu zwraca wartość -10000.

Zwroty
int

Rzuty
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Pobieranie klasy 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 epochalnym.

Rzuty
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Zwracaj DeviceDescriptor z informacjami o urządzeniu, aby uzyskać informacje o nim bez przekazywania rzeczywistego obiektu urządzenia.

Zwroty
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Zwracaj DeviceDescriptor z informacjami o urządzeniu, aby uzyskać informacje o nim bez przekazywania rzeczywistego obiektu urządzenia.

Parametry
shortDescriptor boolean: czy ograniczyć opis do niezbędnych informacji

Zwroty
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

Pobierz stan urządzenia.

Zwroty
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Pomocnik do uzyskiwania różnicy czasowej między urządzeniem a danym ERROR(/Date). Używaj wewnętrznie czasu ery.

Parametry
date Date

Zwroty
long różnica w milisekundach

Rzuty
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Pobieranie strumienia danych z stdout i stderr emulatora

Zwroty
InputStreamSource dane wyjściowe emulatora

getEmulatorProcess

public Process getEmulatorProcess ()

Zwraca Process odpowiadający temu emulatorowi.

Zwroty
Process Process lub null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Dziennik zawierający wszystkie pliki executeShellCommand(String).

Zwroty
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Metoda pomocnicza służąca do określenia ilości wolnego miejsca na zewnętrznej pamięci urządzenia.

Zwroty
long ilość wolnego miejsca w KB.

Rzuty
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

Zwraca ścieżkę do używanego pliku binarnego fastboot. Aby włączyć funkcje szybkiego uruchamiania, nadal wymagana jest wartość Prawda dla zasady isFastbootEnabled().

Zwroty
String

getFastbootProductType

public String getFastbootProductType ()

Wygodna metoda uzyskiwania typu urządzenia w trybie Fastboot.

Z tej metody należy korzystać tylko wtedy, gdy urządzenie ma być w trybie szybkiego uruchamiania. W tym przypadku jest to nieco bezpieczniejsza opcja niż ogólna metoda getProductType(), ponieważ ITestDevice będzie wiedzieć, 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ć;

Rzuty
DeviceNotAvailableException

getFastbootProductVariant

public String getFastbootProductVariant ()

Wygodna metoda uzyskiwania typu urządzenia w trybie Fastboot.

Z tej metody należy korzystać tylko wtedy, gdy urządzenie ma być w trybie szybkiego uruchamiania. W tym przypadku jest to nieco bezpieczniejsza opcja niż ogólna metoda getProductType(), ponieważ ITestDevice będzie wiedzieć, 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ć;

Rzuty
DeviceNotAvailableException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Zwraca numer seryjny trybu fastboot.

Zwroty
String

getFastbootVariable

public String getFastbootVariable (String variableName)

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

Parametry
variableName String: nazwa zmiennej

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

Rzuty
DeviceNotAvailableException

getFastbootVersion

public String getFastbootVersion ()

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

Zwroty
String

getFileEntry

public IFileEntry getFileEntry (String path)

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

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

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

Rzuty
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Nieoficjalna pomoc w przypadku FileEntry z ścieżki niebędącej ścieżką główną. FIXME: Refactor the FileEntry system to have it available from any path. (nawet bez uprawnień root).

Parametry
entry FileListingService.FileEntry: FileEntry niekoniecznie musi być rootem, jak wymaga tego Ddmlib.

Zwroty
IFileEntry obiekt FileEntryWrapper reprezentujący FileEntry.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

Zwroty

Rzuty
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

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

Za każdym razem, gdy urządzenie rozłączy się i połączy ponownie z adb, DDMS może przydzielić nowe IDevice. Dlatego osoby dzwoniące nie powinny przechowywać odwołania do IDevice, ponieważ może ono się zdezaktualizować.

Zwroty
IDevice IDevice

getInstalledPackageNames

public  getInstalledPackageNames ()

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

Zwroty
ERROR(/Set) nazw pakietów String, które są obecnie zainstalowane na urządzeniu.

Rzuty
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Zwraca wartość liczby całkowitej danej właściwości na urządzeniu.

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

defaultValue long: wartość domyślna zwracana, jeśli właściwość jest pusta lub nie istnieje.

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

Rzuty
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

Rzuty
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

Rzuty
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie (w milisekundach od EPOCH), zwracany przez System.currentTimeMillis().

Zwroty
long

getLaunchApiLevel

public int getLaunchApiLevel ()

Uzyskaj poziom interfejsu API, który został po raz pierwszy uruchomiony na urządzeniu. Domyślna wartość to UNKNOWN_API_LEVEL.

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

Rzuty
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Pobiera strumień zrzutów danych logcat.

Działa w 2 trybach:

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

    Zwroty
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

    Pobiera strumień zrzutów ostatnich maxBytes zapisanych danych logcat.

    Przydaje się, gdy chcesz często tworzyć zrzuty uchwycone dane logcat, nie ponosząc przy tym potencjalnie dużych kosztów miejsca na dysku, jakie wiąże się z uzyskiwaniem całego zrzutu 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 polecenia getLogcat() ta metoda zawsze zwraca statyczny zrzut logcat.

    Ma to tę wadę, że jeśli urządzenie jest niedostępne, nie zostanie zwrócona żadna wartość.

    Zwroty
    InputStreamSource InputStreamSource danych logcat. Jeśli nie uda się przechwycić danych logcat, zwrócony zostanie pusty strumień.

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

    Pobiera strumień zrzutów przechwycionych danych logcat od podanej daty. Należy użyć czasu na urządzeniugetDeviceDate().

    Parametry
    date long: w milisekundach od początku epoki do chwili rozpoczęcia zrzutu. (można go uzyskać za pomocą polecenia „date +%s”)

    Zwroty
    InputStreamSource

    getMacAddress

    public String getMacAddress ()

    Zwraca adres MAC urządzenia. Jeśli nie uda się wysłać zapytania do urządzenia, zwraca wartość null.

    Zwroty
    String

    getMainUserId

    public Integer getMainUserId ()

    Zwraca identyfikator głównego użytkownika.

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

    Rzuty
    DeviceNotAvailableException

    getMainlineModuleInfo

    public  getMainlineModuleInfo ()

    Pobieranie informacji o głównych modułach zainstalowanych na urządzeniu.

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

    Rzuty
    DeviceNotAvailableException

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

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

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

    Rzuty
    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;

    Rzuty
    DeviceNotAvailableException

    getMicrodroidProcess

    public Process getMicrodroidProcess ()

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

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    Zwracaj IDeviceStateMonitor powiązany z urządzeniem.

    Zwroty
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

    Zwraca punkt podłączenia.

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

    DO ZROBIENIA: przenieś to zachowanie do IDevice.getMountPoint(String)

    Parametry
    mountName String: nazwa punktu podłączania

    Zwroty
    String punkt podłączania lub null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Zwraca MountPointInfo odpowiadający określonej ścieżce punktu podłączania lub null, jeśli ta ścieżka nie ma nic podłączonego lub w inny sposób nie pojawia się w /proc/mounts jako punkt podłączania.

    Parametry
    mountpoint String

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

    Rzuty
    DeviceNotAvailableException

    getMountPointInfo

    public  getMountPointInfo ()

    Zwraca zanalizowaną wersję informacji w katalogu /proc/mounts na urządzeniu.

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

    Rzuty
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

    Pobierz opcje testowania urządzenia.

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

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

    Metoda pomocnicza służąca do określenia ilości wolnego miejsca na partycji urządzenia.

    Parametry
    partition String

    Zwroty
    long ilość wolnego miejsca w KB.

    Rzuty
    DeviceNotAvailableException

    getPrimaryUserId

    public Integer getPrimaryUserId ()

    Zwraca podstawowy identyfikator użytkownika.

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

    Rzuty
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

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

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

    Zwroty
    ProcessInfo Informacje o procesie o danej nazwie

    Rzuty
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

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

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

    Zwroty
    String

    Rzuty
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

    Wygodna metoda uzyskiwania typu urządzenia.

    Ta metoda zadziała, jeśli urządzenie jest w trybie adb lub Fastboot.

    Zwroty
    String nazwa typu produktu String. nie może być puste

    Rzuty
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

    Wygodna metoda uzyskiwania wersji produktu tego urządzenia.

    Ta metoda zadziała, jeśli urządzenie jest w trybie adb lub Fastboot.

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

    Rzuty
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

    Pobierać z urządzenia określoną wartość właściwości.

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

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

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

    Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania. Format: PNG.

    DO ZROBIENIA: rozszerz implementacje powyżej, aby obsługiwały opcje „format” i „rescale”.

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

    Zwroty
    InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie powiódł się.

    Rzuty
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format)

    Robi zrzut ekranu z urządzenia. Zalecamy użycie funkcji getScreenshot(format) z kodowaniem JPEG, aby uzyskać mniejszy rozmiar.

    Parametry
    format String: obsługiwane PNG, JPEG

    Zwroty
    InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie powiódł się.

    Rzuty
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    Robi zrzut ekranu z urządzenia. Zalecamy użycie getScreenshot(String) zamiast kodowania JPEG, aby zmniejszyć rozmiar.

    Parametry
    format String: obsługiwane PNG, 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 powiódł się.

    Rzuty
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot ()

    Robi zrzut ekranu z urządzenia.

    Zwroty
    InputStreamSource InputStreamSource zrzutu ekranu w formacie png lub null, jeśli zrzut ekranu nie powiódł się.

    Rzuty
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

    Wygodna metoda uzyskania numeru seryjnego tego urządzenia.

    Zwroty
    String numer seryjny String.

    getSetting

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

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

    Parametry
    userId int

    namespace String

    key String

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

    Rzuty
    DeviceNotAvailableException

    getSetting

    public String getSetting (String namespace, 
                    String key)

    Zobacz getSetting(int, String, String) i wykonane przez użytkownika systemowego.

    Parametry
    namespace String

    key String

    Zwroty
    String

    Rzuty
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

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

    Zwroty
    String

    getSimState

    public String getSimState ()

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

    Zwroty
    String

    getTombstones

    public  getTombstones ()

    Pobieranie i zwracanie listy nagrobków z urządzeń. Wymaga uprawnień root.

    Ta metoda działa w najlepszy możliwy sposób, więc jeśli z jakiegokolwiek powodu nie uda się wyodrębnić jednego nagrobka, nie będzie on widoczny na liście. Tylko instrukcja DeviceNotAvailableException spowoduje wcześniejsze zakończenie metody.

    Zwroty
    Lista plików nagłówków, pusta, jeśli nie ma nagłówka.

    Rzuty
    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 ()

    Aby zarządzać urządzeniem, uzyskaj 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 niesystemowe i zaktualizowane pakiety systemowe.

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

    Rzuty
    DeviceNotAvailableException

    getUseFastbootErase

    public boolean getUseFastbootErase ()

    Określ, czy chcesz użyć fastboot erase czy fastboot format do wyczyszczenia partycji na urządzeniu.

    Zwroty
    boolean true, jeśli ma zostać użyte szybkie kasowanie, lub false, jeśli ma zostać użyte szybkie formatowanie.

    getUserFlags

    public int getUserFlags (int userId)

    Znajdowanie i zwracanie flag danego użytkownika. Flagi są definiowane w klasie „android.content.pm.UserInfo” w projekcie Android Open Source.

    Parametry
    userId int

    Zwroty
    int flagi powiązane z podanym identyfikatorem użytkownika (userId), jeśli został znaleziony, lub -10000 w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    getUserInfos

    public  getUserInfos ()

    Pobiera mapę useId na urządzeniu do UserInfo. Jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami, zostanie zwrócony błąd DeviceRuntimeException.

    Zwroty
    lista obiektów UserInfo.

    Rzuty
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

    W przeciwnym razie zwraca -10000.

    Parametry
    userId int

    Zwroty
    int

    Rzuty
    DeviceNotAvailableException

    handleAllocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Przetwarzanie podanego zdarzenia DeviceEvent. Możesz przenieść urządzenie do nowego stanu. Poinformuje IDeviceMonitor o wszelkich przejściach stanu.

    Przetwarzanie zdarzenia dotyczącego urządzenia, które może, ale nie musi spowodować przeniesienie urządzenia do nowego stanu alokacji.

    Parametry
    event DeviceEvent

    Zwroty
    IManagedTestDevice.DeviceEventResponse

    hasFeature

    public boolean hasFeature (String feature)

    Sprawdzanie, czy funkcja jest dostępna na urządzeniu

    Parametry
    feature String: format, który powinien być użyty: „feature:” czy „”.

    Zwroty
    boolean Wartość „prawda”, jeśli udało się znaleźć funkcję. W przeciwnym razie wartość „fałsz”.

    Rzuty
    DeviceNotAvailableException

    installPackage

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

    Zainstaluj na urządzeniu pakiet Androida.

    Parametry
    packageFile File: plik APK do zainstalowania

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

    extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.

    Zwroty
    String String z kodem błędu lub null, jeśli operacja się powiodła.

    Rzuty
    DeviceNotAvailableException

    installPackage

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

    Zainstaluj na urządzeniu pakiet Androida.

    Uwaga: tej funkcji należy używać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.

    Parametry
    packageFile File: plik APK do zainstalowania

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

    grantPermissions boolean: czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji

    extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.

    Zwroty
    String String z kodem błędu lub null, jeśli operacja się powiodła.

    Rzuty
    DeviceNotAvailableException

    installPackageForUser

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

    Instalowanie pakietu Androida na urządzeniu danego użytkownika.

    Parametry
    packageFile File: plik APK do zainstalowania

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

    userId int: liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja.

    extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.

    Zwroty
    String String z kodem błędu lub null, jeśli operacja się powiodła.

    Rzuty
    DeviceNotAvailableException

    installPackageForUser

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

    Instalowanie pakietu Androida na urządzeniu danego użytkownika.

    Uwaga: tej funkcji należy używać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.

    Parametry
    packageFile File: plik APK do zainstalowania

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

    grantPermissions boolean: czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji

    userId int: liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja.

    extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.

    Zwroty
    String String z kodem błędu lub null, jeśli operacja się powiodła.

    Rzuty
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    Zwroty
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

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

    Zwroty
    boolean Wartość true (prawda), jeśli zliczanie aplikacji jest obsługiwane, w przeciwnym razie wartość false (fałsz).

    Rzuty
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

    Sprawdź, czy platforma na urządzeniu obsługuje pomijanie blokady związanej z niskim docelowym poziomem interfejsu SDK podczas instalowania aplikacji

    Zwroty
    boolean Wartość Prawda, jeśli obsługiwane jest pominięcie blokady niskiego docelowego pakietu SDK. W przeciwnym razie wartość Fałsz.

    Rzuty
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    Sprawdź, czy debugfs jest zamontowany.

    Zwroty
    boolean true, jeśli debugfs jest zamontowany

    Rzuty
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

    Zwraca wartość wskazującą, czy urządzenie jest zaszyfrowane.

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

    Rzuty
    DeviceNotAvailableException

    isDirectory

    public boolean isDirectory (String path)

    Zwraca wartość „True”, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość „False”.

    Parametry
    path String

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isEnableAdbRoot

    public boolean isEnableAdbRoot ()

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

    isEncryptionSupported

    public boolean isEncryptionSupported ()

    Zwraca wartość wskazującą, czy szyfrowanie jest obsługiwane na urządzeniu.

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

    Rzuty
    DeviceNotAvailableException

    isExecutable

    public boolean isExecutable (String fullPath)

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

    Parametry
    fullPath String

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

    Zwracaj, jeśli na urządzeniu jest dostępny tryb Fastboot.

    Zwroty
    boolean

    isHeadless

    public boolean isHeadless ()

    Zwraca wartość true, jeśli urządzenie jest bez głowicy (bez ekranu), w przeciwnym razie zwraca wartość false.

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

    Zwraca informację, czy urządzenie używa trybu użytkownika systemu bez interfejsu graficznego.

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

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

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isMultiUserSupported

    public boolean isMultiUserSupported ()

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

    Zwroty
    boolean true, jeśli obsługiwane jest korzystanie przez wielu użytkowników, w przeciwnym razie false

    Rzuty
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

    Przesyłanie zapytania do urządzenia o określonej nazwie pakietu i określonym identyfikatorem użytkownika w celu sprawdzenia, czy aplikacja jest obecnie zainstalowana na tym urządzeniu.

    Parametry
    packageName String: pakiet, którego instalację sprawdzamy.

    userId String: identyfikator użytkownika, dla którego sprawdzamy, czy zainstalowano pakiet. Jeśli jest to wartość null, zostanie użyta wartość 0.

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

    Rzuty
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName)

    Wyszukaj na urządzeniu daną nazwę pakietu, aby sprawdzić, czy jest on zainstalowany.

    Parametry
    packageName String

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

    Rzuty
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

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

    Zwroty
    boolean Wartość „prawda”, jeśli uprawnienia czasu działania są obsługiwane. W przeciwnym razie wartość „fałsz”.

    Rzuty
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

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

    Zwroty
    boolean

    isUserRunning

    public boolean isUserRunning (int userId)

    Sprawdź, czy dany użytkownik jest obecny.

    Parametry
    userId int

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

    Rzuty
    DeviceNotAvailableException

    isUserSecondary

    public boolean isUserSecondary (int userId)

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

    Parametry
    userId int

    Zwroty
    boolean Prawda, jeśli użytkownik jest dodatkowy, w przeciwnym razie fałsz.

    Rzuty
    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 „ludzkim” użytkownikiem, a zatem może uruchamiać czynności (zazwyczaj w wyświetlanym domyślnie widoku).

    Parametry
    userId int

    Zwroty
    boolean

    Rzuty
    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 „ludzkim” użytkownikiem, a zatem może uruchamiać na wyświetlaczu różne działania.

    Parametry
    userId int

    displayId int

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

    Zwraca informacje o tym, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji w tle w konfiguracji ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

    Jeśli tak, możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean), przekazując wyświetlacz zwrócony przez funkcję listDisplayIdsForStartingVisibleBackgroundUsers() (która powinna zawierać ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

    Zwraca informację, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji 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

    Rzuty
    DeviceNotAvailableException

    isWifiEnabled

    public boolean isWifiEnabled ()

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

    Sprawdzanie, czy Wi-Fi jest włączone na urządzeniu. Przydatne do sprawdzania stanu Wi-Fi przed testami, które nie powinny być wykonywane z użyciem Wi-Fi, np. testy danych mobilnych.

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

    Rzuty
    DeviceNotAvailableException

    listDisplayIds

    public  listDisplayIds ()

    Pobierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, jak podaje „dumpsys SurfaceFlinger”.

    Zwroty
    Lista wyświetlaczy. Domyślnie zawsze zwraca wartość domyślną 0.

    Rzuty
    DeviceNotAvailableException

    listDisplayIdsForStartingVisibleBackgroundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    Zwroty

    Rzuty
    DeviceNotAvailableException

    listUsers

    public  listUsers ()

    Pobiera listę użytkowników na urządzeniu. Wyjątek DeviceRuntimeException zostanie rzucony, jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.

    Zwroty
    lista identyfikatorów użytkowników.

    Rzuty
    DeviceNotAvailableException

    logAnrs

    public boolean logAnrs (ITestLogger logger)

    Zbiera i rejestruje błędy ANR na urządzeniu.

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

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

    Rzuty
    DeviceNotAvailableException

    logBugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w raportach dla zgłaszających.

    Parametry
    dataName String: nazwa, pod którą zgłoszenie błędu zostanie przesłane.

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

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

    logOnDevice

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

    Zaloguj wiadomość w logcat urządzenia. To bezpieczne wywołanie, które nie spowoduje błędu nawet wtedy, gdy logowanie 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 ()

    Zamontuj debugfs.

    Rzuty
    DeviceNotAvailableException

    nonBlockingReboot

    public void nonBlockingReboot ()

    Wydając polecenie ponownego uruchomienia urządzenia, wraca po jego wykonaniu i gdy urządzenie nie jest już widoczne dla adb.

    Rzuty
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

    Zastąpić, jeśli urządzenie wymaga wykonania określonych czynności po uzyskaniu uprawnień root w adb, zanim będzie można przywrócić urządzenie do trybu online. Implementacja domyślna nie zawiera żadnych dodatkowych działań. Na tym etapie nie ma gwarancji, że adb root jest włączone.

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postAdbUnrootAction

    public void postAdbUnrootAction ()

    Zastąpić, jeśli urządzenie wymaga wykonania określonych czynności po usunięciu uprawnień roota za pomocą adb, a przed przywróceniem urządzenia do trybu online. Implementacja domyślna nie obejmuje żadnych dodatkowych działań. Na tym etapie nie ma gwarancji, że adb root jest wyłączony.

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public void postBootSetup ()

    Postępuj zgodnie z instrukcjami, aby skonfigurować urządzenie do testowania po każdym uruchomieniu.

    Należy go wywołać po całkowitym uruchomieniu/udostępnieniu urządzenia.

    Zazwyczaj nie trzeba wywoływać tej metody w sposób jawny, ponieważ implementacje powinny wykonywać te czynności automatycznie podczas ponownego uruchamiania.

    Funkcja może być wywoływana, gdy urządzenie uruchamia się ponownie z powodu innych zdarzeń (np. po zakończeniu polecenia fastboot update).

    Rzuty
    DeviceNotAvailableException

    postInvocationTearDown

    public void postInvocationTearDown (Throwable exception)

    Dodatkowe czynności związane z czyszczeniem, które są wymagane na urządzeniu, zostaną wykonane po zakończeniu wywołania.

    Parametry
    exception Throwable: jeśli występuje, to ostatnie wyjątek wywołany przez błąd wywołania.

    preInvocationSetup

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

    Dodatkowe czynności wymagane na urządzeniu, które zostaną wykonane na urządzeniu przed rozpoczęciem procesu wywołania.

    Parametry
    info IBuildInfo: IBuildInfo urządzenia.

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

    Rzuty
    DeviceNotAvailableException
    TargetSetupError

    pullDir

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

    Rekursywnie pobieraj zawartość katalogu z urządzenia.

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

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

    userId int: identyfikator użytkownika, z którego mają być pobierane dane

    Zwroty
    boolean true – jeśli plik został pomyślnie pobrany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Rekursywnie pobieraj zawartość katalogu z urządzenia.

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

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

    Zwroty
    boolean true – jeśli plik został pomyślnie pobrany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Pobiera plik z urządzenia.

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

    localFile File: lokalny plik do przechowywania treści. Jeśli nie jest pusty, jego zawartość zostanie zastąpiona.

    Zwroty
    boolean true – jeśli plik został pomyślnie pobrany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                    int userId)

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

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

    userId int: identyfikator użytkownika, z którego mają być pobierane dane

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

    Rzuty
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

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

    Parametry
    remoteFilePath String: bezwzględna ścieżka 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).

    Rzuty
    DeviceNotAvailableException

    pullFile

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

    Pobiera plik z urządzenia.

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

    localFile File: lokalny plik do przechowywania treści. Jeśli nie jest pusty, jego zawartość zostanie zastąpiona.

    userId int: identyfikator użytkownika, z którego mają być pobierane dane

    Zwroty
    boolean true – jeśli plik został pomyślnie pobrany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

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

    Parametry
    remoteFilePath String: bezwzględna ścieżka 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).

    Rzuty
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

    Wygodna metoda pobierania pliku z zewnętrznej pamięci urządzenia, przechowywania 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 w stosunku do punktu zamontowania 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).

    Rzuty
    DeviceNotAvailableException

    pushDir

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

    Rekursywnie przesyłaj zawartość katalogu na urządzenie, wykluczając niektóre katalogi, które są filtrowane.

    Parametry
    localFileDir File: lokalny katalog do wypychania,

    deviceFilePath String: bezwzględna ścieżka do pliku w zdalnym miejscu docelowym

    excludedDirectories : zestaw nazw wykluczonych katalogów, których nie należy przesyłać.

    Zwroty
    boolean true – czy plik został przesłany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Rekursywnie przesyłaj zawartość katalogu na urządzenie.

    Parametry
    localFileDir File: lokalny katalog do wypychania,

    deviceFilePath String: bezwzględna ścieżka do pliku w zdalnym miejscu docelowym

    Zwroty
    boolean true – czy plik został przesłany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    pushDir

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

    Rekursywnie przesyłaj zawartość katalogu na urządzenie.

    Parametry
    localFileDir File: lokalny katalog do wypychania,

    deviceFilePath String: bezwzględna ścieżka do pliku w zdalnym miejscu docelowym

    userId int: identyfikator użytkownika, do którego mają być przesyłane dane.

    Zwroty
    boolean true – czy plik został przesłany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    pushFile

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

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

    Parametry
    localFile File: plik lokalny do przesłania

    remoteFilePath String: bezwzględna ścieżka do pliku docelowego na zdalnym serwerze

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

    Zwroty
    boolean true – czy plik został przesłany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Przesyłanie pliku na urządzenie. Domyślnie za pomocą dostawcy treści.

    Parametry
    localFile File: plik lokalny do przesłania

    remoteFilePath String: bezwzględna ścieżka do pliku docelowego zdalnego.

    Zwroty
    boolean true – czy plik został przesłany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    pushFile

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

    Przesyłanie pliku na urządzenie. Domyślnie za pomocą dostawcy treści.

    Parametry
    localFile File: plik lokalny do przesłania

    remoteFilePath String: bezwzględna ścieżka do pliku docelowego zdalnego.

    userId int: identyfikator użytkownika, do którego mają być przesyłane dane

    Zwroty
    boolean true – czy plik został przesłany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

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

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

    remoteFilePath String: bezwzględna ścieżka do pliku docelowego na zdalnym serwerze

    Zwroty
    boolean true – jeśli ciąg znaków został przesłany. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    Uruchom ponownie

    public void reboot (String reason)

    Uruchom ponownie urządzenie w trybie adb z danymi reason, które mają być zachowane po ponownym uruchomieniu.

    Blokuje, dopóki urządzenie nie stanie się dostępne.

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

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

    Rzuty
    DeviceNotAvailableException

    Uruchom ponownie

    public void reboot ()

    Uruchom ponownie urządzenie w trybie adb.

    Blokuje, dopóki urządzenie nie stanie się dostępne.

    Rzuty
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Uruchamia ponownie urządzenie w trybie programu rozruchowego.

    Blokuje, dopóki urządzenie nie znajdzie się w trybie programu rozruchowego.

    Rzuty
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Uruchom ponownie urządzenie w trybie Fastboot.

    Blokuje, dopóki urządzenie nie znajdzie się w trybie Fastboot.

    Rzuty
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    Uruchom ponownie urządzenie w trybie odzyskiwania adb.

    Blokuje urządzenie, dopóki nie wejdzie w tryb odzyskiwania

    Rzuty
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

    Uruchom ponownie urządzenie w trybie ładowania bocznego adb (zauważ, że jest to specjalny tryb odzyskiwania).

    Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload

    Rzuty
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Uruchom ponownie urządzenie w trybie ładowania bocznego adb (zauważ, że jest to specjalny tryb odzyskiwania).

    Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload

    Parametry
    autoReboot boolean: czy urządzenie ma się automatycznie ponownie uruchomić po zainstalowaniu aplikacji przez sideload

    Rzuty
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

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

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

    Rzuty
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

    Uruchomi ponownie tylko część urządzenia w przestrzeni użytkownika.

    Blokuje, dopóki urządzenie nie stanie się dostępne.

    OSTRZEŻENIE. Funkcja ponownego uruchamiania w przestrzeni użytkownika jest obecnie aktywnie rozwijana. Korzystaj z niej na własne ryzyko.

    Rzuty
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

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

    Rzuty
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Próby przywrócenia komunikacji z urządzeniem.

    Zwroty
    boolean Wartość Prawda, jeśli próba odzyskania danych zakończyła się powodzeniem. Zwraca wartość Fałsz, jeśli pominięto odzyskiwanie danych.

    Rzuty
    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 i po zakończeniu działania urządzenia.

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

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    Ustaw partycję systemową na urządzeniu jako tylko do odczytu. Może spowodować ponowne uruchomienie urządzenia.

    Rzuty
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    Ustaw partycję systemową na urządzeniu jako partycję do zapisu. Może spowodować ponowne uruchomienie urządzenia.

    Rzuty
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

    Ustaw partycję dostawcy na urządzeniu jako partycję tylko do odczytu. Może spowodować ponowne uruchomienie urządzenia.

    Rzuty
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Ustaw partycję dostawcy na urządzeniu jako partycję do zapisu. Może spowodować ponowne uruchomienie urządzenia.

    Rzuty
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

    Usuń danego administratora urządzenia w danym użytkowniku i wróć true, jeśli operacja się powiedzie, w przeciwnym razie false.

    Parametry
    componentName String: administratora urządzenia, którego chcesz usunąć.

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

    Zwroty
    boolean Wartość true (prawda), jeśli operacja się powiodła, a w przeciwnym razie – false (fałsz).

    Rzuty
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Usuń wszystkich dotychczasowych właścicieli profilu urządzenia.

    Rzuty
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    usunąć danego użytkownika z urządzenia,

    Parametry
    userId int: użytkownika, którego chcesz usunąć

    Zwroty
    boolean Wartość „prawda”, jeśli udało się usunąć użytkownika, w przeciwnym razie – „fałsz”.

    Rzuty
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

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

    runInstrumentationTests

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

    Metoda ułatwiająca wykonywanie funkcji ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z jednym lub większą liczbą podsłuchujących przekazanych jako parametry.

    Parametry
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy

    listeners ITestLifeCycleReceiver: słuchacze wyników testu

    Zwroty
    boolean true, jeśli polecenie testowe zostało wykonane. false – jeśli nie udało się go ukończyć, ale odzyskanie się powiodło;

    Rzuty
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Uruchamia testy z instrumentacją i zapewnia odzyskiwanie urządzenia.

    Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a przywrócenie się powiedzie, wszyscy słuchacze zostaną poinformowani o testRunFailed i zwrócona zostanie wartość „false”. Polecenie testu nie zostanie ponownie wykonane. W razie potrzeby rozmówcy mogą spróbować ponownie.

    Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a przywrócenie nie powiedzie się, wszyscy słuchacze zostaną poinformowani o testRunFailed i wyjątek DeviceNotAvailableException zostanie rzucony.

    Parametry
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy

    listeners : odbiornik wyników testu

    Zwroty
    boolean true, jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go wykonać z powodu wyjątku dotyczącego komunikacji z urządzeniem, ale odzyskiwanie zakończyło się pomyślnie

    Rzuty
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    To samo co ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), ale test jest przeprowadzany w przypadku danego użytkownika.

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    To samo co ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), ale test jest przeprowadzany w przypadku danego użytkownika.

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Wstrzykuje IConfiguration w użyciu.

    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 uprawnień roota

    Parametry
    date Date: określenie konkretnej daty; jeśli null, zostanie użyta data hosta

    Rzuty
    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: administrator urządzenia musi być jego właścicielem.

    userId int: kraju zamieszkania właściciela urządzenia.

    Zwroty
    boolean Wartość true (prawda), jeśli operacja się powiodła, a w przeciwnym razie – false (fałsz).

    Rzuty
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Zaktualizuj stan urządzenia.

    Parametry
    deviceState TestDeviceState: TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    W emulatorze ustaw SizeLimitedOutputStream na rejestrowanie danych wyjściowych.

    Parametry
    output SizeLimitedOutputStream: aby zapisać dane wyjściowe w logach

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Ustawia Process, gdy to urządzenie jest emulatorem.

    Parametry
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Ustaw opcję fastboot na urządzeniu. Należy go ustawić, gdy urządzenie jest po raz pierwszy przypisywane.

    Parametry
    fastbootEnabled boolean: czy szybki rozruch jest dostępny na urządzeniu

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Ustawia ścieżkę do binarnego pliku fastboot, którego należy użyć. Aby włączyć funkcje szybkiego uruchamiania, nadal wymagana jest wartość Prawda dla zasady isFastbootEnabled().

    Parametry
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

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

    Nowe urządzenie IDevice musi odnosić się do tego samego urządzenia fizycznego co bieżące urządzenie referencyjne. Ta metoda zostanie wywołana, jeśli DDMS przypisał nowe urządzenie IDevice.

    Parametry
    newDevice IDevice: IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

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

    Parametry
    delay int: opóźnienie w ms

    setOptions

    public void setOptions (TestDeviceOptions options)

    Ustaw TestDeviceOptions na urządzeniu

    Parametry
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Ustawia określoną wartość właściwości na urządzeniu. Wymaga, aby root adb był ustawiony na 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 zakończyło się pomyślnie, w przeciwnym razie zwraca wartość False.

    Rzuty
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Ustaw IDeviceRecovery, aby używać go na tym urządzeniu. Należy go ustawić, gdy urządzenie jest po raz pierwszy przypisywane.

    Parametry
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Służy do określenia metody odzyskiwania, gdy wystąpi problem z komunikacją urządzenia. Zalecamy stosowanie tej metody tylko wtedy, gdy jest to konieczne (na przykład gdy platforma jest niedostępna).

    Parametry
    mode ITestDevice.RecoveryMode: czy włączyć tryb „Przywróć do stanu online”.

    setSetting

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

    Zobacz setSetting(int, String, String, String) i wykonane przez użytkownika systemowego.

    Parametry
    namespace String

    key String

    value String

    Rzuty
    DeviceNotAvailableException

    setSetting

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

    Dodanie wartości ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu urządzenia. namespace musi być jedną z tych wartości: {"system", "secure", "global"}

    Parametry
    userId int

    namespace String

    key String

    value String

    Rzuty
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Wstrzykuje instancję ITestLogger

    Parametry
    testLogger ITestLogger

    setTrackingSerial

    public void setTrackingSerial (String trackingSerial)

    W celu zarządzania urządzeniami śledź numer seryjny, którego używamy do identyfikowania urządzenia.

    Parametry
    trackingSerial String

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

    Ustaw, czy chcesz użyć fastboot erase czy fastboot format do wyczyszczenia partycji na urządzeniu.

    Parametry
    useFastbootErase boolean: true, jeśli chcesz użyć polecenia fastboot erase, lub false, jeśli chcesz użyć polecenia fastboot format.

    startLogcat

    public void startLogcat ()

    Rozpocznij przechwytywanie danych logcat z urządzenia w tle.

    Nie będzie mieć zastosowania, jeśli dane logcat są już rejestrowane. Dane można później pobrać za pomocą getLogcat.

    Gdy urządzenie nie jest już używane, musi zostać wywołana funkcja stopLogcat().

    Zwykle nie trzeba wywoływać funkcji startLogcat() ani stopLogcat() w kontekście wywołania TF, ponieważ logcat jest uruchamiany i zatrzymywany przez framework TF.

    startUser

    public boolean startUser (int userId)

    Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik jest już uruchomiony w tle, ta metoda nie wykonuje żadnej operacji.

    Parametry
    userId int: użytkownik może uruchomić aplikację w tle

    Zwroty
    boolean Wartość true, jeśli użytkownik został uruchomiony w tle.

    Rzuty
    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 jest już uruchomiony w tle, ta metoda nie wykonuje żadnej operacji. Możliwość podania dodatkowego parametru, aby poczekać na zastosowanie operacji.

    Parametry
    userId int: użytkownik może uruchomić aplikację w tle

    waitFlag boolean: polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie.

    Zwroty
    boolean Wartość true, jeśli użytkownik został uruchomiony w tle.

    Rzuty
    DeviceNotAvailableException

    startVisibleBackgroundUser

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

    Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli pozwala użytkownikowi uruchamiać na nim działania).

    UWAGA: to polecenie nie sprawdza, czy użytkownik istnieje, czy wyświetlacz jest dostępny, device supports such feature itp.

    Parametry
    userId int: użytkownik może uruchomić aplikację w tle

    displayId int: wyświetlanie informacji o początkowym użytkowniku na

    waitFlag boolean: polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie.

    Zwroty
    boolean true jeśli użytkownik został uruchomiony i jest widoczny w tle.

    Rzuty
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Zamknij i usuń dane wyjściowe emulatora.

    stopLogcat

    public void stopLogcat ()

    Zatrzymaj przechwytywanie danych logcat z urządzenia i usuń zapisane dane logcat.

    Nie będzie mieć żadnego wpływu, jeśli dane wyjściowe logcat nie są przechwytywane.

    stopUser

    public boolean stopUser (int userId)

    Zatrzymuje danego użytkownika. Jeśli użytkownik został już zatrzymany, ta metoda nie będzie miała żadnego działania. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemowego.

    Parametry
    userId int: użytkownik musi się zatrzymać.

    Zwroty
    boolean Wartość true, jeśli użytkownik został zatrzymany.

    Rzuty
    DeviceNotAvailableException

    stopUser

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

    Zatrzymanie danego użytkownika. Można podać dodatkowe flagi, aby zaczekać na wykonanie operacji i przymusowo zakończyć sesję użytkownika. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemowego.

    Parametry
    userId int: użytkownik musi się zatrzymać.

    waitFlag boolean: polecenie będzie oczekiwać, aż użytkownik się zatrzyma.

    forceFlag boolean: wymuszenie zatrzymania przez użytkownika.

    Zwroty
    boolean Wartość true, jeśli użytkownik został zatrzymany.

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

    Rzuty
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

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

    Zwroty
    boolean true, jeśli przełączenie się powiodło, w przeciwnym razie false.

    Rzuty
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId)

    Przełącz się na innego użytkownika o domyślnym czasie oczekiwania. switchUser(int, long).

    Parametry
    userId int

    Zwroty
    boolean Prawda, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.

    Rzuty
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId, 
                    long timeout)

    Przełącz się na innego użytkownika z podanym czasem oczekiwania jako terminem. Próba wyłączenia blokady ekranu po pomyślnej zmianie użytkownika.

    Parametry
    userId int

    timeout long: czas oczekiwania przed zwróceniem wartości false w przypadku błędu switch-user.

    Zwroty
    boolean Prawda, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.

    Rzuty
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Synchronizuje stopniowo zawartość lokalnego katalogu plików na urządzeniu.

    Określa, które pliki przesłać, porównując sygnatury czasowe plików lokalnych z ich odpowiednikami na zdalnym komputerze. Na urządzenie będą przesyłane tylko nowe lub nieistniejące pliki. Dlatego koszty dodatkowe powinny być stosunkowo niewielkie, jeśli pliki na urządzeniu są już aktualne.

    Ukryte pliki (z nazwami zaczynającymi się od „.”) zostaną zignorowane.

    Przykład użycia: syncFiles("/tmp/files", "/sdcard") utworzy katalog /sdcard/files, jeśli jeszcze nie istnieje, i rekursywnie prześle zawartość katalogu /tmp/files do katalogu /sdcard/files.

    Parametry
    localFileDir File: lokalny katalog plików zawierający pliki do rekurencyjnego przesyłania.

    deviceFilePath String: ścieżka bezwzględna do katalogu źródeł na zdalnym serwerze. Wszystkie katalogi w ścieżce pliku muszą być czytelne. Przesyłanie do katalogu /data/local/tmp, gdy adb nie jest rootem, zakończy się niepowodzeniem.

    Zwroty
    boolean true, jeśli pliki zostały zsynchronizowane. false w innych przypadkach.

    Rzuty
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    Przyjmuje zgłoszenie o błędzie i zwraca je w obiekcie Bugreport, aby je obsłużyć. W przypadku problemów zwraca wartość null. Plik, na który wskazuje obiekt Bugreport, musi zostać oczyszczony 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, jeśli operacja się powiodła.

    Rzuty
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

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

    Parametry
    packageName String: pakiet na Androida do odinstalowania

    userId int: liczba całkowita identyfikatora użytkownika, dla którego ma zostać odinstalowana aplikacja.

    Zwroty
    String String z kodem błędu lub null, jeśli operacja się powiodła.

    Rzuty
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

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

    Ta metoda może ponownie uruchomić framework, ale nie wywoła funkcji postBootSetup(). Dlatego po zastosowaniu tej metody urządzenie może nie być w pełni gotowe do przetestowania.

    Zwroty
    boolean true w przypadku powodzenia lub jeśli urządzenie nie jest zaszyfrowane.

    Rzuty
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Odmontuj debugfs.

    Rzuty
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Blokuje do momentu ustawienia flagi „boot complete”.

    Parametry
    timeOut long: czas oczekiwania w ms na ustawienie flagi

    Zwroty
    boolean Prawda, jeśli w okresie limitu czasu ustawiona jest flaga uruchamiania urządzenia.

    Rzuty
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Czeka, aż urządzenie będzie gotowe do testowania. Używa domyślnego limitu czasu.

    Zwroty
    boolean Prawda, jeśli urządzenie jest dostępne, Fałsz, jeśli odzyskiwanie jest wyłączone i niedostępne.

    Rzuty
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Czeka, aż urządzenie będzie gotowe do testowania.

    Parametry
    waitTime long: czas oczekiwania w ms

    Zwroty
    boolean Prawda, jeśli urządzenie jest dostępne, Fałsz, jeśli odzyskiwanie jest wyłączone i niedostępne.

    Rzuty
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Czeka, aż urządzenie będzie gotowe do działania i dostępne, bez uwzględniania ścieżki odzyskiwania.

    Parametry
    waitTime long

    Zwroty
    boolean Prawda, jeśli urządzenie jest dostępne, Fałsz, jeśli nie.

    Rzuty
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Blokuje, dopóki urządzenie nie będzie widoczne w Fastboot. Użyj domyślnego limitu czasu.

    Rzuty
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Blokuje urządzenie w stanie „adb recovery” (uwaga: jest to stan inny niż IDeviceRecovery).

    Parametry
    waitTime long: czas oczekiwania w ms

    Zwroty
    boolean true jeśli urządzenie uruchomi się w trybie odzyskiwania przed upływem czasu. false w innych przypadkach

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blokuje urządzenie w stanie „adb sideload”.

    Parametry
    waitTime long: czas oczekiwania w ms

    Zwroty
    boolean true jeśli urządzenie uruchomi się w trybie sideload przed upływem czasu. false w innych przypadkach

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Blokuje dostęp do urządzenia, np. uniemożliwia dostęp do adb.

    Parametry
    waitTime long: czas oczekiwania w ms

    Zwroty
    boolean true, jeśli urządzenie nie będzie dostępne przed upływem czasu. false w innych przypadkach

    waitForDeviceOnline

    public void waitForDeviceOnline ()

    Blokuje, dopóki urządzenie nie będzie widoczne przez adb. Używa domyślnego limitu czasu

    Pamiętaj, że urządzenie może nie reagować na polecenia po zakończeniu. Zamiast tego użyj waitForDeviceAvailable().

    Rzuty
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

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

    Pamiętaj, że urządzenie może nie reagować na polecenia po zakończeniu. Zamiast tego użyj waitForDeviceAvailable().

    Parametry
    waitTime long: czas oczekiwania w ms

    Rzuty
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    Czeka, aż urządzenie zareaguje na podstawowe polecenie adb shell.

    Parametry
    waitTime long: czas oczekiwania w ms

    Zwroty
    boolean true, jeśli urządzenie zacznie reagować przed upływem czasu waitTime.

    Chronione metody

    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 adb shell 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 wykonywania działania ponownego uruchamiania.

    Parametry
    rebootMode NativeDevice.RebootMode: tryb ponownego uruchamiania.

    reason String: w przypadku tego restartu.

    Zwroty
    NativeDevice.RebootDeviceAction utworzono RebootDeviceAction.

    createRunUtil

    protected IRunUtil createRunUtil ()

    Zwroty
    IRunUtil

    doAdbReboot

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

    Uruchom ponownie urządzenie za pomocą adb.

    Parametry
    rebootMode NativeDevice.RebootMode: tryb ponownego uruchamiania.

    reason String: w przypadku ponownego uruchamiania.

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    metoda pomocnicza do rzucania wyjątkiem, jeśli uprawnienia czasu działania nie są obsługiwane

    Rzuty
    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żyć.

    Zwroty
    IRunUtil

    initializeConnection

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

    Parametry
    info IBuildInfo

    attributes MultiMap

    Rzuty
    DeviceNotAvailableException
    TargetSetupError

    internalGetProperty

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

    Pobierać właściwości urządzenia z pamięci podręcznej ddmlib domyślnie, a w przeciwnym razie używać 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 zwracana przez polecenie „adb shell getprop”

    fastbootVar String: nazwa zmiennej fastboot, której dotyczy zapytanie. Jeśli jest to wartość null, nie będzie wysyłane zapytanie fastboot.

    description String: prosty opis zmiennej. Pierwsza litera powinna być duża.

    Zwroty
    String Ciąg tekstowy, który może być null lub pusty, zawierający wartość danej właściwości.

    Rzuty
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

    Zwraca informację, czy wywołania zwrotne ponownego uruchamiania są obecnie wykonywane. Jeśli wartość jest równa true, 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 jest dokładny do minuty, w przypadku równych czasów plik jest uważany za nowszy.

    Parametry
    localFile File

    entry IFileEntry

    Zwroty
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    Informuje wszystkie IDeviceActionReceiver o zdarzeniu zakończenia ponownego uruchamiania.

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

    Informuje wszystkie IDeviceActionReceiver o zdarzeniu rozpoczęcia ponownego uruchamiania.

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    performDeviceAction

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

    Wykonywanie czynności na tym urządzeniu. Próbuje odzyskać urządzenie i opcjonalnie powtórzyć polecenie, jeśli działanie się nie powiedzie.

    Parametry
    actionDescription String: krótki opis działania, które należy wykonać. Służy tylko do celów rejestrowania.

    action NativeDevice.DeviceAction: działanie do wykonania

    retryAttempts int: próby ponownego wykonania działania, jeśli nie powiodło się, ale udało się przywrócić

    Zwroty
    boolean true, jeśli działanie zostało wykonane;

    Rzuty
    DeviceNotAvailableException jeśli próba odzyskania nie powiedzie się lub zostanie wykonana maksymalna liczba prób;

    postAdbReboot

    protected void postAdbReboot ()

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

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

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

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Parametry
    remoteFilePath String

    localFile File

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    setClock

    protected void setClock (Clock clock)

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

    Parametry
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Oznacza TestDevice jako microdroid i ustala jego identyfikator CID.

    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 z użyciem zmiennych środowiskowych i zgłasza stan tego 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 czeka na dostępność.

    time long: czas oczekiwania na wystąpienie niedostępności.

    Zwroty
    boolean Wartość „prawda”, jeśli urządzenie jest niedostępne.