Urządzenie natywne
public class NativeDevice
extends Object
implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver
Obiekt Java.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
Domyślna implementacja urządzeń z systemem Android ITestDevice
, które nie obsługują pełnego stosu.
Streszczenie
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/nieodnalezionego identyfikatora użytkownika: UserHandle zdefiniował wartość -10000 |
long | MAX_HOST_DEVICE_TIME_OFFSET |
int | MAX_RETRY_ATTEMPTS domyślna liczba ponownych prób wykonania polecenia |
Pola | |
---|---|
protected static final String | SD_CARD |
protected static final String | STORAGE_EMULATED |
protected TestDeviceOptions | mOptions |
protected final IDeviceStateMonitor | mStateMonitor
|
Konstruktorzy publiczni | |
---|---|
NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor) Tworzy |
Metody publiczne | |
---|---|
void | batchPrefetchStartupBuildProps () Mikrooptymalizacja (około 400 milinów) poprzez wstępne pobieranie wszystkich potrzebnych rekwizytów zamiast wywoływania „adb getprop” dla każdego z nich. |
boolean | canSwitchToHeadlessSystemUser () Zwraca informację, czy można przełączyć się na użytkownika bezgłowego SYSTEM. |
boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) Sprawdź, czy dana funkcja jest obecnie obsługiwana, biorąc pod uwagę minimalnie obsługiwany poziom. |
boolean | checkConnectivity () Sprawdź, czy urządzenie ma łączność sieciową. |
boolean | clearErrorDialogs () Spróbuj odrzucić wszelkie okna dialogowe o błędach wyświetlane obecnie w interfejsie użytkownika urządzenia. |
void | clearLastConnectedWifiNetwork () Usuwa ostatnią połączoną sieć Wi-Fi. |
void | clearLogcat () Usuwa wszelkie zgromadzone dane logcat. |
boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Łączy się z siecią Wi-Fi. |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) Łączy się z siecią Wi-Fi. |
boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Łączy się z siecią Wi-Fi.f |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) Łączy się z siecią Wi-Fi. |
boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) Wariant |
boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) Wariant |
int | createUser (String name, boolean guest, boolean ephemeral) Utwórz użytkownika o podanej nazwie i podanych flagach |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Utwórz użytkownika o podanej nazwie i podanych flagach |
int | createUser (String name) Utwórz użytkownika o podanej nazwie i domyślnych flagach 0. |
int | createUserNoThrow (String name) Utwórz użytkownika o podanej nazwie i domyślnych flagach 0. |
void | deleteFile (String deviceFilePath) Metoda pomocnicza służąca do usuwania pliku lub katalogu na urządzeniu. |
void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Usuwa zarejestrowany |
boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) Metoda pomocnicza sprawdzająca, czy urządzenie zostało uruchomione miękko, porównując bieżący serwer systemowy z poprzednim |
boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Metoda pomocnicza sprawdzająca, czy urządzenie zostało uruchomione miękko od czasu UTC od epoki z urządzenia i jego |
boolean | disableAdbRoot () Wyłącza root adb. |
void | disableKeyguard () Próba wyłączenia blokady klawiatury. |
boolean | disableNetworkMonitor () Wyłącza monitorowanie sieci na urządzeniu. |
boolean | disconnectFromWifi () Rozłącza się z siecią Wi-Fi. |
boolean | doesFileExist (String deviceFilePath, int userId) Metoda pomocnicza służąca do ustalenia, czy dla danego użytkownika istnieje plik na urządzeniu. |
boolean | doesFileExist (String deviceFilePath) Metoda pomocnicza służąca do ustalenia, czy plik na urządzeniu istnieje. |
File | dumpHeap (String process, String devicePath) Spróbuj zrzucić stertę z serwera systemowego. |
boolean | enableAdbRoot () Włącza root 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 limitem czasu. |
String | executeAdbCommand (long timeout, envMap, String... cmdArgs) executeAdbCommand (long timeout, envMap, String... cmdArgs) Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym limitem czasu. |
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ługo działające polecenie fastboot jako polecenie systemowe. |
CommandResult | executeLongFastbootCommand ( envVarMap, String... cmdArgs) executeLongFastbootCommand ( envVarMap, String... cmdArgs) Metoda pomocnicza, która wykonuje długo działające polecenie fastboot jako polecenie systemowe z systemowymi zmiennymi środowiskowymi. |
String | executeShellCommand (String command) Metoda pomocnicza, która wykonuje polecenie powłoki adb 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 kontrolujących zachowanie poleceń. |
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 kontrolujących zachowanie poleceń. |
void | executeShellCommand (String command, IShellOutputReceiver receiver) Wykonuje podane polecenie powłoki adb, ponawiając wiele razy, jeśli polecenie nie powiedzie się. |
CommandResult | executeShellV2Command (String cmd) Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako |
CommandResult | executeShellV2Command (String cmd, OutputStream pipeToOutput) Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako |
CommandResult | executeShellV2Command (String cmd, File pipeAsInput) Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako |
CommandResult | executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Wykonuje polecenie powłoki adb z większą liczbą parametrów kontrolujących zachowanie poleceń. |
CommandResult | executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit) Wykonuje polecenie powłoki adb z większą liczbą parametrów kontrolujących zachowanie poleceń. |
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 kontrolujących zachowanie poleceń. |
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 kontrolujących zachowanie poleceń. |
CommandResult | fastbootWipePartition (String partition) Metoda pomocnicza, która czyści partycję urządzenia. |
getActiveApexes () Pobierz informacje o APEXach aktywowanych na urządzeniu. | |
getAllSettings (String namespace) Zwróć pary klucz-wartość żądanej przestrzeni nazw. | |
DeviceAllocationState | getAllocationState () Zwróć bieżący stan alokacji urządzenia |
String | getAndroidId (int userId) Znajdź i zwróć identyfikator Androida powiązany z identyfikatorem użytkownika, null, jeśli nie zostanie znaleziony. |
getAndroidIds () Utwórz mapę znalezionych identyfikatorów Androida pasujących do identyfikatorów użytkowników. | |
int | getApiLevel () Uzyskaj poziom interfejsu API urządzenia. |
PackageInfo | getAppPackageInfo (String packageName) Pobierz informacje o pakiecie zainstalowanym na urządzeniu. |
getAppPackageInfos () Pobierz informacje o pakietach zainstalowanych na urządzeniu. | |
String | getBasebandVersion () Wygodna metoda uzyskania wersji tego urządzenia w paśmie podstawowym (radiowym). |
Integer | getBattery () Zwraca bieżący poziom baterii urządzenia lub 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 rozruchu i przyczyną rozruchu. | |
getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) Metoda pomocnicza zbiera mapę historii rozruchu z czasem rozruchu i powodem rozruchu od podanego czasu od epoki z urządzenia i określoną jednostką czasu. | |
String | getBootloaderVersion () Wygodna metoda uzyskania wersji bootloadera tego urządzenia. |
InputStreamSource | getBugreport () Pobiera raport o błędzie z urządzenia. |
InputStreamSource | getBugreportz () Pobiera raport o błędach z urządzenia. |
String | getBuildAlias () Pobierz alias kompilacji aktualnie uruchomionej na urządzeniu. |
String | getBuildFlavor () Pobierz wersję kompilacji urządzenia. |
String | getBuildId () Pobierz wersję aktualnie uruchomioną na urządzeniu. |
String | getBuildSigningKeys () Zwraca typ klucza używany do podpisania obrazu urządzenia Zazwyczaj urządzenia z Androidem mogą być podpisane kluczami testowymi (jak w AOSP) lub kluczami wydania (kontrolowanymi przez poszczególnych producentów urządzeń) |
DeviceDescriptor | getCachedDeviceDescriptor () Zwraca buforowany |
DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) Zwraca buforowany |
String[] | getChildren (String path) Alternatywa dla używania |
AbstractConnection | getConnection () Bieżące połączenie powiązane z urządzeniem. |
DeviceFoldableState | getCurrentFoldableState () Zwraca bieżący stan składania urządzenia lub wartość null, jeśli wystąpiły pewne problemy. |
int | getCurrentUser () Zwróć identyfikator bieżącego uruchomionego użytkownika. |
String | getDeviceClass () Pobierz klasę urządzenia. |
long | getDeviceDate () Zwróć datę urządzenia w milisekundach od epoki. |
DeviceDescriptor | getDeviceDescriptor () Zwróć |
DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) Zwróć |
TestDeviceState | getDeviceState () Uzyskaj stan urządzenia. |
long | getDeviceTimeOffset (Date date) Pomocnik do uzyskania różnicy czasu między urządzeniem a danym |
InputStreamSource | getEmulatorOutput () Pobierz strumień emulatora stdout i stderr |
Process | getEmulatorProcess () Zwróć |
final File | getExecuteShellCommandLog () Dziennik zawierający wszystkie dzienniki |
long | getExternalStoreFreeSpace () Metoda pomocnicza określająca ilość wolnego miejsca w pamięci zewnętrznej urządzenia. |
String | getFastbootPath () Zwraca ścieżkę używanego pliku binarnego fastboot. |
String | getFastbootProductType () Wygodna metoda uzyskania typu produktu tego urządzenia, gdy jest ono w trybie szybkiego uruchamiania. |
String | getFastbootProductVariant () Wygodna metoda uzyskania typu produktu tego urządzenia, gdy jest ono w trybie szybkiego uruchamiania. |
String | getFastbootSerialNumber () Zwraca numer seryjny trybu fastboot. |
String | getFastbootVariable (String variableName) Pobierz podaną wartość zmiennej fastboot z urządzenia. |
String | getFastbootVersion () Zwraca ciąg wersji używanego pliku binarnego fastboot. |
IFileEntry | getFileEntry (String path) Pobierz odwołanie do zdalnego pliku na urządzeniu. |
IFileEntry | getFileEntry (FileListingService.FileEntry entry) Nieoficjalny pomocnik do uzyskania |
getFoldableStates () Zwraca listę składanych stanów na urządzeniu. | |
IDevice | getIDevice () Zwraca odwołanie do powiązanego ddmlib |
getInstalledPackageNames () Pobierz nazwy pakietów aplikacji obecne na urządzeniu. | |
long | getIntProperty (String name, long defaultValue) Zwraca wartość całkowitą danej właściwości z urządzenia. |
String | getIpAddress () Pobiera adres IP urządzenia. |
KeyguardControllerState | getKeyguardState () Zwróć obiekt, aby uzyskać bieżący stan blokady klawiatury lub null, jeśli nie jest obsługiwany. |
long | getLastExpectedRebootTimeMillis () Zwraca ostatni raz, kiedy interfejsy API Tradefed wyzwoliły ponowne uruchomienie w milisekundach od czasu EPOCH, zgodnie z wartością zwróconą przez |
int | getLaunchApiLevel () Uzyskaj pierwszy uruchomiony poziom API urządzenia. |
InputStreamSource | getLogcat () Pobiera strumień migawki danych logcat. |
InputStreamSource | getLogcat (int maxBytes) Pobiera strumień migawki ostatnich |
InputStreamSource | getLogcatDump () Pobierz zrzut bieżącego logcat dla urządzenia. |
InputStreamSource | getLogcatSince (long date) Pobiera strumień migawki przechwyconych danych logcat, począwszy od podanej daty. |
String | getMacAddress () Zwraca adres MAC urządzenia; wartość null, jeśli zapytanie z urządzenia nie powiedzie się. |
Integer | getMainUserId () Zwraca główny identyfikator użytkownika. |
getMainlineModuleInfo () Uzyskaj informacje o głównych modułach zainstalowanych na urządzeniu. | |
int | getMaxNumberOfRunningUsersSupported () Uzyskaj maksymalną liczbę obsługiwanych jednocześnie działających użytkowników. |
int | getMaxNumberOfUsersSupported () Uzyskaj maksymalną liczbę obsługiwanych użytkowników. |
Process | getMicrodroidProcess () |
IDeviceStateMonitor | getMonitor () Zwróć |
String | getMountPoint (String mountName) Zwraca punkt podłączenia. |
ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) Zwraca wartość |
getMountPointInfo () Zwraca przeanalizowaną wersję informacji z pliku /proc/mounts na urządzeniu | |
TestDeviceOptions | getOptions () Pobierz opcje testowe dla urządzenia. |
long | getPartitionFreeSpace (String partition) Metoda pomocnicza określająca ilość wolnego miejsca na partycji urządzenia. |
Integer | getPrimaryUserId () Zwraca podstawowy identyfikator użytkownika. |
ProcessInfo | getProcessByName (String processName) Metoda pomocnicza uruchamia komendy "pidof" i "stat" i zwraca obiekt |
String | getProcessPid (String process) Zwraca pid usługi lub null, jeśli coś poszło nie tak. |
String | getProductType () Wygodna metoda uzyskania typu produktu tego urządzenia. |
String | getProductVariant () Wygodna metoda uzyskania wariantu produktu tego urządzenia. |
String | getProperty (String name) Pobierz podaną wartość właściwości z urządzenia. |
ITestDevice.RecoveryMode | getRecoveryMode () Pobierz bieżący tryb odzyskiwania używany na urządzeniu. |
InputStreamSource | getScreenshot (String format) Pobiera zrzut ekranu z urządzenia. |
InputStreamSource | getScreenshot (long displayId) Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. |
InputStreamSource | getScreenshot (String format, boolean rescale) Pobiera zrzut ekranu z urządzenia. |
InputStreamSource | getScreenshot () Pobiera zrzut ekranu z urządzenia. |
String | getSerialNumber () Wygodna metoda uzyskania numeru seryjnego tego urządzenia. |
String | getSetting (int userId, String namespace, String key) Zwróć wartość żądanego ustawienia. |
String | getSetting (String namespace, String key) Zobacz |
String | getSimOperator () Zwróć operatora karty SIM lub null, jeśli nie jest dostępny lub jeśli urządzenie nie jest dostępne. |
String | getSimState () Zwróć stan karty SIM lub null, jeśli nie jest dostępny lub urządzenie nie jest dostępne. |
getTombstones () Pobierz i zwróć listę nagrobków z urządzeń. | |
long | getTotalMemory () Zwraca całkowity rozmiar pamięci fizycznej w bajtach lub -1 w przypadku błędu wewnętrznego |
getUninstallablePackageNames () Pobierz nazwy pakietów aplikacji, które można odinstalować. | |
boolean | getUseFastbootErase () Dowiedz się, czy do czyszczenia partycji na urządzeniu ma być używany format fastboot lub fastboot. |
int | getUserFlags (int userId) Znajdź i zwróć flagi danego użytkownika. |
getUserInfos () Pobiera mapę useId do | |
int | getUserSerialNumber (int userId) Jeśli zostanie znaleziony, zwróć numer seryjny powiązany z identyfikatorem użytkownika, w pozostałych przypadkach -10000. |
IManagedTestDevice.DeviceEventResponse | handleAllocationEvent (DeviceEvent event) Przetwórz podane zdarzenie DeviceEvent. Przetwórz zdarzenie DeviceEvent, które może, ale nie musi, przenieść to urządzenie do nowego stanu alokacji. |
boolean | hasFeature (String feature) Sprawdź, czy dana funkcja jest dostępna na urządzeniu. |
String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Zainstaluj pakiet Android na urządzeniu. |
String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstaluj pakiet Android na urządzeniu. |
String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Zainstaluj pakiet Android na urządzeniu dla danego użytkownika. |
String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Zainstaluj pakiet Android na urządzeniu dla danego użytkownika. |
void | invalidatePropertyCache () |
boolean | isAdbRoot () |
boolean | isAdbTcp () |
boolean | isAppEnumerationSupported () Sprawdź, czy platforma na urządzeniu obsługuje wyliczanie aplikacji |
boolean | isBypassLowTargetSdkBlockSupported () Sprawdź, czy platforma na urządzeniu obsługuje omijanie niskiego docelowego bloku SDK podczas instalacji aplikacji |
boolean | isDeviceEncrypted () Zwraca, jeśli urządzenie jest zaszyfrowane. |
boolean | isDirectory (String path) Zwróć True, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie false. |
boolean | isEnableAdbRoot () |
boolean | isEncryptionSupported () Zwraca, jeśli urządzenie obsługuje szyfrowanie. |
boolean | isExecutable (String fullPath) Zwraca wartość True, jeśli ścieżka pliku na urządzeniu jest plikiem wykonywalnym, w przeciwnym razie zwraca wartość false. |
boolean | isFastbootEnabled () Wróć, jeśli dla urządzenia dostępna jest funkcja fastboot. |
boolean | isHeadless () Zwróć wartość true, jeśli urządzenie jest bezgłowe (bez ekranu), w przeciwnym razie wartość false. |
boolean | isHeadlessSystemUserMode () Zwraca informację, czy urządzenie korzysta z trybu użytkownika systemu bezgłowego. |
boolean | isMainUserPermanentAdmin () Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani zmienić na inny niż administrator. |
boolean | isMultiUserSupported () Określa, czy obsługiwanych jest wielu użytkowników. |
boolean | isPackageInstalled (String packageName, String userId) Zapytaj urządzenie o podaną nazwę pakietu i podany identyfikator użytkownika, aby sprawdzić, czy jest ono aktualnie zainstalowane dla tego użytkownika. |
boolean | isPackageInstalled (String packageName) Zapytaj urządzenie o podaną nazwę pakietu, aby sprawdzić, czy jest on aktualnie zainstalowany, czy nie. |
boolean | isRuntimePermissionSupported () Sprawdź, czy platforma na urządzeniu obsługuje nadawanie uprawnień w czasie wykonywania |
boolean | isStateBootloaderOrFastbootd () Zwraca wartość true, jeśli urządzenie znajduje się w stanie |
boolean | isUserRunning (int userId) Sprawdź, czy dany użytkownik jest uruchomiony. |
boolean | isUserSecondary (int userId) Zwraca informację, czy określony użytkownik jest użytkownikiem dodatkowym zgodnie z jego flagami. |
boolean | isUserVisible (int userId) Sprawdza czy dany użytkownik jest widoczny. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Sprawdza czy dany użytkownik jest widoczny na danym wyświetlaczu. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Zwraca, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle w |
boolean | isVisibleBackgroundUsersSupported () Zwraca informację, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle. |
boolean | isWifiEnabled () Sprawdź, czy Wi-Fi jest włączone. |
listDisplayIds () Zbierz listę dostępnych identyfikatorów wyświetlaczy na urządzeniu zgodnie z raportem „dumpsys SurfaceFlinger”. | |
listDisplayIdsForStartingVisibleBackgroundUsers () Pobiera listę ekranów, których można użyć do | |
listUsers () Pobiera listę użytkowników na urządzeniu. | |
boolean | logAnrs ( ITestLogger logger) Zbiera i rejestruje błędy ANR z urządzenia. |
boolean | logBugreport (String dataName, ITestLogger listener) Metoda pomocnicza umożliwiająca przyjęcie raportu o błędzie i zalogowanie go do reporterów. |
void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Zarejestruj wiadomość w logcat urządzenia. |
void | nonBlockingReboot () Wydaje polecenie ponownego uruchomienia urządzenia i powraca po zakończeniu polecenia i gdy urządzenie nie jest już widoczne dla adb. |
void | postAdbRootAction () Zastąp, jeśli urządzenie wymaga podjęcia określonych działań po rootowaniu adb i zanim urządzenie wróci do trybu online. |
void | postAdbUnrootAction () Zastąp, jeśli urządzenie wymaga podjęcia określonych działań po unrootowaniu adb i zanim urządzenie wróci do trybu online. |
void | postBootSetup () Wykonaj instrukcje, aby skonfigurować urządzenie do testowania po każdym uruchomieniu. |
void | postInvocationTearDown (Throwable exception) Dodatkowe kroki dotyczące wymaganego czyszczenia specyficznego dla urządzenia, które zostaną wykonane po zakończeniu wywołania. |
void | preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) Dodatkowe kroki wymaganej konfiguracji specyficznej dla urządzenia, które zostaną wykonane na urządzeniu przed przepływem wywołania. |
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 tymczasowym |
File | pullFile (String remoteFilePath) Pobiera plik z urządzenia, przechowuje go w lokalnym 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) Wygodna metoda pobierania pliku z zewnętrznej pamięci urządzenia, przechowywania go w lokalnym tymczasowym |
boolean | pushDir (File localFileDir, String deviceFilePath, excludedDirectories) pushDir (File localFileDir, String deviceFilePath, excludedDirectories) Rekursywnie przesyłaj zawartość katalogu do urządzenia, wykluczając niektóre filtrowane katalogi. |
boolean | pushDir (File localFileDir, String deviceFilePath) Rekursywnie wypychaj zawartość katalogu na urządzenie. |
boolean | pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded) Wariant |
boolean | pushFile (File localFile, String remoteFilePath) Prześlij plik na urządzenie. |
boolean | pushString (String contents, String remoteFilePath) Prześlij plik utworzony z ciągu znaków do urządzenia |
void | reboot (String reason) Ponownie uruchamia urządzenie w trybie adb z podanego |
void | reboot () Ponownie uruchamia urządzenie w trybie adb. |
void | rebootIntoBootloader () Ponownie uruchamia urządzenie w trybie bootloadera. |
void | rebootIntoFastbootd () Ponownie uruchamia urządzenie w trybie fastbootd. |
void | rebootIntoRecovery () Ponownie uruchamia urządzenie w trybie odzyskiwania adb. |
void | rebootIntoSideload () Ponownie uruchamia urządzenie w trybie adb sideload (pamiętaj, że jest to specjalny tryb w trakcie odzyskiwania) Blokuje, dopóki urządzenie nie przejdzie w tryb sideload |
void | rebootIntoSideload (boolean autoReboot) Ponownie uruchamia urządzenie w trybie adb sideload (pamiętaj, że jest to specjalny tryb w trakcie odzyskiwania) Blokuje, dopóki urządzenie nie przejdzie w tryb sideload |
void | rebootUntilOnline () Alternatywa dla |
void | rebootUntilOnline (String reason) Alternatywa dla |
void | rebootUserspace () Uruchamia ponownie tylko część urządzenia stanowiącą przestrzeń 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 nadającą się do zapisu. |
void | remountVendorReadOnly () Ustaw partycję dostawcy na urządzeniu jako tylko do odczytu. |
void | remountVendorWritable () Ustaw partycję dostawcy na urządzeniu jako zapisywalną. |
boolean | removeAdmin (String componentName, int userId) Usuń danego administratora urządzenia dla danego użytkownika i zwróć wartość |
void | removeOwners () Usuń wszystkich istniejących właścicieli profili urządzeń, dokładając wszelkich starań. |
boolean | removeUser (int userId) Usuń danego użytkownika z urządzenia. |
void | resetContentProviderSetup () Zresetuj flagę konfiguracji dostawcy treści, aby uruchomić ją ponownie. |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Wygodna metoda wykonywania |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Przeprowadza testy oprzyrządowania i zapewnia odzyskiwanie urządzenia. |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) Taki sam jak |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) To samo co |
void | setConfiguration ( IConfiguration configuration) Wstrzykuje używaną |
final void | setConnectionAvdInfo ( GceAvdInfo avdInfo) |
void | setDate (Date date) Ustawia datę na urządzeniu Uwaga: ustawienie daty na urządzeniu wymaga rootowania |
boolean | setDeviceOwner (String componentName, int userId) Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika. |
void | setDeviceState ( TestDeviceState deviceState) Zaktualizuj stan urządzenia. |
void | setEmulatorOutputStream ( SizeLimitedOutputStream output) W przypadku emulatora ustaw |
void | setEmulatorProcess (Process p) Ustawia |
void | setFastbootEnabled (boolean fastbootEnabled) Ustaw opcję fastboot dla urządzenia. |
void | setFastbootPath (String fastbootPath) Ustawia ścieżkę do pliku binarnego fastboot, który powinien zostać użyty. |
void | setIDevice (IDevice newDevice) Zaktualizuj urządzenie IDevice powiązane z tym urządzeniem ITestDevice. |
void | setLogStartDelay (int delay) Ustawia czas oczekiwania w ms przed rozpoczęciem przechwytywania logcat dla urządzenia online. |
void | setOptions ( TestDeviceOptions options) Ustaw opcję |
boolean | setProperty (String propKey, String propValue) Ustawia daną wartość właściwości na urządzeniu. |
void | setRecovery ( IDeviceRecovery recovery) Ustaw |
void | setRecoveryMode ( ITestDevice.RecoveryMode mode) Ustaw bieżący tryb odzyskiwania, który będzie używany na urządzeniu. |
void | setSetting (String namespace, String key, String value) Zobacz |
void | setSetting (int userId, String namespace, String key, String value) Dodaj wartość ustawienia do przestrzeni nazw danego użytkownika. |
void | setTestLogger ( ITestLogger testLogger) Wstrzykuje instancję |
void | setUseFastbootErase (boolean useFastbootErase) Określ, czy do czyszczenia partycji na urządzeniu ma być używany format Fastboot, czy format Fastboot. |
void | startLogcat () Rozpocznij przechwytywanie danych wyjściowych logcat z urządzenia w tle. |
boolean | startUser (int userId) Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. |
boolean | startUser (int userId, boolean waitFlag) Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Uruchamia danego użytkownika w tle, widocznym na danym ekranie (tzn. umożliwiając użytkownikowi uruchomienie działań na tym ekranie). |
void | stopEmulatorOutput () Zamknij i usuń wyjście emulatora. |
void | stopLogcat () Zatrzymaj przechwytywanie danych wyjściowych logcat z urządzenia i odrzuć aktualnie zapisane dane logcat. |
boolean | stopUser (int userId) Zatrzymuje danego użytkownika. |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Zatrzymaj 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 na inny identyfikator użytkownika z domyślnym limitem czasu. |
boolean | switchUser (int userId, long timeout) Przełącz na inny identyfikator użytkownika z podanym limitem czasu jako ostatecznym terminem. |
boolean | syncFiles (File localFileDir, String deviceFilePath) Przyrostowo synchronizuje zawartość lokalnego katalogu plików z urządzeniem. |
Bugreport | takeBugreport () Weź raport o błędzie i zwróć go do obiektu |
String | uninstallPackage (String packageName) Odinstaluj pakiet Androida z urządzenia. |
String | uninstallPackageForUser (String packageName, int userId) Odinstaluj pakiet Androida z urządzenia dla danego użytkownika. |
boolean | unlockDevice () Odblokowuje urządzenie, jeśli jest ono zaszyfrowane. |
boolean | waitForBootComplete (long timeOut) Blokuje do momentu ustawienia flagi zakończenia rozruchu urządzenia. |
boolean | waitForDeviceAvailable () Czeka, aż urządzenie zacznie reagować i będzie dostępne do testów. |
boolean | waitForDeviceAvailable (long waitTime) Czeka, aż urządzenie zacznie reagować i będzie dostępne do testów. |
boolean | waitForDeviceAvailableInRecoverPath (long waitTime) Czeka, aż urządzenie zacznie reagować i będzie dostępne, bez uwzględniania ścieżki odzyskiwania. |
void | waitForDeviceBootloader () Blokuje, dopóki urządzenie nie będzie widoczne poprzez fastboot. |
boolean | waitForDeviceInRecovery (long waitTime) Blokuje, aby urządzenie znajdowało się w stanie „odzyskiwania adb” (należy pamiętać, że różni się to od |
boolean | waitForDeviceInSideload (long waitTime) Blokuje, aby urządzenie znajdowało się w stanie „adb sideload”. |
boolean | waitForDeviceNotAvailable (long waitTime) Bloki dla urządzenia, które mają być niedostępne, tj. Brakuje w adb |
void | waitForDeviceOnline () Blokuje, dopóki urządzenie nie będzie widoczne przez adb. |
void | waitForDeviceOnline (long waitTime) Blokuje, dopóki urządzenie nie będzie widoczne przez adb. |
boolean | waitForDeviceShell (long waitTime) Czeka, aż urządzenie zareaguje na podstawowe polecenie powłoki adb. |
Metody chronione | |
---|---|
void | addExtraConnectionBuilderArgs ( DefaultConnection.ConnectionBuilder builder) |
String[] | buildAdbShellCommand (String command, boolean forceExitStatusDetection) Kompiluje polecenie systemu operacyjnego dla danej sesji poleceń powłoki adb i argumentów |
void | checkApiLevelAgainst (String feature, int strictMinLevel) |
NativeDevice.RebootDeviceAction | createRebootDeviceAction ( NativeDevice.RebootMode rebootMode, String reason) Utwórz |
IRunUtil | createRunUtil () |
void | doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason) Wykonaj ponowne uruchomienie adb. |
void | ensureRuntimePermissionSupported () metoda pomocnicza, aby zgłosić wyjątek, jeśli uprawnienia środowiska wykonawczego 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) Pobierz właściwość urządzenia, domyślnie z pamięci podręcznej ddmlib i wróć do `adb Shell getprop` lub `fastboot getvar`, w zależności od tego, czy urządzenie znajduje się w trybie Fastboot, czy nie. |
boolean | isInRebootCallback () Zwraca informację, czy aktualnie wykonywane jest wywołanie zwrotne ponownego uruchomienia, czy nie. |
boolean | isNewer (File localFile, IFileEntry entry) Zwróć wartość |
void | notifyRebootEnded () Powiadamia wszystkie |
void | notifyRebootStarted () Powiadamia wszystkie |
boolean | performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts) Wykonuje akcję na tym urządzeniu. |
void | postAdbReboot () Możliwe dodatkowe działania, które można podjąć po ponownym uruchomieniu. |
void | prePostBootSetup () Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w przypadku określonej konfiguracji po rozruchu. |
boolean | pullFileInternal (String remoteFilePath, File localFile) |
void | setClock (Clock clock) Ustaw instancję Clock do użycia. |
void | setMicrodroidProcess (Process process) Oznacza urządzenie testowe jako mikrodroid i ustawia jego identyfikator CID. |
void | setTestDeviceOptions ( deviceOptions) setTestDeviceOptions ( deviceOptions) |
CommandResult | simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) Wykonuje proste polecenie fastboot ze zmiennymi środowiskowymi i raportuje stan polecenia. |
CommandResult | simpleFastbootCommand (long timeout, String[] fullCmd) Wykonuje proste polecenie fastboot i raportuje stan polecenia. |
boolean | waitForDeviceNotAvailable (String operationDesc, long time) Poczekaj, aż urządzenie stanie się niedostępne (przestań raportować do adb). |
Stałe
NIEPRAWIDŁOWY IDENTYFIKATOR UŻYTKOWNIKA
public static final int INVALID_USER_ID
Wartość zwrócona w przypadku nieprawidłowego/nieodnalezionego identyfikatora użytkownika: UserHandle zdefiniował wartość -10000
Wartość stała: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Wartość stała: 5000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
domyślna liczba ponownych prób wykonania polecenia
Wartość stała: 2 (0x00000002)
Pola
KARTA SD
protected static final String SD_CARD
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
Konstruktorzy publiczni
Urządzenie natywne
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Tworzy TestDevice
.
Parametry | |
---|---|
device | IDevice : powiązane IDevice |
stateMonitor | IDeviceStateMonitor : mechanizm IDeviceStateMonitor do użycia |
allocationMonitor | IDeviceMonitor : IDeviceMonitor informujący o zmianach stanu alokacji. Może mieć wartość zerową |
Metody publiczne
BatchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Mikrooptymalizacja (około 400 milinów) poprzez wstępne pobieranie wszystkich potrzebnych rekwizytów zamiast wywoływania „adb getprop” dla każdego z nich. tzn. pobranie wszystkich właściwości jest równie szybkie, jak pobranie jednej. Rzeczy takie jak Device.getApiLevel(), checkApiLevelAgainstNextRelease i getBuildAlias wywołują pod maską `adb getprop`. Pobieramy je w jednym wywołaniu i wywołujemy NativeDevice.setProperty. Nawet jeśli tego nie zrobimy, NativeDevice samo wywoła setProperty i zapisze wynik w pamięci podręcznej dla przyszłych wywołań. Po prostu robimy to nieco wcześniej. Jeśli urządzenie jest w trakcie odzyskiwania lub występują inne błędy podczas pobierania rekwizytów, po prostu je ignorujemy.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Zwraca informację, czy można przełączyć się na użytkownika bezgłowego SYSTEM.
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
sprawdźApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Sprawdź, czy dana funkcja jest obecnie obsługiwana, biorąc pod uwagę minimalnie obsługiwany poziom. Ta metoda uwzględnia niepublikowane jeszcze funkcje, zanim zostanie podniesiony poziom API.
Parametry | |
---|---|
strictMinLevel | int : Ścisły minimalny możliwy poziom obsługujący tę funkcję. |
Zwroty | |
---|---|
boolean | Prawda, jeśli poziom jest obsługiwany. Inaczej nieprawda. |
Rzuca | |
---|---|
DeviceNotAvailableException |
sprawdź Łączność
public boolean checkConnectivity ()
Sprawdź, czy urządzenie ma łączność sieciową.
Zwroty | |
---|---|
boolean | true , jeśli urządzenie ma działające połączenie sieciowe, false w przeciwnym razie. |
Rzuca | |
---|---|
DeviceNotAvailableException |
wyczyść okno dialogowe błędów
public boolean clearErrorDialogs ()
Spróbuj odrzucić wszelkie okna dialogowe o błędach wyświetlane obecnie w interfejsie użytkownika urządzenia.
Zwroty | |
---|---|
boolean | true , jeśli nie było żadnych okien dialogowych lub okna dialogowe zostały pomyślnie usunięte. inaczej false . |
Rzuca | |
---|---|
DeviceNotAvailableException |
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Usuwa ostatnią połączoną sieć Wi-Fi. Należy to wywołać przy rozpoczynaniu nowego wywołania, aby uniknąć łączenia się z siecią Wi-Fi używaną w poprzednim teście po ponownym uruchomieniu urządzenia.
wyczyśćLogcat
public void clearLogcat ()
Usuwa wszelkie zgromadzone dane logcat.
Jest to przydatne w przypadkach, gdy chcesz mieć pewność, żeITestDevice#getLogcat()
zwraca tylko dane dziennika utworzone po pewnym momencie (np. po flashowaniu nowej wersji urządzenia itp.). połącz się z siecią Wi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do czasu pomyślnego nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie Wi-FiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania funkcji ITestDevice#disconnectFromWifi()
lub ITestDevice#clearLastConnectedWifiNetwork()
.
Parametry | |
---|---|
wifiSsidToPsk | |
scanSsid | boolean : czy skanować w poszukiwaniu ukrytych identyfikatorów SSID dla tej sieci. |
Zwroty | |
---|---|
boolean | true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false |
Rzuca | |
---|---|
DeviceNotAvailableException |
połącz się z siecią Wi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do momentu pomyślnego nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania funkcjiITestDevice#disconnectFromWifi()
lub ITestDevice#clearLastConnectedWifiNetwork()
.Parametry | |
---|---|
wifiSsid | String : identyfikator SSID Wi-Fi, z którym można się połączyć |
wifiPsk | String : hasło PSK lub wartość null, jeśli nie jest szyfrowana |
Zwroty | |
---|---|
boolean | true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false |
Rzuca | |
---|---|
DeviceNotAvailableException |
połącz się z siecią Wi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do czasu pomyślnego nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie Wi-FiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania ITestDevice#disconnectFromWifi()
lub ITestDevice#clearLastConnectedWifiNetwork()
Parametry | |
---|---|
wifiSsidToPsk |
Zwroty | |
---|---|
boolean | true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false |
Rzuca | |
---|---|
DeviceNotAvailableException |
połącz się z siecią Wi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do momentu pomyślnego nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania funkcjiITestDevice#disconnectFromWifi()
lub ITestDevice#clearLastConnectedWifiNetwork()
.Parametry | |
---|---|
wifiSsid | String : identyfikator SSID Wi-Fi, z którym można się połączyć |
wifiPsk | String : hasło PSK lub wartość null, jeśli nie jest szyfrowana |
scanSsid | boolean : czy skanować w poszukiwaniu ukrytego identyfikatora SSID dla tej sieci. |
Zwroty | |
---|---|
boolean | true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false |
Rzuca | |
---|---|
DeviceNotAvailableException |
połącz się z siecią Wifi w razie potrzeby
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Wariant connectToWifiNetwork(String, String)
, który łączy się tylko wtedy, gdy urządzenie aktualnie nie ma połączenia z siecią.
Parametry | |
---|---|
scanSsid | boolean : czy skanować w poszukiwaniu ukrytego identyfikatora SSID dla tej sieci |
Zwroty | |
---|---|
boolean | true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false |
Rzuca | |
---|---|
DeviceNotAvailableException |
połącz się z siecią Wifi w razie potrzeby
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Wariant connectToWifiNetwork(String, String)
, który łączy się tylko wtedy, gdy urządzenie aktualnie nie ma połączenia z siecią.
Zwroty | |
---|---|
boolean | true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false |
Rzuca | |
---|---|
DeviceNotAvailableException |
Stwórz użytkownika
public int createUser (String name, boolean guest, boolean ephemeral)
Utwórz użytkownika o podanej nazwie i podanych flagach
Parametry | |
---|---|
name | String : użytkownika, który ma zostać utworzony na urządzeniu |
guest | boolean : włącz flagę użytkownika --guest podczas tworzenia |
ephemeral | boolean : włącz flagę użytkownika --ephemeral podczas tworzenia |
Zwroty | |
---|---|
int | identyfikator utworzonego użytkownika |
Rzuca | |
---|---|
DeviceNotAvailableException |
Stwórz użytkownika
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Utwórz użytkownika o podanej nazwie i podanych flagach
Parametry | |
---|---|
name | String : użytkownika, który ma zostać utworzony na urządzeniu |
guest | boolean : włącz flagę użytkownika --guest podczas tworzenia |
ephemeral | boolean : włącz flagę użytkownika --ephemeral podczas tworzenia |
forTesting | boolean : włącz flagę testową --for-testing podczas tworzenia |
Zwroty | |
---|---|
int | identyfikator utworzonego użytkownika |
Rzuca | |
---|---|
DeviceNotAvailableException |
Stwórz użytkownika
public int createUser (String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
Parametry | |
---|---|
name | String : użytkownika, który ma zostać utworzony na urządzeniu |
Zwroty | |
---|---|
int | liczba całkowita dla utworzonego identyfikatora użytkownika |
Rzuca | |
---|---|
DeviceNotAvailableException |
utwórzUserNoThrow
public int createUserNoThrow (String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
Parametry | |
---|---|
name | String : użytkownika, który ma zostać utworzony na urządzeniu |
Zwroty | |
---|---|
int | liczba całkowita dla utworzonego identyfikatora użytkownika lub -1 w przypadku błędu. |
Rzuca | |
---|---|
DeviceNotAvailableException |
usunąć plik
public void deleteFile (String deviceFilePath)
Metoda pomocnicza służąca do usuwania pliku lub katalogu na urządzeniu.
Parametry | |
---|---|
deviceFilePath | String : Bezwzględna ścieżka pliku na urządzeniu. |
Rzuca | |
---|---|
DeviceNotAvailableException |
wyrejestruj urządzenieActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Usuwa zarejestrowany IDeviceActionReceiver
.
Parametry | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : IDeviceActionReceiver , który zostanie usunięty. |
urządzenieSoft uruchomiono ponownie
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Metoda pomocnicza sprawdzająca, czy urządzenie zostało uruchomione miękko, porównując bieżący serwer systemowy z poprzednim ProcessInfo
serwera systemowego. Użyj getProcessByName(String)
, aby uzyskać ProcessInfo
.
Parametry | |
---|---|
prevSystemServerProcess | ProcessInfo : poprzedni proces serwera_systemowego ProcessInfo . |
Zwroty | |
---|---|
boolean | true , jeśli urządzenie zostało zrestartowane programowo |
Rzuca | |
---|---|
DeviceNotAvailableException |
urządzenieSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza sprawdzająca, czy urządzenie zostało uruchomione miękko od czasu UTC od epoki z urządzenia i jego ERROR(/TimeUnit)
. Miękki restart odnosi się do serwera_systemowego uruchomionego ponownie poza twardym ponownym uruchomieniem urządzenia (na przykład: żądanie ponownego uruchomienia). Bieżące urządzenie utcEpochTime w milisekcondach można uzyskać metodą getDeviceDate()
.
Parametry | |
---|---|
utcEpochTime | long : czas urządzenia w sekundach od epoki. |
timeUnit | TimeUnit : jednostka czasu TimeUnit dla danego utcEpochTime. |
Zwroty | |
---|---|
boolean | true , jeśli urządzenie zostało zrestartowane programowo |
Rzuca | |
---|---|
DeviceNotAvailableException |
wyłączAdbRoot
public boolean disableAdbRoot ()
Wyłącza root adb.
Wyłączenie roota adb może spowodować rozłączenie urządzenia z adb. Ta metoda będzie blokowana do czasu udostępnienia urządzenia.Zwroty | |
---|---|
boolean | true , jeśli się powiedzie. |
Rzuca | |
---|---|
DeviceNotAvailableException |
wyłącz Keyguarda
public void disableKeyguard ()
Próba wyłączenia blokady klawiatury.
Najpierw poczekaj, aż wysyłanie danych wejściowych będzie gotowe. Dzieje się to mniej więcej w tym samym czasie, gdy urządzenie zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ w bieżącej implementacji frameworka czasami zdarzają się wyścigi. Następnie wysyłane jest polecenie zwolnienia klawiatury (działa tylko na niezabezpieczonych)
Rzuca | |
---|---|
DeviceNotAvailableException |
wyłącz NetworkMonitor
public boolean disableNetworkMonitor ()
Wyłącza monitorowanie sieci na urządzeniu.
Zwroty | |
---|---|
boolean | true , jeśli monitorowanie zostało pomyślnie wyłączone. false jeśli się nie udało. |
Rzuca | |
---|---|
DeviceNotAvailableException |
rozłącz się z Wi-Fi
public boolean disconnectFromWifi ()
Rozłącza się z siecią Wi-Fi.
Usuwa wszystkie sieci z listy znanych sieci i wyłącza Wi-Fi.Zwroty | |
---|---|
boolean | true , jeśli pomyślnie rozłączono się z siecią Wi-Fi. false , jeśli rozłączenie nie powiodło się. |
Rzuca | |
---|---|
DeviceNotAvailableException |
czy plik istnieje
public boolean doesFileExist (String deviceFilePath, int userId)
Metoda pomocnicza służąca do ustalenia, czy dla danego użytkownika istnieje plik na urządzeniu.
Parametry | |
---|---|
deviceFilePath | String : bezwzględna ścieżka pliku na urządzeniu do sprawdzenia |
userId | int : Identyfikator użytkownika, według którego sprawdzane jest istnienie pliku |
Zwroty | |
---|---|
boolean | true , jeśli plik istnieje, false w przeciwnym razie. |
Rzuca | |
---|---|
DeviceNotAvailableException |
czy plik istnieje
public boolean doesFileExist (String deviceFilePath)
Metoda pomocnicza służąca do ustalenia, czy plik na urządzeniu istnieje.
Parametry | |
---|---|
deviceFilePath | String : bezwzględna ścieżka pliku na urządzeniu do sprawdzenia |
Zwroty | |
---|---|
boolean | true , jeśli plik istnieje, false w przeciwnym razie. |
Rzuca | |
---|---|
DeviceNotAvailableException |
sterta zrzutu
public File dumpHeap (String process, String devicePath)
Spróbuj zrzucić stertę z serwera systemowego. Oczyszczenie zrzuconego pliku jest obowiązkiem dzwoniącego.
Parametry | |
---|---|
process | String : nazwa procesu urządzenia, na którym ma zostać zrzucony plik. |
devicePath | String : ścieżka na urządzeniu, gdzie umieścić zrzut. Musi to być lokalizacja, w której pozwalają na to uprawnienia. |
Zwroty | |
---|---|
File | ERROR(/File) zawierający raport. Null, jeśli coś się nie udało. |
Rzuca | |
---|---|
DeviceNotAvailableException |
włączAdbRoot
public boolean enableAdbRoot ()
Włącza root adb. Jeśli ustawienie „enable-root” ma wartość „false”, zarejestruje wiadomość i powróci bez włączania roota.
Włączenie roota adb może spowodować rozłączenie urządzenia z adb. Ta metoda będzie blokowana do czasu udostępnienia urządzenia.Zwroty | |
---|---|
boolean | true , jeśli się powiedzie. |
Rzuca | |
---|---|
DeviceNotAvailableException |
włączMonitor sieci
public boolean enableNetworkMonitor ()
Umożliwia monitorowanie sieci na urządzeniu.
Zwroty | |
---|---|
boolean | true , jeśli monitorowanie zostało pomyślnie włączone. false jeśli się nie udało. |
Rzuca | |
---|---|
DeviceNotAvailableException |
wykonaj polecenie Adb
public String executeAdbCommand (long timeout, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym limitem czasu.
Zamiast tego należy używać executeShellCommand(String)
tam, gdzie to możliwe, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i lepszą wydajność.
Parametry | |
---|---|
timeout | long : czas w milisekundach, po którym urządzenie zostanie uznane za niereagujące, 0L w przypadku braku limitu czasu |
cmdArgs | String : polecenie adb i argumenty do uruchomienia |
Zwroty | |
---|---|
String | standardowe wyjście z polecenia. null , jeśli polecenie nie zostało wykonane. |
Rzuca | |
---|---|
DeviceNotAvailableException |
wykonaj polecenie Adb
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym limitem czasu.
Zamiast tego należy używać executeShellCommand(String)
tam, gdzie to możliwe, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i lepszą wydajność.
Parametry | |
---|---|
timeout | long : czas w milisekundach, po którym urządzenie zostanie uznane za niereagujące, 0L w przypadku braku limitu czasu |
envMap | |
cmdArgs | String : polecenie adb i argumenty do uruchomienia |
Zwroty | |
---|---|
String | standardowe wyjście z polecenia. null , jeśli polecenie nie zostało wykonane. |
Rzuca | |
---|---|
DeviceNotAvailableException |
wykonaj polecenie Adb
public String executeAdbCommand (String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.
Zamiast tego należy używaćexecuteShellCommand(String)
tam, gdzie to możliwe, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i lepszą wydajność.Parametry | |
---|---|
cmdArgs | String : polecenie adb i argumenty do uruchomienia |
Zwroty | |
---|---|
String | standardowe wyjście z polecenia. null , jeśli polecenie nie zostało wykonane. |
Rzuca | |
---|---|
DeviceNotAvailableException |
wykonaj polecenie Fastboot
public CommandResult executeFastbootCommand (String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty.
Oczekuje się, że będzie używany, gdy urządzenie jest już w trybie szybkiego uruchamiania.
Parametry | |
---|---|
cmdArgs | String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający dane wyjściowe polecenia |
Rzuca | |
---|---|
DeviceNotAvailableException |
wykonaj polecenie Fastboot
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe.
Oczekuje się, że będzie używany, gdy urządzenie jest już w trybie szybkiego uruchamiania.Parametry | |
---|---|
timeout | long : czas w milisekundach przed wygaśnięciem polecenia |
cmdArgs | String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający dane wyjściowe polecenia |
Rzuca | |
---|---|
DeviceNotAvailableException |
wykonaj polecenie LongFastboot
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Metoda pomocnicza, która wykonuje długo działające polecenie fastboot jako polecenie systemowe.
Identyczne zexecuteFastbootCommand(String)
z tą różnicą, że używa dłuższego limitu czasu.Parametry | |
---|---|
cmdArgs | String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający dane wyjściowe polecenia |
Rzuca | |
---|---|
DeviceNotAvailableException |
wykonaj polecenie LongFastboot
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Metoda pomocnicza, która wykonuje długo działające polecenie fastboot jako polecenie systemowe z systemowymi zmiennymi środowiskowymi.
Identyczne z executeFastbootCommand(String)
z tą różnicą, że używa dłuższego limitu czasu.
Parametry | |
---|---|
envVarMap | |
cmdArgs | String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający dane wyjściowe polecenia |
Rzuca | |
---|---|
DeviceNotAvailableException |
wykonaj polecenie Shell
public String executeShellCommand (String command)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca dane wyjściowe jako String
.
Parametry | |
---|---|
command | String : polecenie powłoki adb do uruchomienia |
Zwroty | |
---|---|
String | wyjście powłoki |
Rzuca | |
---|---|
DeviceNotAvailableException |
wykonaj polecenie Shell
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie powłoki adb z większą liczbą parametrów kontrolujących zachowanie poleceń.
Parametry | |
---|---|
command | String : polecenie powłoki adb do uruchomienia |
receiver | IShellOutputReceiver : IShellOutputReceiver , do którego mają być kierowane dane wyjściowe powłoki. |
maxTimeToOutputShellResponse | long : maksymalny czas, przez jaki polecenie może nie dać żadnej odpowiedzi; jednostka określona w timeUnit |
timeUnit | TimeUnit : jednostka dla maxTimeToOutputShellResponse |
retryAttempts | int : maksymalna liczba ponownych prób wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. DeviceNotRespentiveException zostanie wyrzucone, jeśli ponowne retryAttempts zostanie wykonywane. |
Rzuca | |
---|---|
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 do kontrolowania zachowania poleceń.
Parametry | |
---|---|
command | String : Polecenie powłoki ADB do uruchomienia |
receiver | IShellOutputReceiver : IShellOutputReceiver do bezpośredniego wyjścia powłoki do. |
maxTimeoutForCommand | long : maksymalny limit czasu, w którym polecenie może się ukończyć; jednostka określona w timeUnit |
maxTimeToOutputShellResponse | long : maksymalny czas, w którym polecenie może nie wysyłać żadnej odpowiedzi; jednostka określona w timeUnit |
timeUnit | TimeUnit : Jednostka dla maxTimeToOutputShellResponse |
retryAttempts | int : Maksymalna liczba razy do ponownego ponownego wypowiedzi polecenia, jeśli zawiedzie z powodu wyjątku. DeviceNotRespentiveException zostanie wyrzucone, jeśli ponowne retryAttempts zostanie wykonywane. |
Rzuca | |
---|---|
DeviceNotAvailableException |
ExecuteShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Wykonuje podane polecenie ADB Shell, ponosząc wiele razy, jeśli polecenie się nie powiedzie.
Prostsza formaexecuteShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
z wartościami domyślnymi.Parametry | |
---|---|
command | String : Polecenie powłoki ADB do uruchomienia |
receiver | IShellOutputReceiver : IShellOutputReceiver do bezpośredniego wyjścia powłoki do. |
Rzuca | |
---|---|
DeviceNotAvailableException |
ExecuteShellv2Command
public CommandResult executeShellV2Command (String cmd)
Metoda pomocnicza, która wykonuje polecenie powłoki ADB i zwraca wyniki jako CommandResult
odpowiednio zaludnione z wyjściem stanu polecenia, StDout i Stderr.
Parametry | |
---|---|
cmd | String : Polecenie, które powinno być uruchomione. |
Zwroty | |
---|---|
CommandResult | Wynik CommandResult . |
Rzuca | |
---|---|
DeviceNotAvailableException |
ExecuteShellv2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Metoda pomocnicza, która wykonuje polecenie powłoki ADB i zwraca wyniki jako CommandResult
odpowiednio zaludnione z wyjściem stanu polecenia i STDDERR. StDout jest skierowany do określonego strumienia.
Parametry | |
---|---|
cmd | String : Polecenie, które powinno być uruchomione. |
pipeToOutput | OutputStream : ERROR(/OutputStream) , gdzie wyjście STD zostanie przekierowane lub zerowe. |
Zwroty | |
---|---|
CommandResult | Wynik CommandResult . |
Rzuca | |
---|---|
DeviceNotAvailableException |
ExecuteShellv2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Metoda pomocnicza, która wykonuje polecenie ADB Shell i zwraca wyniki jako CommandResult
odpowiednio zaludnione z wyjściem stanu polecenia, stdout i stderr.
Parametry | |
---|---|
cmd | String : Polecenie, które powinno być uruchomione. |
pipeAsInput | File : ERROR(/File) , który będzie rurowy jako wejście do polecenia lub null. |
Zwroty | |
---|---|
CommandResult | Wynik CommandResult . |
Rzuca | |
---|---|
DeviceNotAvailableException |
ExecuteShellv2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie ADB Shell, z większą liczbą parametrów do kontrolowania zachowania poleceń.
Parametry | |
---|---|
cmd | String : Polecenie powłoki ADB do uruchomienia |
maxTimeoutForCommand | long : maksymalny limit czasu, w którym polecenie może się ukończyć; jednostka określona w timeUnit |
timeUnit | TimeUnit : Jednostka dla maxTimeToOutputShellResponse |
retryAttempts | int : Maksymalna liczba razy do ponownego ponownego wypowiedzi polecenia, jeśli zawiedzie z powodu wyjątku. DeviceNotRespentiveException zostanie wyrzucone, jeśli ponowne retryAttempts zostanie wykonywane. |
Zwroty | |
---|---|
CommandResult |
Rzuca | |
---|---|
DeviceNotAvailableException |
ExecuteShellv2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Wykonuje polecenie ADB Shell, z większą liczbą parametrów do kontrolowania zachowania poleceń.
Parametry | |
---|---|
cmd | String : Polecenie powłoki ADB do uruchomienia |
maxTimeoutForCommand | long : maksymalny limit czasu, w którym polecenie może się ukończyć; jednostka określona w timeUnit |
timeUnit | TimeUnit : Jednostka dla maxTimeToOutputShellResponse |
Zwroty | |
---|---|
CommandResult |
Rzuca | |
---|---|
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 do kontrolowania zachowania poleceń.
Parametry | |
---|---|
cmd | String : Polecenie powłoki ADB do uruchomienia |
pipeAsInput | File : ERROR(/File) , który będzie rurowy jako wejście do polecenia lub null. |
pipeToOutput | OutputStream : ERROR(/OutputStream) , gdzie wyjście STD zostanie przekierowane lub zerowe. |
maxTimeoutForCommand | long : maksymalny limit czasu, w którym polecenie może się ukończyć; jednostka określona w timeUnit |
timeUnit | TimeUnit : Jednostka dla maxTimeToOutputShellResponse |
retryAttempts | int : Maksymalna liczba razy do ponownego ponownego wypowiedzi polecenia, jeśli zawiedzie z powodu wyjątku. DeviceNotRespentiveException zostanie wyrzucone, jeśli ponowne retryAttempts zostanie wykonywane. |
Zwroty | |
---|---|
CommandResult |
Rzuca | |
---|---|
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 do kontrolowania zachowania poleceń.
Parametry | |
---|---|
cmd | String : Polecenie powłoki ADB do uruchomienia |
pipeAsInput | File : ERROR(/File) , który będzie rurowy jako wejście do polecenia lub null. |
pipeToOutput | OutputStream : ERROR(/OutputStream) , gdzie wyjście STD zostanie przekierowane lub zerowe. |
pipeToError | OutputStream : ERROR(/OutputStream) , gdzie błąd STD zostanie przekierowany lub zerowy. |
maxTimeoutForCommand | long : maksymalny limit czasu, w którym polecenie może się ukończyć; jednostka określona w timeUnit |
timeUnit | TimeUnit : Jednostka dla maxTimeToOutputShellResponse |
retryAttempts | int : Maksymalna liczba razy do ponownego ponownego wypowiedzi polecenia, jeśli zawiedzie z powodu wyjątku. DeviceNotRespentiveException zostanie wyrzucone, jeśli ponowne retryAttempts zostanie wykonywane. |
Zwroty | |
---|---|
CommandResult |
Rzuca | |
---|---|
DeviceNotAvailableException |
FastbootwipEpartition
public CommandResult fastbootWipePartition (String partition)
Metoda pomocnicza, która usuwa partycję urządzenia.
JeśligetUseFastbootErase()
jest true
, do wycierania partycji zostanie użyte Fastboot Erase. Urządzenie musi następnie utworzyć system plików następnym razem, gdy urządzenie. W przeciwnym razie używany jest format Fastboot, który utworzy nowy system plików na urządzeniu. Oczekiwano, że będzie używany, gdy urządzenie jest już w trybie Fastboot.Parametry | |
---|---|
partition | String : partycja do wycierania |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający dane wyjściowe poleceń |
Rzuca | |
---|---|
DeviceNotAvailableException |
getactiveapexes
publicgetActiveApexes ()
Pobierz informacje o wierzchołkach aktywowanych na urządzeniu.
Zwroty | |
---|---|
ERROR(/Set) ApexInfo obecnie aktywowany na urządzeniu |
Rzuca | |
---|---|
DeviceNotAvailableException |
getallSettings
publicgetAllSettings (String namespace)
Zwracaj pary wartości kluczowych żądanych przestrzeni nazw.
Parametry | |
---|---|
namespace | String : Musi być jednym z {„system”, „bezpieczny”, „globalny”} |
Zwroty | |
---|---|
Mapa par kluczowych. NULL Jeśli przestrzeń nazw nie jest obsługiwana. |
Rzuca | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Zwróć obecny stan alokacji urządzenia
Zwroty | |
---|---|
DeviceAllocationState |
getandroidid
public String getAndroidId (int userId)
Znajdź i zwróć android-ID powiązane z użytkownikiem, null, jeśli nie znaleziono.
Parametry | |
---|---|
userId | int |
Zwroty | |
---|---|
String |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetAndroidids
publicgetAndroidIds ()
Utwórz mapę identyfikatorów Androida znalezionych pasujących identyfikatorów użytkowników. Nie ma ubezpieczenia, że każdy identyfikator użytkownika znalazł identyfikator Androida powiązany w tej funkcji, więc niektóre identyfikatory użytkowników mogą pasować do NULL.
Zwroty | |
---|---|
Mapa identyfikatorów Androida znalazła pasujące identyfikatory użytkowników. |
Rzuca | |
---|---|
DeviceNotAvailableException |
Getapilevel
public int getApiLevel ()
Uzyskaj poziom interfejsu API urządzenia. Domyślnie do UNKNOWN_API_LEVEL
.
Zwroty | |
---|---|
int | liczba całkowita wskazująca poziom API urządzenia |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetAppPackageinfo
public PackageInfo getAppPackageInfo (String packageName)
Pobierz informacje o pakiecie zainstalowanym na urządzeniu.
Parametry | |
---|---|
packageName | String |
Zwroty | |
---|---|
PackageInfo | PackageInfo lub null , jeśli nie można go było odzyskać |
Rzuca | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
Pobierz informacje o pakietach zainstalowanych na urządzeniu.
Zwroty | |
---|---|
ERROR(/List) PackageInfo Instalowane na urządzeniu. |
Rzuca | |
---|---|
DeviceNotAvailableException |
getBaseBandVersion
public String getBasebandVersion ()
Metoda wygody otrzymywania pasma podstawowego (radiowego) wersji tego urządzenia. Uzyskanie wersji radiowej jest specyficzne dla urządzenia, więc może nie zwrócić prawidłowych informacji dla wszystkich urządzeń. Ta metoda opiera się na GSM.Version.baseBand Propery, aby zwrócić prawidłowe informacje o wersji. Nie jest to dokładne dla niektórych urządzeń CDMA, a powrót wersji może nie pasować do wersji zgłoszonej z Fastboot i może nie zwracać wersji dla radia CDMA. TL; DR Ta metoda zgłasza dokładną wersję, jeśli właściwość gsm.version.baseBand jest taka sama jak wersja zwrócona przez fastboot getvar version-baseband
.
Zwroty | |
---|---|
String | String BaseAband Wersja lub null , jeśli nie można go ustalić (urządzenie nie można odczytać Radio ani wersji) |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetBattery
public Integer getBattery ()
Zwraca obecny poziom baterii urządzenia lub zerowy, jeśli poziom baterii jest niedostępny.
Zwroty | |
---|---|
Integer |
GetBooleanProperty
public boolean getBooleanProperty (String name, boolean defaultValue)
Zwraca wartość logiczną danej właściwości.
Parametry | |
---|---|
name | String : nazwa 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 inaczej. |
Rzuca | |
---|---|
DeviceNotAvailableException |
Getboothistory
publicgetBootHistory ()
Metoda pomocnika zbiera mapę historii rozruchu z czasem rozruchu i rozumem.
Zwroty | |
---|---|
Mapa czasu rozruchu (czas UTC na sekundę od epoki) i rozum rozruchowy |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetboothistorySince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnika zbiera mapę historii rozruchu z czasem rozruchu i rozruchu, ponieważ dany czas od epoki z urządzenia i określono jednostkę czasu. Obecne urządzenie Utcepsime w milisekundach można uzyskać metodą getDeviceDate()
.
Parametry | |
---|---|
utcEpochTime | long : czas urządzenia od epoki. |
timeUnit | TimeUnit : Time Unit TimeUnit . |
Zwroty | |
---|---|
Mapa czasu rozruchu (czas UTC na sekundę od epoki) i rozum rozruchowy |
Rzuca | |
---|---|
DeviceNotAvailableException |
getbootloaderversion
public String getBootloaderVersion ()
Metoda wygody, aby uzyskać wersję Bootloader tego urządzenia.
Spróbuje pobrać wersję Bootloader z bieżącego stanu urządzenia. (IE Jeśli urządzenie jest w trybie Fastboot, będzie próbowało odzyskać wersję z Fastboot)Zwroty | |
---|---|
String | String Bootloader wersja lub null , jeśli nie można go znaleźć |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetBugreport
public InputStreamSource getBugreport ()
Pobiera raport z urządzenia.
Wdrożenie tego gwarantuje, że będzie kontynuować pracę na urządzeniu bez karty SD (lub gdzie SDCard nie jest jeszcze zamontowany).
Zwroty | |
---|---|
InputStreamSource | InputStreamSource , który wytworzy zawartość Bugreport na żądanie. W przypadku awarii InputStreamSource wytworzy pusty ERROR(/InputStream) . |
GetBugreportz
public InputStreamSource getBugreportz ()
Pobiera Bugreportz z urządzenia. Zip Format Bugreport zawiera główny raport Bugreport i inne pliki dziennika, które są przydatne do debugowania.
Obsługiwane tylko dla „wersji ADB”> 1.0.36
Zwroty | |
---|---|
InputStreamSource | InputStreamSource pliku ZIP zawierającego BugReportz, zwróć NULL w przypadku awarii. |
getBuildalias
public String getBuildAlias ()
Odzyskaj alias kompilacji, którą obecnie działa urządzenie.
Alias kompilacji jest zwykle bardziej czytelnym ciągiem niż identyfikator kompilacji (zazwyczaj liczba dla kompilacji Nexus). Na przykład ostateczna wersja Android 4.2 ma alias JDQ39 i kompilację ID 573038
Zwroty | |
---|---|
String | kompilacja alias lub spadek do budowania identyfikatora, jeśli nie można go odzyskać |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetBuildflavor
public String getBuildFlavor ()
Odzyskaj smak kompilacji urządzenia.
Zwroty | |
---|---|
String | Smak lub null, jeśli nie można go odzyskać |
Rzuca | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
Odzyskaj kompilację, który obecnie działa.
Zwroty | |
---|---|
String | Identyfikator kompilacji lub IBuildInfo#UNKNOWN_BUILD_ID jeśli nie można go odzyskać |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetBuildsigningKeys
public String getBuildSigningKeys ()
Zwraca typ klucza używany do podpisywania obrazu urządzenia
Zazwyczaj urządzenia z Androidem mogą być podpisywane z Key Test (jak w AOSP) lub keys (kontrolowane przez poszczególnych producentów urządzeń)
Zwroty | |
---|---|
String | Klucz podpisania, jeśli zostanie znaleziony, inaczej null. |
Rzuca | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDeScriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Zwraca buforowany DeviceDescriptor
Jeśli urządzenie jest przydzielone, w przeciwnym razie zwraca bieżący DeviceDescriptor
.
Zwroty | |
---|---|
DeviceDescriptor |
getCachedDeviceDeScriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Zwraca buforowany DeviceDescriptor
Jeśli urządzenie jest przydzielone, w przeciwnym razie zwraca bieżący DeviceDescriptor
.
Parametry | |
---|---|
shortDescriptor | boolean : czy ograniczyć deskryptor do absolutnych minimalnych informacji |
Zwroty | |
---|---|
DeviceDescriptor |
GetChildren
public String[] getChildren (String path)
Alternatywa dla korzystania IFileEntry
, która czasami nie będzie działać z powodu uprawnień.
Parametry | |
---|---|
path | String : jest ścieżką na urządzeniu, gdzie wyszukiwać |
Zwroty | |
---|---|
String[] | Tablica ciągu zawierająca cały plik na ścieżce na urządzeniu. |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetConnection
public AbstractConnection getConnection ()
Bieżące połączenie związane z urządzeniem.
Zwroty | |
---|---|
AbstractConnection |
GetCurrentFoldablestate
public DeviceFoldableState getCurrentFoldableState ()
Zwraca obecny składany stan urządzenia lub zerowy, jeśli wystąpiły pewne problemy.
Zwroty | |
---|---|
DeviceFoldableState |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetCurrentuser
public int getCurrentUser ()
Zwróć identyfikator bieżącego uruchomionego użytkownika. W przypadku błędu zwrot -10000.
Zwroty | |
---|---|
int |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetDeviceClass
public String getDeviceClass ()
Zdobądź klasę urządzenia.
Zwroty | |
---|---|
String | klasa urządzenia String . |
getdevicedate
public long getDeviceDate ()
Zwróć datę urządzenia w milisekundach od epoki.
Zwroty | |
---|---|
long | Data urządzenia w formacie epoki. |
Rzuca | |
---|---|
DeviceNotAvailableException |
getDevicedescriptor
public DeviceDescriptor getDeviceDescriptor ()
Zwróć DeviceDescriptor
z informacji o urządzeniu, aby uzyskać informacje bez przekazywania rzeczywistego obiektu urządzenia.
Zwroty | |
---|---|
DeviceDescriptor |
getDevicedescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Zwróć DeviceDescriptor
z informacji o urządzeniu, aby uzyskać informacje bez przekazywania rzeczywistego obiektu urządzenia.
Parametry | |
---|---|
shortDescriptor | boolean : czy ograniczyć deskryptor do absolutnych minimalnych informacji |
Zwroty | |
---|---|
DeviceDescriptor |
getdevicestate
public TestDeviceState getDeviceState ()
Zdobądź stan urządzenia.
Zwroty | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Pomocnik, aby uzyskać różnicę czasu między urządzeniem a danym ERROR(/Date)
. Używaj czasu EPOCH wewnętrznie.
Parametry | |
---|---|
date | Date |
Zwroty | |
---|---|
long | Różnica w milisekundach |
Rzuca | |
---|---|
DeviceNotAvailableException |
getEmulatoroutput
public InputStreamSource getEmulatorOutput ()
Zdobądź strumień emulatora stdout i stderr
Zwroty | |
---|---|
InputStreamSource | Wyjście emulatora |
getEmulatorProcess
public Process getEmulatorProcess ()
Zwróć Process
odpowiadający temu emulatorowi.
Zwroty | |
---|---|
Process | Process lub null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
Dziennik zawierający wszystkie dzienniki executeShellCommand(String)
.
Zwroty | |
---|---|
File |
getExternalStorefreespace
public long getExternalStoreFreeSpace ()
Metoda pomocnicza do określenia ilości wolnej przestrzeni na zewnętrznym miejscu urządzenia.
Zwroty | |
---|---|
long | ilość wolnej przestrzeni w KB |
Rzuca | |
---|---|
DeviceNotAvailableException |
Getfastbootpath
public String getFastbootPath ()
Zwraca ścieżkę używanego binarnego fastboot. Nadal wymaga isFastbootEnabled()
, aby być prawdą, aby włączyć funkcje fastboot.
Zwroty | |
---|---|
String |
GetFastbootProductType
public String getFastbootProductType ()
Metoda wygody, aby uzyskać rodzaj produktu tego urządzenia, gdy jest w trybie Fastboot.
Ta metoda powinna być używana tylko wtedy, gdy urządzenie powinno znajdować się w Fastboot. Jest to nieco bezpieczniejszy wariant niż ogólna metodagetProductType()
w tym przypadku, ponieważ ItestDevice będzie wiedziała, że odzyska urządzenie do fastboot, jeśli urządzenie jest w niepoprawnym stanie lub nie reaguje.Zwroty | |
---|---|
String | Nazwa typu String lub null , jeśli nie można go określić |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetFastbootProductVariant
public String getFastbootProductVariant ()
Metoda wygody, aby uzyskać rodzaj produktu tego urządzenia, gdy jest w trybie Fastboot.
Ta metoda powinna być używana tylko wtedy, gdy urządzenie powinno znajdować się w Fastboot. Jest to nieco bezpieczniejszy wariant niż ogólna metodagetProductType()
w tym przypadku, ponieważ ItestDevice będzie wiedziała, że odzyska urządzenie do fastboot, jeśli urządzenie jest w niepoprawnym stanie lub nie reaguje.Zwroty | |
---|---|
String | Nazwa typu String lub null , jeśli nie można go określić |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetFastbootserialNumber
public String getFastbootSerialNumber ()
Zwraca numer seryjny trybu Fastboot.
Zwroty | |
---|---|
String |
GetFastbootVariable
public String getFastbootVariable (String variableName)
Odzyskaj podaną wartość zmiennej Fastboot z urządzenia.
Parametry | |
---|---|
variableName | String : nazwa zmiennej |
Zwroty | |
---|---|
String | wartość właściwości lub null , jeśli nie istnieje |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetFastbootversion
public String getFastbootVersion ()
Zwraca ciąg wersji używanego binarnego binarnego. Lub null, jeśli coś pójdzie nie tak.
Zwroty | |
---|---|
String |
GetfileEntry
public IFileEntry getFileEntry (String path)
Odzyskaj odniesienie do zdalnego pliku na urządzeniu.
Parametry | |
---|---|
path | String : Ścieżka pliku do odzyskania. Może być bezwzględną ścieżką lub ścieżką względem „/”. (tj. Zarówno podtrzymuje się składnia „/system”, jak i „system”) |
Zwroty | |
---|---|
IFileEntry | nie można znaleźć pliku IFileEntry lub null , jeśli plik na danej path |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetfileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Nieoficjalny pomocnik, aby uzyskać FileEntry
z ścieżki nie-root. FixMe: Refaktor System FileEntry, aby był dostępny na dowolnej ścieżce. (nawet nie root).
Parametry | |
---|---|
entry | FileListingService.FileEntry : FileEntry niekoniecznie root, jak wymaga DDMLIB. |
Zwroty | |
---|---|
IFileEntry | FileEntryWrapper reprezentujący FileEntry. |
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Get FoldableStates
publicgetFoldableStates ()
Zwraca listę składanych stanów na urządzeniu. Można uzyskać za pomocą „CMD Device_State Print States”.
Zwroty | |
---|---|
Rzuca | |
---|---|
DeviceNotAvailableException |
getidevice
public IDevice getIDevice ()
Zwraca odniesienie do powiązanego DDMLIB IDevice
.
IDevice
może być przydzielane przez DDM za każdym razem, gdy urządzenie odłącza się i łączy od ADB. Zatem dzwoniący nie powinni prowadzić odniesienia do IDevice
, ponieważ odniesienie to może stać się przestarzałe.Zwroty | |
---|---|
IDevice | IDevice |
GetInstalledPackagenames
publicgetInstalledPackageNames ()
Pobierz nazwy pakietów aplikacji obecne na urządzeniu.
Zwroty | |
---|---|
ERROR(/Set) nazw pakietów String aktualnie zainstalowanych na urządzeniu. |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetIntProperty
public long getIntProperty (String name, long defaultValue)
Zwraca wartość całkowitą danej właściwości z urządzenia.
Parametry | |
---|---|
name | String : nazwa właściwości |
defaultValue | long : Wartość domyślna do zwrócenia, jeśli właściwość jest pusta lub nie istnieje. |
Zwroty | |
---|---|
long | Wartość właściwości lub defaultValue Jeśli właściwość jest pusta, nie istnieje lub nie ma wartości całkowitej. |
Rzuca | |
---|---|
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 |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetKeyguardState
public KeyguardControllerState getKeyguardState ()
Zwróć obiekt, aby uzyskać bieżący stan Keyguard lub Null, jeśli nie jest to obsługiwane.
Zwroty | |
---|---|
KeyguardControllerState | KeyguardControllerState zawierający migawkę stanu Keyguard i zwraca Null, jeśli zapytanie Keyguard nie jest obsługiwane. |
Rzuca | |
---|---|
DeviceNotAvailableException |
getLastexpecedReboottimemillis
public long getLastExpectedRebootTimeMillis ()
Zwraca ostatnim razem, gdy API handlowe wywołały ponowne uruchomienie w milisekundach od czasu epoków, zgodnie z System.currentTimeMillis()
.
Zwroty | |
---|---|
long |
GetLaunchapilevel
public int getLaunchApiLevel ()
Uzyskaj pierwszy uruchomiony poziom API urządzenia. Domyślnie do UNKNOWN_API_LEVEL
.
Zwroty | |
---|---|
int | liczba całkowita wskazująca pierwszy uruchomiony poziom urządzenia API |
Rzuca | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
Pobiera strumień migawki danych logCAT.
Działa w dwóch trybach:
TestDeviceOptions.getMaxLogcatDataSize()
bajty bieżącej zawartości przechwytywania logowania tłaZwroty | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Pobiera strumień migawki ostatnich maxBytes
danych logcat.
Przydatne w przypadkach, gdy chcesz przechwycić częste migawki przechwyconych danych logcat bez ponoszenia potencjalnie dużej kary w przestrzeni dysku za uzyskanie całej migawki getLogcat()
.
Parametry | |
---|---|
maxBytes | int : Maksymalna ilość danych do zwrócenia. Powinna być ilością, która może wygodnie pasować do pamięci |
Zwroty | |
---|---|
InputStreamSource |
GetLogcatdump
public InputStreamSource getLogcatDump ()
Zdobądź zrzut bieżącego logcatu dla urządzenia. W przeciwieństwie do getLogcat()
, ta metoda zawsze zwraca statyczny zrzut logcata.
Ma wadę, że nic nie zostanie zwrócone, jeśli urządzenie nie jest możliwe do osiągnięcia.
Zwroty | |
---|---|
InputStreamSource | InputStreamSource danych logCat. Pusty strumień jest zwracany, jeśli nie przechwytuje danych logCAT. |
GetLogcatsince
public InputStreamSource getLogcatSince (long date)
Pobiera strumień migawek przechwyconych danych logCAT, począwszy od podanej daty. Czas na urządzeniu powinien być używany getDeviceDate()
.
Parametry | |
---|---|
date | long : w milisekundach od formatu epoki, kiedy rozpocząć migawkę do chwili obecnej. (Można uzyskać za pomocą „Data +%s”) |
Zwroty | |
---|---|
InputStreamSource |
GetMacaddress
public String getMacAddress ()
Zwraca adres MAC urządzenia, NULL, jeśli nie będzie zapytać z urządzenia.
Zwroty | |
---|---|
String |
GetMainuserid
public Integer getMainUserId ()
Zwraca główny identyfikator użytkownika.
Zwroty | |
---|---|
Integer | Userid głównego użytkownika, jeśli taki jest, i NULL, jeśli nie ma głównego użytkownika. |
Rzuca | |
---|---|
DeviceNotAvailableException |
getMainlinemoduleInfo
publicgetMainlineModuleInfo ()
Uzyskaj informacje o modułach głównych zainstalowanych na urządzeniu.
Zwroty | |
---|---|
ERROR(/Set) modułów głównych String aktualnie zainstalowanych na urządzeniu. |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetMaxNumberOfRunningUsersSSSSUPPORTE
public int getMaxNumberOfRunningUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych jednocześnie uruchamiających użytkowników. Wartość domyślna to 0.
Zwroty | |
---|---|
int | liczba całkowita wskazująca liczbę jednocześnie uruchomionych użytkowników |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetMaxNumberOfUsersSSSPORTED
public int getMaxNumberOfUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników. Wartość domyślna to 0.
Zwroty | |
---|---|
int | liczba całkowita wskazująca liczbę obsługiwanych użytkowników |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetMicrodroidProcess
public Process getMicrodroidProcess ()
Zwroty | |
---|---|
Process | Zwraca proces VM Microdroid. Jeśli TestDevice nie jest mikrodroidem, zwraca Null. |
GetMonitor
public IDeviceStateMonitor getMonitor ()
Zwróć IDeviceStateMonitor
powiązany z urządzeniem.
Zwroty | |
---|---|
IDeviceStateMonitor |
GetMountpoint
public String getMountPoint (String mountName)
Zwraca punkt mocowania.
Zapytają urządzenie bezpośrednio, jeśli buforowane informacje wIDevice
nie są dostępne. TODO: przenieś to zachowanie do IDevice#getMountPoint(String)
Parametry | |
---|---|
mountName | String : Nazwa punktu montażu |
Zwroty | |
---|---|
String | punkt montażowy lub null |
GetMountpointinfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Zwraca MountPointInfo
odpowiadające określonej ścieżce Mountpoint lub null
, jeśli ta ścieżka ma nic nie zamontowanego lub w inny sposób nie pojawia się w /Proc /Mounts jako punkt MountPoint.
Parametry | |
---|---|
mountpoint | String |
Zwroty | |
---|---|
ITestDevice.MountPointInfo | ERROR(/List) MountPointInfo zawierający informacje w „/Proc/Mounts” |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetMountpointinfo
publicgetMountPointInfo ()
Zwraca przeanalizowaną wersję informacji w /proc /mocowania na urządzeniu
Zwroty | |
---|---|
ERROR(/List) MountPointInfo zawierający informacje w „/Proc/Mounts” |
Rzuca | |
---|---|
DeviceNotAvailableException |
getoptions
public TestDeviceOptions getOptions ()
Pobierz opcje testowe urządzenia.
Zwroty | |
---|---|
TestDeviceOptions | TestDeviceOptions związane z badanym urządzeniem. |
GetPartitionFreespace
public long getPartitionFreeSpace (String partition)
Metoda pomocnicza do określenia ilości wolnej przestrzeni na partycji urządzeń.
Parametry | |
---|---|
partition | String |
Zwroty | |
---|---|
long | ilość wolnej przestrzeni w KB |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetPrimaryuserid
public Integer getPrimaryUserId ()
Zwraca podstawowy identyfikator użytkownika.
Zwroty | |
---|---|
Integer | Użytkownik głównego użytkownika, jeśli taki jest, i NULL, jeśli nie ma głównego użytkownika. |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetProcessbyName
public ProcessInfo getProcessByName (String processName)
Metoda pomocnika uruchamia polecenie „PIDOF” i „STAT” i zwraca obiekt ProcessInfo
z PID i czas rozpoczęcia procesu danego procesu.
Parametry | |
---|---|
processName | String : String nazwy Procesa. |
Zwroty | |
---|---|
ProcessInfo | ProcessInfo danej nazwy procesów |
Rzuca | |
---|---|
DeviceNotAvailableException |
getProcesSpid
public String getProcessPid (String process)
Zwraca PID usługi lub NULL, jeśli coś poszło nie tak.
Parametry | |
---|---|
process | String : String nazwy Procesa. |
Zwroty | |
---|---|
String |
Rzuca | |
---|---|
DeviceNotAvailableException |
getProductType
public String getProductType ()
Metoda wygody, aby uzyskać rodzaj produktu tego urządzenia.
Ta metoda będzie działać, jeśli urządzenie znajduje się w trybie ADB lub Fastboot.Zwroty | |
---|---|
String | Nazwa typu produktu String . Nie będzie null |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetProductVariant
public String getProductVariant ()
Metoda wygody w celu uzyskania wariantu produktu tego urządzenia.
Ta metoda będzie działać, jeśli urządzenie znajduje się w trybie ADB lub Fastboot.Zwroty | |
---|---|
String | Nazwa String produktu lub null , jeśli nie można go określić |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetProperty
public String getProperty (String name)
Odzyskać daną wartość właściwości z urządzenia.
Parametry | |
---|---|
name | String : nazwa właściwości |
Zwroty | |
---|---|
String | wartość właściwości lub null , jeśli nie istnieje |
Rzuca | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Uzyskaj obecny tryb odzyskiwania używany dla urządzenia.
Zwroty | |
---|---|
ITestDevice.RecoveryMode | Obecny tryb odzyskiwania używany dla urządzenia. |
getcreenshot
public InputStreamSource getScreenshot (String format)
Chwyta zrzut ekranu z urządzenia. Zalecane do użycia getscreenshot (format) zamiast kodowania JPEG dla mniejszych rozmiarów
Parametry | |
---|---|
format | String : obsługiwany PNG, JPEG |
Zwroty | |
---|---|
InputStreamSource | InputStreamSource zrzutu zrzutowego w formacie lub null , jeśli zrzut ekranu nie był powodzeniem. |
Rzuca | |
---|---|
DeviceNotAvailableException |
getcreenshot
public InputStreamSource getScreenshot (long displayId)
Chwyta zrzut ekranu z urządzenia podanego identyfikatora wyświetlania. Format to PNG.
TODO: Rozszerz powyższe wdrożenia, aby obsługiwać „format” i „przeskok”
Parametry | |
---|---|
displayId | long : identyfikator wyświetlania ekranu, z którego można uzyskać zrzut ekranu. |
Zwroty | |
---|---|
InputStreamSource | InputStreamSource zrzutu zrzutowego w formacie lub null , jeśli zrzut ekranu nie był powodzeniem. |
Rzuca | |
---|---|
DeviceNotAvailableException |
getcreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Chwyta zrzut ekranu z urządzenia. Zaleca się użycie getScreenshot(String)
zamiast kodowania JPEG dla mniejszego rozmiaru.
Parametry | |
---|---|
format | String : obsługiwany PNG, JPEG |
rescale | boolean : Jeśli zrzut ekranu powinien zostać przeskalowany w celu zmniejszenia wielkości powstałego obrazu |
Zwroty | |
---|---|
InputStreamSource | InputStreamSource zrzutu zrzutowego w formacie lub null , jeśli zrzut ekranu nie był powodzeniem. |
Rzuca | |
---|---|
DeviceNotAvailableException |
getcreenshot
public InputStreamSource getScreenshot ()
Chwyta zrzut ekranu z urządzenia.
Zwroty | |
---|---|
InputStreamSource | InputStreamSource zrzutu ekranu w formacie PNG, lub null jeśli zrzut ekranu nie był skuteczny. |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetSerialNumber
public String getSerialNumber ()
Metoda wygody uzyskania numeru seryjnego tego urządzenia.
Zwroty | |
---|---|
String | String Numer seryjny |
Getsetting
public String getSetting (int userId, String namespace, String key)
Zwróć wartość żądanego ustawienia. Przestrzeń nazw musi być jednym z: {„system”, „bezpieczny”, „globalny”}
Parametry | |
---|---|
userId | int |
namespace | String |
key | String |
Zwroty | |
---|---|
String | Wartość powiązana z przestrzenią nazw: klucz użytkownika. NULL, jeśli nie znaleziono. |
Rzuca | |
---|---|
DeviceNotAvailableException |
Getsetting
public String getSetting (String namespace, String key)
Zobacz getSetting(int, String, String)
i wykonany na użytkowniku systemu.
Parametry | |
---|---|
namespace | String |
key | String |
Zwroty | |
---|---|
String |
Rzuca | |
---|---|
DeviceNotAvailableException |
getSimoperator
public String getSimOperator ()
Zwróć operator karty SIM lub NULL, jeśli nie jest dostępny lub jeśli urządzenie nie jest dostępne.
Zwroty | |
---|---|
String |
GetimState
public String getSimState ()
Zwróć stan karty SIM lub null, jeśli nie jest dostępne lub urządzenie nie jest dostępne.
Zwroty | |
---|---|
String |
GetTombstones
publicgetTombstones ()
Przyprzyj i zwróć listę nagrobków z urządzeń. Wymaga korzenia.
Metoda jest najlepsza, więc jeśli jeden nagrobek nie zostanie wyciągnięty z jakiegokolwiek powodu, którego brakuje na liście. Tylko DeviceNotAvailableException
wcześniej zakończy metodę.
Zwroty | |
---|---|
Lista plików nagrobka, pusta, jeśli nie ma nagrobka. |
Rzuca | |
---|---|
DeviceNotAvailableException |
gettotalmemory
public long getTotalMemory ()
Zwraca całkowity rozmiar pamięci fizycznej w bajtach lub -1 w przypadku błędu wewnętrznego
Zwroty | |
---|---|
long |
GetUninstallablePackageNames
publicgetUninstallablePackageNames ()
Przyprzyj nazwom pakietów aplikacji, które można odinstalować. Jest to obecnie definiowane jako pakiety inne niż systemy i zaktualizowane pakiety systemowe.
Zwroty | |
---|---|
ERROR(/Set) niezaznażenia nazw opakowań String aktualnie zainstalowanych na urządzeniu. |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetuseSfastbooterase
public boolean getUseFastbootErase ()
Uzyskaj, czy użyć Fastboot Erase, czy Fastboot Format, aby wytrzeć partycję na urządzeniu.
Zwroty | |
---|---|
boolean | true , jeśli zostanie użyte usuwanie fastboot lub false , jeśli zostanie użyty format fastboot. |
Getuserflags
public int getUserFlags (int userId)
Znajdź i zwróć flagi danego użytkownika. Flagi są zdefiniowane w klasie „Android.content.pm.Userinfo” w projekcie Android Open Source.
Parametry | |
---|---|
userId | int |
Zwroty | |
---|---|
int | Flagi powiązane z UserID dostarczone, jeśli zostaną znalezione, -10000 w jakichkolwiek innych przypadkach. |
Rzuca | |
---|---|
DeviceNotAvailableException |
getuserinfos
publicgetUserInfos ()
Pobiera mapę użytkowania do UserInfo
na urządzeniu. Wyrzuci DeviceRuntimeException
, jeśli wyjście z urządzenia nie jest zgodne z oczekiwaniami.
Zwroty | |
---|---|
Lista obiektów UserInfo. |
Rzuca | |
---|---|
DeviceNotAvailableException |
GetuserSerialNumber
public int getUserSerialNumber (int userId)
Zwróć numer seryjny powiązany do użytkownika, jeśli zostanie znaleziony -10000 w jakichkolwiek innych przypadkach.
Parametry | |
---|---|
userId | int |
Zwroty | |
---|---|
int |
Rzuca | |
---|---|
DeviceNotAvailableException |
HandleallocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Przetworzyć podany deviceEvent. Może przejść urządzenie do nowego stanu. Poinformuje IDeviceMonitor
o dowolnych przejściach państwowych.
Przetwarzaj DeviceEvent, który może, ale nie musi przejść tego urządzenia do nowego stanu alokacji.
Parametry | |
---|---|
event | DeviceEvent |
Zwroty | |
---|---|
IManagedTestDevice.DeviceEventResponse |
Hasfeature
public boolean hasFeature (String feature)
Sprawdź, czy funkcja jest dostępna na urządzeniu.
Parametry | |
---|---|
feature | String : Który format powinien być „Funkcja: |
Zwroty | |
---|---|
boolean | Prawda, jeśli zostanie znaleziona funkcja, w przeciwnym razie fałszywe. |
Rzuca | |
---|---|
DeviceNotAvailableException |
instalacja
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu.
Parametry | |
---|---|
packageFile | File : plik APK do zainstalowania |
reinstall | boolean : true , jeśli należy wykonać ponowną instalację |
extraArgs | String : Opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdują się w „ADB Shell PM -H”. |
Zwroty | |
---|---|
String | String z kodem błędu lub null , jeśli sukces. |
Rzuca | |
---|---|
DeviceNotAvailableException |
instalacja
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu.
Uwaga: Tylko przypadki użycia, które wymagają wyraźnej kontroli przyznania uprawnień do wykonania w czasie instalacji, powinny wywołać tę funkcję.
Parametry | |
---|---|
packageFile | File : plik APK do zainstalowania |
reinstall | boolean : true , jeśli należy wykonać ponowną instalację |
grantPermissions | boolean : Jeśli wszystkie uprawnienia do wykonania powinny zostać przyznane w czasie instalacji |
extraArgs | String : Opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdują się w „ADB Shell PM -H”. |
Zwroty | |
---|---|
String | String z kodem błędu lub null , jeśli sukces. |
Rzuca | |
---|---|
DeviceNotAvailableException |
instaltPackageForuser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.
Parametry | |
---|---|
packageFile | File : plik APK do zainstalowania |
reinstall | boolean : true , jeśli należy wykonać ponowną instalację |
userId | int : Identyfikator użytkownika Integer do zainstalowania. |
extraArgs | String : Opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdują się w „ADB Shell PM -H”. |
Zwroty | |
---|---|
String | String z kodem błędu lub null , jeśli sukces. |
Rzuca | |
---|---|
DeviceNotAvailableException |
instaltPackageForuser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.
Uwaga: Tylko przypadki użycia, które wymagają wyraźnej kontroli przyznania uprawnień do wykonania w czasie instalacji, powinny wywołać tę funkcję.
Parametry | |
---|---|
packageFile | File : plik APK do zainstalowania |
reinstall | boolean : true , jeśli należy wykonać ponowną instalację |
grantPermissions | boolean : Jeśli wszystkie uprawnienia do wykonania powinny zostać przyznane w czasie instalacji |
userId | int : Identyfikator użytkownika Integer do zainstalowania. |
extraArgs | String : Opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdują się w „ADB Shell PM -H”. |
Zwroty | |
---|---|
String | String z kodem błędu lub null , jeśli sukces. |
Rzuca | |
---|---|
DeviceNotAvailableException |
InvalidatePropertyCache
public void invalidatePropertyCache ()
ISADBTCP
public boolean isAdbTcp ()
Zwroty | |
---|---|
boolean |
Isappenumerations poparte
public boolean isAppEnumerationSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje wyliczenie aplikacji
Zwroty | |
---|---|
boolean | Prawda Jeśli wyliczenie aplikacji jest obsługiwane, w przeciwnym razie Fałsz inaczej |
Rzuca | |
---|---|
DeviceNotAvailableException |
ISBYPASSLOWTARGETSDKBLOCKSUPPORTED
public boolean isBypassLowTargetSdkBlockSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje omijanie niskiego docelowego bloku SDK w instalacjach aplikacji
Zwroty | |
---|---|
boolean | Prawda Jeśli obsługiwana jest pomostanie bloku SDK docelowego, Fałsz inaczej |
Rzuca | |
---|---|
DeviceNotAvailableException |
isdeviceEncrypted
public boolean isDeviceEncrypted ()
Zwraca, jeśli urządzenie jest zaszyfrowane.
Zwroty | |
---|---|
boolean | true , jeśli urządzenie jest zaszyfrowane. |
Rzuca | |
---|---|
DeviceNotAvailableException |
isdirectory
public boolean isDirectory (String path)
Zwróć true, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie Fałsz.
Parametry | |
---|---|
path | String |
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
Isenableadbroot
public boolean isEnableAdbRoot ()
Zwroty | |
---|---|
boolean | true , jeśli root ADB powinien być włączony na urządzeniu |
isEncryptionSupport
public boolean isEncryptionSupported ()
Zwraca, jeśli szyfrowanie jest obsługiwane na urządzeniu.
Zwroty | |
---|---|
boolean | true , jeśli urządzenie obsługuje szyfrowanie. |
Rzuca | |
---|---|
DeviceNotAvailableException |
IsExecutable
public boolean isExecutable (String fullPath)
Zwraca true, jeśli ścieżka pliku na urządzeniu jest plikiem wykonywalnym, w przeciwnym razie False.
Parametry | |
---|---|
fullPath | String |
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
isfastbootenabled
public boolean isFastbootEnabled ()
Zwróć, jeśli fastboot jest dostępny dla urządzenia.
Zwroty | |
---|---|
boolean |
Isheadless
public boolean isHeadless ()
Zwróć true, jeśli urządzenie jest bezgłowe (bez ekranu), w przeciwnym razie fałszywe.
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
isheadSsystemSermode
public boolean isHeadlessSystemUserMode ()
Zwraca, czy urządzenie używa trybu użytkownika systemu bezgłowego.
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
IsmainuserPerManentAdmin
public boolean isMainUserPermanentAdmin ()
Zwraca, czy głównym użytkownikiem jest stały administrator i nie można go usunąć ani obniżyć do statusu bez admin.
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
IsmultiuseSersed
public boolean isMultiUserSupported ()
Określa, czy obsługiwany jest wielu użytkowników.
Zwroty | |
---|---|
boolean | Prawda, jeśli obsługiwane jest wielu użytkowników, w przeciwnym razie Fałsz inaczej |
Rzuca | |
---|---|
DeviceNotAvailableException |
ISPACKAGEINSTALLED
public boolean isPackageInstalled (String packageName, String userId)
Zapytaj urządzenie pod kątem nazwy pakietu i podanego identyfikatora użytkownika, aby sprawdzić, czy jest on obecnie zainstalowany, czy nie dla tego użytkownika.
Parametry | |
---|---|
packageName | String : Pakiet, który sprawdzamy, czy jest zainstalowany. |
userId | String : Identyfikator użytkownika, dla którego sprawdzamy pakiet, jest zainstalowany. Jeśli NULL, zostanie użyty zero podstawowego użytkownika. |
Zwroty | |
---|---|
boolean | To prawda, że pakiet jest zgłaszany jako zainstalowany. Inaczej nieprawda. |
Rzuca | |
---|---|
DeviceNotAvailableException |
ISPACKAGEINSTALLED
public boolean isPackageInstalled (String packageName)
Zapytaj urządzenie pod daną nazwą pakietu, aby sprawdzić, czy jest on aktualnie zainstalowany, czy nie.
Parametry | |
---|---|
packageName | String |
Zwroty | |
---|---|
boolean | To prawda, że pakiet jest zgłaszany jako zainstalowany. Inaczej nieprawda. |
Rzuca | |
---|---|
DeviceNotAvailableException |
IsruntimePermissionsionsed
public boolean isRuntimePermissionSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje pozwolenie na wykonanie czasu wykonywania
Zwroty | |
---|---|
boolean | To prawda, że uprawnienie czasu wykonawczego jest obsługiwane, w przeciwnym razie Fałsz. |
Rzuca | |
---|---|
DeviceNotAvailableException |
isStateBootloaderORORFastbootd
public boolean isStateBootloaderOrFastbootd ()
Zwraca prawdziwie, jeśli urządzenie jest w TestDeviceState#FASTBOOT
lub TestDeviceState.FASTBOOTD
.
Zwroty | |
---|---|
boolean |
isuserrunning
public boolean isUserRunning (int userId)
Sprawdź, czy uruchomiony jest dany użytkownik.
Parametry | |
---|---|
userId | int |
Zwroty | |
---|---|
boolean | To prawda, że użytkownik działa, fałszywy w każdym innym przypadku. |
Rzuca | |
---|---|
DeviceNotAvailableException |
Isusersecondary
public boolean isUserSecondary (int userId)
Zwróć, czy określony użytkownik jest użytkownikiem wtórnym zgodnie z jego flagami.
Parametry | |
---|---|
userId | int |
Zwroty | |
---|---|
boolean | To prawda, że użytkownik jest drugorzędny, w przeciwnym razie fałsz. |
Rzuca | |
---|---|
DeviceNotAvailableException |
isuservivible
public boolean isUserVisible (int userId)
Sprawdź, czy dany użytkownik jest widoczny.
„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z użytkownikiem „ludzkim”, a zatem może uruchomić działania uruchamiające (zazwyczaj na domyślnym wyświetlaczu).
Parametry | |
---|---|
userId | int |
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
IsUservisibleondisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Sprawdź, czy dany użytkownik jest widoczny na danym wyświetlaczu.
„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z użytkownikiem „ludzkim”, a zatem może uruchomić działania uruchamiające na tym wyświetlaczu.
Parametry | |
---|---|
userId | int |
displayId | int |
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
IsvisibleBackgroundUsSondefaultDisPlaysported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Zwraca, czy urządzenie pozwala użytkownikom być widocznym w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
Jeśli tak, możesz zadzwonić do startVisibleBackgroundUser(int, int, boolean)
, przekazanie wyświetlacza zwróconego przez listDisplayIdsForStartingVisibleBackgroundUsers()
(który powinien zawierać ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
IsvisibleBackgroundUsersSsuse
public boolean isVisibleBackgroundUsersSupported ()
Zwraca, czy urządzenie pozwala użytkownikom być widocznym w tle.
Jeśli tak, możesz zadzwonić do startVisibleBackgroundUser(int, int, boolean)
, przekazując wyświetlacz zwrócony przez listDisplayIdsForStartingVisibleBackgroundUsers()
.
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
Iswifienabled
public boolean isWifiEnabled ()
Test, jeśli WIFI jest włączone.
Sprawdza, czy Wi -Fi jest włączone na urządzeniu. Przydatne do stwierdzenia statusu Wi -Fi przed testami, które nie powinny działać z Wi -Fi, np. Mobile Data Tests.Zwroty | |
---|---|
boolean | true , jeśli WIFI jest włączone. false jeśli wyłączony |
Rzuca | |
---|---|
DeviceNotAvailableException |
ListDisplayids
publiclistDisplayIds ()
Zbierz listę dostępnych wyświetlaczy na urządzeniu, jak podano „DUMPSYS SurfaceFlinger”.
Zwroty | |
---|---|
Lista wyświetlaczy. Domyślnie zawsze zwraca domyślny wyświetlacz 0. |
Rzuca | |
---|---|
DeviceNotAvailableException |
ListDisplayidsforStartingVisibleBackgroundusers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Pobiera listę wyświetlaczy, których można użyć do start a user visible in the background
.
Zwroty | |
---|---|
Rzuca | |
---|---|
DeviceNotAvailableException |
Listusers
publiclistUsers ()
Pobiera listę użytkowników na urządzeniu. Wyrzuci DeviceRuntimeException
, jeśli wyjście z urządzenia nie jest zgodne z oczekiwaniami.
Zwroty | |
---|---|
Lista identyfikatorów użytkowników. |
Rzuca | |
---|---|
DeviceNotAvailableException |
Loganrs
public boolean logAnrs (ITestLogger logger)
Zbiera i rejestruje ANR z urządzenia.
Parametry | |
---|---|
logger | ITestLogger : ITestLogger do rejestrowania ANR. |
Zwroty | |
---|---|
boolean | To prawda, że jeśli rejestrowanie zakończyło się powodzeniem, w przeciwnym razie fałsz. |
Rzuca | |
---|---|
DeviceNotAvailableException |
Logbugreport
public boolean logBugreport (String dataName, ITestLogger listener)
Metoda pomocnicza, aby wziąć raport błędu i zalogować go do reporterów.
Parametry | |
---|---|
dataName | String : Nazwa, pod którą raport Bugreport zostanie zgłoszony. |
listener | ITestLogger : ITestLogger do rejestrowania raportu Bugreport. |
Zwroty | |
---|---|
boolean | To prawda, że jeśli rejestrowanie zakończyło się powodzeniem, w przeciwnym razie fałsz. |
logondevice
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Zaloguj komunikat w logucie urządzenia. Jest to bezpieczne połączenie, które nie rzuci się, nawet jeśli logowanie się nie powiedzie.
Parametry | |
---|---|
tag | String : Tag, pod którym rejestrujemy nasz komunikat w logCat. |
level | Log.LogLevel : Poziom debugowania wiadomości w logCat. |
format | String : Format wiadomości. |
args | Object : Args, który ma zostać zastąpiony przez String.Format (). |
Non -BlockingReboot
public void nonBlockingReboot ()
Wydają polecenie ponownego uruchomienia urządzenia i zwraca na polecenie, a gdy urządzenie nie jest już widoczne dla ADB.
Rzuca | |
---|---|
DeviceNotAvailableException |
PostAdbrootaction
public void postAdbRootAction ()
Zastąp, jeśli urządzenie potrzebuje określonych działań, które należy podjąć po korzeni ADB i zanim urządzenie wróci do Internetu. Domyślna implementacja nie obejmuje żadnych działań dodatkowych. Korzeń ADB nie gwarantuje włączenia na tym etapie.
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PostAdbunrootAction
public void postAdbUnrootAction ()
Zastąp, jeśli urządzenie potrzebuje określonych działań, które należy podjąć po ADB UNOROT i zanim urządzenie wróci do Internetu. Domyślna implementacja nie obejmuje żadnych dodatkowych działań. Na tym etapie nie gwarantuje, że root ADB nie jest wyłączony.
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Postbootstetup
public void postBootSetup ()
Wykonaj instrukcje, aby skonfigurować urządzenie do testowania tego po każdym rozruchu.
Należy wywołać po tym, jak urządzenie jest w pełni uruchomione/dostępne W normalnych okolicznościach ta metoda nie musi być nazywana jawnie, ponieważ implementacje powinny wykonywać te kroki automatycznie podczas wykonania ponownego uruchomienia. Tam, gdzie konieczne jest wywołanie, gdy urządzenie uruchom ponownie z powodu innych zdarzeń (np. Po zakończeniu polecenia aktualizacji Fastboot)Rzuca | |
---|---|
DeviceNotAvailableException |
PostinvocationTowndown
public void postInvocationTearDown (Throwable exception)
Dodatkowe kroki dla wymaganego oczyszczania dla urządzenia, które zostaną wykonane po zakończeniu.
Parametry | |
---|---|
exception | Throwable : Jeśli w ogóle, ostateczny wyjątek podniesiony przez awarię wywołania. |
PreinvocationsEtup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Dodatkowe kroki dla wymaganej konfiguracji dla urządzenia, które zostaną wykonane na urządzeniu przed przepływem wywołania.
Parametry | |
---|---|
info | IBuildInfo : IBuildInfo urządzenia. |
attributes | MultiMap : atrybuty przechowywane w kontekście inwokacji |
Rzuca | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
pulldir
public boolean pullDir (String deviceFilePath, File localDir)
Rekurencyjnie ciągnij zawartość katalogu z urządzenia.
Parametry | |
---|---|
deviceFilePath | String : bezwzględna ścieżka pliku zdalnego źródła |
localDir | File : lokalny katalog do pobrania plików |
Zwroty | |
---|---|
boolean | true , że plik został pomyślnie pobrany. inaczej false . |
Rzuca | |
---|---|
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 zawartości. Jeśli nie jest puste, zawartość zostanie zastąpiona. |
Zwroty | |
---|---|
boolean | true , jeśli plik został pomyślnie pobrany. inaczej false . |
Rzuca | |
---|---|
DeviceNotAvailableException |
Pullfile
public File pullFile (String remoteFilePath, int userId)
Pobiera plik z urządzenia, przechowuje go w lokalnym ERROR(/File)
i zwraca ten File
.
Parametry | |
---|---|
remoteFilePath | String : Bezwzględna ścieżka do pliku na urządzeniu. |
userId | int : identyfikator użytkownika, z którego można wyciągnąć |
Zwroty | |
---|---|
File | ERROR(/File) zawierający zawartość pliku urządzenia lub null , jeśli kopia nie powiodła się z jakiegokolwiek powodu (w tym problemy z systemem plików hosta) |
Rzuca | |
---|---|
DeviceNotAvailableException |
Pullfile
public File pullFile (String remoteFilePath)
Pobiera plik z urządzenia, przechowuje go w lokalnym ERROR(/File)
i zwraca ten File
.
Parametry | |
---|---|
remoteFilePath | String : Bezwzględna ścieżka do pliku na urządzeniu. |
Zwroty | |
---|---|
File | ERROR(/File) zawierający zawartość pliku urządzenia lub null , jeśli kopia nie powiodła się z jakiegokolwiek powodu (w tym problemy z systemem plików hosta) |
Rzuca | |
---|---|
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 zawartości. Jeśli nie jest puste, zawartość zostanie zastąpiona. |
userId | int : identyfikator użytkownika, z którego można wyciągnąć |
Zwroty | |
---|---|
boolean | true , jeśli plik został pomyślnie pobrany. inaczej false . |
Rzuca | |
---|---|
DeviceNotAvailableException |
PullfileContents
public String pullFileContents (String remoteFilePath)
Pobiera plik z urządzenia i zwraca zawartość.
Parametry | |
---|---|
remoteFilePath | String : Bezwzględna ścieżka do pliku na urządzeniu. |
Zwroty | |
---|---|
String | A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Rzuca | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File)
, and return a reference to that File
.
Parametry | |
---|---|
remoteFilePath | String : the path to file on device, relative to the device's external storage mountpoint |
Zwroty | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Rzuca | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Recursively push directory contents to device while excluding some directories that are filtered.
Parametry | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
excludedDirectories |
Zwroty | |
---|---|
boolean | true if file was pushed successfully. inaczej false . |
Rzuca | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Recursively push directory contents to device.
Parametry | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
Zwroty | |
---|---|
boolean | true if file was pushed successfully. inaczej false . |
Rzuca | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variant of pushFile(File, String)
which can optionally consider evaluating the need for the content provider.
Parametry | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
evaluateContentProviderNeeded | boolean : whether to check if we need the content provider |
Zwroty | |
---|---|
boolean | true if file was pushed successfully. inaczej false . |
Rzuca | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath)
Push a file to device. By default using a content provider.
Parametry | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
Zwroty | |
---|---|
boolean | true if file was pushed successfully. inaczej false . |
Rzuca | |
---|---|
DeviceNotAvailableException |
pushString
public boolean pushString (String contents, String remoteFilePath)
Push file created from a string to device
Parametry | |
---|---|
contents | String : the contents of the file to push |
remoteFilePath | String : the remote destination absolute file path |
Zwroty | |
---|---|
boolean | true if string was pushed successfully. inaczej false . |
Rzuca | |
---|---|
DeviceNotAvailableException |
ponowne uruchomienie
public void reboot (String reason)
Reboots the device into adb mode with given reason
to be persisted across reboot.
Blocks until device becomes available.
Last reboot reason can be obtained by querying sys.boot.reason
propety.
Parametry | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Rzuca | |
---|---|
DeviceNotAvailableException |
ponowne uruchomienie
public void reboot ()
Reboots the device into adb mode.
Blocks until device becomes available.Rzuca | |
---|---|
DeviceNotAvailableException |
rebootIntoBootloader
public void rebootIntoBootloader ()
Reboots the device into bootloader mode.
Blocks until device is in bootloader mode.Rzuca | |
---|---|
DeviceNotAvailableException |
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Reboots the device into fastbootd mode.
Blocks until device is in fastbootd mode.
Rzuca | |
---|---|
DeviceNotAvailableException |
rebootIntoRecovery
public void rebootIntoRecovery ()
Reboots the device into adb recovery mode.
Blocks until device enters recoveryRzuca | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload ()
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Rzuca | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Parametry | |
---|---|
autoReboot | boolean : whether to automatically reboot the device after sideload |
Rzuca | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline ()
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Rzuca | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline (String reason)
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Parametry | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Rzuca | |
---|---|
DeviceNotAvailableException |
rebootUserspace
public void rebootUserspace ()
Reboots only userspace part of device.
Blocks until device becomes available.
OSTRZEŻENIE. Userspace reboot is currently under active development, use it on your own risk.
Rzuca | |
---|---|
DeviceNotAvailableException |
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
An alternate to rebootUserspace()
()} that only blocks until device is online ie visible to adb.
Rzuca | |
---|---|
DeviceNotAvailableException |
odzyskać urządzenie
public boolean recoverDevice ()
Attempts to recover device communication.
Zwroty | |
---|---|
boolean | True if recovery attempted and successful, returns False if recovery was skipped |
Rzuca | |
---|---|
DeviceNotAvailableException | if device is no longer available |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registers a IDeviceActionReceiver
for this device.
All registered IDeviceActionReceiver
s will be notified before a device action starts and after the device action ends.
Parametry | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : A IDeviceActionReceiver which will be registered. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Make the system partition on the device read-only. May reboot the device.
Rzuca | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Make the system partition on the device writable. May reboot the device.
Rzuca | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
Make the vendor partition on the device read-only. May reboot the device.
Rzuca | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
Make the vendor partition on the device writable. May reboot the device.
Rzuca | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
Remove given device admin in given user and return true
if it is successful, false
otherwise.
Parametry | |
---|---|
componentName | String : of device admin to be removed. |
userId | int : of user that the device admin lives in. |
Zwroty | |
---|---|
boolean | True if it is successful, false otherwise. |
Rzuca | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Remove all existing device profile owners with the best effort.
Rzuca | |
---|---|
DeviceNotAvailableException |
removeUser
public boolean removeUser (int userId)
Remove a given user from the device.
Parametry | |
---|---|
userId | int : of the user to remove |
Zwroty | |
---|---|
boolean | true if we were successful in removing the user, false otherwise. |
Rzuca | |
---|---|
DeviceNotAvailableException |
resetContentProviderSetup
public void resetContentProviderSetup ()
Reset the flag for content provider setup in order to trigger it again.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
with one or more listeners passed as parameters.
Parametry | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners | ITestLifeCycleReceiver : the test result listener(s) |
Zwroty | |
---|---|
boolean | true if test command completed. false if it failed to complete, but recovery succeeded |
Rzuca | |
---|---|
DeviceNotAvailableException |
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Runs instrumentation tests, and provides device recovery.
If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.
If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.
Parametry | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners |
Zwroty | |
---|---|
boolean | true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded |
Rzuca | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
but runs the test for the given user.
Parametry | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
but runs the test for a given user.
Parametry | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
ustaw konfigurację
public void setConfiguration (IConfiguration configuration)
Wstrzykuje używaną IConfiguration
.
Parametry | |
---|---|
configuration | IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Parametry | |
---|---|
avdInfo | GceAvdInfo |
ustawić datę
public void setDate (Date date)
Sets the date on device
Note: setting date on device requires root
Parametry | |
---|---|
date | Date : specify a particular date; will use host date if null |
Rzuca | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
Set a device admin component as device owner in given user.
Parametry | |
---|---|
componentName | String : of device admin to be device owner. |
userId | int : of the user that the device owner lives in. |
Zwroty | |
---|---|
boolean | True if it is successful, false otherwise. |
Rzuca | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Update the device's state.
Parametry | |
---|---|
deviceState | TestDeviceState : the TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
For emulator set SizeLimitedOutputStream
to log output
Parametry | |
---|---|
output | SizeLimitedOutputStream : to log the output |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Sets the Process
, when this device is an emulator.
Parametry | |
---|---|
p | Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Set the fastboot option for the device. Should be set when device is first allocated.
Parametry | |
---|---|
fastbootEnabled | boolean : whether fastboot is available for the device or not |
ustawFastbootPath
public void setFastbootPath (String fastbootPath)
Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled()
to be true, to have fastboot functions enabled.
Parametry | |
---|---|
fastbootPath | String |
setIDevice
public void setIDevice (IDevice newDevice)
Update the IDevice associated with this ITestDevice.
The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDeviceParametry | |
---|---|
newDevice | IDevice : the IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Sets the time in ms to wait before starting logcat capture for a online device.
Parametry | |
---|---|
delay | int : the delay in ms |
setOptions
public void setOptions (TestDeviceOptions options)
Set the TestDeviceOptions
for the device
Parametry | |
---|---|
options | TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
Sets the given property value on the device. Requires adb root is true.
Parametry | |
---|---|
propKey | String : The key targeted to be set. |
propValue | String : The property value to be set. |
Zwroty | |
---|---|
boolean | returns True if the setprop command was successful, False otherwise. |
Rzuca | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Set the IDeviceRecovery
to use for this device. Should be set when device is first allocated.
Parametry | |
---|---|
recovery | IDeviceRecovery : the IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Set the current recovery mode to use for the device.
Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etcParametry | |
---|---|
mode | ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not. |
setSetting
public void setSetting (String namespace, String key, String value)
See setSetting(int, String, String, String)
and performed on system user.
Parametry | |
---|---|
namespace | String |
key | String |
value | String |
Rzuca | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}
Parametry | |
---|---|
userId | int |
namespace | String |
key | String |
value | String |
Rzuca | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Injects the ITestLogger
instance
Parametry | |
---|---|
testLogger | ITestLogger |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
Set whether to use fastboot erase or fastboot format to wipe a partition on the device.
Parametry | |
---|---|
useFastbootErase | boolean : true if fastboot erase should be used or false if fastboot format should be used. |
startLogcat
public void startLogcat ()
Start capturing logcat output from device in the background.
Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat. When the device is no longer in use,stopLogcat()
must be called. startLogcat()
and stopLogcat()
do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat. startUser
public boolean startUser (int userId)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.
Parametry | |
---|---|
userId | int : of the user to start in the background |
Zwroty | |
---|---|
boolean | true if the user was successfully started in the background. |
Rzuca | |
---|---|
DeviceNotAvailableException |
startUser
public boolean startUser (int userId, boolean waitFlag)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.
Parameters | |
---|---|
userId | int : of the user to start in the background |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Zwroty | |
---|---|
boolean | true if the user was successfully started in the background. |
Rzuca | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).
NOTE: this command doesn't check if the user exists, display is available, device supports such feature
, etc.
Parameters | |
---|---|
userId | int : of the user to start in the background |
displayId | int : display to start user visible on |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Zwroty | |
---|---|
boolean | true if the user was successfully started visible in the background. |
Rzuca | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Close and delete the emulator output.
stopLogcat
public void stopLogcat ()
Stop capturing logcat output from device, and discard currently saved logcat data.
Will have no effect if logcat output is not being captured.stopUser
public boolean stopUser (int userId)
Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.
Parameters | |
---|---|
userId | int : of the user to stop. |
Zwroty | |
---|---|
boolean | true if the user was successfully stopped. |
Rzuca | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.
Parameters | |
---|---|
userId | int : of the user to stop. |
waitFlag | boolean : will make the command wait until user is stopped. |
forceFlag | boolean : will force stop the user. |
Zwroty | |
---|---|
boolean | true if the user was successfully stopped. |
Rzuca | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public String switchToAdbTcp ()
Switch device to adb-over-tcp mode.
Zwroty | |
---|---|
String | the tcp serial number or null if device could not be switched |
Rzuca | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Switch device to adb over usb mode.
Zwroty | |
---|---|
boolean | true if switch was successful, false otherwise. |
Rzuca | |
---|---|
DeviceNotAvailableException |
Zmień użytkownika
public boolean switchUser (int userId)
Switch to another userId with a default timeout. switchUser(int, long)
.
Parametry | |
---|---|
userId | int |
Zwroty | |
---|---|
boolean | True if the new userId matches the userId provider. Inaczej nieprawda. |
Rzuca | |
---|---|
DeviceNotAvailableException |
Zmień użytkownika
public boolean switchUser (int userId, long timeout)
Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.
Parameters | |
---|---|
userId | int |
timeout | long : to wait before returning false for switch-user failed. |
Zwroty | |
---|---|
boolean | True if the new userId matches the userId provider. Inaczej nieprawda. |
Rzuca | |
---|---|
DeviceNotAvailableException |
syncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
Incrementally syncs the contents of a local file directory to device.
Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date. Hidden files (with names starting with ".") will be ignored. Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.Parameters | |
---|---|
localFileDir | File : the local file directory containing files to recursively push. |
deviceFilePath | String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail |
Zwroty | |
---|---|
boolean | true if files were synced successfully. inaczej false . |
Rzuca | |
---|---|
DeviceNotAvailableException |
takeBugreport
public Bugreport takeBugreport ()
Take a bugreport and returns it inside a Bugreport
object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close()
.
Zwroty | |
---|---|
Bugreport |
uninstallPackage
public String uninstallPackage (String packageName)
Uninstall an Android package from device.
Parameters | |
---|---|
packageName | String : the Android package to uninstall |
Zwroty | |
---|---|
String | a String with an error code, or null if success. |
Rzuca | |
---|---|
DeviceNotAvailableException |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
Uninstall an Android package from device for a given user.
Parameters | |
---|---|
packageName | String : the Android package to uninstall |
userId | int : the integer user id to uninstall for. |
Zwroty | |
---|---|
String | a String with an error code, or null if success. |
Rzuca | |
---|---|
DeviceNotAvailableException |
unlockDevice
public boolean unlockDevice ()
Unlocks the device if the device is in an encrypted state.
This method may restart the framework but will not callpostBootSetup()
. Therefore, the device might not be fully ready to be tested when this method returns.Zwroty | |
---|---|
boolean | true if successful or if the device is unencrypted. |
Rzuca | |
---|---|
DeviceNotAvailableException |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Blocks until the device's boot complete flag is set.
Parameters | |
---|---|
timeOut | long : time in msecs to wait for the flag to be set |
Zwroty | |
---|---|
boolean | true if device's boot complete flag is set within the timeout |
Rzuca | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Waits for the device to be responsive and available for testing. Uses default timeout.
Zwroty | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Rzuca | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Waits for the device to be responsive and available for testing.
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Zwroty | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Rzuca | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Waits for the device to be responsive and available without considering recovery path.
Parameters | |
---|---|
waitTime | long |
Zwroty | |
---|---|
boolean | True if device is available, False if unavailable. |
Rzuca | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Blocks until device is visible via fastboot. Use default timeout.
Rzuca | |
---|---|
DeviceNotAvailableException |
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery
).
Parametry | |
---|---|
waitTime | long : the time in ms to wait |
Zwroty | |
---|---|
boolean | true if device boots into recovery before time expires. false otherwise |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blocks for the device to be in the 'adb sideload' state
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Zwroty | |
---|---|
boolean | true if device boots into sideload before time expires. false otherwise |
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Blocks for the device to be not available ie missing from adb
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Zwroty | |
---|---|
boolean | true if device becomes not available before time expires. false otherwise |
waitForDeviceOnline
public void waitForDeviceOnline ()
Blocks until device is visible via adb. Uses default timeout
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Rzuca | |
---|---|
DeviceNotAvailableException |
waitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
Blocks until device is visible via adb.
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Rzuca | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Waits for device to be responsive to a basic adb shell command.
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Zwroty | |
---|---|
boolean | true if device becomes responsive before waitTime elapses. |
Metody chronione
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parameters | |
---|---|
builder | DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Builds the OS command for the given adb shell command session and args
Parameters | |
---|---|
command | String |
forceExitStatusDetection | boolean |
Zwroty | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parameters | |
---|---|
feature | String |
strictMinLevel | int |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Create a RebootDeviceAction
to be used when performing a reboot action.
Parameters | |
---|---|
rebootMode | NativeDevice.RebootMode : a mode of this reboot. |
reason | String : for this reboot. |
Zwroty | |
---|---|
NativeDevice.RebootDeviceAction | the created RebootDeviceAction . |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Perform a adb reboot.
Parameters | |
---|---|
rebootMode | NativeDevice.RebootMode : a mode of this reboot. |
reason | String : for this reboot. |
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
helper method to throw exception if runtime permission isn't supported
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Zwroty | |
---|---|
int |
initializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parameters | |
---|---|
info | IBuildInfo |
attributes | MultiMap |
Rzuca | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
internalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.
Parameters | |
---|---|
propName | String : The name of the device property as returned by `adb shell getprop` |
fastbootVar | String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted |
description | String : A simple description of the variable. First letter should be capitalized. |
Zwroty | |
---|---|
String | A string, possibly null or empty, containing the value of the given property |
Rzuca | |
---|---|
DeviceNotAvailableException |
isInRebootCallback
protected boolean isInRebootCallback ()
Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.
Zwroty | |
---|---|
boolean |
isNewer
protected boolean isNewer (File localFile, IFileEntry entry)
Return true
if local file is newer than remote file. IFileEntry
being accurate to the minute, in case of equal times, the file will be considered newer.
Parameters | |
---|---|
localFile | File |
entry | IFileEntry |
Zwroty | |
---|---|
boolean |
notifyRebootEnded
protected void notifyRebootEnded ()
Notifies all IDeviceActionReceiver
about reboot end event.
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notifyRebootStarted
protected void notifyRebootStarted ()
Notifies all IDeviceActionReceiver
about reboot start event.
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
performDeviceAction
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Performs an action on this device. Attempts to recover device and optionally retry command if action fails.
Parametry | |
---|---|
actionDescription | String : a short description of action to be performed. Used for logging purposes only. |
action | NativeDevice.DeviceAction : the action to be performed |
retryAttempts | int : the retry attempts to make for action if it fails but recovery succeeds |
Zwroty | |
---|---|
boolean | true if action was performed successfully |
Rzuca | |
---|---|
DeviceNotAvailableException | if recovery attempt fails or max attempts done without success |
postAdbReboot
protected void postAdbReboot ()
Possible extra actions that can be taken after a reboot.
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
prePostBootSetup
protected void prePostBootSetup ()
Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.
Rzuca | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parameters | |
---|---|
remoteFilePath | String |
localFile | File |
Zwroty | |
---|---|
boolean |
Rzuca | |
---|---|
DeviceNotAvailableException |
Ustaw zegarek
protected void setClock (Clock clock)
Set the Clock instance to use.
Parameters | |
---|---|
clock | Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Marks the TestDevice as microdroid and sets its CID.
Parameters | |
---|---|
process | Process : Process of the Microdroid VM. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Parameters | |
---|---|
deviceOptions |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Executes a simple fastboot command with environment variables and report the status of the command.
Parameters | |
---|---|
timeout | long |
envVarMap | |
fullCmd | String |
Zwroty | |
---|---|
CommandResult |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Executes a simple fastboot command and report the status of the command.
Parameters | |
---|---|
timeout | long |
fullCmd | String |
Zwroty | |
---|---|
CommandResult |
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Wait to see the device going unavailable (stop reporting to adb).
Parameters | |
---|---|
operationDesc | String : The name of the operation that is waiting for unavailable. |
time | long : The time to wait for unavailable to occur. |
Zwroty | |
---|---|
boolean | True if device did become unavailable. |
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2023-12-01 UTC.