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 funkcja jest obecnie obsługiwana na minimalnym obsługiwanym poziomie.

boolean checkConnectivity()

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

boolean clearErrorDialogs()

Spróbuj zamknąć wszystkie okna dialogowe błędów aktualnie wyświetlane 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)

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

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 podaną nazwą i podanymi flagami

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

Utwórz użytkownika z podaną nazwą i podanymi flagami

int createUser(String name)

Utwórz użytkownika z danym imieniem i domyślnymi flagami 0.

int createUserNoThrow(String name)

Utwórz użytkownika o podanej nazwie i domyślnych flagach 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, przez porównanie bieżącego 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 poziom główny adb.

void disableKeyguard()

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

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 roota 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ługo uruchomione polecenie szybkiego rozruchu w postaci polecenia systemowego z systemowymi zmiennymi środowiskowymi.

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 powłoki adb z większą liczbą parametrów sterujących działaniem polecenia.

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów sterujących działaniem polecenia.

void executeShellCommand(String command, IShellOutputReceiver receiver)

Wykonuje podane polecenie powłoki adb. Jeśli polecenie się nie powiedzie, ponawiam próbę wiele razy.

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.

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 powłoki adb z większą liczbą parametrów sterujących działaniem polecenia.

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów sterujących działaniem polecenia.

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów sterujących działaniem 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)

Pobranie informacji o pakiecie zainstalowanym na urządzeniu.

getAppPackageInfos()

Pobiera informacje o pakietach zainstalowanych na urządzeniu.

String getBasebandVersion()

Wygodny sposób na uzyskanie wersji pasma podstawowego (radio) tego urządzenia.

Integer getBattery()

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

boolean getBooleanProperty(String name, boolean defaultValue)

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

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 przydzielone, w przeciwnym razie zwraca bieżący element DeviceDescriptor.

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Zwraca DeviceDescriptor z pamięci podręcznej, jeśli urządzenie jest przydzielone. W przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

String[] getChildren(String path)

Alternatywa dla funkcji IFileEntry, która czasami nie działa ze względu na uprawnienia.

AbstractConnection getConnection()

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

ContentProviderHandler getContentProvider(int userId)

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

Pobierz klasę urządzenia.

long getDeviceDate()

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

DeviceDescriptor getDeviceDescriptor()

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

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Zwracać 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 do określania ilości wolnego miejsca w pamięci zewnętrznej urządzenia.

String getFastbootPath()

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

String getFastbootProductType()

Metoda ułatwiająca uzyskanie typu urządzenia w trybie Fastboot.

String getFastbootProductVariant()

Wygodna metoda pobierania typu produktu, gdy urządzenie działa w trybie szybkiego rozruchu.

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 pliku binarnego fastboot.

IFileEntry getFileEntry(String path)

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

IFileEntry getFileEntry(FileListingService.FileEntry entry)

Nieoficjalny pomocnik pobierania FileEntry ze ścieżki innej niż główna.

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ść całkowitą danej właściwości z urządzenia.

String getIpAddress()

Pobiera adres IP urządzenia.

KeyguardControllerState getKeyguardState()

Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest 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ń zrzutu danych z logcat.

InputStreamSource getLogcat(int maxBytes)

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

InputStreamSource getLogcatDump()

Pobierz zrzut bieżącego logcata na urządzeniu.

InputStreamSource getLogcatSince(long date)

Pobiera strumień zrzutów zarejestrowanych danych logcat od podanej daty.

String getMacAddress()

Zwraca adres MAC urządzenia lub wartość null, jeśli nie wysyła zapytania z tego urządzenia.

Integer getMainUserId()

Zwraca identyfikator głównego użytkownika.

getMainlineModuleInfo()

Uzyskaj informacje o modułach mainline 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łączania.

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 przeanalizowaną wersję informacji z folderu /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)

Pobiera zrzut ekranu z urządzenia.

InputStreamSource getScreenshot()

Robi zrzut ekranu z urządzenia.

String getSerialNumber()

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

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

Zwraca wartość żądanego ustawienia.

String getSetting(String namespace, String key)

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

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

long getTotalMemory()

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

String getTrackingSerial()

Do zarządzania urządzeniem pobierz numer seryjny służący do śledzenia urządzenia.

getUninstallablePackageNames()

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

boolean getUseFastbootErase()

Określ, czy do wyczyszczenia partycji na urządzeniu chcesz użyć formatu szybkiego rozruchu lub szybkiego rozruchu.

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.

Przetwarza zdarzenie DeviceEvent, które może (ale nie musi) przełączyć urządzenie do nowego stanu przydziału.

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 pakiet na Androida na urządzeniu.

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ść Prawda, jeśli ścieżka na urządzeniu jest katalogiem. W przeciwnym razie ma wartość Fałsz.

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

Wartość true (prawda), jeśli urządzenie nie ma interfejsu graficznego (nie ma ekranu). W przeciwnym razie ma wartość false (fałsz).

boolean isHeadlessSystemUserMode()

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

boolean isMainUserPermanentAdmin()

Zwraca informację o tym, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani obniżyć jego statusu administratora.

boolean isMultiUserSupported()

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

boolean isPackageInstalled(String packageName, String userId)

Wyślij do urządzenia zapytanie o nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy to urządzenie jest obecnie zainstalowane dla tego użytkownika.

boolean isPackageInstalled(String packageName)

Wyślij do urządzenia zapytanie o podaną nazwę pakietu, aby sprawdzić, czy jest aktualnie zainstalowane.

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 kontekście 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 dzienniku autorów.

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 będzie można przywrócić urządzenie do trybu online.

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 kroki wymagane do czyszczenia na danym urządzeniu, które 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)

Wygodny sposób na pobranie pliku z pamięci zewnętrznej urządzenia, zapisanie go w lokalnym tymczasowym pliku ERROR(/File) i zwrócenie odwołania do tego elementu (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 atrybutu pushFile(File, String), który może opcjonalnie wziąć pod uwagę 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)

Uruchamia ponownie urządzenie w trybie adb z podaną wartością reason, która jest zachowywana po ponownym uruchomieniu.

void reboot()

Uruchom ponownie urządzenie w trybie adb.

void rebootIntoBootloader()

Uruchom 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 odzyskiwania).

Blokuje, dopóki urządzenie nie przejdzie w tryb ładowania z innego urządzenia

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

void rebootUntilOnline()

Alternatywna metoda reboot(), która blokuje działanie tylko do momentu, aż urządzenie będzie online, tj. 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óbuje odzyskać komunikację z urządzeniem.

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver na tym urządzeniu.

void remountSystemReadOnly()

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

void remountSystemWritable()

Ustaw partycję systemową na urządzeniu jako 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 z konta danego użytkownika i zwróć true, jeśli operacja się uda. 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 co najmniej 1 słuchaczem przekazanym jako parametr.

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)

Działa tak samo jak ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), ale uruchamia test 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 pliku binarnego 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 oczekiwania (w ms) przed rozpoczęciem przechwytywania dzienników logcat przez urządzenie 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 metodę setSetting(int, String, String, String) i wykonano ją na koncie użytkownika systemu.

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

Dodaje wartość 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 czy fastboot format 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ć czynności na tym wyświetlaczu).

void stopEmulatorOutput()

Zamknij i usuń dane wyjściowe emulatora.

void stopLogcat()

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

boolean stopUser(int userId)

Zatrzymuje danego użytkownika.

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

Zatrzymać danego użytkownika.

String switchToAdbTcp()

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

boolean switchToAdbUsb()

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

boolean switchUser(int userId)

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

boolean switchUser(int userId, long timeout)

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

boolean syncFiles(File localFileDir, String deviceFilePath)

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

Bugreport takeBugreport()

Przejmuje zgłoszenie błędu 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()

Odłącz pliki debugowania.

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 działanie urządzenia w stanie „adbrecovery” (to coś innego niż IDeviceRecovery).

boolean waitForDeviceInSideload(long waitTime)

Blokuje urządzenie w stanie „adb sideload”.

boolean waitForDeviceNotAvailable(long waitTime)

Blokady związane z brakiem dostępności urządzenia, np. brak dostępu do narzędzia adb

void waitForDeviceOnline()

Blokuje, dopóki urządzenie nie będzie widoczne w narzędziu 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)

Ponownie uruchom narzędzie 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()

Pobierz 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 domyślnego pamięci podręcznej ddmlib, a w razie potrzeby z polecenia `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()

Powiadamia wszystkie urządzenia IDeviceActionReceiver o zdarzeniu zakończenia restartu.

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 (zatrzymaj raportowanie do adb).

Stałe

INVALID_USER_ID

public static final int INVALID_USER_ID

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

Wartość stała: -10 000 (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

ŚCIEŻKA_DEBUGFS

public static final String DEBUGFS_PATH

KARTA_SD

protected static final String SD_CARD

ZMIENNO MIEJSCE NA DANE

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ązane pole IDevice

stateMonitor IDeviceStateMonitor: mechanizm IDeviceStateMonitor do użycia

allocationMonitor IDeviceMonitor: element IDeviceMonitor informuje o zmianach stanu alokacji. Może być null

Metody publiczne

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Mikrooptymalizacja (około 400 milisekund) poprzez wstępne pobieranie wszystkich potrzebnych rekwizytów, zamiast wywoływania dla każdego z nich polecenia „adb getprop”. Oznacza to, że pobieranie wszystkich właściwości przebiega równie szybko, jak pobieranie. 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 trakcie odzyskiwania lub podczas pobierania zasobów wystąpią inne błędy, zostaną one zignorowane.

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 udostępnione, 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 okien dialogowych lub zostały one wyczyszczone. 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).

połącz_sieciWifi

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: określa, czy ma szukać ukrytych identyfikatorów SSID tej sieci.

Zwroty
boolean true, jeśli udało się połączyć 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: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć

wifiPsk String: hasło PSK lub wartość 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 po każdym ponownym uruchomieniu instancja będzie próbowała je przywrócić, aż zostanie wywołana funkcja ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork().f

Parametry
wifiSsidToPsk : mapa identyfikatorów SSID sieci Wi-Fi z hasłami.

Zwroty
boolean true, jeśli udało się połączyć 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: identyfikator SSID 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 ma skanować w poszukiwaniu ukrytego identyfikatora 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

utwórzUżytkownik

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

utwórzUżytkownik

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 podanej nazwie i domyślnych flagach 0.

Parametry
name String: użytkownika do utworzenia na urządzeniu

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

Rzuty
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

Utwórz użytkownika z danym imieniem i domyślnymi flagami 0.

Parametry
name String: użytkownika do utworzenia na urządzeniu

Zwroty
int liczba całkowita utworzonego identyfikatora użytkownika lub -1 – błąd.

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

urządzenie zostało ponownie uruchomione

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

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 zresetowane od czasu UTC od początku epoki na urządzeniu i jego ERROR(/TimeUnit). Miękkie ponowne uruchomienie to ponowne uruchomienie system_servera poza twardym restartem urządzenia (np. żądanym przez użytkownika). 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óby wyłączenia blokady 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 frameworka ma sporadyczne warunki wyścigu. Następnie wysyłane jest polecenie odblokowania klawiatury (działa tylko w przypadku klawiatur 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 uda się odłączyć od sieci Wi-Fi. 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óry ma zostać sprawdzony

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

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

Rzuty
DeviceNotAvailableException

niePlikIstnieje

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óry ma zostać sprawdzony

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, na którym ma zostać zapisana kopia.

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

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

Rzuty
DeviceNotAvailableException

włącz AdbRoot

public boolean enableAdbRoot ()

Włącza roota 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 będzie zablokowana, dopóki urządzenie nie będzie 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 włączono monitorowanie. false.

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.

Gdy tylko jest to możliwe, należy używać metody executeShellCommand(String), ponieważ zapewnia ona lepsze wykrywanie błędów i wyższą wydajność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie zostaje uznane 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.

Gdy tylko jest to możliwe, należy używać metody executeShellCommand(String), ponieważ zapewnia ona lepsze wykrywanie błędów i wyższą wydajność.

Parametry
cmdArgs String: polecenie adb i argumenty do uruchomienia

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

Rzuty
DeviceNotAvailableException

wykonaj FastbootCommand

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 wynik CommandResult zawierający dane wyjściowe polecenia

Rzuty
DeviceNotAvailableException

wykonaj FastbootCommand

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

Metoda pomocnicza, która uruchamia polecenie szybkiego rozruchu 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 wynik CommandResult zawierający dane wyjściowe polecenia

Rzuty
DeviceNotAvailableException

WykonajLongFastbootCommand

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 wynik CommandResult zawierający dane wyjściowe polecenia

Rzuty
DeviceNotAvailableException

executeLongFastbootCommand

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

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

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

Parametry
envVarMap : systemowe zmienne środowiskowe używane przez polecenie szybkiego rozruchu.

cmdArgs String: polecenie fastboot i argumenty do uruchomienia

Zwroty
CommandResult wynik 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 retryAttempts zostanie wykonane bez powodzenia, zostanie zgłoszony wyjątek DeviceNot Adjust.

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 czas oczekiwania na wykonanie polecenia; jednostka podana w parasm timeUnit

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 ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts zostanie wykonane bez powodzenia, zostanie zgłoszony wyjątek DeviceNot Adjust.

Rzuty
DeviceNotAvailableException

WykonajShellCommand

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 obiektu 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 do uruchomienia.

Zwroty
CommandResult Wynik w formacie CommandResult.

Rzuty
DeviceNotAvailableException

WykonajShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako CommandResult z prawidłowo wypełnionym stanem polecenia i stderr. stdout jest kierowany 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

WykonajShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki w postaci pola CommandResult prawidłowo wypełnionego danymi wyjściowymi o stanie polecenia: stdout i stderr.

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

pipeAsInput File: pole ERROR(/File), które zostanie przesłane potokiem jako dane wejściowe do polecenia, lub wartość 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 powłoki adb do uruchomienia

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

timeUnit TimeUnit: jednostka za maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia 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 powłoki adb do uruchomienia

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w 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 przekazany jako dane wejściowe polecenia lub będzie miał wartość null.

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

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka podana w parasm timeUnit

timeUnit TimeUnit: jednostka za maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia 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 powłoki adb do uruchomienia

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

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

pipeToError OutputStream: ERROR(/OutputStream), gdzie zostanie przekierowany błąd standardowy, lub wartość null.

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

timeUnit TimeUnit: jednostka za maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia 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ę na urządzeniu.

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 wynik CommandResult zawierający dane wyjściowe polecenia

Rzuty
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.

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

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

identyfikatory getAndroid

public  getAndroidIds ()

Utwórz mapę znalezionych identyfikatorów Androida pasujących 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. Wersja radiowa zależy od urządzenia, więc może nie zwracać prawidłowych informacji w przypadku niektórych urządzeń. Ta metoda polega na zwracaniu prawidłowej informacji o wersji za pomocą właściwości gsm.version.baseband. Nie jest to prawidłowe w przypadku niektórych urządzeń CDMA. Zwrócona tutaj wersja może nie być zgodna z wersją zgłaszaną za pomocą szybkiego rozruchu i może 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 baterii urządzenia lub wartość null, jeśli poziom baterii jest niedostępny.

Zwroty
Integer

getBoolean Property,

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

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

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

Zwroty
boolean true, jeśli właściwość ma wartość "1", "y", "yes", "on" lub "true", false, jeśli właściwość ma wartość "0", "n", "no", "off", "false" lub defaultValue w innym przypadku.

Rzuty
DeviceNotAvailableException

getBootHistory

public  getBootHistory ()

Metoda pomocnicza zbiera mapę historii uruchamiania z informacjami o czasie uruchomienia i przyczynie uruchamiania.

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

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 urządzenia od początku epoki.

timeUnit TimeUnit: jednostka czasu TimeUnit.

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

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 na przykład urządzenie jest w trybie fastboot, spróbuje pobrać wersję z tego trybu.

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

Rzuty
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

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

Na pewno będzie działać na urządzeniach bez karty SD (lub na których nie jest ona jeszcze podłączona).

Zwroty
InputStreamSource Interfejs InputStreamSource, który na żądanie utworzy treść raportu o błędzie. W przypadku błędu funkcja InputStreamSource zwróci pustą wartość ERROR(/InputStream).

getBugreportz

public InputStreamSource getBugreportz ()

Pobiera z urządzenia raport o błędach. 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 to zwykle bardziej czytelny ciąg niż identyfikator kompilacji (zwykle liczba w przypadku kompilacji Nexusów). Na przykład ostateczna wersja Androida 4.2 ma alias kompilacji JDQ39 i identyfikator kompilacji 573038.

Zwroty
String aliasu kompilacji lub, jeśli nie można go pobrać, użyć identyfikatora kompilacji.

Rzuty
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

Pobierz wersję kompilacji dla urządzenia.

Zwroty
String wersja 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 DeviceDescriptor z pamięci podręcznej, jeśli urządzenie jest przydzielone. W przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

Zwroty
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Zwraca DeviceDescriptor z pamięci podręcznej, jeśli urządzenie jest przydzielone. W przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

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

Zwroty
DeviceDescriptor

getChildren

public String[] getChildren (String path)

Alternatywa dla funkcji IFileEntry, która czasami nie działa ze względu na uprawnienia.

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

Zwroty
String[] Tablica z ciągiem znaków zawierającym cały plik w ś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 wartość null, jeśli nie jest dostępna.

Dostawcy treści można użyć ponownie, jeśli został utworzony wcześniej za pomocą tego samego elementu 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 ()

Pobierz klasę urządzenia.

Zwroty
String klasa urządzenia String.

getDeviceDate

public long getDeviceDate ()

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

Zwroty
long datę urządzenia w formacie epochalnym.

Rzuty
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Zwracać 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)

Zwracać 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 epoki.

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 logi usługi 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 kilobajtach

Rzuty
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

Zwraca ścieżkę 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 pobierania typu produktu, gdy urządzenie działa w trybie szybkiego rozruchu.

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

getFastbootProductVersion

public String getFastbootProductVariant ()

Metoda ułatwiająca uzyskanie 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 pliku binarnego fastboot. Jeśli coś poszło nie tak, podaj wartość null.

Zwroty
String

pobieranie wpisu z pliku

public IFileEntry getFileEntry (String path)

Pobranie odwołania 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 znaku „/”. (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 nie musi mieć poziomu roota, jak wymaga Ddmlib.

Zwroty
IFileEntry obiekt FileEntryWrapper reprezentujący obiekt 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

GetInstallNames (Nazwa pakietu)

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 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 Pole KeyguardControllerState zawierające zrzut stanu zabezpieczenia klucza i zwraca wartość null, jeśli zapytanie zabezpieczające 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 zwraca statyczny zrzut danych logcat, jeśli urządzenie obecnie odpowiada.

    Zwroty
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

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

    Przydatne w przypadkach, gdy chcesz robić częste zrzuty przechwyconych danych logcat bez naliczania opłaty za potencjalnie duże miejsce na dysku, która wynika z pobrania 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 logcata na urządzeniu. W przeciwieństwie do metody getLogcat() ta metoda zawsze zwraca statyczny zrzut logcat.

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

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

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

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

    Parametry
    date long: format milisekund od początku epoki do chwili rozpoczęcia zrzutu. (można go uzyskać za pomocą funkcji „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
    Na urządzeniu jest obecnie zainstalowanych ERROR(/Set) z String modułów mainline.

    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 Pole ERROR(/List) z wartością MountPointInfo zawierające informacje w 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 do określania ilości wolnego miejsca na partycji urządzenia.

    Parametry
    partition String

    Zwroty
    long ilość wolnego miejsca w kilobajtach

    Rzuty
    DeviceNotAvailableException

    getPrimaryUserId

    public Integer getPrimaryUserId ()

    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

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

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

    Parametry
    processName String: ciąg znaków nazwy 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 produktu na tym urządzeniu.

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

    Zwroty
    String nazwa typu produktu String. Nie będzie miał wartości null

    Rzuty
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

    Metoda wygodna, by pobrać wersję produktu z tego urządzenia.

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

    Zwroty
    String nazwa 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 ()

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

    Zwroty
    ITestDevice.RecoveryMode trybu przywracania używanego w przypadku urządzenia.

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

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

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

    Parametry
    displayId long: wyświetlany identyfikator ekranu, z którego zostanie wykonany zrzut ekranu.

    Zwroty
    InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli nie udało się wykonać zrzutu ekranu.

    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 nie udało się wykonać zrzutu ekranu.

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

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

    Zwroty
    String numer seryjny String,

    getSetting

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

    Zwraca wartość żądanego ustawienia. przestrzeń nazw musi mieć 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

    Pobierz

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

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

    Zwroty
    String

    getSimState

    public String getSimState ()

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

    Zwroty
    String

    getTombstones

    public  getTombstones ()

    Pobierz i zwróć listę elementów tombstone 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 tombstone (pusta, jeśli nie ma żadnych elementów tombstone).

    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

    ZdarzenieAllocationEvent

    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 DeviceEvent, 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:” lub „”.

    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 ponownie zainstalować aplikację

    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: tę funkcję należy wywoływać tylko w przypadkach, gdy wymagana jest wyraźna kontrola udzielania 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

    zainstalujPakiet dla użytkownika

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

    Instalowanie pakietu na 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 w opisie „adb shell pm -h”.

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

    Rzuty
    DeviceNotAvailableException

    zainstalujPakiet dla użytkownika

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

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

    Uwaga: tę funkcję należy wywoływać tylko w przypadkach, gdy wymagana jest wyraźna kontrola udzielania 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: jeśli podczas instalacji powinny być przyznane wszystkie uprawnienia czasu działania.

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

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

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

    Rzuty
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    Zwroty
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

    Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczenie 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 niskiego docelowego poziomu interfejsu SDK podczas instalowania aplikacji

    Zwroty
    boolean Wartość „prawda”, jeśli pomijany jest blok pakietu SDK o niskim docelowym zakresie. W przeciwnym razie wartość false (fałsz)

    Rzuty
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    Sprawdź, czy są podłączone pliki debugf.

    Zwroty
    boolean true, jeśli debugfs jest zamontowany

    Rzuty
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

    Zwracany, jeśli 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 ()

    Wartość true (prawda), jeśli urządzenie nie ma interfejsu graficznego (nie ma ekranu). W przeciwnym razie ma wartość false (fałsz).

    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 Wartość true, jeśli obsługiwany jest wielu użytkowników, w przeciwnym razie wartość false (fałsz)

    Rzuty
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

    Wyślij do urządzenia zapytanie o nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy to urządzenie jest obecnie zainstalowane dla tego użytkownika.

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

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

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

    Rzuty
    DeviceNotAvailableException

    isPackagePackage (Zainstalowany pakiet)

    public boolean isPackageInstalled (String packageName)

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

    Parametry
    packageName String

    Zwroty
    boolean 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 są obsługiwane uprawnienia w czasie działania. W przeciwnym razie ma wartość „false”.

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

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

    Wskazuje, czy urządzenie pozwala na uruchamianie użytkowników w tle w 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 ()

    Wskazuje, czy urządzenie zezwala na uruchamianie użytkowników w tle.

    Jeśli tak, możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean), przekazując wartość wyświetlaną przez 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 wyłączono

    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. Jeśli dane wyjściowe z urządzenia będą niezgodne z oczekiwaniami, wywoła DeviceRuntimeException.

    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” (prawda), jeśli logowanie zakończyło się powodzeniem. W przeciwnym razie ma wartość false (fałsz).

    Rzuty
    DeviceNotAvailableException

    logBugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w dzienniku autorów.

    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.

    logowanie na urządzeniu

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

    Zaloguj wiadomość w logcat urządzenia. Jest to bezpieczne wywołanie, które nie zostanie wykonane nawet w przypadku niepowodzenia logowania.

    Parametry
    tag String: tag, w którym rejestrujemy wiadomość w tagu 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().

    Debugfs

    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 obejmuje ż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

    Konfiguracja postBoot

    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.

    W normalnych okolicznościach ta metoda nie musi być jawnie wywoływana, ponieważ implementacje powinny wykonywać te kroki automatycznie po ponownym uruchomieniu.

    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 kroki wymagane do czyszczenia na danym urządzeniu, które 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 kroki wymagane w przypadku konkretnego urządzenia, które zostaną wykonane przed uruchomieniem 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: katalog lokalny, do którego mają być pobierane pliki

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

    Zwroty
    boolean true, jeśli udało się pobrać plik. 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 udało się pobrać plik. 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: ścieżka bezwzględna do pliku na urządzeniu.

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

    Zwroty
    File Pole ERROR(/File) zawierające zawartość pliku na urządzeniu lub null, jeśli z jakiegokolwiek powodu kopiowanie nie powiodło się (w tym 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 Pole ERROR(/File) zawierające zawartość pliku na urządzeniu lub null, jeśli z jakiegokolwiek powodu kopiowanie nie powiodło się (w tym 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 Pole String zawierające zawartość pliku na urządzeniu lub null, jeśli z jakiegokolwiek powodu kopiowanie nie powiodło się (w tym 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 pliku zdalnego miejsca docelowego

    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 przekazania

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

    Rzuty
    DeviceNotAvailableException

    plik push

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

    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 zdalnego miejsca docelowego

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

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

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

    Blokada do czasu rozpoczęcia przywracania urządzenia

    Rzuty
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

    Uruchamia ponownie urządzenie w trybie wczytywania z boku strony (pamiętaj, że jest to specjalny tryb w trakcie przywracania)

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

    Rzuty
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Uruchamia ponownie urządzenie w trybie wczytywania z boku strony (pamiętaj, że jest to specjalny tryb w trakcie przywracania)

    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

    zrestartujDoOnline

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

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

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

    OSTRZEŻENIE. Obecnie trwa restartowanie przestrzeni użytkownika. Korzystasz z niej na własne ryzyko.

    Rzuty
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

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

    Rzuty
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Próbuje odzyskać komunikację 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 uruchomić ponownie urządzenie.

    Rzuty
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

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

    Rzuty
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Ustaw partycję dostawcy na urządzeniu z możliwością zapisu. Może spowodować ponowne uruchomienie urządzenia.

    Rzuty
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

    Usuń danego administratora urządzenia z konta danego użytkownika i zwróć true, jeśli operacja się uda. 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 w miarę możliwości.

    Rzuty
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    Usuń danego użytkownika z urządzenia.

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

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

    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 co najmniej 1 słuchaczem przekazanym jako parametr.

    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 : detektory 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ę powodzeniem

    Rzuty
    DeviceNotAvailableException

    uruchom Testy instrumentów jakoUżytkownik

    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

    UruchamianieTestówTestów jakoUżytkownik

    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)

    Wstawia używany IConfiguration.

    Parametry
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parametry
    avdInfo GceAvdInfo

    setDate

    public void setDate (Date date)

    ustawia datę na urządzeniu;

    Uwaga: ustawienie daty na urządzeniu wymaga uprawnień roota

    Parametry
    date Date: określ konkretną datę; zostanie użyta data hosta, jeśli null

    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: administratora urządzenia jako właściciela urządzenia.

    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 pliku binarnego 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 jest wywoływana, gdy DDMS przydzieli nowe urządzenie IDevice

    Parametry
    newDevice IDevice: IDevice

    setLogStartOpóźnienie

    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 Jeśli polecenie setprop zakończyło się powodzeniem, zwraca wartość True. W przeciwnym razie zwraca wartość False.

    Rzuty
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Ustaw IDeviceRecovery do użycia 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 przywracania urządzenia, którego chcesz używać.

    Służy do określenia metody odzyskiwania, która ma być używana w przypadku wystąpienia problemu z komunikacją na urządzeniu. Zalecamy stosowanie tej metody tylko wtedy, gdy jest to konieczne (na przykład gdy framework jest niedostępny).

    Parametry
    mode ITestDevice.RecoveryMode: określa, czy tryb „odzyskiwanie do tylko online” ma być włączony.

    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)

    Dodaje wartość ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu. przestrzeń nazw musi mieć 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)

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

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

    Parametry
    useFastbootErase boolean: true, jeśli chcesz użyć szybkiego kasowania, lub false, jeśli chcesz użyć formatowania szybkiego kasowania.

    startLogcat

    public void startLogcat ()

    Rozpocznij przechwytywanie danych wyjściowych 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() i stopLogcat() w kontekście wywołania TF, ponieważ platforma TF uruchamia i zatrzymuje logcat.

    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 w tle dane użytkownika, jeśli jego działanie zostało zatrzymane. Jeśli użytkownik działa już w tle, ta metoda to NOOP. Możliwość dodania dodatkowej flagi, aby poczekać na zastosowanie operacji.

    Parametry
    userId int: użytkownika, który rozpocznie się 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ć czynności na tym wyświetlaczu).

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

    Parametry
    userId int: uż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

    Wyjście emulatora

    public void stopEmulatorOutput ()

    Zamknij i usuń dane wyjściowe emulatora.

    stopLogcat

    public void stopLogcat ()

    Zatrzymaj przechwytywanie danych logcat z urządzenia i usuń aktualnie 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 i systemowego użytkownika.

    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)

    Zatrzymać danego użytkownika. Można podać dodatkowe flagi, aby zaczekać na wykonanie operacji i przymusowo zakończyć działanie użytkownika. Nie można zatrzymać bieżącego i systemowego użytkownika.

    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 TCP lub null, jeśli nie można przełączyć urządzenia

    Rzuty
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

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

    Zwroty
    boolean true, jeśli udało się przełączyć, false w przeciwnym razie.

    Rzuty
    DeviceNotAvailableException

    użytkownik przełączony

    public boolean switchUser (int userId)

    Przełącz się na inny identyfikator użytkownika z domyślnym czasem 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. Spróbuj wyłączyć blokadę klawiszy po pomyślnym zmianie użytkownika.

    Parametry
    userId int

    timeout long: nie udało się poczekać przed zwróceniem wartości false dla użytkownika Switch.

    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 przekazywane są tylko „nowsze” lub nieistniejące pliki. Dlatego koszty operacyjne powinny być stosunkowo niewielkie, jeśli pliki na urządzeniu są już aktualne.

    Ukryte pliki (o nazwach zaczynających się od „.”) są ignorowane.

    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 komputerze docelowym. Wszystkie katalogi w ścieżce pliku muszą być czytelne. Przeniesienie do katalogu /data/local/tmp, gdy adb nie będzie mieć wartości root, zakończy się niepowodzeniem

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

    Rzuty
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    Utwórz raport o błędzie i zwróć go w obiekcie Bugreport, aby go 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

    Odinstaluj pakiet

    public String uninstallPackage (String packageName)

    Odinstaluj pakiet na 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: całkowita wartość 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ć platformę, ale nie wywoła metody postBootSetup(). Z tego powodu urządzenie może nie być w pełni gotowe do testowania, gdy ta metoda zostanie zwrócona.

    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 się, dopóki nie zostanie ustawiona flaga zakończenia rozruchu urządzenia.

    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 do momentu, aż urządzenie będzie widoczne w trybie fastboot. Użyj domyślnego limitu czasu.

    Rzuty
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Blokuje działanie urządzenia w stanie „adbrecovery” (to coś innego niż IDeviceRecovery).

    Parametry
    waitTime long: czas oczekiwania w ms

    Zwroty
    boolean true, jeśli urządzenie uruchomi się w trybie przywracania przed upływem tego 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. W innym przypadku: false

    waitForDeviceOnline

    public void waitForDeviceOnline ()

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

    Pamiętaj, że urządzenie niekoniecznie reaguje na polecenia po zakończeniu. Zamiast tego użyj waitForDeviceAvailable().

    Rzuty
    DeviceNotAvailableException

    Poczekaj naUrządzenieOnline

    public void waitForDeviceOnline (long waitTime)

    Blokuje, dopóki urządzenie nie będzie widoczne w narzędziu 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)

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

    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 utworzony 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 tego restartu.

    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 domyślnego pamięci podręcznej ddmlib, a w razie potrzeby z 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 wartości ma być zapytanie. Jeśli null, nie będzie wysyłane zapytanie fastboot.

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

    Zwroty
    String Ciąg znaków, prawdopodobnie 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

    Jest Nowszy

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Zwróć wartość 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

    powiadamiaj o zakończeniu ponownego uruchamiania

    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

    Wykonuj działanie na urządzeniu

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

    Wykonywanie czynności na tym urządzeniu. Próbuje przywrócić urządzenie i opcjonalnie ponawiać polecenie, jeśli działanie się nie powiedzie.

    Parametry
    actionDescription String: krótki opis działania do wykonania. Służy tylko do celów rejestrowania.

    action NativeDevice.DeviceAction: działanie do wykonania.

    retryAttempts int: jeśli się to nie uda, ponawia próbę, ale przywrócenie się powiedzie,

    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

    Konfiguracja prePostBoot Setup

    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

    Prosty FastbootCommand

    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

    Oczekiwanie naUrządzenieNiedostępne

    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 pojawienie się informacji o niedostępności danych.

    Zwroty
    boolean Wartość „prawda”, jeśli urządzenie stało się niedostępne.