Urządzenie natywne

public class NativeDevice
extends Object implements IManagedTestDevice, IConfigurationReceiver, ITestLoggerReceiver

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


Domyślna implementacja urządzeń z Androidem, które nie są w pełni naładowane (ITestDevice).

Podsumowanie

Zagnieżdżone klasy

class NativeDevice.AdbAction

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

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) za zrestartowanie urządzenia. 

Stałe

int INVALID_USER_ID

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

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

domyślna liczba ponownych prób wykonania polecenia

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 milisekund) poprzez wstępne pobieranie wszystkich potrzebnych rekwizytów, zamiast wywoływania dla każdego z nich polecenia „adb getprop”.

boolean canSwitchToHeadlessSystemUser()

Wskazuje, czy można przełączyć się na użytkownika SYSTEMU bez interfejsu graficznego.

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

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

boolean checkConnectivity()

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

boolean clearErrorDialogs()

Spróbuj zamknąć wszystkie okna dialogowe błędów aktualnie wyświetlane w interfejsie urządzenia.

void clearLastConnectedWifiNetwork()

Usuwa ostatnio używaną sieć Wi-Fi.

void clearLogcat()

Usuwa wszystkie zgromadzone dane logcat.

boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

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

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

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

boolean connectToWifiNetwork( wifiSsidToPsk)

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

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

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

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

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

boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

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

int createUserNoThrow(String name)

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

void deleteFile(String deviceFilePath, int userId)

Metoda pomocnicza do usuwania pliku lub katalogu z urządzenia.

void deleteFile(String deviceFilePath)

Metoda pomocnicza do usuwania pliku lub katalogu z urządzenia.

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało wstępnie uruchomione do kosza, porównując bieżący serwer system_server z poprzednim serwerem system_server ProcessInfo.

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało uruchomione w niewielkim stopniu od czasu UTC od początku epoki na urządzeniu i w 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 do określenia, czy dany użytkownik istnieje na urządzeniu.

boolean doesFileExist(String deviceFilePath)

Metoda pomocnicza określająca, czy plik istnieje na urządzeniu.

File dumpHeap(String process, String devicePath)

Spróbuj zrobić zrzut stosu z serwera system_server.

boolean enableAdbRoot()

Powoduje włączenie poziomu głównego 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 szybkiego rozruchu jako polecenie systemowe z domyślnym czasem oczekiwania wynoszącym 2 minuty.

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

Metoda pomocnicza, która uruchamia polecenie szybkiego rozruchu jako polecenie systemowe.

CommandResult executeLongFastbootCommand(String... cmdArgs)

Metoda pomocnicza, która wykonuje długo uruchomione polecenie szybkiego rozruchu 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 powłoki adb i zwraca dane wyjściowe w postaci 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 powłoki adb i zwraca wyniki w postaci pola CommandResult prawidłowo wypełnionego danymi wyjściowymi o stanie polecenia: stdout i stderr.

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

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 i parametrem stderr.

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.

CommandResult executeShellV2Command(String cmd, 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, 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ę na urządzeniu.

getActiveApexes()

Pobieranie informacji o punktach APEX aktywowanych na urządzeniu.

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 Androida powiązany z identyfikatorem użytkownika (jeśli nie zostanie znaleziony, wartość null).

getAndroidIds()

Utwórz mapę znalezionych identyfikatorów Androida pasujących 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()

Pobieranie informacji 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 uruchamiania z informacjami o czasie uruchomienia i przyczynie uruchamiania.

getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem uruchomienia i przyczyną uruchomienia od określonego czasu od początku epoki z urządzenia i w określonej jednostce czasu.

String getBootloaderVersion()

Wygodna metoda pobierania wersji programu rozruchowego tego urządzenia.

InputStreamSource getBugreport()

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

InputStreamSource getBugreportz()

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

String getBuildAlias()

Pobierz alias kompilacji, na której urządzenie jest obecnie uruchomione.

String getBuildFlavor()

Pobierz rodzaj kompilacji dla urządzenia.

String getBuildId()

Pobierz kompilację, która jest obecnie uruchomiona przez urządzenie.

String getBuildSigningKeys()

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

Zwykle urządzenia z Androidem mogą być podpisywane za pomocą kluczy testowych (np. AOSP) lub kluczy wersji (kontrolowanych przez poszczególnych producentów urządzeń)

DeviceDescriptor getCachedDeviceDescriptor()

Zwraca DeviceDescriptor z pamięci podręcznej, jeśli urządzenie jest przydzielone. W przeciwnym razie zwraca bieżącą wartość 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 składanego lub wartość null, jeśli wystąpiły problemy.

int getCurrentUser()

Zwraca identyfikator obecnie uruchomionego konta użytkownika.

String getDeviceClass()

Pobierz klasę urządzenia.

long getDeviceDate()

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

DeviceDescriptor getDeviceDescriptor()

Zwróć wartość DeviceDescriptor w informacjach o urządzeniu, aby uzyskać o nim informacje bez przekazywania rzeczywistego obiektu urządzenia.

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Zwróć wartość DeviceDescriptor w informacjach o urządzeniu, aby uzyskać o nim informacje bez przekazywania rzeczywistego obiektu urządzenia.

TestDeviceState getDeviceState()

Pobierz stan urządzenia.

long getDeviceTimeOffset(Date date)

Pomoc dotycząca różnicy czasu między urządzeniem a danym elementem ERROR(/Date).

InputStreamSource getEmulatorOutput()

Pobieranie strumienia emulatora stdout i stderr

Process getEmulatorProcess()

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

final File getExecuteShellCommandLog()

Dziennik zawierający wszystkie logi usługi executeShellCommand(String).

long getExternalStoreFreeSpace()

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

String getFastbootPath()

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

String getFastbootProductType()

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

String getFastbootProductVariant()

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

String getFastbootSerialNumber()

Zwraca numer seryjny trybu szybkiego rozruchu.

String getFastbootVariable(String variableName)

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

String getFastbootVersion()

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

IFileEntry getFileEntry(String path)

Pobranie odwołania 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 urządzenia składanego.

IDevice getIDevice()

Zwraca odwołanie do powiązanego pliku ddmlib IDevice.

getInstalledPackageNames()

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

long getIntProperty(String name, long defaultValue)

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

String getIpAddress()

Pobiera adres IP urządzenia.

KeyguardControllerState getKeyguardState()

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

long getLastExpectedRebootTimeMillis()

Zwraca (w milisekundach) czas ostatniego uruchomienia ponownego uruchomienia przez interfejsy Tradefed API od początku epoki (EPOCH) zwróconego przez funkcję System.currentTimeMillis().

int getLaunchApiLevel()

Pobierz pierwszy poziom interfejsu API urządzenia, który został uruchomiony.

InputStreamSource getLogcat()

Pobiera strumień zrzutu danych z logcat.

InputStreamSource getLogcat(int maxBytes)

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

InputStreamSource getLogcatDump()

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

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 główny identyfikator użytkownika.

getMainlineModuleInfo()

Uzyskaj informacje o modułach mainline zainstalowanych na urządzeniu.

int getMaxNumberOfRunningUsersSupported()

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

int getMaxNumberOfUsersSupported()

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

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

Zwrot IDeviceStateMonitor powiązany z urządzeniem.

String getMountPoint(String mountName)

Zwraca punkt podłączania.

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

Zwraca MountPointInfo odpowiadający podanej ścieżce punktu podłączania lub null, jeśli ta ścieżka nie jest podłączona lub z innego powodu nie występuje w /proc/mounts jako punkt podłączania.

getMountPointInfo()

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

TestDeviceOptions getOptions()

Pobierz opcje testowe dla urządzenia.

long getPartitionFreeSpace(String partition)

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

Integer getPrimaryUserId()

Zwraca identyfikator głównego użytkownika.

ProcessInfo getProcessByName(String processName)

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

String getProcessPid(String process)

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

String getProductType()

Wygodna metoda pobierania typu produktu tego urządzenia.

String getProductVariant()

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

String getProperty(String name)

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

ITestDevice.RecoveryMode getRecoveryMode()

Pobierz bieżący tryb przywracania urządzenia.

InputStreamSource getScreenshot(String format)

Pobiera zrzut ekranu z urządzenia.

InputStreamSource getScreenshot(long displayId)

Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze.

InputStreamSource getScreenshot(String format, boolean rescale)

Pobiera zrzut ekranu z urządzenia.

InputStreamSource getScreenshot()

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

Patrz: getSetting(int, String, String) i wykonano je na użytkowniku systemowym.

String getSimOperator()

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

String getSimState()

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

getTombstones()

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

long getTotalMemory()

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

getUninstallablePackageNames()

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

boolean getUseFastbootErase()

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

int getUserFlags(int userId)

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

getUserInfos()

Pobiera Map of useId do UserInfo na urządzeniu.

int getUserSerialNumber(int userId)

Zwraca numer seryjny powiązany z identyfikatorem użytkownika, jeśli został znaleziony, oraz -10000 w pozostałych przypadkach.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

Przetwarza dane zdarzenie DeviceEvent.

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

boolean hasFeature(String feature)

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

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

Zainstaluj pakiet na Androida na urządzeniu.

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 na Androida na urządzeniu danego użytkownika.

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

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

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

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

boolean isBypassLowTargetSdkBlockSupported()

Sprawdź, czy platforma na urządzeniu umożliwia omijanie bloku docelowego SDK o niskim poziomie docelowym podczas instalowania aplikacji

boolean isDebugfsMounted()

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

boolean isDeviceEncrypted()

Zwracany, jeśli urządzenie jest zaszyfrowane.

boolean isDirectory(String path)

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

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

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

boolean isExecutable(String fullPath)

Zwraca wartość Prawda, jeśli ścieżka pliku na urządzeniu to plik wykonywalny. W przeciwnym razie zwraca wartość false (fałsz).

boolean isFastbootEnabled()

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

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

Wskazuje, czy urządzenie używa systemowego trybu użytkownika 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ługa wielu użytkowników jest obsługiwana.

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 działania

boolean isStateBootloaderOrFastbootd()

Zwraca wartość prawda, jeśli urządzenie jest w zakresie TestDeviceState#FASTBOOT lub TestDeviceState.FASTBOOTD.

boolean isUserRunning(int userId)

Sprawdź, czy dany użytkownik jest uruchomiony.

boolean isUserSecondary(int userId)

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

boolean isUserVisible(int userId)

Sprawdza, czy dany użytkownik jest widoczny.

boolean isUserVisibleOnDisplay(int userId, int displayId)

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

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

boolean isVisibleBackgroundUsersSupported()

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

boolean isWifiEnabled()

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

listDisplayIds()

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

listDisplayIdsForStartingVisibleBackgroundUsers()

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

listUsers()

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

boolean logAnrs(ITestLogger logger)

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

boolean logBugreport(String dataName, ITestLogger listener)

Metoda pomocnicza, która powoduje wygenerowanie raportu o błędzie i zarejestrowanie go u zgłaszających.

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

Zapisz komunikat w dzienniku urządzenia.

void mountDebugfs()

Zamontuj pliki debugowania.

void nonBlockingReboot()

Wyświetla polecenie ponownego uruchomienia urządzenia i zwraca po wykonaniu polecenia, gdy urządzenie nie jest już widoczne dla adb.

void postAdbRootAction()

Zastąp, jeśli urządzenie wymaga wykonania określonych działań po zrzucie roota adb, ale zanim znów będzie online.

void postAdbUnrootAction()

Zastąp, jeśli urządzenie wymaga wykonania określonych działań po usunięciu z programu adb root i przed powrociem urządzenia do trybu online.

void postBootSetup()

Wykonaj instrukcje konfigurowania urządzenia 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 kroki wymagane w przypadku konkretnego urządzenia, które zostaną wykonane przed wywołaniem.

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, zapisuje go w lokalnym tymczasowym pliku ERROR(/File) i zwraca ten plik: File.

File pullFile(String remoteFilePath)

Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym pliku ERROR(/File) i zwraca ten plik: 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)

Rekurencyjnie przesyłaj zawartość katalogów na urządzenie, wykluczając jednocześnie niektóre odfiltrowane katalogi.

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)

Przekaż plik na urządzenie.

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

Przekaż plik na urządzenie.

boolean pushString(String contents, String remoteFilePath)

Przekaż plik utworzony z ciągu znaków na urządzenie

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

Ponownie uruchamia tryb adb na urządzeniu.

void rebootIntoBootloader()

Uruchamia ponownie urządzenie w trybie programu rozruchowego.

void rebootIntoFastbootd()

Uruchamia urządzenie w trybie fastbootd.

void rebootIntoRecovery()

Uruchamia ponownie urządzenie w trybie odzyskiwania adb.

void rebootIntoSideload()

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

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

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, dopóki urządzenie nie przejdzie w tryb pobierania z innego urządzenia

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)

Alternatywna metoda reboot(), która blokuje działanie tylko do momentu, aż urządzenie będzie online, tj. widoczne dla adb.

void rebootUserspace()

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

void rebootUserspaceUntilOnline()

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

boolean recoverDevice()

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

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver dla tego urządzenia.

void remountSystemReadOnly()

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

void remountSystemWritable()

Włącz zapis partycji systemowej na urządzeniu.

void remountVendorReadOnly()

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

void remountVendorWritable()

Ustaw partycję dostawcy na urządzeniu z możliwością 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 w miarę możliwości.

boolean removeUser(int userId)

Usunąć danego użytkownika z urządzenia.

void resetContentProviderSetup()

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

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

Wygodna metoda wykonywania funkcji ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z co najmniej jednym detektorem przekazywanym jako parametr.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

Przeprowadza testy instrumentacji i umożliwia przywracanie urządzenia.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)

Tak samo jak w zasadzie ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), ale uruchamia test 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)

Wstawia używany IConfiguration.

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

Ustawia datę na urządzeniu

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

boolean setDeviceOwner(String componentName, int userId)

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

void setDeviceState(TestDeviceState deviceState)

aktualizować stan urządzenia,

void setEmulatorOutputStream(SizeLimitedOutputStream output)

Aby emulator ustaw SizeLimitedOutputStream tak, by logował dane wyjściowe

void setEmulatorProcess(Process p)

Ustawia funkcję Process, gdy to urządzenie jest emulatorem.

void setFastbootEnabled(boolean fastbootEnabled)

Ustaw opcję Szybki rozruch urządzenia.

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 dla urządzenia

boolean setProperty(String propKey, String propValue)

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

void setRecovery(IDeviceRecovery recovery)

Ustaw aplikację IDeviceRecovery, która ma być używana na tym urządzeniu.

void setRecoveryMode(ITestDevice.RecoveryMode mode)

Ustaw bieżący tryb przywracania urządzenia, którego chcesz używać.

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

Patrz: setSetting(int, String, String, String) i wykonano je na użytkowniku systemowym.

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

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

void setTestLogger(ITestLogger testLogger)

Wstawia instancję ITestLogger

void setUseFastbootErase(boolean useFastbootErase)

Określ, czy do wyczyszczenia partycji na urządzeniu chcesz używać formatu Szybki rozruch, czy formatu Szybki rozruch.

void startLogcat()

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

boolean startUser(int userId)

Uruchamia w tle dane użytkownika, jeśli jego działanie zostało zatrzymane.

boolean startUser(int userId, boolean waitFlag)

Uruchamia w tle dane użytkownika, jeśli jego działanie zostało zatrzymane.

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

Uruchamia użytkownika w tle, co jest widoczne na danym wyświetlaczu (pozwala mu uruchamiać działania na tym ekranie).

void stopEmulatorOutput()

Zamknij i usuń dane wyjściowe emulatora.

void stopLogcat()

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

boolean stopUser(int userId)

Zatrzymuje dane 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 inny identyfikator użytkownika z domyślnym czasem 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()

Utwórz raport o błędzie i zwróć go w obiekcie Bugreport, aby go obsłużyć.

String uninstallPackage(String packageName)

Odinstaluj pakiet na Androida z urządzenia.

String uninstallPackageForUser(String packageName, int userId)

Odinstalować pakiet na Androida z urządzenia danego użytkownika.

boolean unlockDevice()

Odblokowuje urządzenie, jeśli jest zaszyfrowane.

void unmountDebugfs()

Odłącz pliki debugowania.

boolean waitForBootComplete(long timeOut)

Blokuje się, dopóki nie zostanie ustawiona flaga ukończenia rozruchu urządzenia.

boolean waitForDeviceAvailable()

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

boolean waitForDeviceAvailable(long waitTime)

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

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Czekam, aż urządzenie będzie gotowe i reaguje, bez uwzględniania ścieżki odzyskiwania.

void waitForDeviceBootloader()

Blokuje do momentu, aż urządzenie będzie widoczne w trybie fastboot.

boolean waitForDeviceInRecovery(long waitTime)

Blokuje stan urządzenia „adbrecovery” (to coś innego niż IDeviceRecovery).

boolean waitForDeviceInSideload(long waitTime)

Blokuje urządzenie w stanie „adb z innego urządzenia”

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 w narzędziu adb.

boolean waitForDeviceShell(long waitTime)

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

Metody chronione

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

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

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

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

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

Ponownie uruchom narzędzie adb.

void ensureRuntimePermissionSupported()

metoda pomocnicza zgłaszania wyjątku, jeśli uprawnienia w czasie 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)

Pobierz właściwość urządzenia z domyślnej pamięci podręcznej ddmlib i przełącz się na „adb shell getprop” lub „fastboot getvar” w zależności od tego, czy urządzenie działa w trybie Fastboot Fastboot.

boolean isInRebootCallback()

Wskazuje, czy są obecnie wykonywane wywołania zwrotne ponownego uruchomienia.

boolean isNewer(File localFile, IFileEntry entry)

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

void notifyRebootEnded()

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

void notifyRebootStarted()

Powiadamia wszystkie urządzenia IDeviceActionReceiver o zdarzeniu ponownego uruchomienia urządzenia.

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

Wykonuje czynność na urządzeniu.

void postAdbReboot()

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

void prePostBootSetup()

Zezwala każdemu typowi urządzeń (AndroidNativeDevice, TestDevice) na zastąpienie tej metody w przypadku określonej konfiguracji po rozruchu.

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

Ustaw używaną instancję Zegara.

void setMicrodroidProcess(Process process)

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

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

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

CommandResult simpleFastbootCommand(long timeout, String[] fullCmd)

Wykonuje proste polecenie fastboot i zgłasza stan polecenia.

boolean waitForDeviceNotAvailable(String operationDesc, long time)

Poczekaj, aż urządzenie stanie się niedostępne (zatrzymaj raportowanie do adb).

Stałe

NIEPRAWIDŁOWY_IDENTYFIKATOR_UŻYTKOWNIKA

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 ponownych prób 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

Opcje m.

protected TestDeviceOptions mOptions

Monitor stanu m

protected final IDeviceStateMonitor mStateMonitor

Konstruktory publiczne

Urządzenie natywne

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

Tworzy TestDevice.

Parametry
device IDevice: powiązane pole IDevice

stateMonitor IDeviceStateMonitor: mechanizm IDeviceStateMonitor używany do użycia,

allocationMonitor IDeviceMonitor: element IDeviceMonitor informuje o zmianach stanu alokacji. Może mieć wartość 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 zawierają wywołania „adb getprop”. Pobieramy je w ramach jednego wywołania i wywołujemy funkcję NativeDevice.set Property. Nawet jeśli tego nie zrobimy, NativeDevice wywoła funkcję setproperty i zapisze wynik w pamięci podręcznej na potrzeby przyszłych wywołań. Właśnie robimy to trochę wcześniej. Jeśli urządzenie jest w trakcie odzyskiwania lub podczas pobierania zasobów wystąpią inne błędy, zostaną one zignorowane.

MożePrzełącz naUżytkownik systemu bez interfejsu graficznego

public boolean canSwitchToHeadlessSystemUser ()

Wskazuje, czy można przełączyć się na użytkownika SYSTEMU bez interfejsu graficznego.

Zwroty
boolean

Rzuty
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

Rzuty
DeviceNotAvailableException

sprawdź połączenia

public boolean checkConnectivity ()

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

Zwroty
boolean true, jeśli urządzenie ma działające połączenie sieciowe, false (przez limit).

Rzuty
DeviceNotAvailableException

ClearErrorDialogs

public boolean clearErrorDialogs ()

Spróbuj zamknąć wszystkie okna dialogowe błędów aktualnie wyświetlane w interfejsie urządzenia.

Zwroty
boolean true, jeśli nie było żadnych okien dialogowych lub zostały one wyczyszczone. W przeciwnym razie: false.

Rzuty
DeviceNotAvailableException

wyczyśćLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Usuwa ostatnio używaną sieć Wi-Fi. Tę opcję należy wywoływać przy rozpoczynaniu nowego wywołania, aby po zrestartowaniu urządzenia nie łączyć się z siecią Wi-Fi używaną w poprzednim teście.

ClearLogcat

public void clearLogcat ()

Usuwa wszystkie zgromadzone dane logcat.

Jest to przydatne w przypadkach, gdy chcesz mieć pewność, że funkcja ITestDevice#getLogcat() zwróci tylko dane logów utworzone w określonym momencie (na przykład po zaktualizowaniu kompilacji urządzenia itp.).

połącz_sieciWifi

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

Włącza Wi-Fi i blokuje połączenie, dopóki nie zostanie nawiązane połączenie 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().

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. W przeciwnym razie: false

Rzuty
DeviceNotAvailableException

połącz_sieciWifi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

Włącza Wi-Fi i blokuje połączenie, dopóki z określoną siecią nie zostanie nawiązane połączenie. 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().

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

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

Zwroty
boolean true, jeśli udało się połączyć z siecią Wi-Fi. W przeciwnym razie: false

Rzuty
DeviceNotAvailableException

połącz_sieciWifi

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

Włącza Wi-Fi i blokuje połączenie, dopóki nie zostanie nawiązane połączenie 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. W przeciwnym razie: false

Rzuty
DeviceNotAvailableException

połącz_sieciWifi

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

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

Włącza Wi-Fi i blokuje połączenie, dopóki z określoną siecią nie zostanie nawiązane połączenie. 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().

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

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

scanSsid boolean: określa, czy ma skanować w poszukiwaniu ukrytego identyfikatora SSID tej sieci.

Zwroty
boolean true, jeśli udało się połączyć z siecią Wi-Fi. W przeciwnym razie: false

Rzuty
DeviceNotAvailableException

PołączToWifiSiećW razie potrzeby

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

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

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

Zwroty
boolean true, jeśli udało się połączyć z siecią Wi-Fi. W przeciwnym razie: false

Rzuty
DeviceNotAvailableException

PołączToWifiSiećW razie potrzeby

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Zwroty
boolean true, jeśli udało się połączyć z siecią Wi-Fi. W przeciwnym razie: false

Rzuty
DeviceNotAvailableException

utwórzUżytkownik

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

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

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

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

ephemeral boolean: włącz flagę użytkownika – na bieżąco 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 podaną nazwą i podanymi flagami

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

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

ephemeral boolean: włącz flagę użytkownika – na bieżąco podczas tworzenia

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

Zwroty
int identyfikator utworzonego użytkownika

Rzuty
DeviceNotAvailableException

utwórzUżytkownik

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 utworzona dla identyfikatora użytkownika

Rzuty
DeviceNotAvailableException

createUserNoThrow,

public int createUserNoThrow (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 utworzonego identyfikatora użytkownika lub -1 – błąd.

Rzuty
DeviceNotAvailableException

usuńPlik

public void deleteFile (String deviceFilePath, 
                int userId)

Metoda pomocnicza do usuwania pliku lub katalogu z urządzenia.

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

userId int: identyfikator użytkownika, z którego ma nastąpić usunięcie

Rzuty
DeviceNotAvailableException

usuńPlik

public void deleteFile (String deviceFilePath)

Metoda pomocnicza do usuwania pliku lub katalogu z urządzenia.

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

Rzuty
DeviceNotAvailableException

wyrejestrujUrządzenieDziałanieOdbiornika

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 sprawdzająca, czy urządzenie zostało wstępnie uruchomione do kosza, porównując bieżący serwer system_server z poprzednim serwerem system_server ProcessInfo. Użyj getProcessByName(String), aby otrzymać ProcessInfo.

Parametry
prevSystemServerProcess ProcessInfo: poprzedni proces system_server ProcessInfo.

Zwroty
boolean true w przypadku ponownego uruchomienia urządzenia

Rzuty
DeviceNotAvailableException

Urządzenie zostało ponownie uruchomione od

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało uruchomione w niewielkim stopniu od czasu UTC od początku epoki na urządzeniu i w jego ERROR(/TimeUnit). Miękkie ponowne uruchomienie odnosi się do serwera system_server uruchomionego ponownie poza twardym restartem urządzenia (np. żądanie ponownego uruchomienia). Bieżącą wartość utcEpochTime urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate().

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

timeUnit TimeUnit: jednostka czasu TimeUnit dla danego czasu utcEpochTime.

Zwroty
boolean true w przypadku ponownego uruchomienia urządzenia

Rzuty
DeviceNotAvailableException

wyłącz AdbRoot

public boolean disableAdbRoot ()

Wyłącza poziom główny adb.

Wyłączenie poziomu głównego adb może spowodować odłączenie urządzenia od narzędzia adb. Ta metoda będzie zablokowana, dopóki urządzenie nie będzie dostępne.

Zwroty
boolean true, jeśli się udało.

Rzuty
DeviceNotAvailableException

wyłączanie klawiszy

public void disableKeyguard ()

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

Najpierw poczekaj na gotowość danych wejściowych. Dzieje się tak mniej więcej w tym samym czasie, gdy urządzenie zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ w bieżącej implementacji platformy od czasu do czasu występuje warunek wyścigu. Następnie wysyłane jest polecenie zamykające ekran blokady (działa tylko w przypadku niezabezpieczonych)

Rzuty
DeviceNotAvailableException

wyłączanie monitorowania sieci

public boolean disableNetworkMonitor ()

Wyłącza monitorowanie sieci na urządzeniu.

Zwroty
boolean true, jeśli monitorowanie zostało wyłączone. false.

Rzuty
DeviceNotAvailableException

odłączOdWi-Fi

public boolean disconnectFromWifi ()

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

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

Zwroty
boolean true, jeśli udało się odłączyć od sieci Wi-Fi. false, jeśli nie udało się odłączyć.

Rzuty
DeviceNotAvailableException

isFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Metoda pomocnicza do określenia, czy dany użytkownik istnieje na urządzeniu.

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

userId int: identyfikator użytkownika, z którym ma być sprawdzane istnienie pliku.

Zwroty
boolean true, jeśli plik istnieje, lub false w innym przypadku.

Rzuty
DeviceNotAvailableException

isFileExist

public boolean doesFileExist (String deviceFilePath)

Metoda pomocnicza określająca, czy plik istnieje na urządzeniu.

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

Zwroty
boolean true, jeśli plik istnieje, lub false w innym przypadku.

Rzuty
DeviceNotAvailableException

zrzut stosu

public File dumpHeap (String process, 
                String devicePath)

Spróbuj zrobić zrzut stosu z serwera system_server. Obowiązkiem osoby dzwoniącej jest usunięcie pobranego pliku.

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

Powoduje włączenie poziomu głównego adb. Jeśli ustawienie „enable-root” ma wartość „false”, spowoduje to zarejestrowanie komunikatu i powrót bez włączania roota.

Włączenie poziomu głównego adb może spowodować odłączenie urządzenia od narzędzia adb. Ta metoda będzie zablokowana, dopóki urządzenie nie będzie dostępne.

Zwroty
boolean true, jeśli się udało.

Rzuty
DeviceNotAvailableException

włącz monitorowanie sieci

public boolean enableNetworkMonitor ()

Umożliwia monitorowanie sieci na urządzeniu.

Zwroty
boolean true, jeśli włączono monitorowanie. false.

Rzuty
DeviceNotAvailableException

Wykonaj AdbCommand

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 większą wydajność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie ma zostać uznane za niedziałające, 0 L (bez limitu czasu oczekiwania)

cmdArgs String: polecenie i argumenty adb do uruchomienia

Zwroty
String „stdout” z polecenia. null, jeśli nie udało się wykonać polecenia.

Rzuty
DeviceNotAvailableException

Wykonaj AdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                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 większą wydajność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie ma zostać uznane za niedziałające, 0 L (bez limitu czasu oczekiwania)

envMap : środowisko ustawione dla polecenia

cmdArgs String: polecenie i argumenty adb do uruchomienia

Zwroty
String „stdout” z polecenia. null, jeśli nie udało się wykonać polecenia.

Rzuty
DeviceNotAvailableException

Wykonaj AdbCommand

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 większą wydajność.

Parametry
cmdArgs String: polecenie i argumenty adb do uruchomienia

Zwroty
String „stdout” z polecenia. null, jeśli nie udało się wykonać polecenia.

Rzuty
DeviceNotAvailableException

wykonaj FastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

Metoda pomocnicza, która wykonuje polecenie szybkiego rozruchu jako polecenie systemowe z domyślnym czasem oczekiwania wynoszącym 2 minuty.

Powinna być używana, gdy urządzenie jest już w trybie szybkiego rozruchu.

Parametry
cmdArgs String: polecenie i argumenty szybkiego rozruchu 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.

Powinna być używana, gdy urządzenie jest już w trybie szybkiego rozruchu.

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

cmdArgs String: polecenie i argumenty szybkiego rozruchu 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ługo uruchomione polecenie szybkiego rozruchu jako polecenie systemowe.

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

Parametry
cmdArgs String: polecenie i argumenty szybkiego rozruchu do uruchomienia

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

Rzuty
DeviceNotAvailableException

WykonajLongFastbootCommand

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

Metoda pomocnicza, która wykonuje długo uruchomione polecenie szybkiego rozruchu w postaci polecenia systemowego z systemowymi zmiennymi środowiskowymi.

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

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

cmdArgs String: polecenie i argumenty szybkiego rozruchu do uruchomienia

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

Rzuty
DeviceNotAvailableException

WykonajShellCommand

public String executeShellCommand (String command)

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

Parametry
command String: polecenie powłoki adb do uruchomienia

Zwroty
String wynik powłoki

Rzuty
DeviceNotAvailableException

WykonajShellCommand

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

Parametry
command String: polecenie powłoki adb do uruchomienia

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

maxTimeToOutputShellResponse long: maksymalny czas, w którym polecenie nie może zwrócić żadnej odpowiedzi; 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 zostanie wykonane bez powodzenia, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Rzuty
DeviceNotAvailableException

WykonajShellCommand

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

Parametry
command String: polecenie powłoki adb do uruchomienia

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

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

maxTimeToOutputShellResponse long: maksymalny czas, w którym polecenie nie może zwrócić żadnej odpowiedzi; 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 zostanie wykonane bez powodzenia, zostanie zgłoszony wyjątek DeviceNot Adjust.

Rzuty
DeviceNotAvailableException

WykonajShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

Parametry
command String: polecenie powłoki adb do uruchomienia

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

Rzuty
DeviceNotAvailableException

WykonajShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

Zwroty
CommandResult Wynik w formacie CommandResult.

Rzuty
DeviceNotAvailableException

WykonajShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki w postaci metody CommandResult zawierającej prawidłowo wypełnione dane wyjściowe stanu polecenia i stderr. stdout jest kierowany do określonego strumienia.

Parametry
cmd String: polecenie do uruchomienia.

pipeToOutput OutputStream: ERROR(/OutputStream), gdzie nastąpi przekierowanie ze standardowych danych wyjściowych, lub wartość null.

Zwroty
CommandResult Wynik w formacie 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 do uruchomienia.

pipeAsInput File: pole ERROR(/File), które zostanie przesłane potokiem jako dane wejściowe do polecenia, lub wartość null.

Zwroty
CommandResult Wynik w formacie CommandResult.

Rzuty
DeviceNotAvailableException

WykonajShellV2Command

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

Wykonuje polecenie powłoki adb z większą liczbą parametrów sterujących działaniem 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 zostanie wykonane bez powodzenia, zostanie zgłoszony wyjątek DeviceNot Adjust.

Zwroty
CommandResult

Rzuty
DeviceNotAvailableException

WykonajShellV2Command

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

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

Zwroty
CommandResult

Rzuty
DeviceNotAvailableException

WykonajShellV2Command

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

Parametry
cmd String: polecenie powłoki adb do uruchomienia

pipeAsInput File: pole ERROR(/File), które zostanie przesłane potokiem jako dane wejściowe do polecenia, lub wartość null.

pipeToOutput OutputStream: ERROR(/OutputStream), gdzie nastąpi przekierowanie ze standardowych danych wyjściowych, 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 zostanie wykonane bez powodzenia, zostanie zgłoszony wyjątek DeviceNot Adjust.

Zwroty
CommandResult

Rzuty
DeviceNotAvailableException

WykonajShellV2Command

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

Parametry
cmd String: polecenie powłoki adb do uruchomienia

pipeAsInput File: pole ERROR(/File), które zostanie przesłane potokiem jako dane wejściowe do polecenia, lub wartość null.

pipeToOutput OutputStream: ERROR(/OutputStream), gdzie nastąpi przekierowanie ze standardowych danych wyjściowych, lub 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 zostanie wykonane bez powodzenia, zostanie zgłoszony wyjątek DeviceNot Adjust.

Zwroty
CommandResult

Rzuty
DeviceNotAvailableException

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

Jeśli getUseFastbootErase() ma wartość true, do wyczyszczenia partycji zostanie użyte usunięcie przez szybki rozruch. 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.

Powinna być używana, gdy urządzenie jest już w trybie szybkiego rozruchu.

Parametry
partition String: partycja do wyczyszczenia.

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

Rzuty
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Pobieranie informacji o punktach APEX aktywowanych na urządzeniu.

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 mieć wartość {"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

PobierzAndroida

public String getAndroidId (int userId)

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

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 gwarancji, że każdy identyfikator użytkownika znajdzie identyfikator Androida powiązany z tą funkcją, więc niektóre identyfikatory użytkownika mogą pasować do wartości null.

Zwroty
Mapa znalezionych identyfikatorów Androida pasujących 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)

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

Pobieranie informacji o pakietach zainstalowanych na urządzeniu.

Zwroty
Na urządzeniu zainstalowano ERROR(/List) z PackageInfo.

Rzuty
DeviceNotAvailableException

getBasebandVersion;

public String getBasebandVersion ()

Wygodny sposób na uzyskanie wersji pasma podstawowego (radio) 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 zwraca prawidłowe informacje o wersji, wykorzystując właściwość 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 zgłasza dokładną wersję tylko wtedy, gdy właściwość gsm.version.baseband jest taka sama jak wersja zwrócona przez funkcję 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 ma wartość "0", "n", "no", "off", "false" albo defaultValue inaczej.

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

getBootHistoryFrom

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem uruchomienia i przyczyną uruchomienia od określonego czasu od początku epoki z urządzenia i w określonej jednostce czasu. Bieżącą wartość utcEpochTime urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate().

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

timeUnit TimeUnit: jednostka czasu TimeUnit.

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

Rzuty
DeviceNotAvailableException

getBootloaderVersion;

public String getBootloaderVersion ()

Wygodna metoda pobierania wersji programu rozruchowego tego urządzenia.

Zostanie podjęta próba pobrania wersji programu rozruchowego 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 niepowodzenia InputStreamSource wygeneruje pusty ERROR(/InputStream).

getBugreportz

public InputStreamSource getBugreportz ()

Pobiera z urządzenia raport o błędach. Raport o błędach w formacie ZIP zawiera główny raport o błędzie i inne pliki dziennika, które przydają się przy debugowaniu.

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

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

getBuildAlias

public String getBuildAlias ()

Pobierz alias kompilacji, na której urządzenie jest obecnie uruchomione.

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 alias kompilacji lub użyj identyfikatora kompilacji, jeśli nie udało się go pobrać.

Rzuty
DeviceNotAvailableException

PobierzKompilacjaFlavor

public String getBuildFlavor ()

Pobierz rodzaj kompilacji dla urządzenia.

Zwroty
String rodzaj kompilacji lub wartość null, jeśli nie można go pobrać

Rzuty
DeviceNotAvailableException

getBuildId

public String getBuildId ()

Pobierz kompilację, która jest obecnie uruchomiona przez urządzenie.

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

Rzuty
DeviceNotAvailableException

getBuildingKeys (Klucze podpisywania kompilacji)

public String getBuildSigningKeys ()

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

Zwykle urządzenia z Androidem mogą być podpisywane za pomocą kluczy testowych (np. AOSP) lub kluczy wersji (kontrolowanych przez poszczególnych producentów urządzeń)

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

Rzuty
DeviceNotAvailableException

Deskryptor 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

Deskryptor 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: określa, czy deskryptor ma zostać ograniczony do minimum informacji

Zwroty
DeviceDescriptor

PobierzDzieci

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 można przeprowadzić 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 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 używany do inicjowania dostawcy treści.

Zwroty
ContentProviderHandler

Rzuty
DeviceNotAvailableException

getCurrentFoldableState,

public DeviceFoldableState getCurrentFoldableState ()

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

Zwroty
DeviceFoldableState

Rzuty
DeviceNotAvailableException

getBieżącyUżytkownik

public int getCurrentUser ()

Zwraca identyfikator obecnie uruchomionego konta użytkownika. W przypadku błędu ustaw -10000.

Zwroty
int

Rzuty
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Pobierz klasę urządzenia.

Zwroty
String klasę urządzenia String.

getDeviceDate

public long getDeviceDate ()

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

Zwroty
long jest to data urządzenia w formacie epoki.

Rzuty
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Zwróć wartość DeviceDescriptor w informacjach o urządzeniu, aby uzyskać o nim informacje bez przekazywania rzeczywistego obiektu urządzenia.

Zwroty
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Zwróć wartość DeviceDescriptor w informacjach o urządzeniu, aby uzyskać o nim informacje bez przekazywania rzeczywistego obiektu urządzenia.

Parametry
shortDescriptor boolean: określa, czy deskryptor ma zostać ograniczony do minimum informacji

Zwroty
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

Pobierz stan urządzenia.

Zwroty
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Pomoc dotycząca różnicy czasu między urządzeniem a danym elementem ERROR(/Date). Używaj wewnętrznie czasu epoki.

Parametry
date Date

Zwroty
long różnica w milisekundach

Rzuty
DeviceNotAvailableException

getEmulatorOutput (Wyjście emulatora)

public InputStreamSource getEmulatorOutput ()

Pobieranie strumienia emulatora stdout i stderr

Zwroty
InputStreamSource dane wyjściowe emulatora

getEmulatorProcess,

public Process getEmulatorProcess ()

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

Zwroty
Process Process lub null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Dziennik zawierający wszystkie logi usługi executeShellCommand(String).

Zwroty
File

PobierzExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

Zwroty
long ilość wolnego miejsca w kilobajtach

Rzuty
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

Zwraca ścieżkę używanego pliku binarnego fastboot. Aby funkcje szybkiego rozruchu były włączone, nadal wymaga wartości prawda isFastbootEnabled().

Zwroty
String

getFastbootProductType

public String getFastbootProductType ()

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

Tej metody należy używać tylko wtedy, gdy urządzenie powinno działać w trybie fastboot. W tym przypadku jest to nieco bezpieczniejszy wariant niż ogólnikowa metoda getProductType(), ponieważ ITestDevice będzie w stanie przywrócić urządzenie do trybu szybkiego rozruchu, jeśli urządzenie jest w nieprawidłowym stanie lub nie reaguje.

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

Rzuty
DeviceNotAvailableException

getFastbootProductVersion

public String getFastbootProductVariant ()

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

Tej metody należy używać tylko wtedy, gdy urządzenie powinno działać w trybie fastboot. W tym przypadku jest to nieco bezpieczniejszy wariant niż ogólnikowa metoda getProductType(), ponieważ ITestDevice będzie w stanie przywrócić urządzenie do trybu szybkiego rozruchu, jeśli urządzenie jest w nieprawidłowym stanie lub nie reaguje.

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

Rzuty
DeviceNotAvailableException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Zwraca numer seryjny trybu szybkiego rozruchu.

Zwroty
String

getFastbootvariable

public String getFastbootVariable (String variableName)

Pobierz z urządzenia podaną 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 pliku do pobrania. Może to być ścieżka bezwzględna lub ścieżka względna wobec znaku „/”. (np. obsługiwana jest zarówno składnia „/system”, jak i „system”).

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

Rzuty
DeviceNotAvailableException

pobieranie wpisu z pliku

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Nieoficjalny pomocnik pobierania FileEntry ze ścieżki innej niż główna. FIXME: refaktoryzuj system FileEntry, aby był dostępny z każdej ścieżki. (nawet innego niż pierwiastek).

Parametry
entry FileListingService.FileEntry: FileEntry nie musi mieć poziomu roota, jak wymaga Ddmlib.

Zwroty
IFileEntry Element FileEntryWrapper reprezentujący wpis pliku.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableState,

public  getFoldableStates ()

Zwraca listę stanów urządzenia składanego. Tę wartość można uzyskać za pomocą polecenia „cmd device_state” („print-states”) „cmd device_state”.

Zwroty

Rzuty
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

Zwraca odwołanie do powiązanego pliku ddmlib IDevice.

DDMS może przydzielić nowy IDevice za każdym razem, gdy urządzenie rozłączy się i ponownie połączy z adb. Dlatego elementy wywołujące nie powinny zawierać odwołania do IDevice, ponieważ może ono stać się nieaktualne.

Zwroty
IDevice IDevice

GetInstallNames (Nazwy pakietów)

public  getInstalledPackageNames ()

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

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

Rzuty
DeviceNotAvailableException

getIntproperty

public long getIntProperty (String name, 
                long defaultValue)

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

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

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

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

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

Zwróć obiekt, aby uzyskać bieżący stan blokady klucza lub wartość null, jeśli nie jest 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

getLastExpectedRestartTimeMillis,

public long getLastExpectedRebootTimeMillis ()

Zwraca (w milisekundach) czas ostatniego uruchomienia ponownego uruchomienia przez interfejsy Tradefed API od początku epoki (EPOCH) zwróconego przez funkcję System.currentTimeMillis().

Zwroty
long

getLaunchApiLevel

public int getLaunchApiLevel ()

Pobierz pierwszy poziom interfejsu API urządzenia, który został uruchomiony. Domyślna wartość to UNKNOWN_API_LEVEL.

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

Rzuty
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Pobiera strumień zrzutu danych z logcat.

Działa w 2 trybach:

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

    Zwroty
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

    Pobiera strumień zrzutów ostatnich maxBytes zarejestrowanych 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. Ilość powinna wygodnie mieścić się w pamięci

    Zwroty
    InputStreamSource

    getLogcatDump

    public InputStreamSource getLogcatDump ()

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

    Wadą jest to, że gdy urządzenie jest nieosiągalne, nic nie jest zwracane.

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

    getLogcatWith

    public InputStreamSource getLogcatSince (long date)

    Pobiera strumień zrzutów zarejestrowanych danych logcat od podanej daty. Godzina na urządzeniu powinna być ustawiona na getDeviceDate().

    Parametry
    date long: w formacie milisekundowym od początku epoki, kiedy ma się rozpocząć tworzenie zrzutu dysku do chwili obecnej. (można uzyskać przy użyciu 'data +%s')

    Zwroty
    InputStreamSource

    getMacAddress.

    public String getMacAddress ()

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

    Zwroty
    String

    getMainUserId,

    public Integer getMainUserId ()

    Zwraca główny identyfikator użytkownika.

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

    Rzuty
    DeviceNotAvailableException

    getMainlineModuleInfo

    public  getMainlineModuleInfo ()

    Uzyskaj informacje o modułach mainline zainstalowanych na urządzeniu.

    Zwroty
    Na urządzeniu jest obecnie zainstalowanych ERROR(/Set) z String modułów mainline.

    Rzuty
    DeviceNotAvailableException

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

    Uzyskaj maksymalną liczbę obsługiwanych jednocześnie działających 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 mikrodroidem, zwraca wartość null.

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    Zwrot IDeviceStateMonitor powiązany z urządzeniem.

    Zwroty
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

    Zwraca punkt podłączania.

    Jeśli informacje przechowywane w pamięci podręcznej w aplikacji IDevice nie są dostę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 podanej ścieżce punktu podłączania lub null, jeśli ta ścieżka nie jest podłączona lub z innego powodu nie występuje 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 przeanalizowaną wersję informacji z folderu /proc/mounts na urządzeniu

    Zwroty
    Pole ERROR(/List) z wartością MountPointInfo zawierające informacje w katalogu „/proc/mounts”

    Rzuty
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

    Pobierz opcje testowe dla 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 identyfikator użytkownika głównego (jeśli istnieje) lub wartość null, jeśli nie ma takiego 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 danego procesu

    Rzuty
    DeviceNotAvailableException

    getProcessPid,

    public String getProcessPid (String process)

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

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

    Zwroty
    String

    Rzuty
    DeviceNotAvailableException

    getProductType;

    public String getProductType ()

    Wygodna metoda pobierania typu produktu tego urządzenia.

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

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

    Rzuty
    DeviceNotAvailableException

    wersja_produktu

    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)

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

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

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

    Rzuty
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

    Pobierz bieżący tryb przywracania urządzenia.

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

    Pobierz zrzut ekranu

    public InputStreamSource getScreenshot (String format)

    Pobiera zrzut ekranu z urządzenia. W przypadku mniejszego rozmiaru zalecamy użycie zamiast tego metody getScreenshot(format) z kodowaniem JPEG

    Parametry
    format String: obsługiwany format PNG, JPEG

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

    Rzuty
    DeviceNotAvailableException

    Pobierz zrzut ekranu

    public InputStreamSource getScreenshot (long displayId)

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

    DO ZROBIENIA: rozszerz powyższe implementacje o obsługę „formatu” i „przeskalowania”

    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

    Pobierz zrzut ekranu

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    Pobiera zrzut ekranu z urządzenia. Aby zmniejszyć rozmiar pliku, zalecamy użycie zamiast niego pliku getScreenshot(String) z kodowaniem JPEG.

    Parametry
    format String: obsługiwany format PNG, JPEG

    rescale boolean: jeśli zrzut ekranu należy przeskalować, by zmniejszyć rozmiar wynikowego obrazu.

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

    Rzuty
    DeviceNotAvailableException

    Pobierz zrzut ekranu

    public InputStreamSource getScreenshot ()

    Pobiera zrzut ekranu z urządzenia.

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

    Rzuty
    DeviceNotAvailableException

    getSerialNumber,

    public String getSerialNumber ()

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

    Zwroty
    String numer seryjny String

    Pobierz

    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 przestrzenią nazw:klucz użytkownika. Jeśli nie znaleziono wartości null.

    Rzuty
    DeviceNotAvailableException

    Pobierz

    public String getSetting (String namespace, 
                    String key)

    Patrz: getSetting(int, String, String) i wykonano je na użytkowniku systemowym.

    Parametry
    namespace String

    key String

    Zwroty
    String

    Rzuty
    DeviceNotAvailableException

    Operator getSim

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

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

    Zwroty
    String

    getTombstones,

    public  getTombstones ()

    Pobierz i zwróć listę elementów tombstone z urządzeń. Wymaga roota.

    jest to możliwie najlepsze, więc jeśli z jakiegoś powodu nie uda się pobrać jednego z grobowców, nie będzie go na liście. Tylko 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

    getOdinstalujablePackageNames

    public  getUninstallablePackageNames ()

    Pobierz nazwy pakietów aplikacji, które można odinstalować. Obecnie jest to pakiet niesystemowy i zaktualizowane pakiety systemowe.

    Zwroty
    ERROR(/Set) nazw pakietów String z możliwością odinstalowania zainstalowanych na urządzeniu.

    Rzuty
    DeviceNotAvailableException

    getUżyjSzybkiego rozruchu

    public boolean getUseFastbootErase ()

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

    Zwroty
    boolean true, jeśli używane będzie usuwanie przy użyciu szybkiego rozruchu, lub false, jeśli używany będzie format fastboot.

    getUserFlags,

    public int getUserFlags (int userId)

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

    Parametry
    userId int

    Zwroty
    int flagi powiązane z podanym identyfikatorem użytkownika (jeśli został znaleziony), a w pozostałych przypadkach – -10000.

    Rzuty
    DeviceNotAvailableException

    getUserInfos

    public  getUserInfos ()

    Pobiera Map of useId do UserInfo na urządzeniu. Jeśli dane wyjściowe z urządzenia będą niezgodne z oczekiwaniami, zostanie zwrócony kod DeviceRuntimeException.

    Zwroty
    listę obiektów UserInfo.

    Rzuty
    DeviceNotAvailableException

    getUserSerialNumber,

    public int getUserSerialNumber (int userId)

    Zwraca numer seryjny powiązany z identyfikatorem użytkownika, jeśli został znaleziony, oraz -10000 w pozostałych przypadkach.

    Parametry
    userId int

    Zwroty
    int

    Rzuty
    DeviceNotAvailableException

    ZdarzenieAllocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Przetwarza dane zdarzenie DeviceEvent. Może spowodować przeniesienie urządzenia do nowego stanu. Informują usługę IDeviceMonitor o wszelkich zmianach stanu.

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

    Parametry
    event DeviceEvent

    Zwroty
    IManagedTestDevice.DeviceEventResponse

    hasFeature

    public boolean hasFeature (String feature)

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

    Parametry
    feature String: który powinien mieć format bezpośrednio „feature:” lub „”.

    Zwroty
    boolean Wartość prawda, jeśli funkcja została znaleziona, a fałsz – w przeciwnym razie.

    Rzuty
    DeviceNotAvailableException

    pakiet_instalacyjny

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

    Zainstaluj pakiet na Androida na urządzeniu.

    Parametry
    packageFile File: plik apk do zainstalowania;

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

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

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

    Rzuty
    DeviceNotAvailableException

    pakiet_instalacyjny

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

    Zainstaluj pakiet na Androida na urządzeniu.

    Uwaga: ta funkcja powinna być wywoływana tylko w przypadkach użycia wymagających bezpośredniej kontroli nad przyznawaniem uprawnień czasu działania podczas 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 zostać przyznane wszystkie uprawnienia czasu działania.

    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

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

    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: ta funkcja powinna być wywoływana tylko w przypadkach użycia wymagających bezpośredniej kontroli nad przyznawaniem uprawnień czasu działania podczas 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 zostać 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

    Obsługiwane są aplikacje

    public boolean isAppEnumerationSupported ()

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

    Zwroty
    boolean Wartość prawda, jeśli wyliczanie aplikacji jest obsługiwane. W przeciwnym razie ma wartość false (fałsz)

    Rzuty
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

    Sprawdź, czy platforma na urządzeniu umożliwia omijanie bloku docelowego SDK o niskim poziomie docelowym 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 są podłączone funkcje debugf

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

    Parametry
    path String

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isEnableAdbRoot.

    public boolean isEnableAdbRoot ()

    Zwroty
    boolean true, jeśli na urządzeniu powinna być włączona usługa adb root

    Obsługiwane szyfrowanie

    public boolean isEncryptionSupported ()

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

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

    Rzuty
    DeviceNotAvailableException

    Element isExecutable

    public boolean isExecutable (String fullPath)

    Zwraca wartość Prawda, jeśli ścieżka pliku na urządzeniu to plik wykonywalny. W przeciwnym razie zwraca wartość false (fałsz).

    Parametry
    fullPath String

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

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

    Zwroty
    boolean

    bez interfejsu graficznego

    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

    Tryb użytkownika bez interfejsu graficznego

    public boolean isHeadlessSystemUserMode ()

    Wskazuje, czy urządzenie używa systemowego trybu użytkownika bez interfejsu graficznego.

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isMainUserPermanentAdmin,

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

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    Obsługa wielu użytkowników

    public boolean isMultiUserSupported ()

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

    Zwroty
    boolean Wartość true, jeśli obsługiwany jest wielu użytkowników, w przeciwnym razie wartość false (fałsz)

    Rzuty
    DeviceNotAvailableException

    isPackagePackage (Zainstalowany pakiet)

    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óry sprawdzamy, czy jest zainstalowany.

    userId String: identyfikator użytkownika, dla którego sprawdzamy, czy pakiet jest zainstalowany. Jeśli wartość to null, używany jest użytkownik główny 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)

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

    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 działania

    Zwroty
    boolean Wartość „prawda”, jeśli są obsługiwane uprawnienia w czasie działania. W przeciwnym razie ma wartość „false”.

    Rzuty
    DeviceNotAvailableException

    isStateBootloader lub Fastbootd

    public boolean isStateBootloaderOrFastbootd ()

    Zwraca wartość prawda, jeśli urządzenie jest w zakresie 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 jest uruchomiony, a „fałsz” w pozostałych przypadkach.

    Rzuty
    DeviceNotAvailableException

    JestUżytkownikdodatkowy

    public boolean isUserSecondary (int userId)

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

    Parametry
    userId int

    Zwroty
    boolean true (prawda), jeśli użytkownik jest dodatkowym użytkownikiem, a w przeciwnym razie ma wartość false (fałsz).

    Rzuty
    DeviceNotAvailableException

    isUserVisible

    public boolean isUserVisible (int userId)

    Sprawdza, czy dany użytkownik jest widoczny.

    „Widoczny” użytkownik to osoba wchodząca w interakcję z „człowiekiem”, która może uruchamiać działania związane z uruchamianiem (zwykle na ekranie domyślnym).

    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 osoba wchodząca w interakcję z „człowiekiem”, która może uruchamiać działania związane z uruchamianiem na tym ekranie.

    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świetlenie zwrócone 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 komunikat wyświetlany przez funkcję listDisplayIdsForStartingVisibleBackgroundUsers().

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    isWifiEnabled

    public boolean isWifiEnabled ()

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

    Sprawdza, czy na urządzeniu jest włączone Wi-Fi. Ta opcja jest przydatna do sprawdzania stanu sieci Wi-Fi przed przeprowadzeniem testów, które nie powinny działać z siecią Wi-Fi (np. testów mobilnej transmisji danych).

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

    Rzuty
    DeviceNotAvailableException

    listaDisplayIds

    public  listDisplayIds ()

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

    Zwroty
    Lista wyświetlaczy. Wartość domyślna zawsze zwraca wartość domyślną 0.

    Rzuty
    DeviceNotAvailableException

    Lista

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    Zwroty

    Rzuty
    DeviceNotAvailableException

    listaUżytkowników

    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
    listę identyfikatorów użytkowników.

    Rzuty
    DeviceNotAvailableException

    Logi

    public boolean logAnrs (ITestLogger logger)

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

    Parametry
    logger ITestLogger: ITestLogger używany 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

    Zgłaszanie błędów w logu

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Metoda pomocnicza, która powoduje wygenerowanie raportu o błędzie i zarejestrowanie go u zgłaszających.

    Parametry
    dataName String: nazwa, pod którą będzie raportowany błąd.

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

    Zwroty
    boolean Wartość „true” (prawda), jeśli logowanie zakończyło się powodzeniem. W przeciwnym razie ma wartość false (fałsz).

    logowanie na urządzeniu

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

    Zapisz komunikat w dzienniku 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 pliku logcat.

    format String: format wiadomości.

    args Object: argumenty do zastąpienia za pomocą funkcji String.format().

    Debugfs

    public void mountDebugfs ()

    Zamontuj pliki debugowania.

    Rzuty
    DeviceNotAvailableException

    Nieblokowanie restartu

    public void nonBlockingReboot ()

    Wyświetla polecenie ponownego uruchomienia urządzenia i zwraca po wykonaniu polecenia, gdy urządzenie nie jest już widoczne dla adb.

    Rzuty
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

    Zastąp, jeśli urządzenie wymaga wykonania określonych działań po zrzucie roota adb, ale zanim znów będzie online. Implementacja domyślna nie obejmuje żadnych dodatkowych działań. Nie ma gwarancji, że narzędzie adb root zostanie włączone na tym etapie.

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postAdbUnrootAction

    public void postAdbUnrootAction ()

    Zastąp, jeśli urządzenie wymaga wykonania określonych działań po usunięciu z programu adb root i przed powrociem urządzenia do trybu online. Implementacja domyślna nie obejmuje żadnych dodatkowych działań. Nie ma gwarancji, że narzędzie adb root zostanie wyłączone na tym etapie.

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Konfiguracja postBoot

    public void postBootSetup ()

    Wykonaj instrukcje konfigurowania urządzenia do testowania po każdym uruchomieniu.

    Ta funkcja powinna zostać wywołana 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.

    Może być konieczne wywołanie go w przypadku ponownego uruchomienia urządzenia w wyniku innych zdarzeń (np. po zakończeniu polecenia aktualizacji przez fastboot).

    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: ostatni wyjątek zgłoszony w wyniku niepowodzenia wywołania.

    Konfiguracja wstępnego wywołania

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

    Dodatkowe kroki wymagane w przypadku konkretnego urządzenia, które zostaną wykonane przed wywołaniem.

    Parametry
    info IBuildInfo: IBuildInfo urządzenia.

    attributes MultiMap: atrybuty przechowywane 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 zdalnego źródła

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

    userId int: identyfikator użytkownika, z którego zostanie pobrany

    Zwroty
    boolean true, jeśli udało się pobrać plik. W przeciwnym razie: false.

    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 zdalnego źródła

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

    Zwroty
    boolean true, jeśli udało się pobrać plik. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    pobieranie pliku

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Pobiera plik z urządzenia.

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

    localFile File: plik lokalny, w którym mają być przechowywane treści. Jeśli nie jest puste, zawartość zostanie zastąpiona.

    Zwroty
    boolean true, jeśli plik został pobrany. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    pobieranie pliku

    public File pullFile (String remoteFilePath, 
                    int userId)

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

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

    userId int: identyfikator użytkownika, z którego zostanie pobrany

    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

    pobieranie pliku

    public File pullFile (String remoteFilePath)

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

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

    pobieranie pliku

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

    Pobiera plik z urządzenia.

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

    localFile File: plik lokalny, w którym mają być przechowywane treści. Jeśli nie jest puste, zawartość zostanie zastąpiona.

    userId int: identyfikator użytkownika, z którego zostanie pobrany

    Zwroty
    boolean true, jeśli plik został pobrany. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    PullFileContents

    public String pullFileContents (String remoteFilePath)

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

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

    Zwroty
    String 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

    pobieranie plikuZzewnątrz

    public 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).

    Parametry
    remoteFilePath String: ścieżka do pliku na urządzeniu podana względem punktu podłączania pamięci zewnętrznej urządzenia

    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

    pushDir

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

    Rekurencyjnie przesyłaj zawartość katalogów na urządzenie, wykluczając jednocześnie niektóre odfiltrowane katalogi.

    Parametry
    localFileDir File: katalog lokalny do przesłania

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

    excludedDirectories : zestaw wykluczonych nazw katalogów, które nie powinny zostać przekazane.

    Zwroty
    boolean true, jeśli plik został przekazany. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

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

    Parametry
    localFileDir File: katalog lokalny do przesłania

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

    Zwroty
    boolean true, jeśli plik został przekazany. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    pushDir

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

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

    Parametry
    localFileDir File: katalog lokalny do przesłania

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

    userId int: identyfikator użytkownika do przekazania

    Zwroty
    boolean true, jeśli plik został przekazany. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    plik push

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

    Parametry
    localFile File: plik lokalny do przekazania

    remoteFilePath String: bezwzględna ścieżka zdalnego miejsca docelowego

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

    Zwroty
    boolean true, jeśli plik został przekazany. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    plik push

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Przekaż plik na urządzenie. Domyślnie za pomocą dostawcy treści.

    Parametry
    localFile File: plik lokalny do przekazania

    remoteFilePath String: bezwzględna ścieżka zdalnego miejsca docelowego

    Zwroty
    boolean true, jeśli plik został przekazany. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    plik push

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

    Przekaż plik na urządzenie. Domyślnie za pomocą dostawcy treści.

    Parametry
    localFile File: plik lokalny do przekazania

    remoteFilePath String: bezwzględna ścieżka zdalnego miejsca docelowego

    userId int: identyfikator użytkownika do przekazania

    Zwroty
    boolean true, jeśli plik został przekazany. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Przekaż plik utworzony z ciągu znaków na urządzenie

    Parametry
    contents String: zawartość pliku do wypchnięcia

    remoteFilePath String: bezwzględna ścieżka zdalnego miejsca docelowego

    Zwroty
    boolean true, jeśli ciąg został przekazany. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    Uruchom ponownie

    public void reboot (String reason)

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

    Blokada do momentu udostępnienia urządzenia.

    Powód 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 określono przyczyny.

    Rzuty
    DeviceNotAvailableException

    Uruchom ponownie

    public void reboot ()

    Ponownie uruchamia tryb adb na urządzeniu.

    Blokada do momentu udostępnienia urządzenia.

    Rzuty
    DeviceNotAvailableException

    uruchom ponownie program rozruchowy

    public void rebootIntoBootloader ()

    Uruchamia ponownie urządzenie w trybie programu rozruchowego.

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

    Rzuty
    DeviceNotAvailableException

    zrestartuj do trybu szybkiego rozruchu

    public void rebootIntoFastbootd ()

    Uruchamia urządzenie w trybie fastbootd.

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

    Rzuty
    DeviceNotAvailableException

    zrestartuj do przywracania systemu

    public void rebootIntoRecovery ()

    Uruchamia ponownie urządzenie w trybie odzyskiwania adb.

    Blokada do czasu rozpoczęcia przywracania urządzenia

    Rzuty
    DeviceNotAvailableException

    zrestartuj do innego urządzenia

    public void rebootIntoSideload ()

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

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

    Rzuty
    DeviceNotAvailableException

    zrestartuj do innego urządzenia

    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, dopóki urządzenie nie przejdzie w tryb pobierania z innego urządzenia

    Parametry
    autoReboot boolean: czy automatycznie zrestartować urządzenie po zainstalowaniu z innego urządzenia

    Rzuty
    DeviceNotAvailableException

    zrestartujDoOnline

    public void rebootUntilOnline ()

    Alternatywna metoda reboot(), która blokuje działanie tylko do momentu, aż urządzenie będzie online, tj. widoczne dla adb.

    Rzuty
    DeviceNotAvailableException

    zrestartujDoOnline

    public void rebootUntilOnline (String reason)

    Alternatywna metoda reboot(), która blokuje działanie tylko do momentu, aż urządzenie będzie online, tj. widoczne dla adb.

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

    Rzuty
    DeviceNotAvailableException

    zrestartuj przestrzeń użytkowników

    public void rebootUserspace ()

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

    Blokada do momentu udostępnienia urządzenia.

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

    Rzuty
    DeviceNotAvailableException

    zrestartujprzestrzeńUżytkownik-Do internetu

    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

    przywróć urządzenie

    public boolean recoverDevice ()

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

    Zwroty
    boolean Wartość True, jeśli próba odzyskania się udała i udało się ją odzyskać. Jeśli przywracanie zostało pominięte, zwraca wartość false (fałsz)

    Rzuty
    DeviceNotAvailableException jeśli urządzenie nie jest już dostępne

    RegisterDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Rejestruje IDeviceActionReceiver dla tego urządzenia.

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

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

    remountSystemReadOnly

    public void remountSystemReadOnly ()

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

    Rzuty
    DeviceNotAvailableException

    remountSystemWritable,

    public void remountSystemWritable ()

    Włącz zapis partycji systemowej na urządzeniu. Może uruchomić ponownie urządzenie.

    Rzuty
    DeviceNotAvailableException

    remountVendorReadOnly (ponowne podłączenie)

    public void remountVendorReadOnly ()

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

    Rzuty
    DeviceNotAvailableException

    remontowanie dostawcyWritable

    public void remountVendorWritable ()

    Ustaw partycję dostawcy na urządzeniu z możliwością zapisu. Może uruchomić ponownie urządzenie.

    Rzuty
    DeviceNotAvailableException

    usuń administratora

    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 do usunięcia.

    userId int: użytkownika, w którym mieszka administrator urządzenia.

    Zwroty
    boolean Wartość „true” (prawda), jeśli jest udana, albo „false” (fałsz).

    Rzuty
    DeviceNotAvailableException

    usuń właścicieli

    public void removeOwners ()

    Usuń wszystkich dotychczasowych właścicieli profilu urządzenia w miarę możliwości.

    Rzuty
    DeviceNotAvailableException

    usuń użytkownika

    public boolean removeUser (int userId)

    Usunąć danego użytkownika z urządzenia.

    Parametry
    userId int: użytkownika do usunięcia

    Zwroty
    boolean true (prawda), jeśli udało się usunąć użytkownika, w przeciwnym razie ma wartość false (fałsz).

    Rzuty
    DeviceNotAvailableException

    resetContentProviderSetup,

    public void resetContentProviderSetup ()

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

    Testy instrumentacji

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

    Wygodna metoda wykonywania funkcji ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z co najmniej jednym detektorem przekazywanym jako parametr.

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

    listeners ITestLifeCycleReceiver: detektory wyników testu

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

    Rzuty
    DeviceNotAvailableException

    Testy instrumentacji

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Przeprowadza testy instrumentacji i umożliwia przywracanie urządzenia.

    Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu i przywrócenie się powiedzie, wszyscy detektory zostaną poinformowani o wyniku testRunFailed i zwróceniu wartości „false” (fałsz). Polecenie testowe nie zostanie uruchomione ponownie. W razie potrzeby dzwoniący powinni ponowić próbę.

    Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a przywrócenie się nie powiedzie, wszyscy detektory zostaną poinformowani o błędzie testRunFailed i zgłoszenia DeviceNotAvailableException.

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

    listeners : detektory wyników testu

    Zwroty
    boolean true, jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go ukończyć z powodu wyjątku komunikacji z urządzeniem, ale udało się przywrócić

    Rzuty
    DeviceNotAvailableException

    UruchomTest narzędzi jakoUżytkownik

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

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

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    UruchomTest narzędzi jakoUżytkownik

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

    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

    ustawDate

    public void setDate (Date date)

    Ustawia datę na urządzeniu

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

    Parametry
    date Date: określ konkretną datę; 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: użytkownika, z którego korzysta właściciel urządzenia.

    Zwroty
    boolean Wartość „true” (prawda), jeśli jest udana, albo „false” (fałsz).

    Rzuty
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    aktualizować stan urządzenia,

    Parametry
    deviceState TestDeviceState: TestDeviceState

    setEmulatorOutputStream,

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    Aby emulator ustaw SizeLimitedOutputStream tak, by logował dane wyjściowe

    Parametry
    output SizeLimitedOutputStream: aby zapisać dane wyjściowe,

    setEmulatorProcess,

    public void setEmulatorProcess (Process p)

    Ustawia funkcję Process, gdy to urządzenie jest emulatorem.

    Parametry
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Ustaw opcję Szybki rozruch urządzenia. Należy go ustawić podczas alokacji urządzenia.

    Parametry
    fastbootEnabled boolean: czy szybki rozruch jest dostępny dla urządzenia.

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Ustawia ścieżkę do pliku binarnego fastboot, którego należy użyć. Aby funkcje szybkiego rozruchu były włączone, nadal wymaga wartości prawda 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 oczekiwania (w ms) przed rozpoczęciem przechwytywania dzienników logcat przez urządzenie online.

    Parametry
    delay int: opóźnienie w ms

    setOptions

    public void setOptions (TestDeviceOptions options)

    Ustaw TestDeviceOptions dla urządzenia

    Parametry
    options TestDeviceOptions

    setproperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Ustawia określoną wartość właściwości na urządzeniu. Wymaga wartości roota adb ma wartość true.

    Parametry
    propKey String: klucz do ustawienia.

    propValue String: wartość właściwości do ustawienia.

    Zwroty
    boolean Jeśli polecenie setprop zakończyło się powodzeniem, zwraca True. W przeciwnym razie zwraca wartość False.

    Rzuty
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Ustaw aplikację IDeviceRecovery, która ma być używana na tym urządzeniu. Należy go ustawić podczas alokacji urządzenia.

    Parametry
    recovery IDeviceRecovery: IDeviceRecovery

    Ustaw tryb odzyskiwania

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Ustaw bieżący tryb przywracania urządzenia, którego chcesz używać.

    Służy do określania metody odzyskiwania, która ma być używana w przypadku wystąpienia problemu z komunikacją na urządzeniu. Zaleca się korzystanie z tej metody z oszczędnością tylko wtedy, gdy jest to konieczne (np. gdy platforma nie działa itp.)

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

    UstawUstawienia

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

    Patrz: setSetting(int, String, String, String) i wykonano je na użytkowniku systemowym.

    Parametry
    namespace String

    key String

    value String

    Rzuty
    DeviceNotAvailableException

    UstawUstawienia

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

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

    setUseFastbootDelete

    public void setUseFastbootErase (boolean useFastbootErase)

    Określ, czy do wyczyszczenia partycji na urządzeniu chcesz używać formatu Szybki rozruch, czy formatu Szybki rozruch.

    Parametry
    useFastbootErase boolean: true, jeśli powinno być używane usuwanie przez szybki rozruch, lub false, jeśli powinien być używany format fastboot.

    StartLogcat

    public void startLogcat ()

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

    Działanie nie będzie działać, jeśli dane wyjściowe logcat są już przechwytywane. Dane można później pobrać za pomocą getLogcat.

    Gdy urządzenie nie jest już używane, należy zadzwonić pod numer stopLogcat().

    Zwykle nie trzeba wywoływać funkcji startLogcat() i stopLogcat() w kontekście wywołania TF, ponieważ platforma TF uruchamia i zatrzymuje logcat.

    Użytkownik początkowy

    public boolean startUser (int userId)

    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.

    Parametry
    userId int: użytkownika, który rozpocznie się w tle

    Zwroty
    boolean true (prawda), jeśli użytkownik został uruchomiony w tle.

    Rzuty
    DeviceNotAvailableException

    Użytkownik początkowy

    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żesz udostępnić dodatkową flagę oczekującą na wykonanie operacji.

    Parametry
    userId int: użytkownika, który rozpocznie się w tle

    waitFlag boolean: spowoduje, że polecenie będzie czekać na uruchomienie i odblokowanie użytkownika.

    Zwroty
    boolean true (prawda), jeśli użytkownik został uruchomiony w tle.

    Rzuty
    DeviceNotAvailableException

    startWidoczneTłoUżytkownik

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

    Uruchamia użytkownika w tle, co jest widoczne na danym wyświetlaczu (pozwala mu uruchamiać działania na tym ekranie).

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

    Parametry
    userId int: użytkownika, który rozpocznie się w tle

    displayId int: wyświetlacz, na którym będzie widoczny początkowy użytkownik

    waitFlag boolean: spowoduje, że polecenie będzie czekać na uruchomienie i odblokowanie użytkownika.

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

    Rzuty
    DeviceNotAvailableException

    Wyjście emulatora

    public void stopEmulatorOutput ()

    Zamknij i usuń dane wyjściowe emulatora.

    StopLogcat

    public void stopLogcat ()

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

    Nie będzie działać, jeśli dane wyjściowe logcat nie zostaną przechwycone.

    stopUser

    public boolean stopUser (int userId)

    Zatrzymuje dane użytkownika. Jeśli użytkownik został już zatrzymany, ta metoda jest traktowana jako NOOP. Nie można zatrzymać bieżącego i systemowego użytkownika.

    Parametry
    userId int: użytkownika do zatrzymania.

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

    Rzuty
    DeviceNotAvailableException

    stopUser

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

    Zatrzymać danego użytkownika. Możesz udostępnić dodatkowe flagi oczekiwania na efekty operacji i wymusić zamknięcie użytkownika. Nie można zatrzymać bieżącego i systemowego użytkownika.

    Parametry
    userId int: użytkownika do zatrzymania.

    waitFlag boolean: spowoduje, że polecenie będzie czekać na zatrzymanie użytkownika.

    forceFlag boolean: wymusi zatrzymanie użytkownika.

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

    przełączDoAdbUsb

    public boolean switchToAdbUsb ()

    Przełącz urządzenie na 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 jest zgodny z dostawcą identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.

    Rzuty
    DeviceNotAvailableException

    użytkownik przełączony

    public boolean switchUser (int userId, 
                    long timeout)

    Przełącz się na inny identyfikator 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ę odczekać przed zwróceniem wartości false dla użytkownika Switch.

    Zwroty
    boolean Prawda, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.

    Rzuty
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

    Określa, które pliki należy przekazać, porównując sygnatury czasowe plików lokalnych z ich zdalnymi odpowiednikami. Na urządzenie przekazywane są tylko „nowsze” lub nieistniejące pliki. Dlatego narzut powinien być stosunkowo niewielki, jeśli plik ustawiony na urządzeniu jest już aktualny.

    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 przekaże zawartość /tmp/files do /sdcard/files.

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

    deviceFilePath String: bezwzględna ścieżka katalogu zdalnego miejsca docelowego. 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. W przeciwnym razie: false.

    Rzuty
    DeviceNotAvailableException

    ZgłośBugreport

    public Bugreport takeBugreport ()

    Utwórz raport o błędzie i zwróć go w obiekcie Bugreport, aby go obsłużyć. W przypadku problemu zwróć wartość null. Plik, do którego odwołuje się obiekt Bugreport, musi zostać wyczyszczony w programie 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 w przypadku powodzenia.

    Rzuty
    DeviceNotAvailableException

    Odinstaluj pakiet dla użytkownika

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Odinstalować pakiet na Androida z urządzenia danego użytkownika.

    Parametry
    packageName String: pakiet na Androida do odinstalowania

    userId int: liczba całkowita identyfikator użytkownika, w przypadku którego chcesz odinstalować aplikację.

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

    Rzuty
    DeviceNotAvailableException

    Odblokuj urządzenie

    public boolean unlockDevice ()

    Odblokowuje urządzenie, jeśli jest 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, jeśli się uda lub urządzenie nie jest zaszyfrowane.

    Rzuty
    DeviceNotAvailableException

    odłącz debugowanie

    public void unmountDebugfs ()

    Odłącz pliki debugowania.

    Rzuty
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Blokuje się, dopóki nie zostanie ustawiona flaga ukończenia rozruchu urządzenia.

    Parametry
    timeOut long: czas oczekiwania na ustawienie flagi w milisekundach

    Zwroty
    boolean true, jeśli flaga zakończenia uruchamiania urządzenia jest ustawiona w ramach czasu oczekiwania

    Rzuty
    DeviceNotAvailableException

    CzekajNaUrządzenieDostępne

    public boolean waitForDeviceAvailable ()

    Czekam, aż urządzenie będzie reagować i będzie dostępne do testowania. Używa domyślnego czasu oczekiwania.

    Zwroty
    boolean Ma wartość Prawda, jeśli urządzenie jest dostępne, Fałsz, jeśli przywracanie jest wyłączone i nie jest dostępne.

    Rzuty
    DeviceNotAvailableException

    CzekajNaUrządzenieDostępne

    public boolean waitForDeviceAvailable (long waitTime)

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

    Parametry
    waitTime long: czas oczekiwania w ms

    Zwroty
    boolean Ma wartość Prawda, jeśli urządzenie jest dostępne, Fałsz, jeśli przywracanie jest wyłączone i nie jest dostępne.

    Rzuty
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Czekam, aż urządzenie będzie gotowe i reaguje, bez uwzględniania ścieżki odzyskiwania.

    Parametry
    waitTime long

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

    Rzuty
    DeviceNotAvailableException

    Oczekiwanie na program rozruchowy urządzenia

    public void waitForDeviceBootloader ()

    Blokuje do momentu, aż urządzenie będzie widoczne w trybie fastboot. Użyj domyślnego czasu oczekiwania.

    Rzuty
    DeviceNotAvailableException

    Poczekaj na przywrócenie urządzenia

    public boolean waitForDeviceInRecovery (long waitTime)

    Blokuje stan urządzenia „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. W innym przypadku: false

    Czekaj na urządzeniu wSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blokuje urządzenie w stanie „adb z innego urządzenia”

    Parametry
    waitTime long: czas oczekiwania w ms

    Zwroty
    boolean true, jeśli urządzenie zostanie uruchomione z innego urządzenia przed upływem czasu. W innym przypadku: false

    Oczekiwanie naUrządzenieNiedostępne

    public boolean waitForDeviceNotAvailable (long waitTime)

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

    Parametry
    waitTime long: czas oczekiwania w ms

    Zwroty
    boolean true, jeśli urządzenie będzie niedostępne przed upływem tego czasu. W innym przypadku: false

    Poczekaj naUrządzenieOnline

    public void waitForDeviceOnline ()

    Blokuje, dopóki urządzenie nie będzie widoczne w narzędziu adb. Używa domyślnego czasu oczekiwania

    Pamiętaj, że urządzenie niekoniecznie reaguje na polecenia po zakończeniu. Zamiast niego użyj właściwości 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 niekoniecznie reaguje na polecenia po zakończeniu. Zamiast niego użyj właściwości waitForDeviceAvailable().

    Parametry
    waitTime long: czas oczekiwania w ms

    Rzuty
    DeviceNotAvailableException

    Poczekaj naPowłokęUrządzenia

    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 reaguje przed upłynięciem waitTime.

    Metody chronione

    addExtraConnectionerArgs (Dodaj dodatkowe łuki budowania połączeń)

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parametry
    builder DefaultConnection.ConnectionBuilder

    Polecenie BuildAdbShellCommand

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

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

    Parametry
    command String

    forceExitStatusDetection boolean

    Zwroty
    String[]

    sprawdź poziomApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Parametry
    feature String

    strictMinLevel int

    Działanie tworzenia ponownego urządzenia

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

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

    Parametry
    rebootMode NativeDevice.RebootMode: tryb ponownego uruchamiania.

    reason String: ten restart.

    Zwroty
    NativeDevice.RebootDeviceAction utworzony RebootDeviceAction.

    createRunTool

    protected IRunUtil createRunUtil ()

    Zwroty
    IRunUtil

    doAdbRestart

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

    Ponownie uruchom narzędzie adb.

    Parametry
    rebootMode NativeDevice.RebootMode: tryb ponownego uruchamiania.

    reason String: ten restart.

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    upewnij się, że uprawnienieRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    metoda pomocnicza zgłaszania wyjątku, jeśli uprawnienia w czasie 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 ()

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

    Zwroty
    IRunUtil

    zainicjuj połączenie

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

    Parametry
    info IBuildInfo

    attributes MultiMap

    Rzuty
    DeviceNotAvailableException
    TargetSetupError

    InternalGet Property

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

    Pobierz właściwość urządzenia z domyślnej pamięci podręcznej ddmlib i przełącz się na „adb shell getprop” lub „fastboot getvar” w zależności od tego, czy urządzenie działa w trybie Fastboot Fastboot.

    Parametry
    propName String: nazwa właściwości urządzenia zwrócona przez polecenie „adb shell getprop”

    fastbootVar String: nazwa równoważnej zmiennej typu fastboot, której ma dotyczyć zapytanie. Jeśli null, nie zostanie podjęta próba wykonania zapytania fastbootowego.

    description String: prosty opis zmiennej. Pierwsza litera powinna być pisana wielką literą.

    Zwroty
    String Ciąg znaków, prawdopodobnie null lub pusty, zawierający wartość danej właściwości

    Rzuty
    DeviceNotAvailableException

    Wywołanie zwrotne isInRestartCallback

    protected boolean isInRebootCallback ()

    Wskazuje, czy są obecnie wykonywane wywołania zwrotne ponownego uruchomienia. Wszystkie publiczne interfejsy API potrzebne do ponownego uruchomienia powinny być wyłączone, jeśli ma wartość prawda.

    Zwroty
    boolean

    Jest Nowszy

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Zwróć wartość true, jeśli plik lokalny jest nowszy niż plik zdalny. IFileEntry z dokładnością co do minuty. W takim przypadku plik zostanie uznany za nowszy.

    Parametry
    localFile File

    entry IFileEntry

    Zwroty
    boolean

    powiadamiaj o zakończeniu ponownego uruchamiania

    protected void notifyRebootEnded ()

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

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    powiadamiaj o uruchomieniu ponownego uruchomienia

    protected void notifyRebootStarted ()

    Powiadamia wszystkie urządzenia IDeviceActionReceiver o zdarzeniu ponownego uruchomienia urządzenia.

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Wykonuj działanie na urządzeniu

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

    Wykonuje czynność na 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 logowania.

    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 przywrócenia nie powiedzie się lub zostanie osiągnięta maksymalna liczba nieudanych prób odzyskania.

    po ponownym uruchomieniu

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

    Zezwala każdemu typowi urządzeń (AndroidNativeDevice, TestDevice) na zastąpienie tej metody w przypadku określonej konfiguracji po rozruchu.

    Rzuty
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    PullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Parametry
    remoteFilePath String

    localFile File

    Zwroty
    boolean

    Rzuty
    DeviceNotAvailableException

    ustawianie zegara

    protected void setClock (Clock clock)

    Ustaw używaną instancję Zegara.

    Parametry
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Oznacza urządzenie testowe jako mikrodroid i ustawia 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 ze zmiennymi środowiskowymi i zgłasza stan polecenia.

    Parametry
    timeout long

    envVarMap

    fullCmd String

    Zwroty
    CommandResult

    Prosty FastbootCommand

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

    Wykonuje proste polecenie fastboot i zgłasza stan polecenia.

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

    Parametry
    operationDesc String: nazwa operacji oczekującej na niedostępny.

    time long: czas oczekiwania na pojawienie się informacji o niedostępności danych.

    Zwroty
    boolean Prawda, jeśli urządzenie stało się niedostępne.