NativeDevice
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
Domyślna implementacja na urządzeniach z Androidem, które nie mają pełnego stosu.ITestDevice
Podsumowanie
Zagnieżdżone klasy | |
---|---|
class |
NativeDevice.AdbAction
|
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Stałe | |
---|---|
int |
INVALID_USER_ID
Wartość zwrócona w przypadku nieprawidłowego lub niewykrytego identyfikatora użytkownika: UserHandle zdefiniował wartość -10000 |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
domyślna liczba prób ponownego wykonania polecenia, |
Fieldsem | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Konstruktory publiczne | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Tworzy |
Metody publiczne | |
---|---|
void
|
batchPrefetchStartupBuildProps()
Mikrooptymalizacja (około 400 ms) polegająca na pobieraniu wstępnym wszystkich potrzebnych właściwości zamiast wywoływania dla każdej z nich polecenia „adb getprop”. |
boolean
|
canSwitchToHeadlessSystemUser()
Zwraca informację, czy można przełączyć się na użytkownika systemu bez interfejsu. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Sprawdź, czy funkcja jest obecnie obsługiwana na minimalnym obsługiwanym poziomie. |
boolean
|
checkConnectivity()
Sprawdź, czy urządzenie ma połączenie sieciowe. |
boolean
|
clearErrorDialogs()
Spróbuj zamknąć wszystkie okna dialogowe błędów aktualnie wyświetlane w interfejsie urządzenia. |
void
|
clearLastConnectedWifiNetwork()
Czyści ostatnią połączoną sieć Wi-Fi. |
void
|
clearLogcat()
Usuwa wszystkie zgromadzone dane logcat. |
boolean
|
connectToWifiNetwork(
Połącza się z siecią Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Połącza się z siecią Wi-Fi. |
boolean
|
connectToWifiNetwork(
Łączy się z siecią Wi-Fi.f |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Połącza się z siecią Wi-Fi. |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Wariant |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
Wariant |
int
|
createUser(String name, boolean guest, boolean ephemeral)
Utwórz użytkownika z podaną nazwą i podanymi flagami |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Utwórz użytkownika z podaną nazwą i podanymi flagami |
int
|
createUser(String name)
Utwórz użytkownika z danym imieniem i domyślnymi flagami 0. |
int
|
createUserNoThrow(String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0. |
void
|
deleteFile(String deviceFilePath, int userId)
Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu. |
void
|
deleteFile(String deviceFilePath)
Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu. |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Usuwa zarejestrowany |
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
Metoda pomocnicza służąca do sprawdzania, czy urządzenie zostało zrestartowane, przez porównanie bieżącego system_server z poprzednim system_server |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza służąca do sprawdzania, czy urządzenie zostało zrestartowane od czasu UTC od początku epoki na urządzeniu i jego |
boolean
|
disableAdbRoot()
Wyłącza poziom główny adb. |
void
|
disableKeyguard()
Próbuje wyłączyć blokadę klawiszy. |
boolean
|
disableNetworkMonitor()
Wyłącza monitorowanie sieci na urządzeniu. |
boolean
|
disconnectFromWifi()
Rozłącza się z siecią Wi-Fi. |
boolean
|
doesFileExist(String deviceFilePath, int userId)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu istnieje dla danego użytkownika. |
boolean
|
doesFileExist(String deviceFilePath)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu istnieje. |
File
|
dumpHeap(String process, String devicePath)
Spróbuj zrzucić stos z system_server. |
boolean
|
enableAdbRoot()
Włącza roota adb. |
boolean
|
enableNetworkMonitor()
Umożliwia monitorowanie sieci na urządzeniu. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania. |
String
|
executeAdbCommand(long timeout,
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania. |
String
|
executeAdbCommand(String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe. |
CommandResult
|
executeLongFastbootCommand(
Metoda pomocnicza, która wykonuje długo uruchomione polecenie szybkiego rozruchu w postaci polecenia systemowego z systemowymi zmiennymi środowiskowymi. |
String
|
executeShellCommand(String command)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca dane wyjściowe jako |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie powłoki adb z większą liczbą parametrów sterujących działaniem polecenia. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie powłoki adb z większą liczbą parametrów sterujących działaniem polecenia. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Wykonuje podane polecenie powłoki adb. Jeśli polecenie się nie powiedzie, ponawiam próbę wiele razy. |
CommandResult
|
executeShellV2Command(String cmd)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako obiekt |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako obiekt |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie polecenia. |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Wykonuje polecenie powłoki adb z większą liczbą parametrów sterujących działaniem polecenia. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie powłoki adb z większą liczbą parametrów sterujących działaniem polecenia. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie powłoki adb z większą liczbą parametrów sterujących działaniem polecenia. |
CommandResult
|
fastbootWipePartition(String partition)
Metoda pomocnicza, która czyści partycję urządzenia. |
|
getActiveApexes()
Pobiera informacje o aktywnej na urządzeniu aplikacji APEX. |
|
getAllSettings(String namespace)
Zwraca pary klucz-wartość żądanej przestrzeni nazw. |
DeviceAllocationState
|
getAllocationState()
Zwraca bieżący stan przydziału urządzenia. |
String
|
getAndroidId(int userId)
Znajdź i zwróć identyfikator android-id powiązany z userId, null, jeśli nie znaleziono. |
|
getAndroidIds()
Utwórz mapę identyfikatorów Androida, które pasują do identyfikatorów użytkowników. |
int
|
getApiLevel()
Pobierz poziom interfejsu API urządzenia. |
PackageInfo
|
getAppPackageInfo(String packageName)
Pobranie informacji o pakiecie zainstalowanym na urządzeniu. |
|
getAppPackageInfos()
Pobiera informacje o pakietach zainstalowanych na urządzeniu. |
String
|
getBasebandVersion()
Wygodny sposób na uzyskanie wersji pasma podstawowego (radio) tego urządzenia. |
Integer
|
getBattery()
Zwraca bieżący poziom baterii urządzenia lub wartość null, jeśli poziom baterii jest niedostępny. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Zwraca wartość logiczną danej właściwości. |
|
getBootHistory()
Metoda pomocnicza zbiera mapę historii rozruchu z czasem i przyczyną rozruchu. |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchomienia od podanego czasu od epoki na urządzeniu i z określonej jednostki czasu. |
String
|
getBootloaderVersion()
Wygodna metoda uzyskania wersji programu rozruchowego tego urządzenia. |
InputStreamSource
|
getBugreport()
Pobiera raport o błędzie z urządzenia. |
InputStreamSource
|
getBugreportz()
Pobiera raport o błędzie z urządzenia. |
String
|
getBuildAlias()
Pobierz alias kompilacji, która jest obecnie używana na urządzeniu. |
String
|
getBuildFlavor()
Pobierz wersję kompilacji dla urządzenia. |
String
|
getBuildId()
Pobierz wersję, która jest obecnie uruchomiona na urządzeniu. |
String
|
getBuildSigningKeys()
Zwraca typ klucza użytego do podpisania obrazu urządzenia. Urządzenia z Androidem są zwykle podpisywane kluczami testowymi (jak w AOSP) lub kluczami wersji (kontrolowanymi przez poszczególnych producentów urządzeń). |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Zwraca element |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Zwraca |
String[]
|
getChildren(String path)
Alternatywa dla funkcji |
AbstractConnection
|
getConnection()
Bieżące połączenie powiązane z urządzeniem. |
ContentProviderHandler
|
getContentProvider(int userId)
Zwraca |
DeviceFoldableState
|
getCurrentFoldableState()
Zwraca bieżący stan urządzenia lub wartość null, jeśli wystąpiły jakieś problemy. |
int
|
getCurrentUser()
Zwraca identyfikator bieżącego użytkownika. |
String
|
getDeviceClass()
Pobierz klasę urządzenia. |
long
|
getDeviceDate()
Zwraca datę urządzenia w milisekundach od początku epoki. |
DeviceDescriptor
|
getDeviceDescriptor()
Zwracać |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Zwracać |
TestDeviceState
|
getDeviceState()
Pobierz stan urządzenia. |
long
|
getDeviceTimeOffset(Date date)
Pomocnik do uzyskiwania różnicy czasowej między urządzeniem a danym |
InputStreamSource
|
getEmulatorOutput()
Pobieranie strumienia danych z wyjścia standardowego i błędów emulatora |
Process
|
getEmulatorProcess()
Zwraca |
final
File
|
getExecuteShellCommandLog()
Dziennik zawierający wszystkie logi |
long
|
getExternalStoreFreeSpace()
Metoda pomocnicza do określania ilości wolnego miejsca w pamięci zewnętrznej urządzenia. |
String
|
getFastbootPath()
Zwraca ścieżkę do używanego pliku binarnego fastboot. |
String
|
getFastbootProductType()
Metoda ułatwiająca uzyskanie typu urządzenia w trybie Fastboot. |
String
|
getFastbootProductVariant()
Wygodna metoda pobierania typu produktu, gdy urządzenie działa w trybie szybkiego rozruchu. |
String
|
getFastbootSerialNumber()
Zwraca numer seryjny trybu fastboot. |
String
|
getFastbootVariable(String variableName)
Pobierz z urządzenia podawaną wartość zmiennej fastboot. |
String
|
getFastbootVersion()
Zwraca ciąg znaków wersji używanego pliku binarnego fastboot. |
IFileEntry
|
getFileEntry(String path)
Pobiera odwołanie do zdalnego pliku na urządzeniu. |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Nieoficjalny pomocnik pobierania |
|
getFoldableStates()
Zwraca listę stanów składania urządzenia. |
IDevice
|
getIDevice()
Zwraca odwołanie do powiązanej biblioteki ddmlib |
|
getInstalledPackageNames()
Pobierz nazwy pakietów aplikacji obecnych na urządzeniu. |
long
|
getIntProperty(String name, long defaultValue)
Zwraca wartość całkowitą danej właściwości z urządzenia. |
String
|
getIpAddress()
Pobiera adres IP urządzenia. |
KeyguardControllerState
|
getKeyguardState()
Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest on obsługiwany. |
long
|
getLastExpectedRebootTimeMillis()
Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie (w milisekundach od EPOCH), zwracany przez |
int
|
getLaunchApiLevel()
Uzyskaj poziom interfejsu API, który został po raz pierwszy uruchomiony na urządzeniu. |
InputStreamSource
|
getLogcat()
Pobiera strumień zrzutu danych z logcat. |
InputStreamSource
|
getLogcat(int maxBytes)
Pobiera strumień zrzutów ostatnich |
InputStreamSource
|
getLogcatDump()
Pobierz zrzut bieżącego logcata na urządzeniu. |
InputStreamSource
|
getLogcatSince(long date)
Pobiera strumień zrzutów zarejestrowanych danych logcat od podanej daty. |
String
|
getMacAddress()
Zwraca adres MAC urządzenia lub wartość null, jeśli nie wysyła zapytania z tego urządzenia. |
Integer
|
getMainUserId()
Zwraca identyfikator głównego użytkownika. |
|
getMainlineModuleInfo()
Uzyskaj informacje o modułach mainline zainstalowanych na urządzeniu. |
int
|
getMaxNumberOfRunningUsersSupported()
Pobierz maksymalną liczbę obsługiwanych jednocześnie uruchomionych użytkowników. |
int
|
getMaxNumberOfUsersSupported()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Zwracaj |
String
|
getMountPoint(String mountName)
Zwraca punkt podłączania. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Zwraca |
|
getMountPointInfo()
Zwraca przeanalizowaną wersję informacji z folderu /proc/mounts na urządzeniu |
TestDeviceOptions
|
getOptions()
Pobierz opcje testowania urządzenia. |
long
|
getPartitionFreeSpace(String partition)
Metoda pomocnicza do określania ilości wolnego miejsca na partycji urządzenia. |
Integer
|
getPrimaryUserId()
Zwraca podstawowy identyfikator użytkownika. |
ProcessInfo
|
getProcessByName(String processName)
Metoda pomocnicza uruchamia polecenia „pidof” i „stat” oraz zwraca obiekt |
String
|
getProcessPid(String process)
Zwraca PID usługi lub wartość null, jeśli wystąpił błąd. |
String
|
getProductType()
Wygodna metoda uzyskiwania typu produktu na tym urządzeniu. |
String
|
getProductVariant()
Wygodna metoda uzyskiwania wersji produktu tego urządzenia. |
String
|
getProperty(String name)
Pobierać z urządzenia określoną wartość właściwości. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Uzyskaj informacje o bieżącym trybie odzyskiwania używanym na urządzeniu. |
InputStreamSource
|
getScreenshot(long displayId)
Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania. |
InputStreamSource
|
getScreenshot(String format)
Robi zrzut ekranu z urządzenia. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Pobiera zrzut ekranu z urządzenia. |
InputStreamSource
|
getScreenshot()
Robi zrzut ekranu z urządzenia. |
String
|
getSerialNumber()
Wygodny sposób na uzyskanie numeru seryjnego tego urządzenia. |
String
|
getSetting(int userId, String namespace, String key)
Zwraca wartość żądanego ustawienia. |
String
|
getSetting(String namespace, String key)
Zobacz |
String
|
getSimOperator()
Zwraca operatora karty SIM lub wartość null, jeśli operator nie jest dostępny lub jeśli urządzenie nie jest dostępne. |
String
|
getSimState()
Zwraca stan karty SIM lub wartość null, jeśli karta SIM lub urządzenie są niedostępne. |
|
getTombstones()
Pobieranie i zwracanie listy nagrobków z urządzeń. |
long
|
getTotalMemory()
Zwraca łączny rozmiar pamięci fizycznej w bajtach lub -1 w przypadku błędu wewnętrznego |
String
|
getTrackingSerial()
Do zarządzania urządzeniem pobierz numer seryjny służący do śledzenia urządzenia. |
|
getUninstallablePackageNames()
Pobierz nazwy pakietów aplikacji, które można odinstalować. |
boolean
|
getUseFastbootErase()
Określ, czy do wyczyszczenia partycji na urządzeniu chcesz użyć formatu szybkiego rozruchu lub szybkiego rozruchu. |
int
|
getUserFlags(int userId)
Znajdowanie i zwracanie flag danego użytkownika. |
|
getUserInfos()
Pobiera mapę useId na urządzeniu do |
int
|
getUserSerialNumber(int userId)
W przeciwnym razie zwraca -10000. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Przetwarzanie podanego zdarzenia DeviceEvent. Przetwarza zdarzenie DeviceEvent, które może (ale nie musi) przełączyć urządzenie do nowego stanu przydziału. |
boolean
|
hasFeature(String feature)
Sprawdzanie, czy funkcja jest dostępna na urządzeniu |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida. |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Zainstaluj pakiet na Androida na urządzeniu. |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Instalowanie pakietu Androida na urządzeniu danego użytkownika. |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instalowanie pakietu Androida na urządzeniu danego użytkownika. |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Sprawdź, czy platforma na urządzeniu obsługuje zliczanie aplikacji |
boolean
|
isBypassLowTargetSdkBlockSupported()
Sprawdź, czy platforma na urządzeniu obsługuje pomijanie blokady niskiego docelowego poziomu interfejsu SDK podczas instalowania aplikacji |
boolean
|
isDebugfsMounted()
Sprawdź, czy debugfs jest zamontowany. |
boolean
|
isDeviceEncrypted()
Zwraca wartość wskazującą, czy urządzenie jest zaszyfrowane. |
boolean
|
isDirectory(String path)
Zwraca wartość Prawda, jeśli ścieżka na urządzeniu jest katalogiem. W przeciwnym razie ma wartość Fałsz. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Zwraca wartość wskazującą, czy szyfrowanie jest obsługiwane na urządzeniu. |
boolean
|
isExecutable(String fullPath)
Zwraca wartość Prawda, jeśli ścieżka do pliku na urządzeniu jest plikiem wykonywalnym, w przeciwnym razie zwraca wartość Fałsz. |
boolean
|
isFastbootEnabled()
Zwracaj, jeśli na urządzeniu jest dostępny tryb Fastboot. |
boolean
|
isHeadless()
Wartość true (prawda), jeśli urządzenie nie ma interfejsu graficznego (nie ma ekranu). W przeciwnym razie ma wartość false (fałsz). |
boolean
|
isHeadlessSystemUserMode()
Zwraca informację, czy urządzenie używa trybu użytkownika systemu bez interfejsu graficznego. |
boolean
|
isMainUserPermanentAdmin()
Zwraca informację o tym, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani obniżyć jego statusu administratora. |
boolean
|
isMultiUserSupported()
Określa, czy obsługiwany jest tryb wielu użytkowników. |
boolean
|
isPackageInstalled(String packageName, String userId)
Wyślij do urządzenia zapytanie o nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy to urządzenie jest obecnie zainstalowane dla tego użytkownika. |
boolean
|
isPackageInstalled(String packageName)
Wyślij do urządzenia zapytanie o podaną nazwę pakietu, aby sprawdzić, czy jest aktualnie zainstalowane. |
boolean
|
isRuntimePermissionSupported()
Sprawdź, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie wykonywania |
boolean
|
isStateBootloaderOrFastbootd()
Zwraca wartość „prawda”, jeśli urządzenie znajduje się w stanie |
boolean
|
isUserRunning(int userId)
Sprawdź, czy dany użytkownik jest obecny. |
boolean
|
isUserSecondary(int userId)
Zwraca informację, czy podany użytkownik jest użytkownikiem dodatkowym na podstawie jego flag. |
boolean
|
isUserVisible(int userId)
Sprawdza, czy dany użytkownik jest widoczny. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Zwraca informacje o tym, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji w tle w kontekście |
boolean
|
isVisibleBackgroundUsersSupported()
Zwraca informację, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji w tle. |
boolean
|
isWifiEnabled()
Sprawdź, czy Wi-Fi jest włączone. |
|
listDisplayIds()
Pobierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, jak podaje „dumpsys SurfaceFlinger”. |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Pobiera listę wyświetlaczy, których można używać do |
|
listUsers()
Pobiera listę użytkowników na urządzeniu. |
boolean
|
logAnrs(ITestLogger logger)
Zbiera i rejestruje błędy ANR na urządzeniu. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w dzienniku autorów. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Zaloguj wiadomość w logcat urządzenia. |
void
|
mountDebugfs()
Zamontuj debugfs. |
void
|
nonBlockingReboot()
Wydając polecenie ponownego uruchomienia urządzenia, wraca po jego wykonaniu i gdy urządzenie nie jest już widoczne dla adb. |
void
|
postAdbRootAction()
Zastąpić, jeśli urządzenie wymaga wykonania określonych czynności po uzyskaniu uprawnień root w adb, zanim będzie można przywrócić urządzenie do trybu online. |
void
|
postAdbUnrootAction()
Zastąpić, jeśli urządzenie wymaga wykonania określonych czynności po usunięciu uprawnień roota za pomocą adb, a przed przywróceniem urządzenia do trybu online. |
void
|
postBootSetup()
Postępuj zgodnie z instrukcjami, aby skonfigurować urządzenie do testowania po każdym uruchomieniu. |
void
|
postInvocationTearDown(Throwable exception)
Dodatkowe kroki wymagane do czyszczenia na danym urządzeniu, które zostaną wykonane po zakończeniu wywołania. |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Dodatkowe czynności wymagane na urządzeniu, które zostaną wykonane na urządzeniu przed rozpoczęciem procesu wywołania. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Rekursywnie pobieraj zawartość katalogu z urządzenia. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Rekursywnie pobieraj zawartość katalogu z urządzenia. |
boolean
|
pullFile(String remoteFilePath, File localFile)
Pobiera plik z urządzenia. |
File
|
pullFile(String remoteFilePath, int userId)
Pobiera plik z urządzenia, przechowuje go w lokalnym folderze tymczasowym |
File
|
pullFile(String remoteFilePath)
Pobiera plik z urządzenia, przechowuje go w lokalnym folderze tymczasowym |
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 |
boolean
|
pushDir(File localFileDir, String deviceFilePath,
Rekursywnie przesyłaj zawartość katalogu na urządzenie, wykluczając niektóre katalogi, które są filtrowane. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Rekursywnie przesyłaj zawartość katalogu na urządzenie. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Rekursywnie przesyłaj zawartość katalogu na urządzenie. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Wariant atrybutu |
boolean
|
pushFile(File localFile, String remoteFilePath)
Przesyłanie pliku na urządzenie. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Przesyłanie pliku na urządzenie. |
boolean
|
pushString(String contents, String remoteFilePath)
Przesyłanie na urządzenie pliku utworzonego na podstawie ciągu znaków |
void
|
reboot(String reason)
Uruchamia ponownie urządzenie w trybie adb z podaną wartością |
void
|
reboot()
Uruchom ponownie urządzenie w trybie adb. |
void
|
rebootIntoBootloader()
Uruchom ponownie urządzenie w trybie programu rozruchowego. |
void
|
rebootIntoFastbootd()
Uruchom ponownie urządzenie w trybie Fastboot. |
void
|
rebootIntoRecovery()
Uruchom ponownie urządzenie w trybie odzyskiwania adb. |
void
|
rebootIntoSideload()
Uruchom ponownie urządzenie w trybie ładowania bocznego adb (zauważ, że jest to specjalny tryb odzyskiwania). Blokuje, dopóki urządzenie nie przejdzie w tryb ładowania z innego urządzenia |
void
|
rebootIntoSideload(boolean autoReboot)
Uruchom ponownie urządzenie w trybie ładowania bocznego adb (zauważ, że jest to specjalny tryb odzyskiwania). Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload |
void
|
rebootUntilOnline()
Alternatywna metoda |
void
|
rebootUntilOnline(String reason)
Alternatywa dla |
void
|
rebootUserspace()
Uruchomi ponownie tylko część urządzenia w przestrzeni użytkownika. |
void
|
rebootUserspaceUntilOnline()
Alternatywa dla |
boolean
|
recoverDevice()
Próbuje odzyskać komunikację z urządzeniem. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Rejestruje |
void
|
remountSystemReadOnly()
Ustaw partycję systemową na urządzeniu jako tylko do odczytu. |
void
|
remountSystemWritable()
Ustaw partycję systemową na urządzeniu jako partycję do zapisu. |
void
|
remountVendorReadOnly()
Ustaw partycję dostawcy na urządzeniu jako partycję tylko do odczytu. |
void
|
remountVendorWritable()
Ustaw partycję dostawcy na urządzeniu jako partycję do zapisu. |
boolean
|
removeAdmin(String componentName, int userId)
Usuń danego administratora urządzenia z konta danego użytkownika i zwróć |
void
|
removeOwners()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia. |
boolean
|
removeUser(int userId)
usunąć danego użytkownika z urządzenia. |
void
|
resetContentProviderSetup()
Zresetuj flagę konfiguracji dostawcy treści, aby ponownie ją uruchomić. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Metoda ułatwiająca wykonywanie funkcji |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Uruchamia testy z instrumentacją i zapewnia odzyskiwanie urządzenia. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
To samo co |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Działa tak samo jak |
void
|
setConfiguration(IConfiguration configuration)
Wstrzykuje |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
ustawia datę na urządzeniu; Uwaga: ustawienie daty na urządzeniu wymaga uprawnień roota |
boolean
|
setDeviceOwner(String componentName, int userId)
Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika. |
void
|
setDeviceState(TestDeviceState deviceState)
Zaktualizuj stan urządzenia. |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
W emulatorze ustaw |
void
|
setEmulatorProcess(Process p)
Ustawia |
void
|
setFastbootEnabled(boolean fastbootEnabled)
Ustaw opcję fastboot na urządzeniu. |
void
|
setFastbootPath(String fastbootPath)
Ustawia ścieżkę do pliku binarnego fastboot, którego należy użyć. |
void
|
setIDevice(IDevice newDevice)
Zaktualizuj urządzenie IDevice powiązane z tym urządzeniem ITestDevice. |
void
|
setLogStartDelay(int delay)
Określa czas oczekiwania (w ms) przed rozpoczęciem przechwytywania dzienników logcat przez urządzenie online. |
void
|
setOptions(TestDeviceOptions options)
Ustaw |
boolean
|
setProperty(String propKey, String propValue)
Ustawia określoną wartość właściwości na urządzeniu. |
void
|
setRecovery(IDeviceRecovery recovery)
Ustaw |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Ustaw bieżący tryb odzyskiwania danych, który ma być używany na urządzeniu. |
void
|
setSetting(String namespace, String key, String value)
Zobacz metodę |
void
|
setSetting(int userId, String namespace, String key, String value)
Dodaje wartość ustawienia do przestrzeni nazw danego użytkownika. |
void
|
setTestLogger(ITestLogger testLogger)
Wstrzykuje instancję |
void
|
setTrackingSerial(String trackingSerial)
W celu zarządzania urządzeniami śledź numer seryjny, którego używamy do identyfikowania urządzenia. |
void
|
setUseFastbootErase(boolean useFastbootErase)
Określ, czy chcesz użyć fastboot erase czy fastboot format do wyczyszczenia partycji na urządzeniu. |
void
|
startLogcat()
Rozpocznij przechwytywanie danych logcat z urządzenia w tle. |
boolean
|
startUser(int userId)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. |
boolean
|
startUser(int userId, boolean waitFlag)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli pozwala użytkownikowi uruchamiać czynności na tym wyświetlaczu). |
void
|
stopEmulatorOutput()
Zamknij i usuń dane wyjściowe emulatora. |
void
|
stopLogcat()
Zatrzymaj przechwytywanie danych logcat z urządzenia i usuń aktualnie zapisane dane logcat. |
boolean
|
stopUser(int userId)
Zatrzymuje danego użytkownika. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Zatrzymać danego użytkownika. |
String
|
switchToAdbTcp()
Przełącz urządzenie w tryb adb-over-tcp. |
boolean
|
switchToAdbUsb()
Przełącz urządzenie na tryb adb przez USB. |
boolean
|
switchUser(int userId)
Przełącz się na innego użytkownika o domyślnym czasie oczekiwania. |
boolean
|
switchUser(int userId, long timeout)
Przełącz się na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Stopniowo synchronizuje zawartość lokalnego katalogu plików z urządzeniem. |
Bugreport
|
takeBugreport()
Przejmuje zgłoszenie błędu i zwraca je w obiekcie |
String
|
uninstallPackage(String packageName)
Odinstaluj pakiet Androida z urządzenia. |
String
|
uninstallPackageForUser(String packageName, int userId)
Odinstaluj pakiet Androida z urządzenia danego użytkownika. |
boolean
|
unlockDevice()
Odblokowuje urządzenie, jeśli jest ono zaszyfrowane. |
void
|
unmountDebugfs()
Odłącz pliki debugowania. |
boolean
|
waitForBootComplete(long timeOut)
Blokuje do momentu ustawienia flagi „boot complete”. |
boolean
|
waitForDeviceAvailable()
Czeka, aż urządzenie będzie gotowe do testowania. |
boolean
|
waitForDeviceAvailable(long waitTime)
Czeka, aż urządzenie będzie gotowe do testowania. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Czeka, aż urządzenie będzie gotowe do działania i dostępne bez uwzględniania ścieżki odzyskiwania. |
void
|
waitForDeviceBootloader()
Blokuje, dopóki urządzenie nie będzie widoczne w Fastboot. |
boolean
|
waitForDeviceInRecovery(long waitTime)
Blokuje działanie urządzenia w stanie „adbrecovery” (to coś innego niż |
boolean
|
waitForDeviceInSideload(long waitTime)
Blokuje urządzenie w stanie „adb sideload”. |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Blokady związane z brakiem dostępności urządzenia, np. brak dostępu do narzędzia adb |
void
|
waitForDeviceOnline()
Blokuje, dopóki urządzenie nie będzie widoczne w narzędziu adb. |
void
|
waitForDeviceOnline(long waitTime)
Blokuje, dopóki urządzenie nie będzie widoczne przez adb. |
boolean
|
waitForDeviceShell(long waitTime)
Czeka, aż urządzenie zareaguje na podstawowe polecenie adb shell. |
Chronione metody | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
Tworzy polecenie systemu operacyjnego dla danej sesji polecenia adb shell i argumentów |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Utwórz |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Ponownie uruchom narzędzie adb. |
void
|
ensureRuntimePermissionSupported()
metoda pomocnicza do rzucania wyjątkiem, jeśli uprawnienia czasu działania nie są obsługiwane |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Pobierz instancję |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Pobierać właściwości urządzenia z domyślnego pamięci podręcznej ddmlib, a w razie potrzeby z polecenia `adb shell getprop` lub `fastboot getvar`, w zależności od tego, czy urządzenie jest w trybie Fastboot. |
boolean
|
isInRebootCallback()
Zwraca informację, czy wywołania zwrotne ponownego uruchamiania są obecnie wykonywane. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Zwraca |
void
|
notifyRebootEnded()
Powiadamia wszystkie urządzenia |
void
|
notifyRebootStarted()
Informuje wszystkie |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Wykonywanie czynności na tym urządzeniu. |
void
|
postAdbReboot()
Możliwe dodatkowe działania, które można wykonać po ponownym uruchomieniu. |
void
|
prePostBootSetup()
Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w przypadku określonej konfiguracji po uruchomieniu. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Ustaw instancję zegara, której chcesz używać. |
void
|
setMicrodroidProcess(Process process)
Oznacza TestDevice jako microdroid i ustala jego identyfikator CID. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
Wykonuje proste polecenie fastboot z użyciem zmiennych środowiskowych i zgłasza stan tego polecenia. |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
Wykonuje proste polecenie fastboot i zgłasza jego stan. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
Poczekaj, aż urządzenie stanie się niedostępne (zatrzymaj raportowanie do adb). |
Stałe
INVALID_USER_ID
public static final int INVALID_USER_ID
Wartość zwrócona w przypadku każdego nieprawidłowego lub nieznalezionego identyfikatora użytkownika: UserHandle zdefiniował wartość -10000
Wartość stała: -10 000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Wartość stała: 5000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
domyślna liczba prób ponownego wykonania polecenia,
Wartość stała: 2 (0x00000002)
Fieldsem
ŚCIEŻKA_DEBUGFS
public static final String DEBUGFS_PATH
KARTA_SD
protected static final String SD_CARD
ZMIENNO MIEJSCE NA DANE
protected static final String STORAGE_EMULATED
Konstruktory publiczne
NativeDevice
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Tworzy TestDevice
.
Parametry | |
---|---|
device |
IDevice : powiązane pole IDevice |
stateMonitor |
IDeviceStateMonitor : mechanizm IDeviceStateMonitor do użycia |
allocationMonitor |
IDeviceMonitor : element IDeviceMonitor informuje o zmianach stanu alokacji.
Może być null |
Metody publiczne
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Mikrooptymalizacja (około 400 milisekund) poprzez wstępne pobieranie wszystkich potrzebnych rekwizytów, zamiast wywoływania dla każdego z nich polecenia „adb getprop”. Oznacza to, że pobieranie wszystkich właściwości przebiega równie szybko, jak pobieranie. Funkcje takie jak device.getApiLevel(), checkApiLevelAgainstNextRelease i getBuildAlias wywołują w tle polecenie `adb getprop`. Pobieramy je w jednym wywołaniu i wywołujemy metodę NativeDevice.setProperty. Nawet jeśli tego nie zrobimy, NativeDevice sam wywoła metodę setProperty i zapisze wynik w pamięci podręcznej na potrzeby przyszłych wywołań. Robimy to tylko nieco wcześniej. Jeśli urządzenie jest w trakcie odzyskiwania lub podczas pobierania zasobów wystąpią inne błędy, zostaną one zignorowane.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Zwraca informację, czy można przełączyć się na użytkownika systemu bez interfejsu.
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Sprawdź, czy dana funkcja jest obecnie obsługiwana z uwzględnieniem minimalnego poziomu obsługi. Ta metoda uwzględnia funkcje, które nie zostały jeszcze udostępnione, zanim podniesiesz poziom interfejsu API.
Parametry | |
---|---|
strictMinLevel |
int : najniższy możliwy poziom, który obsługuje funkcję. |
Zwroty | |
---|---|
boolean |
Prawda, jeśli poziom jest obsługiwany. W przeciwnym razie ma wartość Fałsz. |
Rzuty | |
---|---|
DeviceNotAvailableException |
checkConnectivity
public boolean checkConnectivity ()
Sprawdź, czy urządzenie ma połączenie z siecią.
Zwroty | |
---|---|
boolean |
true jeśli urządzenie ma aktywne połączenie z siecią,
false w przeciwnym razie. |
Rzuty | |
---|---|
DeviceNotAvailableException |
clearErrorDialogs
public boolean clearErrorDialogs ()
Spróbuj zamknąć wszystkie okna z błędami wyświetlane obecnie w interfejsie urządzenia.
Zwroty | |
---|---|
boolean |
true , jeśli nie było żadnych okien dialogowych lub zostały one wyczyszczone.
false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Czyści ostatnią połączoną sieć Wi-Fi. Należy go wywołać podczas uruchamiania nowego wywołania, aby uniknąć łączenia się z siecią Wi-Fi użytą w poprzednim teście po ponownym uruchomieniu urządzenia.
ClearLogcat
public void clearLogcat ()
Usuwa wszystkie zgromadzone dane logcat.
Jest to przydatne, gdy chcesz mieć pewność, że ITestDevice#getLogcat()
zwróci tylko dane dziennika utworzone po określonym momencie (np. po przeflashowaniu nowej wersji urządzenia).
połącz_sieciWifi
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Połącza się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice#disconnectFromWifi()
lub ITestDevice#clearLastConnectedWifiNetwork()
.
Parametry | |
---|---|
wifiSsidToPsk |
: mapa identyfikatorów SSID sieci Wi-Fi z hasłami. |
scanSsid |
boolean : określa, czy ma szukać ukrytych identyfikatorów SSID tej sieci. |
Zwroty | |
---|---|
boolean |
true , jeśli udało się połączyć z siecią Wi-Fi. false w innym przypadku |
Rzuty | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Połącza się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z określoną siecią Wi-Fi.
Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice#disconnectFromWifi()
lub ITestDevice#clearLastConnectedWifiNetwork()
.
Parametry | |
---|---|
wifiSsid |
String : identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć |
wifiPsk |
String : hasło PSK lub wartość null, jeśli nie jest zaszyfrowane |
Zwroty | |
---|---|
boolean |
true jeśli urządzenie jest połączone z siecią Wi-Fi. false w innym przypadku |
Rzuty | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk)
Połącza się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia po każdym ponownym uruchomieniu instancja będzie próbowała je przywrócić, aż zostanie wywołana funkcja ITestDevice#disconnectFromWifi()
lub ITestDevice#clearLastConnectedWifiNetwork()
.f
Parametry | |
---|---|
wifiSsidToPsk |
: mapa identyfikatorów SSID sieci Wi-Fi z hasłami. |
Zwroty | |
---|---|
boolean |
true , jeśli udało się połączyć z siecią Wi-Fi. false w innym przypadku |
Rzuty | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Połącza się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z określoną siecią Wi-Fi.
Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice#disconnectFromWifi()
lub ITestDevice#clearLastConnectedWifiNetwork()
.
Parametry | |
---|---|
wifiSsid |
String : identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć |
wifiPsk |
String : hasło PSK lub null, jeśli nie jest zaszyfrowane |
scanSsid |
boolean : czy skanować ukryte identyfikatory SSID tej sieci. |
Zwroty | |
---|---|
boolean |
true jeśli urządzenie jest połączone z siecią Wi-Fi. false w innym przypadku |
Rzuty | |
---|---|
DeviceNotAvailableException |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Wariant connectToWifiNetwork(String, String)
, który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z internetem.
Parametry | |
---|---|
scanSsid |
boolean : czy ma skanować w poszukiwaniu ukrytego identyfikatora SSID tej sieci |
Zwroty | |
---|---|
boolean |
true jeśli urządzenie jest połączone z siecią Wi-Fi. false w innym przypadku |
Rzuty | |
---|---|
DeviceNotAvailableException |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Wariant connectToWifiNetwork(String, String)
, który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z internetem.
Zwroty | |
---|---|
boolean |
true jeśli urządzenie jest połączone z siecią Wi-Fi. false w innym przypadku |
Rzuty | |
---|---|
DeviceNotAvailableException |
utwórzUżytkownik
public int createUser (String name, boolean guest, boolean ephemeral)
Utwórz użytkownika z danym imieniem i podanymi flagami
Parametry | |
---|---|
name |
String : użytkownika, którego chcesz utworzyć na urządzeniu |
guest |
boolean : włącz flagę użytkownika – gość podczas tworzenia. |
ephemeral |
boolean : włącz flagę użytkownika --ephemeral podczas tworzenia. |
Zwroty | |
---|---|
int |
identyfikator utworzonego użytkownika |
Rzuty | |
---|---|
DeviceNotAvailableException |
utwórzUżytkownik
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Utwórz użytkownika z danym imieniem i podanymi flagami
Parametry | |
---|---|
name |
String : użytkownika, którego chcesz utworzyć na urządzeniu |
guest |
boolean : włącz flagę użytkownika – gość podczas tworzenia. |
ephemeral |
boolean : włącz flagę użytkownika --ephemeral podczas tworzenia. |
forTesting |
boolean : włącz flagę testu --for-testing podczas tworzenia. |
Zwroty | |
---|---|
int |
identyfikator utworzonego użytkownika |
Rzuty | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
Parametry | |
---|---|
name |
String : użytkownika do utworzenia na urządzeniu |
Zwroty | |
---|---|
int |
liczba całkowita dla utworzonego identyfikatora użytkownika |
Rzuty | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
Utwórz użytkownika z danym imieniem i domyślnymi flagami 0.
Parametry | |
---|---|
name |
String : użytkownika do utworzenia na urządzeniu |
Zwroty | |
---|---|
int |
liczba całkowita utworzonego identyfikatora użytkownika lub -1 – błąd. |
Rzuty | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath, int userId)
Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu.
Parametry | |
---|---|
deviceFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu. |
userId |
int : identyfikator użytkownika, z którego chcesz usunąć dane. |
Rzuty | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath)
Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu.
Parametry | |
---|---|
deviceFilePath |
String : ścieżka bezwzględna do pliku na urządzeniu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
deregisterDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Usuwa zarejestrowany IDeviceActionReceiver
.
Parametry | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : IDeviceActionReceiver , który zostanie usunięty. |
urządzenie zostało ponownie uruchomione
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Metoda pomocnicza służąca do sprawdzania, czy urządzenie zostało zrestartowane, przez porównanie bieżącego system_server z poprzednim system_server ProcessInfo
. Aby skorzystać z promocji ProcessInfo
, użyj getProcessByName(String)
.
Parametry | |
---|---|
prevSystemServerProcess |
ProcessInfo : poprzedni proces system_server ProcessInfo . |
Zwroty | |
---|---|
boolean |
true jeśli urządzenie zostało zrestartowane |
Rzuty | |
---|---|
DeviceNotAvailableException |
deviceSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza służąca do sprawdzania, czy urządzenie zostało zresetowane od czasu UTC od początku epoki na urządzeniu i jego ERROR(/TimeUnit)
. Miękkie ponowne uruchomienie to ponowne uruchomienie system_servera poza twardym restartem urządzenia (np. żądanym przez użytkownika). Bieżący czas UTC urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate()
.
Parametry | |
---|---|
utcEpochTime |
long : czas na urządzeniu w sekundach od początku epoki. |
timeUnit |
TimeUnit : jednostka czasu TimeUnit dla podanego czasu utcEpochTime. |
Zwroty | |
---|---|
boolean |
true jeśli urządzenie zostało zrestartowane |
Rzuty | |
---|---|
DeviceNotAvailableException |
disableAdbRoot
public boolean disableAdbRoot ()
Wyłącza rootowanie adb.
Wyłączenie roota adb może spowodować rozłączenie urządzenia z adb. Ta metoda zablokuje urządzenie, dopóki nie będzie dostępne.
Zwroty | |
---|---|
boolean |
true w przypadku powodzenia. |
Rzuty | |
---|---|
DeviceNotAvailableException |
disableKeyguard
public void disableKeyguard ()
Próby wyłączenia blokady klawiatury.
Najpierw zaczekaj, aż przesłanie danych wejściowych będzie gotowe. Stanie się to mniej więcej w tym samym czasie, gdy urządzenie zgłosi BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ obecna implementacja frameworka ma sporadyczne warunki wyścigu. Następnie wysyłane jest polecenie odblokowania klawiatury (działa tylko w przypadku klawiatur niezabezpieczonych)
Rzuty | |
---|---|
DeviceNotAvailableException |
disableNetworkMonitor
public boolean disableNetworkMonitor ()
Wyłącza monitorowanie sieci na urządzeniu.
Zwroty | |
---|---|
boolean |
true , jeśli monitoring został wyłączony. false
jeśli nie udało się. |
Rzuty | |
---|---|
DeviceNotAvailableException |
disconnectFromWifi
public boolean disconnectFromWifi ()
Rozłącza się z siecią Wi-Fi.
Usuwa wszystkie sieci z listy znanych sieci i wyłącza Wi-Fi.
Zwroty | |
---|---|
boolean |
true , jeśli uda się odłączyć od sieci Wi-Fi. false
jeśli nie udało się zakończyć połączenia. |
Rzuty | |
---|---|
DeviceNotAvailableException |
doesFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu istnieje dla danego użytkownika.
Parametry | |
---|---|
deviceFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu, który ma zostać sprawdzony |
userId |
int : identyfikator użytkownika, którego dotyczy sprawdzanie istnienia pliku |
Zwroty | |
---|---|
boolean |
true , jeśli plik istnieje, false w przeciwnym razie. |
Rzuty | |
---|---|
DeviceNotAvailableException |
niePlikIstnieje
public boolean doesFileExist (String deviceFilePath)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu istnieje.
Parametry | |
---|---|
deviceFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu, który ma zostać sprawdzony |
Zwroty | |
---|---|
boolean |
true , jeśli plik istnieje, false w przeciwnym razie. |
Rzuty | |
---|---|
DeviceNotAvailableException |
dumpHeap
public File dumpHeap (String process, String devicePath)
Spróbuj zrzucić stos z system_server. Usuwanie zrzutu ekranu należy do osoby wywołującej.
Parametry | |
---|---|
process |
String : nazwa procesu urządzenia, na którym ma zostać zapisana kopia. |
devicePath |
String : ścieżka na urządzeniu, w której ma zostać zapisany zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia. |
Zwroty | |
---|---|
File |
element ERROR(/File) zawierający raport. Wartość null, jeśli coś się nie udało. |
Rzuty | |
---|---|
DeviceNotAvailableException |
włącz AdbRoot
public boolean enableAdbRoot ()
Włącza roota adb. Jeśli ustawienie „enable-root” ma wartość „false”, zostanie zarejestrowana wiadomość i zwrócona wartość bez włączania root.
Włączenie roota adb może spowodować rozłączenie urządzenia z adb. Ta metoda będzie zablokowana, dopóki urządzenie nie będzie dostępne.
Zwroty | |
---|---|
boolean |
true w przypadku powodzenia. |
Rzuty | |
---|---|
DeviceNotAvailableException |
enableNetworkMonitor
public boolean enableNetworkMonitor ()
Umożliwia monitorowanie sieci na urządzeniu.
Zwroty | |
---|---|
boolean |
true , jeśli włączono monitorowanie. false . |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.
Gdy tylko jest to możliwe, należy używać metody executeShellCommand(String)
, ponieważ zapewnia ona lepsze wykrywanie błędów i wyższą wydajność.
Parametry | |
---|---|
timeout |
long : czas w milisekundach, po którym urządzenie zostaje uznane za niedziałające. Wartość 0 oznacza brak limitu czasu. |
cmdArgs |
String : polecenie adb i argumenty do uruchomienia |
Zwroty | |
---|---|
String |
„stdout” z polecenia. null , jeśli polecenie nie zostało wykonane. |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.
Zamiast tego, w miarę możliwości, należy używać funkcji executeShellCommand(String)
, ponieważ zapewnia ona lepszą skuteczność i wykrywanie błędów.
Parametry | |
---|---|
timeout |
long : czas w milisekundach, po którym urządzenie jest uważane za niedziałające. Wartość 0 oznacza brak limitu czasu. |
envMap |
: środowisko do ustawienia dla polecenia |
cmdArgs |
String : polecenie adb i argumenty do uruchomienia |
Zwroty | |
---|---|
String |
„stdout” z polecenia. null , jeśli polecenie nie zostało wykonane. |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.
Gdy tylko jest to możliwe, należy używać metody executeShellCommand(String)
, ponieważ zapewnia ona lepsze wykrywanie błędów i wyższą wydajność.
Parametry | |
---|---|
cmdArgs |
String : polecenie adb i argumenty do uruchomienia |
Zwroty | |
---|---|
String |
„stdout” z polecenia. null , jeśli polecenie nie zostało wykonane. |
Rzuty | |
---|---|
DeviceNotAvailableException |
wykonaj FastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty.
Ma być używany, gdy urządzenie jest już w trybie fastboot.
Parametry | |
---|---|
cmdArgs |
String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult |
wynik CommandResult zawierający dane wyjściowe polecenia |
Rzuty | |
---|---|
DeviceNotAvailableException |
wykonaj FastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Metoda pomocnicza, która uruchamia polecenie szybkiego rozruchu jako polecenie systemowe.
Ma być używany, gdy urządzenie jest już w trybie fastboot.
Parametry | |
---|---|
timeout |
long : czas w milisekundach do wygaśnięcia polecenia |
cmdArgs |
String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult |
wynik CommandResult zawierający dane wyjściowe polecenia |
Rzuty | |
---|---|
DeviceNotAvailableException |
WykonajLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe.
To samo co executeFastbootCommand(String)
, ale z dłuższym czasem oczekiwania.
Parametry | |
---|---|
cmdArgs |
String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult |
wynik CommandResult zawierający dane wyjściowe polecenia |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Metoda pomocnicza, która wykonuje długo działające polecenie fastboot jako polecenie systemowe ze zmiennymi środowiskowymi systemu.
To samo co executeFastbootCommand(String)
, ale z dłuższym czasem oczekiwania.
Parametry | |
---|---|
envVarMap |
: systemowe zmienne środowiskowe używane przez polecenie szybkiego rozruchu. |
cmdArgs |
String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult |
wynik CommandResult zawierający dane wyjściowe polecenia |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public String executeShellCommand (String command)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca dane wyjściowe jako String
.
Parametry | |
---|---|
command |
String : polecenie adb shell do uruchomienia |
Zwroty | |
---|---|
String |
dane wyjściowe powłoki |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
command |
String : polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver : IShellOutputReceiver , do którego ma być kierowane wyjście powłoki. |
maxTimeToOutputShellResponse |
long : maksymalny czas, przez który komenda może nie generować odpowiedzi; jednostka podana w parametrze timeUnit |
timeUnit |
TimeUnit : jednostka maxTimeToOutputShellResponse |
retryAttempts |
int : maksymalna liczba prób ponownego wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts zostanie wykonane bez powodzenia, zostanie zgłoszony wyjątek DeviceNot Adjust. |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
command |
String : polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver : IShellOutputReceiver , do którego ma być kierowane wyjście powłoki. |
maxTimeoutForCommand |
long : maksymalny czas oczekiwania na wykonanie polecenia; jednostka podana w parasm timeUnit |
maxTimeToOutputShellResponse |
long : maksymalny czas, przez który komenda może nie generować odpowiedzi; jednostka podana w parametrze timeUnit |
timeUnit |
TimeUnit : jednostka maxTimeToOutputShellResponse |
retryAttempts |
int : maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts zostanie wykonane bez powodzenia, zostanie zgłoszony wyjątek DeviceNot Adjust. |
Rzuty | |
---|---|
DeviceNotAvailableException |
WykonajShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Wykonuje podane polecenie adb shell, powtarzając próbę kilka razy, jeśli polecenie się nie powiedzie.
Prostsza forma obiektu executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
z wartościami domyślnymi.
Parametry | |
---|---|
command |
String : polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver : IShellOutputReceiver , do którego ma być kierowane wyjście powłoki. |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako obiekt CommandResult
wypełniony odpowiednimi danymi wyjściowymi polecenia, tj. stdout i stderr.
Parametry | |
---|---|
cmd |
String : polecenie do uruchomienia. |
Zwroty | |
---|---|
CommandResult |
Wynik w formacie CommandResult . |
Rzuty | |
---|---|
DeviceNotAvailableException |
WykonajShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako CommandResult
z prawidłowo wypełnionym stanem polecenia i stderr. stdout jest kierowany do określonego strumienia.
Parametry | |
---|---|
cmd |
String : polecenie, które ma zostać wykonane. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , gdzie standardowe dane wyjściowe zostaną przekierowane lub będą miały wartość null. |
Zwroty | |
---|---|
CommandResult |
Wynik w języku CommandResult . |
Rzuty | |
---|---|
DeviceNotAvailableException |
WykonajShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki w postaci pola CommandResult
prawidłowo wypełnionego danymi wyjściowymi o stanie polecenia: stdout i stderr.
Parametry | |
---|---|
cmd |
String : polecenie, które ma zostać wykonane. |
pipeAsInput |
File : pole ERROR(/File) , które zostanie przesłane potokiem jako dane wejściowe do polecenia, lub wartość null. |
Zwroty | |
---|---|
CommandResult |
Wynik w języku CommandResult . |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
cmd |
String : polecenie powłoki adb do uruchomienia |
maxTimeoutForCommand |
long : maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit . |
timeUnit |
TimeUnit : jednostka za maxTimeToOutputShellResponse |
retryAttempts |
int : maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie powiedzie się, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
Zwroty | |
---|---|
CommandResult |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
cmd |
String : polecenie powłoki adb do uruchomienia |
maxTimeoutForCommand |
long : maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit . |
timeUnit |
TimeUnit : jednostka maxTimeToOutputShellResponse |
Zwroty | |
---|---|
CommandResult |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
cmd |
String : polecenie adb shell do uruchomienia |
pipeAsInput |
File : ERROR(/File) , który zostanie przekazany jako dane wejściowe polecenia lub będzie miał wartość null. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , gdzie standardowe dane wyjściowe zostaną przekierowane lub będą miały wartość null. |
maxTimeoutForCommand |
long : maksymalny czas oczekiwania na wykonanie polecenia; jednostka podana w parasm timeUnit |
timeUnit |
TimeUnit : jednostka za maxTimeToOutputShellResponse |
retryAttempts |
int : maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie powiedzie się, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
Zwroty | |
---|---|
CommandResult |
Rzuty | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
cmd |
String : polecenie powłoki adb do uruchomienia |
pipeAsInput |
File : ERROR(/File) , który zostanie przekazany jako dane wejściowe polecenia lub będzie miał wartość null. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , gdzie standardowe dane wyjściowe zostaną przekierowane lub będą miały wartość null. |
pipeToError |
OutputStream : ERROR(/OutputStream) , gdzie zostanie przekierowany błąd standardowy, lub wartość null. |
maxTimeoutForCommand |
long : maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit . |
timeUnit |
TimeUnit : jednostka za maxTimeToOutputShellResponse |
retryAttempts |
int : maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie powiedzie się, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
Zwroty | |
---|---|
CommandResult |
Rzuty | |
---|---|
DeviceNotAvailableException |
fastbootWipePartition
public CommandResult fastbootWipePartition (String partition)
Metoda pomocnicza, która czyści partycję na urządzeniu.
Jeśli getUseFastbootErase()
to true
, partycja zostanie wyczyszczona za pomocą szybkiego formatowania. Przy następnym uruchomieniu urządzenie musi utworzyć system plików.
W przeciwnym razie używany jest format fastboot, który tworzy nowy system plików na urządzeniu.
Ma być używany, gdy urządzenie jest już w trybie fastboot.
Parametry | |
---|---|
partition |
String : partycja, którą chcesz wymazać |
Zwroty | |
---|---|
CommandResult |
wynik CommandResult zawierający dane wyjściowe polecenia |
Rzuty | |
---|---|
DeviceNotAvailableException |
getActiveApexes
publicgetActiveApexes ()
Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.
Zwroty | |
---|---|
|
Aktywowano obecnie na urządzeniu ERROR(/Set) z ApexInfo |
Rzuty | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
Zwraca pary klucz-wartość żądanej przestrzeni nazw.
Parametry | |
---|---|
namespace |
String : musi być jedną z tych wartości: {"system", "secure", "global"} |
Zwroty | |
---|---|
|
mapę par klucz-wartość. Wartość null, jeśli przestrzeń nazw nie jest obsługiwana. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Zwraca bieżący stan przydziału urządzenia.
Zwroty | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
Znajdź i zwróć identyfikator android-id powiązany z userId, null, jeśli nie znaleziono.
Parametry | |
---|---|
userId |
int |
Zwroty | |
---|---|
String |
Rzuty | |
---|---|
DeviceNotAvailableException |
identyfikatory getAndroid
publicgetAndroidIds ()
Utwórz mapę znalezionych identyfikatorów Androida pasujących do identyfikatorów użytkowników. Nie ma pewności, że w przypadku każdego identyfikatora użytkownika uda się znaleźć powiązany z nim identyfikator Androida, więc niektóre identyfikatory użytkowników mogą być równe null.
Zwroty | |
---|---|
|
Mapa identyfikatorów Androida dopasowanych do identyfikatorów użytkowników. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getApiLevel
public int getApiLevel ()
Pobierz poziom interfejsu API urządzenia. Domyślna wartość to UNKNOWN_API_LEVEL
.
Zwroty | |
---|---|
int |
liczba całkowita wskazująca poziom interfejsu API urządzenia |
Rzuty | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.
Parametry | |
---|---|
packageName |
String |
Zwroty | |
---|---|
PackageInfo |
PackageInfo lub null , jeśli nie udało się pobrać informacji |
Rzuty | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
Pobiera informacje o pakietach zainstalowanych na urządzeniu.
Zwroty | |
---|---|
|
ERROR(/List) z PackageInfo zainstalowanych na urządzeniu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public String getBasebandVersion ()
Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia. Wersja radiowa zależy od urządzenia, więc może nie zwracać prawidłowych informacji w przypadku niektórych urządzeń. Ta metoda polega na zwracaniu prawidłowej informacji o wersji za pomocą właściwości gsm.version.baseband.
Nie jest to prawidłowe w przypadku niektórych urządzeń CDMA. Zwrócona tutaj wersja może nie być zgodna z wersją zgłaszaną za pomocą szybkiego rozruchu i może nie zwracać wersji dla radia CDMA.
TL;DR: ta metoda podaje dokładną wersję tylko wtedy, gdy właściwość gsm.version.baseband jest taka sama jak wersja zwracana przez fastboot getvar version-baseband
.
Zwroty | |
---|---|
String |
wersję pasma podstawowego String lub null , jeśli nie można jej określić (urządzenie nie ma radia lub nie można odczytać ciągu wersji). |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBattery
public Integer getBattery ()
Zwraca bieżący poziom baterii urządzenia lub wartość null, jeśli poziom baterii jest niedostępny.
Zwroty | |
---|---|
Integer |
getBoolean Property,
public boolean getBooleanProperty (String name, boolean defaultValue)
Zwraca wartość logiczną danej właściwości.
Parametry | |
---|---|
name |
String : nazwa właściwości, |
defaultValue |
boolean : wartość domyślna do zwrócenia, jeśli właściwość jest pusta lub nie istnieje. |
Zwroty | |
---|---|
boolean |
true , jeśli właściwość ma wartość "1" , "y" , "yes" , "on" lub "true" , false , jeśli właściwość ma wartość "0" , "n" , "no" , "off" , "false" lub defaultValue
w innym przypadku. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBootHistory
publicgetBootHistory ()
Metoda pomocnicza zbiera mapę historii uruchamiania z informacjami o czasie uruchomienia i przyczynie uruchamiania.
Zwroty | |
---|---|
|
Mapa czasu uruchamiania (czas UTC w sekundach od początku epoki) i przyczyny uruchamiania |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchomienia od podanego czasu od epoki na urządzeniu i z określonej jednostki czasu. Bieżący czas UTC urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate()
.
Parametry | |
---|---|
utcEpochTime |
long : czas urządzenia od początku epoki. |
timeUnit |
TimeUnit : jednostka czasu TimeUnit . |
Zwroty | |
---|---|
|
Mapa czasu uruchamiania (czas UTC w sekundach od początku epoki) i przyczyny uruchamiania |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public String getBootloaderVersion ()
Wygodna metoda uzyskania wersji programu rozruchowego tego urządzenia.
Spróbuje pobrać wersję bootloadera z obecnego stanu urządzenia. Jeśli na przykład urządzenie jest w trybie fastboot, spróbuje pobrać wersję z tego trybu.
Zwroty | |
---|---|
String |
wersja programu rozruchowego String lub null , jeśli nie można go znaleźć |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
Pobiera raport o błędzie z urządzenia.
Na pewno będzie działać na urządzeniach bez karty SD (lub na których nie jest ona jeszcze podłączona).
Zwroty | |
---|---|
InputStreamSource |
Interfejs InputStreamSource , który na żądanie utworzy treść raportu o błędzie. W przypadku błędu funkcja InputStreamSource zwróci pustą wartość ERROR(/InputStream) . |
getBugreportz
public InputStreamSource getBugreportz ()
Pobiera z urządzenia raport o błędach. Plik bugreport w formacie ZIP zawiera główny raport o błędzie oraz inne pliki logów, które są przydatne do debugowania.
Obsługiwane tylko w przypadku wersji „adb” > 1.0.36
Zwroty | |
---|---|
InputStreamSource |
a InputStreamSource pliku zip zawierającego raport o błędach, zwraca null w przypadku błędu. |
getBuildAlias
public String getBuildAlias ()
Pobierz alias kompilacji, która jest obecnie używana na urządzeniu.
Alias kompilacji to zwykle bardziej czytelny ciąg niż identyfikator kompilacji (zwykle liczba w przypadku kompilacji Nexusów). Na przykład ostateczna wersja Androida 4.2 ma alias kompilacji JDQ39 i identyfikator kompilacji 573038.
Zwroty | |
---|---|
String |
aliasu kompilacji lub, jeśli nie można go pobrać, użyć identyfikatora kompilacji. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public String getBuildFlavor ()
Pobierz wersję kompilacji dla urządzenia.
Zwroty | |
---|---|
String |
wersja kompilacji lub null, jeśli nie udało się jej pobrać |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
Pobierz wersję, która jest obecnie uruchomiona na urządzeniu.
Zwroty | |
---|---|
String |
identyfikator kompilacji lub IBuildInfo#UNKNOWN_BUILD_ID , jeśli nie udało się go pobrać; |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys
public String getBuildSigningKeys ()
Zwraca typ klucza użytego do podpisania obrazu urządzenia.
Urządzenia z Androidem są zwykle podpisywane kluczami testowymi (jak w AOSP) lub kluczami wersji (kontrolowanymi przez poszczególnych producentów urządzeń).
Zwroty | |
---|---|
String |
Klucz podpisywania, jeśli został znaleziony, w przeciwnym razie wartość null. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Zwraca DeviceDescriptor
z pamięci podręcznej, jeśli urządzenie jest przydzielone. W przeciwnym razie zwraca bieżącą wartość DeviceDescriptor
.
Zwroty | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Zwraca DeviceDescriptor
z pamięci podręcznej, jeśli urządzenie jest przydzielone. W przeciwnym razie zwraca bieżącą wartość DeviceDescriptor
.
Parametry | |
---|---|
shortDescriptor |
boolean : czy ograniczyć opis do niezbędnych informacji |
Zwroty | |
---|---|
DeviceDescriptor |
getChildren
public String[] getChildren (String path)
Alternatywa dla funkcji IFileEntry
, która czasami nie działa ze względu na uprawnienia.
Parametry | |
---|---|
path |
String : ścieżka na urządzeniu, na której ma być przeprowadzone wyszukiwanie |
Zwroty | |
---|---|
String[] |
Tablica z ciągiem znaków zawierającym cały plik w ścieżce na urządzeniu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
Bieżące połączenie powiązane z urządzeniem.
Zwroty | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Zwraca wartość ContentProviderHandler
lub wartość null, jeśli nie jest dostępna.
Dostawcy treści można użyć ponownie, jeśli został utworzony wcześniej za pomocą tego samego elementu userId
.
Parametry | |
---|---|
userId |
int : identyfikator użytkownika, za pomocą którego można zainicjować dostawcę treści. |
Zwroty | |
---|---|
ContentProviderHandler |
Rzuty | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Zwraca bieżący stan urządzenia lub wartość null, jeśli wystąpiły jakieś problemy.
Zwroty | |
---|---|
DeviceFoldableState |
Rzuty | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
Zwraca identyfikator bieżącego użytkownika. W przypadku błędu zwraca wartość -10000.
Zwroty | |
---|---|
int |
Rzuty | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Pobierz klasę urządzenia.
Zwroty | |
---|---|
String |
klasa urządzenia String . |
getDeviceDate
public long getDeviceDate ()
Zwraca datę urządzenia w milisekundach od początku epoki.
Zwroty | |
---|---|
long |
datę urządzenia w formacie epochalnym. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
Zwracać DeviceDescriptor
z informacjami o urządzeniu, aby uzyskać informacje o nim bez przekazywania rzeczywistego obiektu urządzenia.
Zwroty | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Zwracać DeviceDescriptor
z informacjami o urządzeniu, aby uzyskać informacje o nim bez przekazywania rzeczywistego obiektu urządzenia.
Parametry | |
---|---|
shortDescriptor |
boolean : czy ograniczyć opis do niezbędnych informacji |
Zwroty | |
---|---|
DeviceDescriptor |
getDeviceState
public TestDeviceState getDeviceState ()
Pobierz stan urządzenia.
Zwroty | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Pomocnik do uzyskiwania różnicy czasowej między urządzeniem a danym ERROR(/Date)
. Używaj wewnętrznie czasu epoki.
Parametry | |
---|---|
date |
Date |
Zwroty | |
---|---|
long |
różnica w milisekundach |
Rzuty | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
Pobieranie strumienia danych z stdout i stderr emulatora
Zwroty | |
---|---|
InputStreamSource |
dane wyjściowe emulatora |
getEmulatorProcess
public Process getEmulatorProcess ()
Zwraca Process
odpowiadający temu emulatorowi.
Zwroty | |
---|---|
Process |
Process lub null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
Dziennik zawierający wszystkie logi usługi executeShellCommand(String)
.
Zwroty | |
---|---|
File |
getExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
Metoda pomocnicza służąca do określenia ilości wolnego miejsca na zewnętrznej pamięci urządzenia.
Zwroty | |
---|---|
long |
ilość wolnego miejsca w kilobajtach |
Rzuty | |
---|---|
DeviceNotAvailableException |
getFastbootPath
public String getFastbootPath ()
Zwraca ścieżkę używanego pliku binarnego fastboot.
Aby włączyć funkcje szybkiego uruchamiania, nadal wymagana jest wartość Prawda dla zasady isFastbootEnabled()
.
Zwroty | |
---|---|
String |
getFastbootProductType
public String getFastbootProductType ()
Wygodna metoda pobierania typu produktu, gdy urządzenie działa w trybie szybkiego rozruchu.
Z tej metody należy korzystać tylko wtedy, gdy urządzenie ma być w trybie szybkiego uruchamiania. W tym przypadku jest to nieco bezpieczniejsza opcja niż ogólna metoda getProductType()
, ponieważ ITestDevice będzie wiedzieć, jak przywrócić urządzenie do trybu fastboot, jeśli jest ono w nieprawidłowym stanie lub nie odpowiada.
Zwroty | |
---|---|
String |
nazwę typu produktu String lub null , jeśli nie można jej określić; |
Rzuty | |
---|---|
DeviceNotAvailableException |
getFastbootProductVersion
public String getFastbootProductVariant ()
Metoda ułatwiająca uzyskanie typu urządzenia w trybie Fastboot.
Z tej metody należy korzystać tylko wtedy, gdy urządzenie ma być w trybie szybkiego uruchamiania. W tym przypadku jest to nieco bezpieczniejsza opcja niż ogólna metoda getProductType()
, ponieważ ITestDevice będzie wiedzieć, jak przywrócić urządzenie do trybu fastboot, jeśli jest ono w nieprawidłowym stanie lub nie odpowiada.
Zwroty | |
---|---|
String |
nazwę typu produktu String lub null , jeśli nie można jej określić; |
Rzuty | |
---|---|
DeviceNotAvailableException |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Zwraca numer seryjny trybu fastboot.
Zwroty | |
---|---|
String |
getFastbootVariable
public String getFastbootVariable (String variableName)
Pobierz z urządzenia podawaną wartość zmiennej fastboot.
Parametry | |
---|---|
variableName |
String : nazwa zmiennej |
Zwroty | |
---|---|
String |
wartość właściwości lub null , jeśli nie istnieje, |
Rzuty | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
Zwraca ciąg znaków wersji używanego pliku binarnego fastboot. Jeśli coś poszło nie tak, podaj wartość null.
Zwroty | |
---|---|
String |
pobieranie wpisu z pliku
public IFileEntry getFileEntry (String path)
Pobranie odwołania do zdalnego pliku na urządzeniu.
Parametry | |
---|---|
path |
String : ścieżka do pliku do pobrania. Może to być ścieżka bezwzględna lub względna względem znaku „/”. (czyli obsługiwana jest składnia „/system” i „system”). |
Zwroty | |
---|---|
IFileEntry |
IFileEntry lub null , jeśli nie można znaleźć pliku w folderze path |
Rzuty | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Nieoficjalna pomoc w przypadku FileEntry
z ścieżki niebędącej ścieżką główną. FIXME: Refactor the
FileEntry system to have it available from any path. (nawet bez uprawnień root).
Parametry | |
---|---|
entry |
FileListingService.FileEntry : FileEntry nie musi mieć poziomu roota, jak wymaga Ddmlib. |
Zwroty | |
---|---|
IFileEntry |
obiekt FileEntryWrapper reprezentujący obiekt FileEntry. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
Zwraca listę stanów składania urządzenia. Można go uzyskać za pomocą polecenia „cmd device_state print-states”.
Zwroty | |
---|---|
|
Rzuty | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
Zwraca odwołanie do powiązanej biblioteki ddmlib IDevice
.
Za każdym razem, gdy urządzenie rozłączy się i połączy ponownie z adb, DDMS może przydzielić nowe IDevice
. Dlatego osoby dzwoniące nie powinny przechowywać odwołania do IDevice
, ponieważ może ono się zdezaktualizować.
Zwroty | |
---|---|
IDevice |
IDevice |
GetInstallNames (Nazwa pakietu)
publicgetInstalledPackageNames ()
Pobierz nazwy pakietów aplikacji obecnych na urządzeniu.
Zwroty | |
---|---|
|
ERROR(/Set) nazw pakietów String , które są obecnie zainstalowane na urządzeniu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
Zwraca wartość liczby całkowitej danej właściwości na urządzeniu.
Parametry | |
---|---|
name |
String : nazwa właściwości, |
defaultValue |
long : wartość domyślna zwracana, jeśli właściwość jest pusta lub nie istnieje. |
Zwroty | |
---|---|
long |
wartość właściwości lub defaultValue , jeśli właściwość jest pusta, nie istnieje lub nie ma wartości całkowitej. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getIpAddress.
public String getIpAddress ()
Pobiera adres IP urządzenia.
Zwroty | |
---|---|
String |
adres IP urządzenia lub null , jeśli urządzenie nie ma adresu IP |
Rzuty | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest on obsługiwany.
Zwroty | |
---|---|
KeyguardControllerState |
Pole KeyguardControllerState zawierające zrzut stanu zabezpieczenia klucza i zwraca wartość null, jeśli zapytanie zabezpieczające nie jest obsługiwane. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public long getLastExpectedRebootTimeMillis ()
Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie (w milisekundach od EPOCH), zwracany przez System.currentTimeMillis()
.
Zwroty | |
---|---|
long |
getLaunchApiLevel
public int getLaunchApiLevel ()
Uzyskaj poziom interfejsu API, który został po raz pierwszy uruchomiony na urządzeniu. Domyślna wartość to UNKNOWN_API_LEVEL
.
Zwroty | |
---|---|
int |
liczba całkowita wskazująca pierwszy uruchomiony poziom interfejsu API urządzenia; |
Rzuty | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
Pobiera strumień zrzutów danych logcat.
Działa w 2 trybach:
TestDeviceOptions.getMaxLogcatDataSize()
bajtów bieżącej zawartości przechwytywania logcat w tle.
Zwroty | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Pobiera strumień zrzutów ostatnich maxBytes
zapisanych danych logcat.
Przydatne w przypadkach, gdy chcesz robić częste zrzuty przechwyconych danych logcat bez naliczania opłaty za potencjalnie duże miejsce na dysku, która wynika z pobrania całego zrzutu getLogcat()
.
Parametry | |
---|---|
maxBytes |
int : maksymalna ilość danych do zwrócenia. Powinna to być ilość, która zmieści się w pamięci. |
Zwroty | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
Pobierz zrzut bieżącego logcata na urządzeniu. W przeciwieństwie do metody getLogcat()
ta metoda zawsze zwraca statyczny zrzut logcat.
Ma ona tę wadę, że jeśli urządzenie jest niedostępne, nic nie zostanie zwrócone.
Zwroty | |
---|---|
InputStreamSource |
InputStreamSource danych logcat. Jeśli nie uda się przechwycić danych logcat, zwrócony zostanie pusty strumień. |
getLogcatSince
public InputStreamSource getLogcatSince (long date)
Pobiera strumień zrzutów z zapisanych danych logcat od podanej daty. Należy użyć czasu na urządzeniugetDeviceDate()
.
Parametry | |
---|---|
date |
long : format milisekund od początku epoki do chwili rozpoczęcia zrzutu.
(można go uzyskać za pomocą funkcji „date +%s”) |
Zwroty | |
---|---|
InputStreamSource |
getMacAddress.
public String getMacAddress ()
Zwraca adres MAC urządzenia. Jeśli nie uda się wysłać zapytania do urządzenia, zwraca wartość null.
Zwroty | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
Zwraca identyfikator głównego użytkownika.
Zwroty | |
---|---|
Integer |
userId głównego użytkownika, jeśli taki istnieje, lub null, jeśli nie ma głównego użytkownika. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
Pobieranie informacji o głównych modułach zainstalowanych na urządzeniu.
Zwroty | |
---|---|
|
Na urządzeniu jest obecnie zainstalowanych ERROR(/Set) z String modułów mainline. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
Pobierz maksymalną liczbę obsługiwanych jednocześnie uruchomionych użytkowników. Domyślna wartość to 0.
Zwroty | |
---|---|
int |
liczba całkowita wskazująca liczbę jednocześnie działających użytkowników; |
Rzuty | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników. Domyślna wartość to 0.
Zwroty | |
---|---|
int |
liczba całkowita wskazująca liczbę obsługiwanych użytkowników; |
Rzuty | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
Zwroty | |
---|---|
Process |
Zwraca proces maszyny wirtualnej Microdroid. Jeśli TestDevice nie jest Microdroidem, zwraca null. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Zwracaj IDeviceStateMonitor
powiązany z urządzeniem.
Zwroty | |
---|---|
IDeviceStateMonitor |
getMountPoint
public String getMountPoint (String mountName)
Zwraca punkt podłączenia.
Jeśli informacje z poziomu pamięci podręcznej w IDevice
są niedostępne, wysyła zapytanie bezpośrednio do urządzenia.
DO ZROBIENIA: przenieś to zachowanie do IDevice#getMountPoint(String)
Parametry | |
---|---|
mountName |
String : nazwa punktu podłączania |
Zwroty | |
---|---|
String |
punkt podłączania lub null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Zwraca MountPointInfo
odpowiadający określonej ścieżce punktu podłączania lub null
, jeśli ta ścieżka nie ma nic podłączonego lub w inny sposób nie pojawia się w /proc/mounts jako punkt podłączania.
Parametry | |
---|---|
mountpoint |
String |
Zwroty | |
---|---|
ITestDevice.MountPointInfo |
Pole ERROR(/List) z wartością MountPointInfo zawierające informacje w katalogu „/proc/mounts” |
Rzuty | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
Zwraca zanalizowaną wersję informacji w katalogu /proc/mounts na urządzeniu.
Zwroty | |
---|---|
|
ERROR(/List) z MountPointInfo zawierający informacje z katalogu „/proc/mounts”. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getOptions
public TestDeviceOptions getOptions ()
Pobierz opcje testowania urządzenia.
Zwroty | |
---|---|
TestDeviceOptions |
TestDeviceOptions związane z testowanym urządzeniem. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
Metoda pomocnicza do określania ilości wolnego miejsca na partycji urządzenia.
Parametry | |
---|---|
partition |
String |
Zwroty | |
---|---|
long |
ilość wolnego miejsca w kilobajtach |
Rzuty | |
---|---|
DeviceNotAvailableException |
getPrimaryUserId
public Integer getPrimaryUserId ()
Zwraca identyfikator głównego użytkownika.
Zwroty | |
---|---|
Integer |
userId głównego użytkownika, jeśli taki istnieje, lub null, jeśli nie ma głównego użytkownika. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
Metoda pomocnicza uruchamia polecenia „pidof” i „stat” oraz zwraca obiekt ProcessInfo
z identyfikatorem PID i czasem rozpoczęcia danego procesu.
Parametry | |
---|---|
processName |
String : ciąg znaków nazwy procesu. |
Zwroty | |
---|---|
ProcessInfo |
Informacje o procesie o danej nazwie |
Rzuty | |
---|---|
DeviceNotAvailableException |
getProcessPid
public String getProcessPid (String process)
Zwraca PID usługi lub wartość null, jeśli wystąpił błąd.
Parametry | |
---|---|
process |
String : ciąg znaków z nazwą procesu. |
Zwroty | |
---|---|
String |
Rzuty | |
---|---|
DeviceNotAvailableException |
getProductType;
public String getProductType ()
Wygodna metoda uzyskiwania typu produktu na tym urządzeniu.
Ta metoda zadziała, jeśli urządzenie jest w trybie adb lub Fastboot.
Zwroty | |
---|---|
String |
nazwa typu produktu String . Nie będzie miał wartości null |
Rzuty | |
---|---|
DeviceNotAvailableException |
getProductVariant
public String getProductVariant ()
Metoda wygodna, by pobrać wersję produktu z tego urządzenia.
Ta metoda działa, gdy urządzenie jest w trybie adb lub fastboot.
Zwroty | |
---|---|
String |
nazwa wersji produktu String lub null , jeśli nie można jej określić, |
Rzuty | |
---|---|
DeviceNotAvailableException |
getProperty
public String getProperty (String name)
Pobierać z urządzenia określoną wartość właściwości.
Parametry | |
---|---|
name |
String : nazwa właściwości, |
Zwroty | |
---|---|
String |
wartość właściwości lub null , jeśli nie istnieje, |
Rzuty | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Uzyskaj informacje o bieżącym trybie odzyskiwania używanym na urządzeniu.
Zwroty | |
---|---|
ITestDevice.RecoveryMode |
trybu przywracania używanego w przypadku urządzenia. |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania. Format to PNG.
DO ZROBIENIA: rozszerz implementacje powyżej, aby obsługiwały opcje „format” i „rescale”.
Parametry | |
---|---|
displayId |
long : wyświetlany identyfikator ekranu, z którego zostanie wykonany zrzut ekranu. |
Zwroty | |
---|---|
InputStreamSource |
InputStreamSource zrzutu ekranu w formacie lub null , jeśli nie udało się wykonać zrzutu ekranu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format)
Robi zrzut ekranu z urządzenia. Zalecamy użycie funkcji getScreenshot(format) z kodowaniem JPEG, aby uzyskać mniejszy rozmiar.
Parametry | |
---|---|
format |
String : obsługiwane PNG, JPEG |
Zwroty | |
---|---|
InputStreamSource |
InputStreamSource zrzutu ekranu w formacie lub null , jeśli nie udało się wykonać zrzutu ekranu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Robi zrzut ekranu z urządzenia. Zalecamy użycie getScreenshot(String)
zamiast kodowania JPEG, aby zmniejszyć rozmiar.
Parametry | |
---|---|
format |
String : obsługiwane PNG, JPEG |
rescale |
boolean : czy zrzut ekranu ma zostać przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu |
Zwroty | |
---|---|
InputStreamSource |
InputStreamSource zrzutu ekranu w formacie lub null , jeśli zrzut ekranu nie powiódł się. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot ()
Robi zrzut ekranu z urządzenia.
Zwroty | |
---|---|
InputStreamSource |
InputStreamSource zrzutu ekranu w formacie png lub null , jeśli zrzut ekranu nie powiódł się. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public String getSerialNumber ()
Wygodny sposób na uzyskanie numeru seryjnego tego urządzenia.
Zwroty | |
---|---|
String |
numer seryjny String , |
getSetting
public String getSetting (int userId, String namespace, String key)
Zwraca wartość żądanego ustawienia. przestrzeń nazw musi mieć jedną z tych wartości: {"system", "secure", "global"}
Parametry | |
---|---|
userId |
int |
namespace |
String |
key |
String |
Zwroty | |
---|---|
String |
wartość powiązana z nazwą przestrzeni nazw:kluczem użytkownika. Wartość null, jeśli nie znaleziono. |
Rzuty | |
---|---|
DeviceNotAvailableException |
Pobierz
public String getSetting (String namespace, String key)
Zobacz getSetting(int, String, String)
i wykonane przez użytkownika systemowego.
Parametry | |
---|---|
namespace |
String |
key |
String |
Zwroty | |
---|---|
String |
Rzuty | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
Zwrot operatora karty SIM lub wartość null, jeśli opcja jest niedostępna lub urządzenie nie jest dostępne.
Zwroty | |
---|---|
String |
getSimState
public String getSimState ()
Zwraca stan karty SIM lub wartość null, jeśli karta SIM lub urządzenie są niedostępne.
Zwroty | |
---|---|
String |
getTombstones
publicgetTombstones ()
Pobierz i zwróć listę elementów tombstone z urządzeń. Wymaga uprawnień root.
Ta metoda działa w najlepszy możliwy sposób, więc jeśli z jakiegokolwiek powodu nie uda się wyodrębnić jednego nagrobka, nie będzie on widoczny na liście. Tylko instrukcja DeviceNotAvailableException
spowoduje wcześniejsze zakończenie metody.
Zwroty | |
---|---|
|
Lista plików tombstone (pusta, jeśli nie ma żadnych elementów tombstone). |
Rzuty | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
Zwraca łączny rozmiar pamięci fizycznej w bajtach lub -1 w przypadku błędu wewnętrznego
Zwroty | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
Aby zarządzać urządzeniem, uzyskaj numer seryjny używany do śledzenia urządzenia.
Zwroty | |
---|---|
String |
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
Pobierz nazwy pakietów aplikacji, które można odinstalować. Obecnie są to pakiety niesystemowe i zaktualizowane pakiety systemowe.
Zwroty | |
---|---|
|
ERROR(/Set) nazwy pakietów String , których nie można odinstalować, zainstalowanych obecnie na urządzeniu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getUseFastbootErase
public boolean getUseFastbootErase ()
Określ, czy chcesz użyć fastboot erase czy fastboot format do wyczyszczenia partycji na urządzeniu.
Zwroty | |
---|---|
boolean |
true , jeśli ma zostać użyte szybkie kasowanie, lub false , jeśli ma zostać użyte szybkie formatowanie. |
getUserFlags
public int getUserFlags (int userId)
Znajdowanie i zwracanie flag danego użytkownika. Flagi są definiowane w klasie „android.content.pm.UserInfo” w projekcie Android Open Source.
Parametry | |
---|---|
userId |
int |
Zwroty | |
---|---|
int |
flagi powiązane z podanym identyfikatorem użytkownika (userId), jeśli został znaleziony, lub -10000 w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getUserInfos
publicgetUserInfos ()
Pobiera mapę useId na urządzeniu do UserInfo
. Jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami, zostanie zwrócony błąd DeviceRuntimeException
.
Zwroty | |
---|---|
|
lista obiektów UserInfo. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
W przeciwnym razie zwraca -10000.
Parametry | |
---|---|
userId |
int |
Zwroty | |
---|---|
int |
Rzuty | |
---|---|
DeviceNotAvailableException |
ZdarzenieAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Przetwarzanie podanego zdarzenia DeviceEvent. Możesz przenieść urządzenie do nowego stanu. Poinformuje IDeviceMonitor
o wszelkich przejściach stanu.
Przetwarzanie zdarzenia DeviceEvent, które może, ale nie musi spowodować przeniesienie urządzenia do nowego stanu alokacji.
Parametry | |
---|---|
event |
DeviceEvent |
Zwroty | |
---|---|
IManagedTestDevice.DeviceEventResponse |
hasFeature
public boolean hasFeature (String feature)
Sprawdzanie, czy funkcja jest dostępna na urządzeniu
Parametry | |
---|---|
feature |
String : format, który powinien być użyty: „feature: |
Zwroty | |
---|---|
boolean |
Wartość „prawda”, jeśli udało się znaleźć funkcję. W przeciwnym razie wartość „fałsz”. |
Rzuty | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
Parametry | |
---|---|
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy ponownie zainstalować aplikację |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty | |
---|---|
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, gdy wymagana jest wyraźna kontrola udzielania uprawnień w czasie działania w momencie instalacji.
Parametry | |
---|---|
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions |
boolean : czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty | |
---|---|
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty | |
---|---|
DeviceNotAvailableException |
zainstalujPakiet dla użytkownika
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Instalowanie pakietu na Androida na urządzeniu danego użytkownika.
Parametry | |
---|---|
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
userId |
int : liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w opisie „adb shell pm -h”. |
Zwroty | |
---|---|
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty | |
---|---|
DeviceNotAvailableException |
zainstalujPakiet dla użytkownika
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instalowanie pakietu na Androida na urządzeniu danego użytkownika.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, gdy wymagana jest wyraźna kontrola udzielania uprawnień w czasie działania w momencie instalacji.
Parametry | |
---|---|
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions |
boolean : jeśli podczas instalacji powinny być przyznane wszystkie uprawnienia czasu działania. |
userId |
int : liczba całkowita identyfikator użytkownika, u którego ma być zainstalowana aplikacja. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w opisie „adb shell pm -h”. |
Zwroty | |
---|---|
String |
String z kodem błędu lub null w przypadku powodzenia. |
Rzuty | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
Zwroty | |
---|---|
boolean |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczenie aplikacji
Zwroty | |
---|---|
boolean |
Wartość true (prawda), jeśli zliczanie aplikacji jest obsługiwane, w przeciwnym razie wartość false (fałsz). |
Rzuty | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje pomijanie blokady niskiego docelowego poziomu interfejsu SDK podczas instalowania aplikacji
Zwroty | |
---|---|
boolean |
Wartość „prawda”, jeśli pomijany jest blok pakietu SDK o niskim docelowym zakresie. W przeciwnym razie wartość false (fałsz) |
Rzuty | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
Sprawdź, czy są podłączone pliki debugf.
Zwroty | |
---|---|
boolean |
true , jeśli debugfs jest zamontowany |
Rzuty | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypted
public boolean isDeviceEncrypted ()
Zwracany, jeśli urządzenie jest zaszyfrowane.
Zwroty | |
---|---|
boolean |
true jeśli urządzenie jest zaszyfrowane. |
Rzuty | |
---|---|
DeviceNotAvailableException |
isDirectory
public boolean isDirectory (String path)
Zwraca wartość „True”, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość „False”.
Parametry | |
---|---|
path |
String |
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
isEnableAdbRoot
public boolean isEnableAdbRoot ()
Zwroty | |
---|---|
boolean |
true czy na urządzeniu ma być włączony dostęp roota adb |
isEncryptionSupported
public boolean isEncryptionSupported ()
Zwraca wartość wskazującą, czy szyfrowanie jest obsługiwane na urządzeniu.
Zwroty | |
---|---|
boolean |
true , jeśli urządzenie obsługuje szyfrowanie. |
Rzuty | |
---|---|
DeviceNotAvailableException |
isExecutable
public boolean isExecutable (String fullPath)
Zwraca wartość Prawda, jeśli ścieżka do pliku na urządzeniu jest plikiem wykonywalnym, w przeciwnym razie zwraca wartość Fałsz.
Parametry | |
---|---|
fullPath |
String |
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
isFastbootEnabled
public boolean isFastbootEnabled ()
Zwracaj, jeśli na urządzeniu jest dostępny tryb Fastboot.
Zwroty | |
---|---|
boolean |
isHeadless
public boolean isHeadless ()
Wartość true (prawda), jeśli urządzenie nie ma interfejsu graficznego (nie ma ekranu). W przeciwnym razie ma wartość false (fałsz).
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Zwraca informację, czy urządzenie używa trybu użytkownika systemu bez interfejsu graficznego.
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin,
public boolean isMainUserPermanentAdmin ()
Zwraca informację, czy główny użytkownik jest stałym administratorem i czy nie można go usunąć ani obniżyć jego uprawnień do poziomu nieadministratora.
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
isMultiUserSupported
public boolean isMultiUserSupported ()
Określa, czy obsługiwany jest tryb wielu użytkowników.
Zwroty | |
---|---|
boolean |
Wartość true, jeśli obsługiwany jest wielu użytkowników, w przeciwnym razie wartość false (fałsz) |
Rzuty | |
---|---|
DeviceNotAvailableException |
isPackageInstalled
public boolean isPackageInstalled (String packageName, String userId)
Wyślij do urządzenia zapytanie o nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy to urządzenie jest obecnie zainstalowane dla tego użytkownika.
Parametry | |
---|---|
packageName |
String : pakiet, którego instalację sprawdzamy. |
userId |
String : identyfikator użytkownika, dla którego sprawdzamy, czy zainstalowano pakiet. Jeśli wartość jest pusta, zostanie użyta wartość zero. |
Zwroty | |
---|---|
boolean |
Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
Rzuty | |
---|---|
DeviceNotAvailableException |
isPackagePackage (Zainstalowany pakiet)
public boolean isPackageInstalled (String packageName)
Wyszukaj na urządzeniu daną nazwę pakietu, aby sprawdzić, czy jest on zainstalowany.
Parametry | |
---|---|
packageName |
String |
Zwroty | |
---|---|
boolean |
Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
Rzuty | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public boolean isRuntimePermissionSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie wykonywania
Zwroty | |
---|---|
boolean |
Wartość „prawda”, jeśli są obsługiwane uprawnienia w czasie działania. W przeciwnym razie ma wartość „false”. |
Rzuty | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Zwraca wartość „prawda”, jeśli urządzenie znajduje się w stanie TestDeviceState#FASTBOOT
lub TestDeviceState.FASTBOOTD
.
Zwroty | |
---|---|
boolean |
isUserRunning
public boolean isUserRunning (int userId)
Sprawdź, czy dany użytkownik jest uruchomiony.
Parametry | |
---|---|
userId |
int |
Zwroty | |
---|---|
boolean |
Wartość „prawda”, jeśli użytkownik biega. W pozostałych przypadkach wartość „fałsz”. |
Rzuty | |
---|---|
DeviceNotAvailableException |
isUserSecondary
public boolean isUserSecondary (int userId)
Zwraca informację, czy podany użytkownik jest użytkownikiem dodatkowym na podstawie jego flag.
Parametry | |
---|---|
userId |
int |
Zwroty | |
---|---|
boolean |
Prawda, jeśli użytkownik jest dodatkowy, w przeciwnym razie fałsz. |
Rzuty | |
---|---|
DeviceNotAvailableException |
isUserVisible
public boolean isUserVisible (int userId)
Sprawdza, czy dany użytkownik jest widoczny.
„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „ludzkim” użytkownikiem, a zatem może uruchamiać czynności (zazwyczaj w wyświetlanym domyślnie widoku).
Parametry | |
---|---|
userId |
int |
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu.
„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „ludzkim” użytkownikiem, a zatem może uruchamiać na wyświetlaczu różne działania.
Parametry | |
---|---|
userId |
int |
displayId |
int |
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Wskazuje, czy urządzenie pozwala na uruchamianie użytkowników w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
Jeśli tak, możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean)
, przekazując wyświetlacz zwrócony przez funkcję listDisplayIdsForStartingVisibleBackgroundUsers()
(która powinna zawierać ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Wskazuje, czy urządzenie zezwala na uruchamianie użytkowników w tle.
Jeśli tak, możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean)
, przekazując wartość wyświetlaną przez listDisplayIdsForStartingVisibleBackgroundUsers()
.
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
isWifiEnabled
public boolean isWifiEnabled ()
Sprawdź, czy Wi-Fi jest włączone.
Sprawdzanie, czy Wi-Fi jest włączone na urządzeniu. Przydatne do sprawdzania stanu Wi-Fi przed testami, które nie powinny być wykonywane z użyciem Wi-Fi, np. testy danych mobilnych.
Zwroty | |
---|---|
boolean |
true , jeśli Wi-Fi jest włączone. false , jeśli wyłączono |
Rzuty | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
Pobierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, jak podaje „dumpsys SurfaceFlinger”.
Zwroty | |
---|---|
|
Lista wyświetlaczy. Domyślnie zawsze zwraca wartość domyślną 0. |
Rzuty | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Pobiera listę wyświetlaczy, których można używać do start a user visible in the background
.
Zwroty | |
---|---|
|
Rzuty | |
---|---|
DeviceNotAvailableException |
listUsers
publiclistUsers ()
Pobiera listę użytkowników na urządzeniu. Jeśli dane wyjściowe z urządzenia będą niezgodne z oczekiwaniami, wywoła DeviceRuntimeException
.
Zwroty | |
---|---|
|
lista identyfikatorów użytkowników. |
Rzuty | |
---|---|
DeviceNotAvailableException |
logAnrs
public boolean logAnrs (ITestLogger logger)
Zbiera i rejestruje błędy ANR na urządzeniu.
Parametry | |
---|---|
logger |
ITestLogger : ITestLogger do rejestrowania błędów ANR. |
Zwroty | |
---|---|
boolean |
Wartość „true” (prawda), jeśli logowanie zakończyło się powodzeniem. W przeciwnym razie ma wartość false (fałsz). |
Rzuty | |
---|---|
DeviceNotAvailableException |
logBugreport
public boolean logBugreport (String dataName, ITestLogger listener)
Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w dzienniku autorów.
Parametry | |
---|---|
dataName |
String : nazwa, pod którą zgłoszenie błędu zostanie przesłane. |
listener |
ITestLogger : ITestLogger do rejestrowania raportu o błędzie. |
Zwroty | |
---|---|
boolean |
Wartość true, jeśli rejestrowanie zakończyło się powodzeniem. W przeciwnym razie wartość false. |
logowanie na urządzeniu
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Zaloguj wiadomość w logcat urządzenia. Jest to bezpieczne wywołanie, które nie zostanie wykonane nawet w przypadku niepowodzenia logowania.
Parametry | |
---|---|
tag |
String : tag, w którym rejestrujemy wiadomość w tagu logcat. |
level |
Log.LogLevel : poziom debugowania wiadomości w logcat. |
format |
String : format wiadomości. |
args |
Object : argumenty, które mają zostać zastąpione za pomocą String.format(). |
nonBlockingReboot
public void nonBlockingReboot ()
Wydając polecenie ponownego uruchomienia urządzenia, wraca po jego wykonaniu i gdy urządzenie nie jest już widoczne dla adb.
Rzuty | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
Zastąpić, jeśli urządzenie wymaga wykonania określonych czynności po uzyskaniu uprawnień root w adb, zanim będzie można przywrócić urządzenie do trybu online. Implementacja domyślna nie obejmuje żadnych dodatkowych działań. Na tym etapie nie ma gwarancji, że adb root jest włączone.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
Zastąpić, jeśli urządzenie wymaga wykonania określonych czynności po usunięciu uprawnień roota za pomocą adb, a przed przywróceniem urządzenia do trybu online. Implementacja domyślna nie obejmuje żadnych dodatkowych działań. Na tym etapie nie ma gwarancji, że adb root jest wyłączony.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Konfiguracja postBoot
public void postBootSetup ()
Postępuj zgodnie z instrukcjami, aby skonfigurować urządzenie do testowania po każdym uruchomieniu.
Należy go wywołać po całkowitym uruchomieniu/udostępnieniu urządzenia.
W normalnych okolicznościach ta metoda nie musi być jawnie wywoływana, ponieważ implementacje powinny wykonywać te kroki automatycznie po ponownym uruchomieniu.
Funkcja może być wywoływana, gdy urządzenie uruchamia się ponownie z powodu innych zdarzeń (np. po zakończeniu polecenia fastboot update).
Rzuty | |
---|---|
DeviceNotAvailableException |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Dodatkowe kroki wymagane do czyszczenia na danym urządzeniu, które zostaną wykonane po zakończeniu wywołania.
Parametry | |
---|---|
exception |
Throwable : jeśli występuje, to ostatnie wyjątek wywołany przez błąd wywołania. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Dodatkowe kroki wymagane w przypadku konkretnego urządzenia, które zostaną wykonane przed uruchomieniem procesu wywołania.
Parametry | |
---|---|
info |
IBuildInfo : IBuildInfo urządzenia. |
attributes |
MultiMap : atrybuty zapisane w kontekście wywołania. |
Rzuty | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
pullDir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
Rekursywnie pobieraj zawartość katalogu z urządzenia.
Parametry | |
---|---|
deviceFilePath |
String : bezwzględna ścieżka do pliku źródłowego zdalnego |
localDir |
File : katalog lokalny, do którego mają być pobierane pliki |
userId |
int : identyfikator użytkownika, z którego mają być pobierane dane |
Zwroty | |
---|---|
boolean |
true , jeśli udało się pobrać plik. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
pullDir
public boolean pullDir (String deviceFilePath, File localDir)
Rekursywnie pobieraj zawartość katalogu z urządzenia.
Parametry | |
---|---|
deviceFilePath |
String : bezwzględna ścieżka do pliku źródłowego zdalnego |
localDir |
File : lokalny katalog, do którego mają być przenoszone pliki |
Zwroty | |
---|---|
boolean |
true , jeśli udało się pobrać plik. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile)
Pobiera plik z urządzenia.
Parametry | |
---|---|
remoteFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu. |
localFile |
File : lokalny plik do przechowywania treści. Jeśli nie jest pusty, jego zawartość zostanie zastąpiona. |
Zwroty | |
---|---|
boolean |
true – jeśli plik został pomyślnie pobrany. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath, int userId)
Pobiera plik z urządzenia, przechowuje go w lokalnym folderze tymczasowym ERROR(/File)
i zwraca ten File
.
Parametry | |
---|---|
remoteFilePath |
String : ścieżka bezwzględna do pliku na urządzeniu. |
userId |
int : identyfikator użytkownika, z którego mają być pobierane dane |
Zwroty | |
---|---|
File |
Pole ERROR(/File) zawierające zawartość pliku na urządzeniu lub null , jeśli z jakiegokolwiek powodu kopiowanie nie powiodło się (w tym z systemem plików hosta) |
Rzuty | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath)
Pobiera plik z urządzenia, przechowuje go w lokalnym folderze tymczasowym ERROR(/File)
i zwraca ten File
.
Parametry | |
---|---|
remoteFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu. |
Zwroty | |
---|---|
File |
Pole ERROR(/File) zawierające zawartość pliku na urządzeniu lub null , jeśli z jakiegokolwiek powodu kopiowanie nie powiodło się (w tym z systemem plików hosta) |
Rzuty | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Pobiera plik z urządzenia.
Parametry | |
---|---|
remoteFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu. |
localFile |
File : lokalny plik do przechowywania treści. Jeśli nie jest pusty, jego zawartość zostanie zastąpiona. |
userId |
int : identyfikator użytkownika, z którego mają być pobierane dane |
Zwroty | |
---|---|
boolean |
true – jeśli plik został pomyślnie pobrany. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
Pobiera plik z urządzenia i zwraca jego zawartość.
Parametry | |
---|---|
remoteFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu. |
Zwroty | |
---|---|
String |
Pole String zawierające zawartość pliku na urządzeniu lub null , jeśli z jakiegokolwiek powodu kopiowanie nie powiodło się (w tym z systemem plików hosta) |
Rzuty | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
Wygodna metoda pobierania pliku z zewnętrznej pamięci urządzenia, przechowywania go w lokalnym pliku tymczasowym ERROR(/File)
i zwracania odwołania do tego pliku File
.
Parametry | |
---|---|
remoteFilePath |
String : ścieżka do pliku na urządzeniu w stosunku do punktu zamontowania zewnętrznej pamięci masowej urządzenia |
Zwroty | |
---|---|
File |
ERROR(/File) zawierający zawartość pliku na urządzeniu lub null , jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta). |
Rzuty | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Rekursywnie przesyłaj zawartość katalogu na urządzenie, wykluczając niektóre katalogi, które są filtrowane.
Parametry | |
---|---|
localFileDir |
File : lokalny katalog do wypychania, |
deviceFilePath |
String : bezwzględna ścieżka do pliku w zdalnym miejscu docelowym |
excludedDirectories |
: zestaw nazw wykluczonych katalogów, których nie należy przesyłać. |
Zwroty | |
---|---|
boolean |
true – czy plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Rekursywnie przesyłaj zawartość katalogu na urządzenie.
Parametry | |
---|---|
localFileDir |
File : lokalny katalog do wypychania, |
deviceFilePath |
String : bezwzględna ścieżka pliku zdalnego miejsca docelowego |
Zwroty | |
---|---|
boolean |
true – czy plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Rekursywnie przesyłaj zawartość katalogu na urządzenie.
Parametry | |
---|---|
localFileDir |
File : lokalny katalog do wypychania, |
deviceFilePath |
String : bezwzględna ścieżka do pliku w zdalnym miejscu docelowym |
userId |
int : identyfikator użytkownika do przekazania |
Zwroty | |
---|---|
boolean |
true – czy plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
plik push
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Wariant pushFile(File, String)
, który może opcjonalnie uwzględniać ocenę potrzeby dostawcy treści.
Parametry | |
---|---|
localFile |
File : plik lokalny do przesłania |
remoteFilePath |
String : bezwzględna ścieżka do pliku docelowego zdalnego. |
evaluateContentProviderNeeded |
boolean : czy sprawdzić, czy potrzebujemy dostawcy treści |
Zwroty | |
---|---|
boolean |
true – czy plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath)
Przesyłanie pliku na urządzenie. Domyślnie za pomocą dostawcy treści.
Parametry | |
---|---|
localFile |
File : plik lokalny do przesłania |
remoteFilePath |
String : bezwzględna ścieżka do pliku docelowego zdalnego. |
Zwroty | |
---|---|
boolean |
true – czy plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, int userId)
Przesyłanie pliku na urządzenie. Domyślnie za pomocą dostawcy treści.
Parametry | |
---|---|
localFile |
File : plik lokalny do przesłania |
remoteFilePath |
String : bezwzględna ścieżka zdalnego miejsca docelowego |
userId |
int : identyfikator użytkownika, do którego mają być przesyłane dane |
Zwroty | |
---|---|
boolean |
true – czy plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
pushString
public boolean pushString (String contents, String remoteFilePath)
Przesyłanie na urządzenie pliku utworzonego na podstawie ciągu znaków
Parametry | |
---|---|
contents |
String : zawartość pliku do przesłania. |
remoteFilePath |
String : bezwzględna ścieżka do pliku docelowego zdalnego. |
Zwroty | |
---|---|
boolean |
true – jeśli ciąg znaków został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
Uruchom ponownie
public void reboot (String reason)
Uruchom ponownie urządzenie w trybie adb z danymi reason
, które mają być zachowane po ponownym uruchomieniu.
Blokuje, dopóki urządzenie nie stanie się dostępne.
Przyczynę ostatniego ponownego uruchomienia można uzyskać, wysyłając zapytanie do właściwości sys.boot.reason
.
Parametry | |
---|---|
reason |
String : przyczyna ponownego uruchomienia lub null , jeśli nie podano powodu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
Uruchom ponownie
public void reboot ()
Uruchom ponownie urządzenie w trybie adb.
Blokuje, dopóki urządzenie nie stanie się dostępne.
Rzuty | |
---|---|
DeviceNotAvailableException |
rebootIntoBootloader
public void rebootIntoBootloader ()
Uruchom ponownie urządzenie w trybie programu rozruchowego.
Blokuje, dopóki urządzenie nie znajdzie się w trybie programu rozruchowego.
Rzuty | |
---|---|
DeviceNotAvailableException |
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Uruchom ponownie urządzenie w trybie Fastboot.
Blokuje, dopóki urządzenie nie znajdzie się w trybie Fastboot.
Rzuty | |
---|---|
DeviceNotAvailableException |
rebootIntoRecovery
public void rebootIntoRecovery ()
Uruchom ponownie urządzenie w trybie odzyskiwania adb.
Blokada do czasu rozpoczęcia przywracania urządzenia
Rzuty | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload ()
Uruchamia ponownie urządzenie w trybie wczytywania z boku strony (pamiętaj, że jest to specjalny tryb w trakcie przywracania)
Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload
Rzuty | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Uruchamia ponownie urządzenie w trybie wczytywania z boku strony (pamiętaj, że jest to specjalny tryb w trakcie przywracania)
Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload
Parametry | |
---|---|
autoReboot |
boolean : czy urządzenie ma się automatycznie ponownie uruchomić po zainstalowaniu aplikacji przez sideload |
Rzuty | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline ()
Alternatywa dla reboot()
, która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.
Rzuty | |
---|---|
DeviceNotAvailableException |
zrestartujDoOnline
public void rebootUntilOnline (String reason)
Alternatywa dla reboot()
, która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.
Parametry | |
---|---|
reason |
String : przyczyna ponownego uruchomienia lub null , jeśli nie podano powodu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
rebootUserspace
public void rebootUserspace ()
Uruchamia ponownie tylko część przestrzeni użytkownika urządzenia.
Blokuje, dopóki urządzenie nie stanie się dostępne.
OSTRZEŻENIE. Obecnie trwa restartowanie przestrzeni użytkownika. Korzystasz z niej na własne ryzyko.
Rzuty | |
---|---|
DeviceNotAvailableException |
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
Alternatywna metoda rebootUserspace()
()}, która blokuje tylko do momentu, gdy urządzenie jest w trybie online,
czyli widoczne dla adb.
Rzuty | |
---|---|
DeviceNotAvailableException |
recoverDevice
public boolean recoverDevice ()
Próbuje odzyskać komunikację z urządzeniem.
Zwroty | |
---|---|
boolean |
Wartość Prawda, jeśli próba odzyskania danych zakończyła się powodzeniem. Zwraca wartość Fałsz, jeśli pominięto odzyskiwanie danych. |
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest już dostępne |
RegisterDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Rejestruje IDeviceActionReceiver
na tym urządzeniu.
Wszystkie zarejestrowane IDeviceActionReceiver
zostaną powiadomione przed rozpoczęciem i po zakończeniu działania urządzenia.
Parametry | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : IDeviceActionReceiver , który zostanie zarejestrowany. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Ustaw partycję systemową na urządzeniu jako tylko do odczytu. Może spowodować ponowne uruchomienie urządzenia.
Rzuty | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Ustaw partycję systemową na urządzeniu jako partycję do zapisu. Może uruchomić ponownie urządzenie.
Rzuty | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
Ustaw partycję dostawcy na urządzeniu jako partycję tylko do odczytu. Może uruchomić ponownie urządzenie.
Rzuty | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
Ustaw partycję dostawcy na urządzeniu z możliwością zapisu. Może spowodować ponowne uruchomienie urządzenia.
Rzuty | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
Usuń danego administratora urządzenia z konta danego użytkownika i zwróć true
, jeśli operacja się uda. W przeciwnym razie: false
.
Parametry | |
---|---|
componentName |
String : administratora urządzenia, którego chcesz usunąć. |
userId |
int : użytkownika, w którego przestrzeni osobistej znajduje się administrator urządzenia. |
Zwroty | |
---|---|
boolean |
Wartość true (prawda), jeśli operacja się powiodła, a w przeciwnym razie – false (fałsz). |
Rzuty | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia w miarę możliwości.
Rzuty | |
---|---|
DeviceNotAvailableException |
removeUser
public boolean removeUser (int userId)
Usuń danego użytkownika z urządzenia.
Parametry | |
---|---|
userId |
int : użytkownika, którego chcesz usunąć |
Zwroty | |
---|---|
boolean |
Wartość „true”, jeśli udało się usunąć użytkownika, a w przeciwnym razie – „false”. |
Rzuty | |
---|---|
DeviceNotAvailableException |
resetContentProviderSetup
public void resetContentProviderSetup ()
Zresetuj flagę konfiguracji dostawcy treści, aby ponownie ją uruchomić.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Metoda ułatwiająca wykonywanie funkcji ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
z co najmniej 1 słuchaczem przekazanym jako parametr.
Parametry | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner , który przeprowadza testy |
listeners |
ITestLifeCycleReceiver : słuchacze wyników testu |
Zwroty | |
---|---|
boolean |
true , jeśli polecenie testowe zostało wykonane. false – jeśli nie udało się go ukończyć, ale odzyskanie się powiodło; |
Rzuty | |
---|---|
DeviceNotAvailableException |
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Uruchamia testy z instrumentacją i zapewnia odzyskiwanie urządzenia.
Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a przywrócenie się powiedzie, wszyscy słuchacze zostaną poinformowani o testRunFailed i zwrócona zostanie wartość „false”. Polecenie testu nie zostanie ponownie wykonane. W razie potrzeby rozmówcy mogą spróbować ponownie.
Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a przywrócenie nie powiedzie się, wszyscy słuchacze zostaną poinformowani o testRunFailed i wyjątek DeviceNotAvailableException zostanie rzucony.
Parametry | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner , który przeprowadza testy |
listeners |
: detektory wyników testu |
Zwroty | |
---|---|
boolean |
true , jeśli polecenie testowe zostało wykonane. false , jeśli nie udało się go wykonać z powodu wyjątku dotyczącego komunikacji z urządzeniem, ale odzyskiwanie zakończyło się powodzeniem |
Rzuty | |
---|---|
DeviceNotAvailableException |
uruchom Testy instrumentów jakoUżytkownik
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
To samo co ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
, ale test jest przeprowadzany w przypadku danego użytkownika.
Parametry | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
UruchamianieTestówTestów jakoUżytkownik
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
To samo co ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
, ale test jest przeprowadzany w przypadku danego użytkownika.
Parametry | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Wstawia używany IConfiguration
.
Parametry | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Parametry | |
---|---|
avdInfo |
GceAvdInfo |
setDate
public void setDate (Date date)
ustawia datę na urządzeniu;
Uwaga: ustawienie daty na urządzeniu wymaga uprawnień roota
Parametry | |
---|---|
date |
Date : określ konkretną datę; zostanie użyta data hosta, jeśli null |
Rzuty | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika.
Parametry | |
---|---|
componentName |
String : administratora urządzenia jako właściciela urządzenia. |
userId |
int : kraju zamieszkania właściciela urządzenia. |
Zwroty | |
---|---|
boolean |
Wartość true (prawda), jeśli operacja się powiodła, a w przeciwnym razie – false (fałsz). |
Rzuty | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Zaktualizuj stan urządzenia.
Parametry | |
---|---|
deviceState |
TestDeviceState : TestDeviceState |
setEmulatorOutputStream,
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
W emulatorze ustaw SizeLimitedOutputStream
na rejestrowanie danych wyjściowych.
Parametry | |
---|---|
output |
SizeLimitedOutputStream : aby zapisać dane wyjściowe w logach |
setEmulatorProcess,
public void setEmulatorProcess (Process p)
Ustawia Process
, gdy to urządzenie jest emulatorem.
Parametry | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Ustaw opcję fastboot na urządzeniu. Należy go ustawić, gdy urządzenie jest po raz pierwszy przypisywane.
Parametry | |
---|---|
fastbootEnabled |
boolean : czy szybki rozruch jest dostępny na urządzeniu |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Ustawia ścieżkę do pliku binarnego fastboot, którego należy użyć.
Aby włączyć funkcje szybkiego uruchamiania, nadal wymagana jest wartość Prawda dla zasady isFastbootEnabled()
.
Parametry | |
---|---|
fastbootPath |
String |
setIDevice
public void setIDevice (IDevice newDevice)
Zaktualizuj urządzenie IDevice powiązane z tym urządzeniem ITestDevice.
Nowe urządzenie IDevice musi odnosić się do tego samego urządzenia fizycznego co bieżące urządzenie referencyjne. Ta metoda jest wywoływana, gdy DDMS przydzieli nowe urządzenie IDevice
Parametry | |
---|---|
newDevice |
IDevice : IDevice |
setLogStartOpóźnienie
public void setLogStartDelay (int delay)
Określa czas (w milisekundach) oczekiwania przed rozpoczęciem przechwytywania logcat na urządzeniu online.
Parametry | |
---|---|
delay |
int : opóźnienie w ms |
setOptions
public void setOptions (TestDeviceOptions options)
Ustaw TestDeviceOptions
na urządzeniu
Parametry | |
---|---|
options |
TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
Ustawia określoną wartość właściwości na urządzeniu. Wymaga, aby root adb był ustawiony na wartość true.
Parametry | |
---|---|
propKey |
String : klucz, który ma zostać ustawiony. |
propValue |
String : wartość właściwości do ustawienia. |
Zwroty | |
---|---|
boolean |
Jeśli polecenie setprop zakończyło się powodzeniem, zwraca wartość True . W przeciwnym razie zwraca wartość False. |
Rzuty | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Ustaw IDeviceRecovery
do użycia na tym urządzeniu. Należy go ustawić, gdy urządzenie jest po raz pierwszy przypisywane.
Parametry | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Ustaw bieżący tryb przywracania urządzenia, którego chcesz używać.
Służy do określenia metody odzyskiwania, która ma być używana w przypadku wystąpienia problemu z komunikacją na urządzeniu. Zalecamy stosowanie tej metody tylko wtedy, gdy jest to konieczne (na przykład gdy framework jest niedostępny).
Parametry | |
---|---|
mode |
ITestDevice.RecoveryMode : określa, czy tryb „odzyskiwanie do tylko online” ma być włączony. |
setSetting
public void setSetting (String namespace, String key, String value)
Zobacz setSetting(int, String, String, String)
i wykonane przez użytkownika systemowego.
Parametry | |
---|---|
namespace |
String |
key |
String |
value |
String |
Rzuty | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
Dodaje wartość ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu. przestrzeń nazw musi mieć jedną z tych wartości: {"system", "secure", "global"}
Parametry | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
Rzuty | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Wstawia instancję ITestLogger
Parametry | |
---|---|
testLogger |
ITestLogger |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
W celu zarządzania urządzeniami śledź numer seryjny, którego używamy do identyfikowania urządzenia.
Parametry | |
---|---|
trackingSerial |
String |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
Określ, czy chcesz użyć fastboot erase czy fastboot format do wyczyszczenia partycji na urządzeniu.
Parametry | |
---|---|
useFastbootErase |
boolean : true , jeśli chcesz użyć szybkiego kasowania, lub false , jeśli chcesz użyć formatowania szybkiego kasowania. |
startLogcat
public void startLogcat ()
Rozpocznij przechwytywanie danych wyjściowych logcat z urządzenia w tle.
Nie będzie mieć zastosowania, jeśli dane logcat są już rejestrowane. Dane można później pobrać za pomocą getLogcat.
Gdy urządzenie nie jest już używane, musi zostać wywołana funkcja stopLogcat()
.
Zwykle nie trzeba wywoływać funkcji startLogcat()
i stopLogcat()
w kontekście wywołania TF, ponieważ platforma TF uruchamia i zatrzymuje logcat.
startUser
public boolean startUser (int userId)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik jest już uruchomiony w tle, ta metoda nie wykonuje żadnej operacji.
Parametry | |
---|---|
userId |
int : użytkownik może uruchomić aplikację w tle |
Zwroty | |
---|---|
boolean |
Wartość true, jeśli użytkownik został uruchomiony w tle. |
Rzuty | |
---|---|
DeviceNotAvailableException |
startUser
public boolean startUser (int userId, boolean waitFlag)
Uruchamia w tle dane użytkownika, jeśli jego działanie zostało zatrzymane. Jeśli użytkownik działa już w tle, ta metoda to NOOP. Możliwość dodania dodatkowej flagi, aby poczekać na zastosowanie operacji.
Parametry | |
---|---|
userId |
int : użytkownika, który rozpocznie się w tle |
waitFlag |
boolean : polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie. |
Zwroty | |
---|---|
boolean |
Wartość true, jeśli użytkownik został uruchomiony w tle. |
Rzuty | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli pozwala użytkownikowi uruchamiać czynności na tym wyświetlaczu).
UWAGA: to polecenie nie sprawdza, czy użytkownik istnieje, czy wyświetlacz jest dostępny, device supports such feature
itp.
Parametry | |
---|---|
userId |
int : użytkownik może uruchomić aplikację w tle |
displayId |
int : wyświetlanie informacji o początkowym użytkowniku na |
waitFlag |
boolean : polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie. |
Zwroty | |
---|---|
boolean |
true jeśli użytkownik został uruchomiony i jest widoczny w tle. |
Rzuty | |
---|---|
DeviceNotAvailableException |
Wyjście emulatora
public void stopEmulatorOutput ()
Zamknij i usuń dane wyjściowe emulatora.
stopLogcat
public void stopLogcat ()
Zatrzymaj przechwytywanie danych logcat z urządzenia i usuń aktualnie zapisane dane logcat.
Nie będzie mieć żadnego wpływu, jeśli dane wyjściowe logcat nie są przechwytywane.
stopUser
public boolean stopUser (int userId)
Zatrzymuje danego użytkownika. Jeśli użytkownik został już zatrzymany, ta metoda nie będzie miała żadnego działania. Nie można zatrzymać bieżącego i systemowego użytkownika.
Parametry | |
---|---|
userId |
int : użytkownik musi się zatrzymać. |
Zwroty | |
---|---|
boolean |
Wartość true, jeśli użytkownik został zatrzymany. |
Rzuty | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Zatrzymać danego użytkownika. Można podać dodatkowe flagi, aby zaczekać na wykonanie operacji i przymusowo zakończyć działanie użytkownika. Nie można zatrzymać bieżącego i systemowego użytkownika.
Parametry | |
---|---|
userId |
int : użytkownik musi się zatrzymać. |
waitFlag |
boolean : polecenie będzie oczekiwać, aż użytkownik się zatrzyma. |
forceFlag |
boolean : wymuszenie zatrzymania przez użytkownika. |
Zwroty | |
---|---|
boolean |
Wartość true, jeśli użytkownik został zatrzymany. |
Rzuty | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public String switchToAdbTcp ()
Przełącz urządzenie w tryb adb-over-tcp.
Zwroty | |
---|---|
String |
numer seryjny TCP lub null , jeśli nie można przełączyć urządzenia |
Rzuty | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Przełącz urządzenie w tryb adb przez USB.
Zwroty | |
---|---|
boolean |
true , jeśli udało się przełączyć, false w przeciwnym razie. |
Rzuty | |
---|---|
DeviceNotAvailableException |
użytkownik przełączony
public boolean switchUser (int userId)
Przełącz się na inny identyfikator użytkownika z domyślnym czasem oczekiwania. switchUser(int, long)
.
Parametry | |
---|---|
userId |
int |
Zwroty | |
---|---|
boolean |
Prawda, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz. |
Rzuty | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId, long timeout)
Przełącz się na innego użytkownika z podanym czasem oczekiwania jako terminem. Spróbuj wyłączyć blokadę klawiszy po pomyślnym zmianie użytkownika.
Parametry | |
---|---|
userId |
int |
timeout |
long : nie udało się poczekać przed zwróceniem wartości false dla użytkownika Switch. |
Zwroty | |
---|---|
boolean |
Prawda, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz. |
Rzuty | |
---|---|
DeviceNotAvailableException |
syncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
Synchronizuje stopniowo zawartość lokalnego katalogu plików na urządzeniu.
Określa, które pliki przesłać, porównując sygnatury czasowe plików lokalnych z ich odpowiednikami na zdalnym komputerze. Na urządzenie przekazywane są tylko „nowsze” lub nieistniejące pliki. Dlatego koszty operacyjne powinny być stosunkowo niewielkie, jeśli pliki na urządzeniu są już aktualne.
Ukryte pliki (o nazwach zaczynających się od „.”) są ignorowane.
Przykład użycia: syncFiles("/tmp/files", "/sdcard") utworzy katalog /sdcard/files, jeśli jeszcze nie istnieje, i rekursywnie prześle zawartość katalogu /tmp/files do katalogu /sdcard/files.
Parametry | |
---|---|
localFileDir |
File : lokalny katalog plików zawierający pliki do rekurencyjnego przesyłania. |
deviceFilePath |
String : ścieżka bezwzględna do katalogu źródeł na zdalnym komputerze docelowym. Wszystkie katalogi w ścieżce pliku muszą być czytelne. Przeniesienie do katalogu /data/local/tmp, gdy adb nie będzie mieć wartości root, zakończy się niepowodzeniem |
Zwroty | |
---|---|
boolean |
true , jeśli pliki zostały zsynchronizowane. false w innych przypadkach. |
Rzuty | |
---|---|
DeviceNotAvailableException |
takeBugreport
public Bugreport takeBugreport ()
Utwórz raport o błędzie i zwróć go w obiekcie Bugreport
, aby go obsłużyć. W przypadku problemów zwraca wartość null. Plik, na który wskazuje obiekt Bugreport, musi zostać oczyszczony za pomocą funkcji Bugreport.close()
.
Zwroty | |
---|---|
Bugreport |
Odinstaluj pakiet
public String uninstallPackage (String packageName)
Odinstaluj pakiet na Androida z urządzenia.
Parametry | |
---|---|
packageName |
String : pakiet na Androida do odinstalowania |
Zwroty | |
---|---|
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty | |
---|---|
DeviceNotAvailableException |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
Odinstaluj pakiet Androida z urządzenia danego użytkownika.
Parametry | |
---|---|
packageName |
String : pakiet na Androida do odinstalowania |
userId |
int : całkowita wartość identyfikatora użytkownika, dla którego ma zostać odinstalowana aplikacja. |
Zwroty | |
---|---|
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty | |
---|---|
DeviceNotAvailableException |
unlockDevice
public boolean unlockDevice ()
Odblokowuje urządzenie, jeśli jest ono zaszyfrowane.
Ta metoda może ponownie uruchomić platformę, ale nie wywoła metodypostBootSetup()
. Z tego powodu urządzenie może nie być w pełni gotowe do testowania, gdy ta metoda zostanie zwrócona.
Zwroty | |
---|---|
boolean |
true w przypadku powodzenia lub jeśli urządzenie nie jest zaszyfrowane. |
Rzuty | |
---|---|
DeviceNotAvailableException |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Blokuje się, dopóki nie zostanie ustawiona flaga zakończenia rozruchu urządzenia.
Parametry | |
---|---|
timeOut |
long : czas oczekiwania w ms na ustawienie flagi |
Zwroty | |
---|---|
boolean |
Prawda, jeśli w okresie limitu czasu ustawiona jest flaga uruchamiania urządzenia. |
Rzuty | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Czeka, aż urządzenie będzie gotowe do testowania. Używa domyślnego limitu czasu.
Zwroty | |
---|---|
boolean |
Prawda, jeśli urządzenie jest dostępne, Fałsz, jeśli odzyskiwanie jest wyłączone i niedostępne. |
Rzuty | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Czeka, aż urządzenie będzie gotowe do testowania.
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Zwroty | |
---|---|
boolean |
Prawda, jeśli urządzenie jest dostępne, Fałsz, jeśli odzyskiwanie jest wyłączone i niedostępne. |
Rzuty | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Czeka, aż urządzenie będzie gotowe do działania i dostępne bez uwzględniania ścieżki odzyskiwania.
Parametry | |
---|---|
waitTime |
long |
Zwroty | |
---|---|
boolean |
Prawda, jeśli urządzenie jest dostępne, Fałsz, jeśli nie. |
Rzuty | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Blokuje do momentu, aż urządzenie będzie widoczne w trybie fastboot. Użyj domyślnego limitu czasu.
Rzuty | |
---|---|
DeviceNotAvailableException |
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Blokuje działanie urządzenia w stanie „adbrecovery” (to coś innego niż IDeviceRecovery
).
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Zwroty | |
---|---|
boolean |
true , jeśli urządzenie uruchomi się w trybie przywracania przed upływem tego czasu.
false w innych przypadkach |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blokuje urządzenie w stanie „adb sideload”.
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Zwroty | |
---|---|
boolean |
true jeśli urządzenie uruchomi się w trybie sideload przed upływem czasu. false
w innych przypadkach |
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Blokuje dostęp do urządzenia, np. uniemożliwia dostęp do adb.
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Zwroty | |
---|---|
boolean |
true , jeśli urządzenie nie będzie dostępne przed upływem czasu.
W innym przypadku: false |
waitForDeviceOnline
public void waitForDeviceOnline ()
Blokuje, dopóki urządzenie nie będzie widoczne przez adb. Używa domyślnego limitu czasu
Pamiętaj, że urządzenie niekoniecznie reaguje na polecenia po zakończeniu. Zamiast tego użyj waitForDeviceAvailable()
.
Rzuty | |
---|---|
DeviceNotAvailableException |
Poczekaj naUrządzenieOnline
public void waitForDeviceOnline (long waitTime)
Blokuje, dopóki urządzenie nie będzie widoczne w narzędziu adb.
Pamiętaj, że urządzenie może nie reagować na polecenia po zakończeniu. Zamiast tego użyj waitForDeviceAvailable()
.
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Rzuty | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Czekam, aż urządzenie zareaguje na podstawowe polecenie powłoki adb.
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Zwroty | |
---|---|
boolean |
true , jeśli urządzenie zacznie reagować przed upływem czasu waitTime. |
Chronione metody
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parametry | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Tworzy polecenie systemu operacyjnego dla danej sesji polecenia adb shell i argumentów
Parametry | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
Zwroty | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parametry | |
---|---|
feature |
String |
strictMinLevel |
int |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Utwórz RebootDeviceAction
, który będzie używany podczas wykonywania działania ponownego uruchamiania.
Parametry | |
---|---|
rebootMode |
NativeDevice.RebootMode : tryb ponownego uruchamiania. |
reason |
String : w przypadku tego restartu. |
Zwroty | |
---|---|
NativeDevice.RebootDeviceAction |
utworzony RebootDeviceAction . |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Uruchom ponownie urządzenie za pomocą adb.
Parametry | |
---|---|
rebootMode |
NativeDevice.RebootMode : tryb ponownego uruchamiania. |
reason |
String : w przypadku tego restartu. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
metoda pomocnicza do rzucania wyjątkiem, jeśli uprawnienia czasu działania nie są obsługiwane
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Zwroty | |
---|---|
int |
getRunUtil
protected IRunUtil getRunUtil ()
Uzyskaj instancję RunUtil
, której chcesz użyć.
Zwroty | |
---|---|
IRunUtil |
initializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parametry | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
Rzuty | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
internalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Pobierać właściwości urządzenia z domyślnego pamięci podręcznej ddmlib, a w razie potrzeby z polecenia `adb shell getprop` lub `fastboot getvar`, w zależności od tego, czy urządzenie jest w trybie Fastboot.
Parametry | |
---|---|
propName |
String : nazwa właściwości urządzenia zwracana przez polecenie „adb shell getprop”. |
fastbootVar |
String : nazwa zmiennej fastboot, której wartości ma być zapytanie. Jeśli null , nie będzie wysyłane zapytanie fastboot. |
description |
String : prosty opis zmiennej. Pierwsza litera powinna być duża. |
Zwroty | |
---|---|
String |
Ciąg znaków, prawdopodobnie null lub pusty, zawierający wartość danej właściwości |
Rzuty | |
---|---|
DeviceNotAvailableException |
isInRebootCallback
protected boolean isInRebootCallback ()
Zwraca informację, czy wywołania zwrotne ponownego uruchamiania są obecnie wykonywane. Jeśli wartość jest równa true, wszystkie publiczne interfejsy API do ponownego uruchamiania powinny być wyłączone.
Zwroty | |
---|---|
boolean |
Jest Nowszy
protected boolean isNewer (File localFile, IFileEntry entry)
Zwróć wartość true
, jeśli plik lokalny jest nowszy niż plik zdalny. IFileEntry
jest dokładny do minuty, w przypadku równych czasów plik jest uważany za nowszy.
Parametry | |
---|---|
localFile |
File |
entry |
IFileEntry |
Zwroty | |
---|---|
boolean |
powiadamiaj o zakończeniu ponownego uruchamiania
protected void notifyRebootEnded ()
Informuje wszystkie IDeviceActionReceiver
o zdarzeniu zakończenia ponownego uruchamiania.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notifyRebootStarted
protected void notifyRebootStarted ()
Informuje wszystkie IDeviceActionReceiver
o zdarzeniu rozpoczęcia ponownego uruchamiania.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Wykonuj działanie na urządzeniu
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Wykonywanie czynności na tym urządzeniu. Próbuje przywrócić urządzenie i opcjonalnie ponawiać polecenie, jeśli działanie się nie powiedzie.
Parametry | |
---|---|
actionDescription |
String : krótki opis działania do wykonania. Służy tylko do celów rejestrowania. |
action |
NativeDevice.DeviceAction : działanie do wykonania. |
retryAttempts |
int : jeśli się to nie uda, ponawia próbę, ale przywrócenie się powiedzie, |
Zwroty | |
---|---|
boolean |
true , jeśli działanie zostało wykonane; |
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli próba odzyskania nie powiedzie się lub zostanie wykonana maksymalna liczba prób; |
postAdbReboot
protected void postAdbReboot ()
Możliwe dodatkowe działania, które można wykonać po ponownym uruchomieniu.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Konfiguracja prePostBoot Setup
protected void prePostBootSetup ()
Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w przypadku określonej konfiguracji po uruchomieniu.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parametry | |
---|---|
remoteFilePath |
String |
localFile |
File |
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
setClock
protected void setClock (Clock clock)
Ustaw instancję zegara, której chcesz używać.
Parametry | |
---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Oznacza TestDevice jako microdroid i ustala jego identyfikator CID.
Parametry | |
---|---|
process |
Process : proces maszyny wirtualnej Microdroid. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Parametry | |
---|---|
deviceOptions |
|
Prosty FastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Wykonuje proste polecenie fastboot z użyciem zmiennych środowiskowych i zgłasza stan tego polecenia.
Parametry | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
Zwroty | |
---|---|
CommandResult |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Wykonuje proste polecenie fastboot i zgłasza jego stan.
Parametry | |
---|---|
timeout |
long |
fullCmd |
String |
Zwroty | |
---|---|
CommandResult |
Oczekiwanie naUrządzenieNiedostępne
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Poczekaj, aż urządzenie stanie się niedostępne (przestanie przesyłać raporty do adb).
Parametry | |
---|---|
operationDesc |
String : nazwa operacji, która czeka na dostępność. |
time |
long : czas oczekiwania na pojawienie się informacji o niedostępności danych. |
Zwroty | |
---|---|
boolean |
Wartość „prawda”, jeśli urządzenie stało się niedostępne. |