Urządzenie natywne
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
| java.lang.Object | |
| ↳ | com.android.tradefed.device.NativeDevice |
Domyślna implementacja na ITestDevice urządzeniach z Androidem, które nie obsługują pełnego stosu.
Podsumowanie
Zagnieżdżone klasy | |
|---|---|
class |
NativeDevice.AdbAction
|
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Stałe | |
|---|---|
String |
DEBUGFS_PATH
|
int |
INVALID_USER_ID
Wartość zwracana w przypadku nieprawidłowego lub nieznalezionego identyfikatora użytkownika: UserHandle zdefiniował wartość -10000 |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
domyślna liczba ponownych prób wykonania polecenia, |
String |
SD_CARD
|
String |
STORAGE_EMULATED
|
Fieldsem | |
|---|---|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Publiczne konstruktory | |
|---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Tworzy |
|
Metody publiczne | |
|---|---|
void
|
batchPrefetchStartupBuildProps()
Mikrooptymalizacja (ok. 400 ms) polegająca na wstępnym pobieraniu wszystkich potrzebnych właściwości zamiast wywoływania polecenia „adb getprop” dla każdej z nich. |
boolean
|
canSwitchToHeadlessSystemUser()
Zwraca informację, czy można przełączyć się na użytkownika SYSTEM bez interfejsu graficznego. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Sprawdź, czy funkcja jest obecnie obsługiwana na minimalnym poziomie obsługi. |
boolean
|
checkConnectivity()
Sprawdź, czy urządzenie ma połączenie z siecią. |
boolean
|
clearErrorDialogs()
Próba zamknięcia wszystkich okien dialogowych z błędami, które są obecnie wyświetlane w interfejsie urządzenia. |
void
|
clearLastConnectedWifiNetwork()
Usuwa ostatnią połączoną sieć Wi-Fi. |
void
|
clearLogcat()
Usuwa wszystkie zgromadzone dane logcat. |
boolean
|
connectToWifiNetwork(
Łączy się z siecią Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Łączy się z siecią Wi-Fi. |
boolean
|
connectToWifiNetwork(
Łą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 danej nazwie i z podanymi flagami. |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Utwórz użytkownika o danej nazwie i z podanymi flagami. |
int
|
createUser(String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0. |
int
|
createUserNoThrow(String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0. |
DeviceInspectionResult
|
debugDeviceNotAvailable()
sprawdzanie urządzenia i zwracanie szczegółowych informacji, gdy urządzenie staje się niedostępne; |
void
|
deleteFile(String deviceFilePath, int userId)
Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu. |
void
|
deleteFile(String deviceFilePath)
Metoda pomocnicza 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 ponownie uruchomione przez porównanie bieżącego serwera systemowego z poprzednim serwerem systemowym |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione od czasu UTC od początku epoki z urządzenia i jego |
boolean
|
disableAdbRoot()
Wyłącza uprawnienia roota adb. |
void
|
disableKeyguard()
próby wyłączenia ochrony 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 do określania, czy plik na urządzeniu istnieje dla danego użytkownika. |
boolean
|
doesFileExist(String deviceFilePath)
Metoda pomocnicza do sprawdzania, czy plik istnieje na urządzeniu. |
File
|
dumpHeap(String process, String devicePath)
Spróbuj zrzucić stertę z procesu system_server. |
boolean
|
enableAdbRoot()
Włącza uprawnienia roota ADB. |
boolean
|
enableNetworkMonitor()
Włącza monitorowanie sieci na urządzeniu. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania. |
String
|
executeAdbCommand(long timeout,
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania. |
String
|
executeAdbCommand(String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe. |
CommandResult
|
executeAdbV2Command(String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe. |
CommandResult
|
executeAdbV2Command(long timeout, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania. |
CommandResult
|
executeAdbV2Command(long timeout,
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe. |
CommandResult
|
executeLongFastbootCommand(
Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe ze zmiennymi środowiskowymi systemu. |
String
|
executeShellCommand(String command)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca dane wyjściowe jako |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Wykonuje podane polecenie powłoki adb, ponawiając je wielokrotnie, jeśli się nie powiedzie. |
CommandResult
|
executeShellV2Command(String cmd)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
CommandResult
|
fastbootWipePartition(String partition)
Metoda pomocnicza, która czyści partycję urządzenia. |
|
getActiveApexes()
Pobiera informacje o pakietach APEX aktywowanych na urządzeniu. |
String
|
getAdbPath()
Zwraca ścieżkę używanego pliku binarnego adb. |
|
getAllSettings(String namespace)
Zwraca pary klucz-wartość żądanej przestrzeni nazw. |
DeviceAllocationState
|
getAllocationState()
Zwraca bieżący stan przydziału urządzenia. |
String
|
getAndroidId(int userId)
Znajduje i zwraca identyfikator Androida powiązany z identyfikatorem użytkownika. Jeśli nie zostanie znaleziony, zwraca wartość null. |
|
getAndroidIds()
Utwórz mapę identyfikatorów Androida pasujących do identyfikatorów użytkowników. |
int
|
getApiLevel()
Pobierz poziom interfejsu API urządzenia. |
PackageInfo
|
getAppPackageInfo(String packageName)
Pobiera informacje o pakiecie zainstalowanym na urządzeniu. |
|
getAppPackageInfos()
Pobieranie informacji o pakietach zainstalowanych na urządzeniu. |
String
|
getBasebandVersion()
Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia. |
Integer
|
getBattery()
Zwraca bieżący poziom naładowania baterii urządzenia lub wartość null, jeśli poziom naładowania baterii jest niedostępny. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Zwraca wartość logiczną danej właściwości. |
|
getBootHistory()
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchomienia. |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchamiania od podanego czasu od początku epoki na urządzeniu oraz określoną jednostką czasu. |
String
|
getBootloaderVersion()
Wygodna metoda uzyskiwania wersji programu rozruchowego tego urządzenia. |
InputStreamSource
|
getBugreport()
Pobiera raport o błędzie z urządzenia. |
InputStreamSource
|
getBugreportz()
Pobiera z urządzenia raport o błędzie. |
String
|
getBuildAlias()
Pobierz alias kompilacji, na której obecnie działa urządzenie. |
String
|
getBuildFlavor()
Pobierz wersję kompilacji urządzenia. |
String
|
getBuildId()
Pobierz kompilację, na której obecnie działa urządzenie. |
String
|
getBuildSigningKeys()
Zwraca typ klucza użytego do podpisania obrazu urządzenia. Urządzenia z Androidem są zwykle podpisywane kluczami testowymi (jak w AOSP) lub kluczami wersji (kontrolowanymi przez poszczególnych producentów urządzeń). |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Zwraca buforowaną wartość |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Zwraca buforowaną wartość |
String[]
|
getChildren(String path)
Alternatywa dla używania |
AbstractConnection
|
getConnection()
Aktualne połączenie powiązane z urządzeniem. |
ContentProviderHandler
|
getContentProvider(int userId)
Zwraca wartość |
DeviceFoldableState
|
getCurrentFoldableState()
Zwraca bieżący stan urządzenia składanego lub wartość null, jeśli wystąpiły problemy. |
int
|
getCurrentUser()
Zwraca identyfikator aktualnie zalogowanego użytkownika. |
String
|
getDeviceClass()
Pobierz klasę urządzenia. |
long
|
getDeviceDate()
Zwraca datę urządzenia w milisekundach od początku epoki. |
DeviceDescriptor
|
getDeviceDescriptor()
Zwróć |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Zwróć |
TestDeviceState
|
getDeviceState()
Pobierz stan urządzenia. |
long
|
getDeviceTimeOffset(Date date)
Funkcja pomocnicza do uzyskiwania różnicy czasu między urządzeniem a podanym |
InputStreamSource
|
getEmulatorOutput()
Pobieranie strumienia stdout i stderr emulatora |
Process
|
getEmulatorProcess()
Zwraca wartość |
final
File
|
getExecuteShellCommandLog()
Dziennik zawierający wszystkie logi |
long
|
getExternalStoreFreeSpace()
Metoda pomocnicza do określania ilości wolnego miejsca w pamięci zewnętrznej urządzenia. |
String
|
getFastbootPath()
Zwraca ścieżkę używanego pliku binarnego fastboot. |
String
|
getFastbootProductType()
Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot. |
String
|
getFastbootProductVariant()
Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot. |
String
|
getFastbootSerialNumber()
Zwraca numer seryjny trybu fastboot. |
String
|
getFastbootVariable(String variableName)
Pobierz z urządzenia wartość podanej zmiennej fastboot. |
String
|
getFastbootVersion()
Zwraca ciąg znaków wersji używanego pliku binarnego fastboot. |
IFileEntry
|
getFileEntry(String path)
Pobieranie odwołania do pliku zdalnego na urządzeniu. |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Nieoficjalne narzędzie pomocnicze do pobierania |
|
getFoldableStates()
Zwraca listę stanów urządzenia składanego. |
IDevice
|
getIDevice()
Zwraca odwołanie do powiązanej biblioteki ddmlib |
|
getInstalledPackageNames()
Pobierz nazwy pakietów aplikacji znajdujących się na urządzeniu. |
long
|
getIntProperty(String name, long defaultValue)
Zwraca wartość całkowitą danej właściwości z urządzenia. |
String
|
getIpAddress()
Pobiera adres IP urządzenia. |
KeyguardControllerState
|
getKeyguardState()
Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest obsługiwany. |
long
|
getLastExpectedRebootTimeMillis()
Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie, w milisekundach od EPOCH, zgodnie z wartością zwracaną przez |
int
|
getLaunchApiLevel()
Pobierz poziom API, na którym urządzenie zostało uruchomione po raz pierwszy. |
InputStreamSource
|
getLogcat()
Pobiera strumień zrzutu danych logcat. |
InputStreamSource
|
getLogcat(int maxBytes)
Pobiera strumień zrzutu ostatnich |
InputStreamSource
|
getLogcatDump()
Pobierz zrzut bieżącego dziennika logcat z urządzenia. |
InputStreamSource
|
getLogcatSince(long date)
Pobiera strumień zrzutu przechwyconych danych logcat od podanej daty. |
String
|
getMacAddress()
Zwraca adres MAC urządzenia lub wartość null, jeśli nie można go pobrać z urządzenia. |
Integer
|
getMainUserId()
Zwraca główny identyfikator użytkownika. |
|
getMainlineModuleInfo()
Pobiera informacje o modułach głównych zainstalowanych na urządzeniu. |
int
|
getMaxNumberOfRunningUsersSupported()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników działających jednocześnie. |
int
|
getMaxNumberOfUsersSupported()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Zwraca |
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 testu dla urządzenia. |
long
|
getPartitionFreeSpace(String partition)
Metoda pomocnicza do określania ilości wolnego miejsca na partycji urządzenia. |
Integer
|
getPrimaryUserId()
Zwraca podstawowy identyfikator użytkownika. |
ProcessInfo
|
getProcessByName(String processName)
Metoda pomocnicza uruchamia polecenia „pidof” i „stat” i zwraca obiekt |
String
|
getProcessPid(String process)
Zwraca identyfikator procesu usługi lub wartość null, jeśli wystąpił błąd. |
String
|
getProductType()
Wygodna metoda uzyskiwania typu produktu tego urządzenia. |
String
|
getProductVariant()
Wygodna metoda pobierania wersji produktu tego urządzenia. |
String
|
getProperty(String name)
Pobierz z urządzenia wartość danej właściwości. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Pobierz bieżący tryb odzyskiwania używany na urządzeniu. |
InputStreamSource
|
getScreenshot(long displayId)
Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. |
InputStreamSource
|
getScreenshot(String format)
Robi zrzut ekranu urządzenia. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Robi zrzut ekranu urządzenia. |
InputStreamSource
|
getScreenshot()
Robi zrzut ekranu urządzenia. |
String
|
getSerialNumber()
Wygodny sposób na uzyskanie numeru seryjnego tego urządzenia. |
String
|
getSetting(int userId, String namespace, String key)
Zwraca wartość żądanego ustawienia. |
String
|
getSetting(String namespace, String key)
Patrz |
String
|
getSimOperator()
Zwraca operatora karty SIM lub wartość null, jeśli nie jest dostępny lub urządzenie jest niedostępne. |
String
|
getSimState()
Zwraca stan karty SIM lub wartość null, jeśli karta SIM jest niedostępna lub urządzenie jest niedostępne. |
|
getTombstones()
Pobierz i zwróć listę znaczników usunięcia z urządzeń. |
long
|
getTotalMemory()
Zwraca łączny rozmiar pamięci fizycznej w bajtach lub –1 w przypadku błędu wewnętrznego. |
String
|
getTrackingSerial()
Na potrzeby zarządzania urządzeniem pobierz numer seryjny używany do śledzenia urządzenia. |
|
getUninstallablePackageNames()
Pobierz nazwy pakietów aplikacji, które można odinstalować. |
boolean
|
getUseFastbootErase()
Sprawdza, czy do wyczyszczenia partycji na urządzeniu należy użyć polecenia fastboot erase czy fastboot format. |
int
|
getUserFlags(int userId)
Znajdź i zwróć flagi danego użytkownika. |
|
getUserInfos()
Pobiera mapę identyfikatorów użycia do |
int
|
getUserSerialNumber(int userId)
Zwraca numer seryjny powiązany z identyfikatorem userId, jeśli zostanie znaleziony, lub wartość -10000 w innych przypadkach. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Przetwarzanie danego zdarzenia DeviceEvent. Przetwórz zdarzenie DeviceEvent, które może, ale nie musi, przenieść to urządzenie do nowego stanu przydziału. |
boolean
|
hasFeature(String feature)
Sprawdź, czy funkcja jest dostępna na urządzeniu. |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
Zainicjuj połączenie z urządzeniem. |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu. |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu. |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika. |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika. |
boolean
|
installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)
Instaluje pliki APK w trybie przyrostowym. |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczanie aplikacji |
boolean
|
isBypassLowTargetSdkBlockSupported()
Sprawdzanie, czy platforma na urządzeniu obsługuje omijanie blokady niskiego docelowego pakietu SDK podczas instalowania aplikacji |
boolean
|
isDebugfsMounted()
Sprawdź, czy debugfs jest zamontowany. |
boolean
|
isDeviceEncrypted()
Wyświetla informację o tym, czy urządzenie jest zaszyfrowane. |
boolean
|
isDirectory(String path)
Zwraca wartość Prawda, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość Fałsz. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Wyświetla informację o tym, czy urządzenie obsługuje szyfrowanie. |
boolean
|
isExecutable(String fullPath)
Zwraca wartość Prawda, jeśli ścieżka pliku na urządzeniu prowadzi do pliku wykonywalnego, w przeciwnym razie zwraca wartość Fałsz. |
boolean
|
isFastbootEnabled()
Zwraca wartość, jeśli na urządzeniu jest dostępny tryb Fastboot. |
boolean
|
isHeadless()
Zwraca wartość „true”, jeśli urządzenie nie ma ekranu, w przeciwnym razie zwraca wartość „false”. |
boolean
|
isHeadlessSystemUserMode()
Zwraca informację o tym, czy urządzenie korzysta z trybu użytkownika systemu bez interfejsu graficznego. |
boolean
|
isMainUserPermanentAdmin()
Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani obniżyć jego uprawnień do poziomu użytkownika bez uprawnień administracyjnych. |
boolean
|
isMultiUserSupported()
Określa, czy obsługiwany jest tryb wielu użytkowników. |
boolean
|
isPackageInstalled(String packageName, String userId)
Wysyła zapytanie do urządzenia o daną nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana dla tego użytkownika. |
boolean
|
isPackageInstalled(String packageName)
Wysyłaj do urządzenia zapytania o daną nazwę pakietu, aby sprawdzić, czy jest on obecnie zainstalowany. |
boolean
|
isRuntimePermissionSupported()
Sprawdzanie, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie działania |
boolean
|
isStateBootloaderOrFastbootd()
Zwraca wartość „prawda”, jeśli urządzenie jest w stanie |
boolean
|
isUserRunning(int userId)
Sprawdź, czy dany użytkownik jest aktywny. |
boolean
|
isUserSecondary(int userId)
Zwraca informację, czy określony użytkownik jest użytkownikiem dodatkowym na podstawie jego flag. |
boolean
|
isUserVisible(int userId)
Sprawdza, czy dany użytkownik jest widoczny. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Zwraca informację, czy urządzenie zezwala na uruchamianie użytkowników w tle w |
boolean
|
isVisibleBackgroundUsersSupported()
Zwraca informację, czy urządzenie zezwala na uruchamianie użytkownikom widocznym w tle. |
boolean
|
isWifiEnabled()
Sprawdź, czy Wi-Fi jest włączone. |
|
listDisplayIds()
Zbierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, zgodnie z raportem „dumpsys SurfaceFlinger”. |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Pobiera listę wyświetlaczy, których można używać do |
|
listUsers()
Pobiera listę użytkowników na urządzeniu. |
boolean
|
logAnrs(ITestLogger logger)
Zbiera i rejestruje błędy ANR z urządzenia. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Metoda pomocnicza służąca do tworzenia raportu o błędzie i przesyłania go do osób zgłaszających. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Zapisz wiadomość w logcat urządzenia. |
void
|
mountDebugfs()
Podłącz debugfs. |
void
|
nonBlockingReboot()
Wydaje polecenie ponownego uruchomienia urządzenia i zwraca wynik po zakończeniu polecenia oraz gdy urządzenie nie jest już widoczne dla adb. |
void
|
postAdbRootAction()
Zastąp, jeśli po uzyskaniu dostępu do roota za pomocą ADB i przed ponownym połączeniem urządzenia z siecią trzeba wykonać na nim określone działania. |
void
|
postAdbUnrootAction()
Zastąp, jeśli po odrootowaniu za pomocą ADB i przed ponownym połączeniem urządzenia z siecią trzeba wykonać na nim określone działania. |
void
|
postBootSetup()
Wykonaj instrukcje, aby skonfigurować urządzenie do testowania po każdym uruchomieniu. |
void
|
postInvocationTearDown(Throwable exception)
Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania. |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Dodatkowe czynności wymagane do skonfigurowania urządzenia, które zostaną wykonane na urządzeniu przed wywołaniem przepływu. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Rekursywne pobieranie zawartości katalogu z urządzenia. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Rekursywne pobieranie zawartości katalogu z urządzenia. |
boolean
|
pullFile(String remoteFilePath, File localFile)
Pobiera plik z urządzenia. |
File
|
pullFile(String remoteFilePath, int userId)
Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym |
File
|
pullFile(String remoteFilePath)
Pobiera plik z urządzenia, zapisuje 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 pamięci zewnętrznej urządzenia, zapisywania go w lokalnym pliku tymczasowym |
boolean
|
pushDir(File localFileDir, String deviceFilePath,
Rekursywne przesyłanie zawartości katalogu na urządzenie z wykluczeniem niektórych katalogów, które są filtrowane. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Rekursywne przekazywanie zawartości katalogu na urządzenie. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Rekursywne przekazywanie zawartości katalogu na urządzenie. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Wariant |
boolean
|
pushFile(File localFile, String remoteFilePath)
Przekazywanie pliku na urządzenie. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Przekazywanie pliku na urządzenie. |
boolean
|
pushString(String contents, String remoteFilePath)
Przesyłanie na urządzenie pliku utworzonego z ciągu znaków |
void
|
reboot(String reason)
Uruchamia ponownie urządzenie w trybie adb z podanym parametrem |
void
|
reboot()
Uruchamia ponownie urządzenie w trybie adb. |
void
|
rebootIntoBootloader()
Uruchamia ponownie urządzenie w trybie programu rozruchowego. |
void
|
rebootIntoFastbootd()
Uruchamia ponownie urządzenie w trybie fastbootd. |
void
|
rebootIntoRecovery()
Uruchamia ponownie urządzenie w trybie odzyskiwania adb. |
void
|
rebootIntoSideload()
Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania). Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku |
void
|
rebootIntoSideload(boolean autoReboot)
Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania). Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku |
void
|
rebootUntilOnline()
Alternatywa dla |
void
|
rebootUntilOnline(String reason)
Alternatywa dla |
void
|
rebootUserspace()
Ponowne uruchomienie tylko części urządzenia w przestrzeni użytkownika. |
void
|
rebootUserspaceUntilOnline()
Alternatywa dla |
boolean
|
recoverDevice()
Próbuje przywrócić 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 zapisywalną. |
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)
Usuwa administratora urządzenia z konta użytkownika i zwraca |
void
|
removeOwners()
Usuń wszystkich obecnych właścicieli profilu urządzenia, 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 ponownie ją wywołać. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Wygodna metoda wykonywania |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Uruchamia testy z instrumentacją i umożliwia przywracanie urządzeń. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Tak samo jak |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Tak samo jak |
void
|
setAdbPath(String adbPath)
Ustawia ścieżkę do pliku binarnego adb, który ma być używany. |
void
|
setConfiguration(IConfiguration configuration)
Wstawia używany element |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
Ustawia datę na urządzeniu Uwaga: ustawienie daty na urządzeniu wymaga dostępu do roota. |
boolean
|
setDeviceOwner(String componentName, int userId)
Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika. |
void
|
setDeviceState(TestDeviceState deviceState)
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 ma być używany. |
void
|
setIDevice(IDevice newDevice)
Zaktualizuj urządzenie IDevice powiązane z tym urządzeniem ITestDevice. |
void
|
setLogStartDelay(int delay)
Określa czas (w milisekundach) oczekiwania przed rozpoczęciem rejestrowania logcat na urządzeniu online. |
void
|
setOptions(TestDeviceOptions options)
Ustaw |
boolean
|
setProperty(String propKey, String propValue)
Ustawia na urządzeniu podaną wartość właściwości. |
void
|
setRecovery(IDeviceRecovery recovery)
Ustaw numer |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Ustaw bieżący tryb odzyskiwania, który ma być używany na urządzeniu. |
void
|
setSetting(String namespace, String key, String value)
Patrz |
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
|
setTrackingSerial(String trackingSerial)
Do celów zarządzania urządzeniami śledź numer seryjny, którego używamy do odwoływania się do urządzenia. |
void
|
setUseFastbootErase(boolean useFastbootErase)
Określ, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie fastboot erase czy fastboot format. |
void
|
startLogcat()
Rozpocznij przechwytywanie danych wyjściowych logcat z urządzenia w tle. |
boolean
|
startTradeInModeTesting(int timeoutMs)
Włącz tryb testowania wymiany za dopłatą. |
boolean
|
startUser(int userId)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. |
boolean
|
startUser(int userId, boolean waitFlag)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli umożliwia mu uruchamianie aktywności na tym wyświetlaczu). |
void
|
stopEmulatorOutput()
Zamknij i usuń dane wyjściowe emulatora. |
void
|
stopLogcat()
Zatrzymuje rejestrowanie danych wyjściowych logcat z urządzenia i odrzuca aktualnie zapisane dane logcat. |
void
|
stopTradeInModeTesting()
Zakończ testowanie trybu wymiany za dopłatą. |
boolean
|
stopUser(int userId)
Zatrzymuje danego użytkownika. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Zatrzymanie danego użytkownika. |
String
|
switchToAdbTcp()
Przełącz urządzenie w tryb adb-over-tcp. |
boolean
|
switchToAdbUsb()
Przełącz urządzenie w tryb adb over usb. |
boolean
|
switchUser(int userId)
Przełącz na inny identyfikator użytkownika z domyślnym czasem oczekiwania. |
boolean
|
switchUser(int userId, long timeout)
Przełącz na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Przyrostowo synchronizuje zawartość lokalnego katalogu plików z urządzeniem. |
Bugreport
|
takeBugreport()
Pobiera raport o błędzie i zwraca go w obiekcie |
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. |
void
|
unmountDebugfs()
Odłącz debugfs. |
boolean
|
waitForBootComplete(long timeOut)
Blokuje do momentu ustawienia flagi zakończenia rozruchu urządzenia. |
boolean
|
waitForDeviceAvailable()
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania. |
boolean
|
waitForDeviceAvailable(long waitTime)
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne, bez uwzględniania ścieżki przywracania. |
void
|
waitForDeviceBootloader()
Blokuje działanie, dopóki urządzenie nie będzie widoczne w trybie fastboot. |
void
|
waitForDeviceFastbootD()
|
boolean
|
waitForDeviceInRecovery(long waitTime)
Blokuje możliwość przejścia urządzenia w stan „adb recovery” (uwaga: różni się od |
boolean
|
waitForDeviceInSideload(long waitTime)
Blokuje możliwość przejścia urządzenia w stan „adb sideload” |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Blokuje urządzenie, aby było niedostępne, tzn. nie było widoczne 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 odpowie na podstawowe polecenie powłoki adb. |
Metody chronione | |
|---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
Tworzy polecenie systemu operacyjnego dla danej sesji polecenia 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 za pomocą ADB. |
void
|
ensureRuntimePermissionSupported()
metoda pomocnicza do zgłaszania wyjątku, jeśli uprawnienia czasu działania nie są obsługiwane; |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Uzyskaj instancję |
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Pobiera właściwość urządzenia z pamięci podręcznej ddmlib (domyślnie) lub z polecenia `adb shell getprop` albo `fastboot getvar` w zależności od tego, czy urządzenie jest w trybie Fastboot. |
boolean
|
isInRebootCallback()
Zwraca informację, czy wywołania zwrotne ponownego uruchomienia są obecnie wykonywane. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Zwraca |
void
|
notifyRebootEnded()
Wysyła powiadomienie o zakończeniu ponownego uruchamiania do wszystkich |
void
|
notifyRebootStarted()
Powiadamia wszystkie urządzenia |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
wykonuje działanie na tym urządzeniu; |
void
|
postAdbReboot(NativeDevice.RebootMode rebootMode)
Możliwe dodatkowe działania, które można wykonać po ponownym uruchomieniu. |
void
|
prePostBootSetup()
Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w celu przeprowadzenia konfiguracji po uruchomieniu. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Ustaw instancję zegara, której chcesz używać. |
void
|
setMicrodroidProcess(Process process)
Oznacza TestDevice jako microdroid i ustawia jego identyfikator klienta. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
Wykonuje proste polecenie fastboot ze zmiennymi środowiskowymi i zgłasza stan polecenia. |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
Wykonuje proste polecenie fastboot i zgłasza jego stan. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
Poczekaj, aż urządzenie stanie się niedostępne (przestanie przesyłać raporty do adb). |
Stałe
DEBUGFS_PATH
public static final String DEBUGFS_PATH
Stała wartość: „/sys/kernel/debug”
INVALID_USER_ID
public static final int INVALID_USER_ID
Wartość zwracana w przypadku nieprawidłowego lub nieznalezionego 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)
SD_CARD
protected static final String SD_CARD
Stała wartość: "/sdcard/"
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
Wartość stała: "/storage/emulated/"
Fieldsem
Publiczne konstruktory
Urządzenie natywne
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Tworzy TestDevice.
| Parametry | |
|---|---|
device |
IDevice: powiązany IDevice |
stateMonitor |
IDeviceStateMonitor: mechanizm IDeviceStateMonitor, którego chcesz użyć |
allocationMonitor |
IDeviceMonitor: IDeviceMonitor, aby informować o zmianach stanu przydziału.
Może mieć wartość null |
Metody publiczne
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Mikrooptymalizacja (ok. 400 milisekund) polegająca na wstępnym pobieraniu wszystkich potrzebnych właściwości zamiast wywoływania polecenia „adb getprop” dla każdej z nich. Oznacza to, że pobranie wszystkich właściwości trwa tyle samo czasu co pobranie jednej. Funkcje takie jak device.getApiLevel(), checkApiLevelAgainstNextRelease i getBuildAlias wywołują w tle polecenie `adb getprop`. Pobieramy je w ramach jednego wywołania i wywołujemy funkcję NativeDevice.setProperty. Nawet jeśli tego nie zrobimy, NativeDevice sam wywoła setProperty i zapisze wynik w pamięci podręcznej na potrzeby przyszłych wywołań. Po prostu robimy to nieco wcześniej. Jeśli urządzenie jest w trybie odzyskiwania lub występują inne błędy pobierania właściwości, po prostu je ignorujemy.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Zwraca informację, czy można przełączyć się na użytkownika SYSTEM bez interfejsu graficznego.
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Sprawdź, czy funkcja jest obecnie obsługiwana na minimalnym poziomie obsługi. Ta metoda uwzględnia jeszcze nieopublikowane funkcje, zanim zostanie podniesiony poziom interfejsu API.
| Parametry | |
|---|---|
strictMinLevel |
int: najniższy możliwy poziom, który obsługuje tę funkcję. |
| Zwroty | |
|---|---|
boolean |
Wartość „prawda”, jeśli poziom jest obsługiwany. W przeciwnym razie ma wartość Fałsz. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
checkConnectivity
public boolean checkConnectivity ()
Sprawdź, czy urządzenie ma połączenie z siecią.
| Zwroty | |
|---|---|
boolean |
true jeśli urządzenie ma aktywne połączenie z siecią,
false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
clearErrorDialogs
public boolean clearErrorDialogs ()
Próba zamknięcia wszystkich okien dialogowych z błędami, które są obecnie wyświetlane w interfejsie urządzenia.
| Zwroty | |
|---|---|
boolean |
true – jeśli nie było żadnych okien lub zostały one usunięte.
false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Usuwa ostatnią połączoną sieć Wi-Fi. Tę metodę należy wywołać podczas rozpoczynania nowego wywołania, aby uniknąć łączenia się z siecią Wi-Fi używaną w poprzednim teście po ponownym uruchomieniu urządzenia.
clearLogcat
public void clearLogcat ()
Usuwa wszystkie zgromadzone dane logcat.
Jest to przydatne w sytuacjach, gdy chcesz mieć pewność, że funkcja ITestDevice.getLogcat() zwraca tylko dane logowania wygenerowane po określonym momencie (np. po wgraniu nowej wersji urządzenia).
connectToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje połączenie do czasu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi() lub ITestDevice.clearLastConnectedWifiNetwork().
| Parametry | |
|---|---|
wifiSsidToPsk |
: mapa identyfikatorów SSID sieci Wi-Fi i haseł. |
scanSsid |
boolean: czy skanować ukryte identyfikatory SSID w tej sieci. |
| Zwroty | |
|---|---|
boolean |
true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false
w innym przypadku |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje działanie do czasu nawiązania połączenia z określoną siecią Wi-Fi.
Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi() lub ITestDevice.clearLastConnectedWifiNetwork().
| Parametry | |
|---|---|
wifiSsid |
String: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć. |
wifiPsk |
String: hasło PSK lub wartość null, jeśli połączenie nie jest szyfrowane. |
| Zwroty | |
|---|---|
boolean |
true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false
w innym przypadku |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
connectToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje połączenie do czasu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi() lub ITestDevice.clearLastConnectedWifiNetwork().f
| Parametry | |
|---|---|
wifiSsidToPsk |
: mapa identyfikatorów SSID sieci Wi-Fi i haseł. |
| Zwroty | |
|---|---|
boolean |
true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false
w innym przypadku |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje działanie do czasu nawiązania połączenia z określoną siecią Wi-Fi.
Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi() lub ITestDevice.clearLastConnectedWifiNetwork().
| Parametry | |
|---|---|
wifiSsid |
String: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć. |
wifiPsk |
String: hasło PSK lub wartość null, jeśli połączenie nie jest szyfrowane. |
scanSsid |
boolean: czy skanować ukryty identyfikator SSID tej sieci. |
| Zwroty | |
|---|---|
boolean |
true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false
w innym przypadku |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)Wariant connectToWifiNetwork(String, String), który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z siecią.
| Parametry | |
|---|---|
scanSsid |
boolean: czy skanować ukryty identyfikator SSID tej sieci. |
| Zwroty | |
|---|---|
boolean |
true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false
w innym przypadku |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)Wariant connectToWifiNetwork(String, String), który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z siecią.
| Zwroty | |
|---|---|
boolean |
true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false
w innym przypadku |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)Utwórz użytkownika o danej nazwie i z podanymi flagami.
| Parametry | |
|---|---|
name |
String: użytkownika, który ma utworzyć 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, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)Utwórz użytkownika o danej nazwie i z podanymi flagami.
| Parametry | |
|---|---|
name |
String: użytkownika, który ma utworzyć 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, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
createUser
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 utworzyć na urządzeniu |
| Zwroty | |
|---|---|
int |
liczba całkowita utworzonego identyfikatora użytkownika, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
createUserNoThrow
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 utworzyć na urządzeniu |
| Zwroty | |
|---|---|
int |
liczba całkowita identyfikatora użytkownika utworzonego lub -1 w przypadku błędu. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
debugDeviceNotAvailable
public DeviceInspectionResult debugDeviceNotAvailable ()
sprawdzanie urządzenia i zwracanie szczegółowych informacji, gdy urządzenie staje się niedostępne;
| Zwroty | |
|---|---|
DeviceInspectionResult |
|
deleteFile
public void deleteFile (String deviceFilePath,
int userId)Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.
| Parametry | |
|---|---|
deviceFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
userId |
int: identyfikator użytkownika, z którego chcesz usunąć dane. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
deleteFile
public void deleteFile (String deviceFilePath)
Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.
| Parametry | |
|---|---|
deviceFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
deregisterDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Usuwa zarejestrowany IDeviceActionReceiver.
| Parametry | |
|---|---|
deviceActionReceiver |
IDeviceActionReceiver: IDeviceActionReceiver, która zostanie usunięta. |
deviceSoftRestarted
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione przez porównanie bieżącego serwera systemowego z poprzednim serwerem systemowym ProcessInfo. Aby skorzystać z promocji ProcessInfo, użyj getProcessByName(String).
| Parametry | |
|---|---|
prevSystemServerProcess |
ProcessInfo: poprzedni proces system_server ProcessInfo. |
| Zwroty | |
|---|---|
boolean |
true – jeśli urządzenie zostało ponownie uruchomione. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
deviceSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime,
TimeUnit timeUnit)Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione od czasu UTC od początku epoki z urządzenia i jego ERROR(/TimeUnit). Miękkie ponowne uruchomienie oznacza ponowne uruchomienie serwera systemowego poza twardym ponownym uruchomieniem urządzenia (np. na żądanie). Aktualny czas urządzenia utcEpochTime w milisekundach można uzyskać za pomocą metody getDeviceDate().
| Parametry | |
|---|---|
utcEpochTime |
long: czas urządzenia w sekundach od początku epoki. |
timeUnit |
TimeUnit: jednostka czasu TimeUnit dla danego parametru utcEpochTime. |
| Zwroty | |
|---|---|
boolean |
true – jeśli urządzenie zostało ponownie uruchomione. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
disableAdbRoot
public boolean disableAdbRoot ()
Wyłącza uprawnienia roota adb.
Wyłączenie uprawnień roota adb może spowodować odłączenie urządzenia od adb. Ta metoda będzie blokować działanie programu do momentu, aż urządzenie będzie dostępne.
| Zwroty | |
|---|---|
boolean |
true, jeśli się uda. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
disableKeyguard
public void disableKeyguard ()
próby wyłączenia ochrony 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ż bieżąca implementacja platformy czasami powoduje wyścig. Następnie wysyłane jest polecenie zamknięcia ekranu blokady (działa tylko w przypadku niezabezpieczonych ekranów blokady).
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
disableNetworkMonitor
public boolean disableNetworkMonitor ()
Wyłącza monitorowanie sieci na urządzeniu.
| Zwroty | |
|---|---|
boolean |
true, jeśli monitorowanie zostało wyłączone. falsew przypadku niepowodzenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
disconnectFromWifi
public boolean disconnectFromWifi ()
rozłącza się z siecią Wi-Fi,
Usuwa wszystkie sieci z listy znanych sieci i wyłącza Wi-Fi.
| Zwroty | |
|---|---|
boolean |
true, jeśli połączenie z siecią Wi-Fi zostało zakończone. false
jeśli nie udało się zakończyć połączenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)Metoda pomocnicza do określania, czy plik na urządzeniu istnieje dla danego użytkownika.
| Parametry | |
|---|---|
deviceFilePath |
String: bezwzględna ścieżka do pliku na urządzeniu, który ma zostać sprawdzony. |
userId |
int: identyfikator użytkownika, względem którego należy sprawdzić istnienie pliku. |
| Zwroty | |
|---|---|
boolean |
true, jeśli plik istnieje, false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Metoda pomocnicza do sprawdzania, czy plik istnieje na urządzeniu.
| Parametry | |
|---|---|
deviceFilePath |
String: bezwzględna ścieżka do pliku na urządzeniu, który ma zostać sprawdzony. |
| Zwroty | |
|---|---|
boolean |
true, jeśli plik istnieje, false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
dumpHeap
public File dumpHeap (String process,
String devicePath)Spróbuj zrzucić stertę z procesu system_server. Za usunięcie zrzutu pliku odpowiada osoba wywołująca.
| Parametry | |
|---|---|
process |
String: nazwa procesu na urządzeniu, w którym ma zostać wykonany zrzę pamięci. |
devicePath |
String: ścieżka na urządzeniu, w której ma zostać umieszczony zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia. |
| Zwroty | |
|---|---|
File |
ERROR(/File) zawierający raport. Wartość null, jeśli coś się nie powiodło. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
enableAdbRoot
public boolean enableAdbRoot ()
Włącza uprawnienia roota ADB. Jeśli ustawienie „enable-root” ma wartość „false”, zostanie zarejestrowany komunikat i zwrócona wartość bez włączania dostępu do roota.
Włączenie adb root może spowodować odłączenie urządzenia od adb. Ta metoda będzie blokować działanie programu do momentu, aż urządzenie będzie dostępne.
| Zwroty | |
|---|---|
boolean |
true, jeśli się uda. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
enableNetworkMonitor
public boolean enableNetworkMonitor ()
Włącza monitorowanie sieci na urządzeniu.
| Zwroty | |
|---|---|
boolean |
true – jeśli monitorowanie zostało włączone. falsew przypadku niepowodzenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeAdbCommand
public String executeAdbCommand (long timeout,
String... cmdArgs)Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
timeout |
long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu. |
cmdArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
String |
standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeAdbCommand
public String executeAdbCommand (long timeout,
envMap,
String... cmdArgs) Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
timeout |
long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu. |
envMap |
: środowisko, które ma być ustawione dla polecenia |
cmdArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
String |
standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeAdbCommand
public String executeAdbCommand (String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
cmdArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
String |
standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeAdbV2Command
public CommandResult executeAdbV2Command (String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
cmdArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeAdbV2Command
public CommandResult executeAdbV2Command (long timeout, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
timeout |
long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu. |
cmdArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeAdbV2Command
public CommandResult executeAdbV2Command (long timeout,envMap, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
timeout |
long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu. |
envMap |
: środowisko, które ma być ustawione dla polecenia |
cmdArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty.
Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.
| Parametry | |
|---|---|
cmdArgs |
String: polecenie fastboot i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe.
Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.
| Parametry | |
|---|---|
timeout |
long: czas w milisekundach, po którym polecenie wygasa. |
cmdArgs |
String: polecenie fastboot i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe.
Identyczna z funkcją executeFastbootCommand(String), ale używa dłuższego czasu oczekiwania.
| Parametry | |
|---|---|
cmdArgs |
String: polecenie fastboot i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe ze zmiennymi środowiskowymi systemu.
Identyczna z funkcją executeFastbootCommand(String), ale używa dłuższego czasu oczekiwania.
| Parametry | |
|---|---|
envVarMap |
: zmienne środowiskowe systemu, z którymi jest uruchamiane polecenie fastboot; |
cmdArgs |
String: polecenie fastboot i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeShellCommand
public String executeShellCommand (String command)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca dane wyjściowe jako String.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
| Zwroty | |
|---|---|
String |
dane wyjściowe powłoki, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeShellCommand
public void executeShellCommand (String command,
IShellOutputReceiver receiver,
long maxTimeToOutputShellResponse,
TimeUnit timeUnit,
int retryAttempts)Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki. |
maxTimeToOutputShellResponse |
long: maksymalny czas, w którym polecenie może nie generować odpowiedzi; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts
nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
| Zgłasza | |
|---|---|
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, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki. |
maxTimeoutForCommand |
long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit |
maxTimeToOutputShellResponse |
long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeShellCommand
public void executeShellCommand (String command,
IShellOutputReceiver receiver)Wykonuje podane polecenie powłoki adb, ponawiając je wielokrotnie, jeśli się nie powiedzie.
Prostsza forma funkcji executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) z wartościami domyślnymi.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.
| Parametry | |
|---|---|
cmd |
String: polecenie, które ma zostać uruchomione. |
| Zwroty | |
|---|---|
CommandResult |
Wynik w języku: CommandResult. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia i stderr. stdout jest kierowany do określonego strumienia.
| Parametry | |
|---|---|
cmd |
String: polecenie, które ma zostać uruchomione. |
pipeToOutput |
OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null. |
| Zwroty | |
|---|---|
CommandResult |
Wynik w języku: CommandResult. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.
| Parametry | |
|---|---|
cmd |
String: polecenie, które ma zostać uruchomione. |
pipeAsInput |
File: ERROR(/File), który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null. |
| Zwroty | |
|---|---|
CommandResult |
Wynik w języku: CommandResult. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
cmd |
String: polecenie adb shell do uruchomienia |
maxTimeoutForCommand |
long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
| Zwroty | |
|---|---|
CommandResult |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
cmd |
String: polecenie adb shell do uruchomienia |
maxTimeoutForCommand |
long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
| Zwroty | |
|---|---|
CommandResult |
|
| Zgłasza | |
|---|---|
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, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
cmd |
String: polecenie adb shell do uruchomienia |
pipeAsInput |
File: ERROR(/File), który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null. |
pipeToOutput |
OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null. |
maxTimeoutForCommand |
long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
| Zwroty | |
|---|---|
CommandResult |
|
| Zgłasza | |
|---|---|
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, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
cmd |
String: polecenie adb shell do uruchomienia |
pipeAsInput |
File: ERROR(/File), który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null. |
pipeToOutput |
OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null. |
pipeToError |
OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowany standardowy błąd, lub wartość null. |
maxTimeoutForCommand |
long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
| Zwroty | |
|---|---|
CommandResult |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
fastbootWipePartition
public CommandResult fastbootWipePartition (String partition)
Metoda pomocnicza, która czyści partycję urządzenia.
Jeśli getUseFastbootErase() ma wartość true, do wyczyszczenia partycji zostanie użyte polecenie fastboot erase. Przy następnym uruchomieniu urządzenia musi ono utworzyć system plików.
W przeciwnym razie używany jest format fastboot, który utworzy nowy system plików na urządzeniu.
Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.
| Parametry | |
|---|---|
partition |
String: partycja do wyczyszczenia |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getActiveApexes
publicgetActiveApexes ()
Pobiera informacje o pakietach APEX aktywowanych na urządzeniu.
| Zwroty | |
|---|---|
|
Obecnie na urządzeniu aktywowano ERROR(/Set) z ApexInfo |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getAdbPath
public String getAdbPath ()
Zwraca ścieżkę używanego pliku binarnego adb.
| Zwroty | |
|---|---|
String |
|
getAllSettings
publicgetAllSettings (String namespace)
Zwraca pary klucz-wartość żądanej przestrzeni nazw.
| Parametry | |
|---|---|
namespace |
String: musi mieć jedną z wartości: {"system", "secure", "global"} |
| Zwroty | |
|---|---|
|
mapa par klucz-wartość. Wartość null, jeśli przestrzeń nazw nie jest obsługiwana. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getAllocationState
public DeviceAllocationState getAllocationState ()
Zwraca bieżący stan przydziału urządzenia.
| Zwroty | |
|---|---|
DeviceAllocationState |
|
getAndroidId
public String getAndroidId (int userId)
Znajduje i zwraca identyfikator Androida powiązany z identyfikatorem użytkownika. Jeśli nie zostanie znaleziony, zwraca wartość null.
| Parametry | |
|---|---|
userId |
int |
| Zwroty | |
|---|---|
String |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getAndroidIds
publicgetAndroidIds ()
Utwórz mapę identyfikatorów Androida pasujących do identyfikatorów użytkowników. Nie ma gwarancji, że każdy identyfikator użytkownika znajdzie powiązany identyfikator Androida w tej funkcji, więc niektóre identyfikatory użytkowników mogą pasować do wartości null.
| Zwroty | |
|---|---|
|
Mapa identyfikatorów Androida pasujących do identyfikatorów użytkowników. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getApiLevel
public int getApiLevel ()
Pobierz poziom interfejsu API urządzenia. Domyślna wartość to UNKNOWN_API_LEVEL.
| Zwroty | |
|---|---|
int |
liczba całkowita wskazująca poziom interfejsu API urządzenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Pobiera informacje o pakiecie zainstalowanym na urządzeniu.
| Parametry | |
|---|---|
packageName |
String |
| Zwroty | |
|---|---|
PackageInfo |
PackageInfo lub null, jeśli nie udało się pobrać informacji. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getAppPackageInfos
publicgetAppPackageInfos ()
Pobieranie informacji o pakietach zainstalowanych na urządzeniu.
| Zwroty | |
|---|---|
|
ERROR(/List) z PackageInfo zainstalowanych na urządzeniu. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBasebandVersion
public String getBasebandVersion ()
Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia. Pobieranie wersji radia
jest zależne od urządzenia, więc może nie zwracać prawidłowych informacji na wszystkich urządzeniach. Ta metoda korzysta z właściwości gsm.version.baseband, aby zwracać prawidłowe informacje o wersji.
W przypadku niektórych urządzeń CDMA ta wartość jest niedokładna, a wersja zwrócona w tym miejscu może nie być zgodna z wersją zgłoszoną przez fastboot i może nie zwracać wersji radia CDMA.
W skrócie: ta metoda podaje dokładną wersję tylko wtedy, gdy właściwość gsm.version.baseband jest taka sama jak wersja zwracana przez fastboot getvar version-baseband.
| Zwroty | |
|---|---|
String |
String wersja pasma podstawowego lub null, jeśli nie można jej określić (urządzenie nie ma radia lub nie można odczytać ciągu znaków wersji); |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBattery
public Integer getBattery ()
Zwraca bieżący poziom naładowania baterii urządzenia lub wartość null, jeśli poziom naładowania 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 usługi |
defaultValue |
boolean: wartość domyślna, która ma zostać zwrócona, jeśli właściwość jest pusta lub nie istnieje. |
| Zwroty | |
|---|---|
boolean |
true, jeśli właściwość ma wartość "1", "y", "yes", "on" lub "true"; false, jeśli właściwość ma wartość "0", "n", "no", "off", "false" lub defaultValue; w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBootHistory
publicgetBootHistory ()
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem uruchamiania i przyczyną uruchomienia.
| Zwroty | |
|---|---|
|
Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBootHistorySince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchamiania od podanego czasu od początku epoki na urządzeniu oraz określoną jednostką czasu. Aktualny czas urządzenia utcEpochTime w milisekundach można uzyskać za pomocą metody getDeviceDate().
| Parametry | |
|---|---|
utcEpochTime |
long: czas urządzenia od początku epoki. |
timeUnit |
TimeUnit: jednostka czasu TimeUnit. |
| Zwroty | |
|---|---|
|
Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBootloaderVersion
public String getBootloaderVersion ()
Wygodna metoda uzyskiwania wersji programu rozruchowego tego urządzenia.
Spróbuje pobrać wersję programu rozruchowego z bieżącego stanu urządzenia. (np. jeśli urządzenie jest w trybie Fastboot Mode, spróbuje pobrać wersję z tego trybu).
| Zwroty | |
|---|---|
String |
wersję programu rozruchowego String lub null, jeśli nie można jej znaleźć; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBugreport
public InputStreamSource getBugreport ()
Pobiera raport o błędzie z urządzenia.
Gwarantujemy, że ta implementacja będzie nadal działać na urządzeniu bez karty SD (lub na urządzeniu, na którym karta SD nie jest jeszcze zamontowana).
| Zwroty | |
|---|---|
InputStreamSource |
InputStreamSource, które na żądanie wygeneruje zawartość raportu o błędach. W przypadku niepowodzenia funkcja InputStreamSource zwróci pustą wartość ERROR(/InputStream). |
getBugreportz
public InputStreamSource getBugreportz ()
Pobiera z urządzenia raport o błędzie. Raport o błędzie w formacie ZIP zawiera główny raport o błędzie i inne pliki dziennika, które są przydatne do debugowania.
Obsługiwane tylko w przypadku wersji „adb version” > 1.0.36
| Zwroty | |
|---|---|
InputStreamSource |
a InputStreamSource pliku ZIP zawierającego raport o błędzie. W przypadku niepowodzenia zwraca wartość null. |
getBuildAlias
public String getBuildAlias ()
Pobierz alias kompilacji, na której obecnie działa urządzenie.
Alias kompilacji jest zwykle bardziej czytelnym ciągiem znaków niż identyfikator kompilacji (zwykle numer w przypadku kompilacji na urządzenia Nexus). Na przykład ostateczna wersja Androida 4.2 ma alias kompilacji JDQ39 i identyfikator kompilacji 573038.
| Zwroty | |
|---|---|
String |
alias kompilacji lub identyfikator kompilacji, jeśli nie można go pobrać. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBuildFlavor
public String getBuildFlavor ()
Pobierz wersję kompilacji urządzenia.
| Zwroty | |
|---|---|
String |
wersja kompilacji lub wartość null, jeśli nie można jej pobrać. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBuildId
public String getBuildId ()
Pobierz kompilację, na której obecnie działa urządzenie.
| Zwroty | |
|---|---|
String |
identyfikator kompilacji lub IBuildInfo.UNKNOWN_BUILD_ID, jeśli nie udało się go pobrać. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBuildSigningKeys
public String getBuildSigningKeys ()
Zwraca typ klucza użytego do podpisania obrazu urządzenia.
Urządzenia z Androidem są zwykle podpisywane kluczami testowymi (jak w AOSP) lub kluczami wersji (kontrolowanymi przez poszczególnych producentów urządzeń).
| Zwroty | |
|---|---|
String |
Klucz podpisywania, jeśli został znaleziony, w przeciwnym razie wartość null. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.
| Zwroty | |
|---|---|
DeviceDescriptor |
|
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.
| Parametry | |
|---|---|
shortDescriptor |
boolean: czy ograniczyć opis do minimum informacji |
| Zwroty | |
|---|---|
DeviceDescriptor |
|
getChildren
public String[] getChildren (String path)
Alternatywa dla używania IFileEntry, która czasami nie działa z powodu uprawnień.
| Parametry | |
|---|---|
path |
String: ścieżka na urządzeniu, w której ma się odbywać wyszukiwanie. |
| Zwroty | |
|---|---|
String[] |
Tablica ciągów znaków zawierająca wszystkie pliki w ścieżce na urządzeniu. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getConnection
public AbstractConnection getConnection ()
Aktualne połączenie powiązane z urządzeniem.
| Zwroty | |
|---|---|
AbstractConnection |
|
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Zwraca wartość ContentProviderHandler lub wartość null, jeśli nie jest dostępna.
Dostawcę treści można ponownie wykorzystać, jeśli został wcześniej utworzony z tym samym parametrem userId.
| Parametry | |
|---|---|
userId |
int: identyfikator użytkownika, za pomocą którego należy zainicjować dostawcę treści. |
| Zwroty | |
|---|---|
ContentProviderHandler |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Zwraca bieżący stan urządzenia składanego lub wartość null, jeśli wystąpiły problemy.
| Zwroty | |
|---|---|
DeviceFoldableState |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getCurrentUser
public int getCurrentUser ()
Zwraca identyfikator aktualnie zalogowanego użytkownika. W przypadku błędu zwróć wartość -10000.
| Zwroty | |
|---|---|
int |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getDeviceClass
public String getDeviceClass ()
Pobierz klasę urządzenia.
| Zwroty | |
|---|---|
String |
klasa urządzenia String, |
getDeviceDate
public long getDeviceDate ()
Zwraca datę urządzenia w milisekundach od początku epoki.
| Zwroty | |
|---|---|
long |
datę urządzenia w formacie epoki; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o urządzeniu bez przekazywania rzeczywistego obiektu urządzenia.
| Zwroty | |
|---|---|
DeviceDescriptor |
|
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o urządzeniu bez przekazywania rzeczywistego obiektu urządzenia.
| Parametry | |
|---|---|
shortDescriptor |
boolean: czy ograniczyć opis do minimum informacji |
| Zwroty | |
|---|---|
DeviceDescriptor |
|
getDeviceState
public TestDeviceState getDeviceState ()
Pobierz stan urządzenia.
| Zwroty | |
|---|---|
TestDeviceState |
|
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Funkcja pomocnicza do uzyskiwania różnicy czasu między urządzeniem a podanym ERROR(/Date). wewnętrznie używać czasu epoki.
| Parametry | |
|---|---|
date |
Date |
| Zwroty | |
|---|---|
long |
różnicę w milisekundach, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
Pobieranie strumienia stdout i stderr emulatora
| Zwroty | |
|---|---|
InputStreamSource |
dane wyjściowe emulatora, |
getEmulatorProcess
public Process getEmulatorProcess ()
Zwraca wartość Process odpowiadającą temu emulatorowi.
| Zwroty | |
|---|---|
Process |
Process lub null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
Dziennik zawierający wszystkie logi executeShellCommand(String).
| Zwroty | |
|---|---|
File |
|
getExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
Metoda pomocnicza do określania ilości wolnego miejsca w pamięci zewnętrznej urządzenia.
| Zwroty | |
|---|---|
long |
ilość wolnego miejsca w KB, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getFastbootPath
public String getFastbootPath ()
Zwraca ścieżkę używanego pliku binarnego fastboot.
Wymaga to nadal, aby zasada isFastbootEnabled() miała wartość Prawda, aby włączyć funkcje fastboot.
| Zwroty | |
|---|---|
String |
|
getFastbootProductType
public String getFastbootProductType ()
Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.
Tej metody należy używać tylko wtedy, gdy urządzenie ma być w trybie fastboot. Jest to nieco bezpieczniejsza odmiana ogólnej metody getProductType(), ponieważ w tym przypadku interfejs ITestDevice wie, jak przywrócić urządzenie do trybu fastboot, jeśli jest ono w nieprawidłowym stanie lub nie odpowiada.
| Zwroty | |
|---|---|
String |
nazwę typu produktu String lub null, jeśli nie można jej określić. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getFastbootProductVariant
public String getFastbootProductVariant ()
Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.
Tej metody należy używać tylko wtedy, gdy urządzenie ma być w trybie fastboot. Jest to nieco bezpieczniejsza odmiana ogólnej metody getProductType(), ponieważ w tym przypadku interfejs ITestDevice wie, jak przywrócić urządzenie do trybu fastboot, jeśli jest ono w nieprawidłowym stanie lub nie odpowiada.
| Zwroty | |
|---|---|
String |
nazwę typu produktu String lub null, jeśli nie można jej określić. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Zwraca numer seryjny trybu fastboot.
| Zwroty | |
|---|---|
String |
|
getFastbootVariable
public String getFastbootVariable (String variableName)
Pobierz z urządzenia wartość podanej zmiennej fastboot.
| Parametry | |
|---|---|
variableName |
String: nazwa zmiennej; |
| Zwroty | |
|---|---|
String |
wartość właściwości lub null, jeśli nie istnieje. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getFastbootVersion
public String getFastbootVersion ()
Zwraca ciąg znaków wersji używanego pliku binarnego fastboot. lub wartość null, jeśli coś pójdzie nie tak.
| Zwroty | |
|---|---|
String |
|
getFileEntry
public IFileEntry getFileEntry (String path)
Pobieranie odwołania do pliku zdalnego na urządzeniu.
| Parametry | |
|---|---|
path |
String: ścieżka pliku do pobrania. Może to być ścieżka bezwzględna lub ścieżka względna do „/” (obsługiwana jest składnia „/system” i „system”). |
| Zwroty | |
|---|---|
IFileEntry |
wartość IFileEntry lub null, jeśli nie można znaleźć pliku pod podanym adresem path. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Nieoficjalne narzędzie pomocnicze do pobierania FileEntry ze ścieżki bez uprawnień roota. FIXME: Zrefaktoryzuj system FileEntry, aby był dostępny z dowolnej ścieżki. (nawet bez uprawnień roota).
| Parametry | |
|---|---|
entry |
FileListingService.FileEntry: FileEntry niekoniecznie musi być katalogiem głównym, jak wymaga tego biblioteka Ddmlib. |
| Zwroty | |
|---|---|
IFileEntry |
obiekt FileEntryWrapper reprezentujący obiekt FileEntry. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getFoldableStates
publicgetFoldableStates ()
Zwraca listę stanów urządzenia składanego. Można je uzyskać za pomocą polecenia „cmd device_state print-states”.
| Zwroty | |
|---|---|
|
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getIDevice
public IDevice getIDevice ()
Zwraca odwołanie do powiązanej biblioteki ddmlib IDevice.
Nowy IDevice może być przydzielany przez DDMS za każdym razem, gdy urządzenie zostanie odłączone i ponownie połączone z adb. Dlatego wywołujący nie powinni przechowywać odwołania do IDevice, ponieważ może ono stać się nieaktualne.
| Zwroty | |
|---|---|
IDevice |
IDevice |
getInstalledPackageNames
publicgetInstalledPackageNames ()
Pobierz nazwy pakietów aplikacji znajdujących się na urządzeniu.
| Zwroty | |
|---|---|
|
ERROR(/Set) z String nazw pakietów zainstalowanych obecnie na urządzeniu. |
| Zgłasza | |
|---|---|
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 usługi |
defaultValue |
long: wartość domyślna, która ma zostać zwrócona, 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. |
| Zgłasza | |
|---|---|
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; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest obsługiwany.
| Zwroty | |
|---|---|
KeyguardControllerState |
KeyguardControllerState zawierający zrzut stanu blokady ekranu. Zwraca wartość null, jeśli zapytanie dotyczące blokady ekranu nie jest obsługiwane. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getLastExpectedRebootTimeMillis
public long getLastExpectedRebootTimeMillis ()
Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie, w milisekundach od EPOCH, zgodnie z wartością zwracaną przez System.currentTimeMillis().
| Zwroty | |
|---|---|
long |
|
getLaunchApiLevel
public int getLaunchApiLevel ()
Pobierz poziom API, na którym urządzenie zostało uruchomione po raz pierwszy. Domyślna wartość to UNKNOWN_API_LEVEL.
| Zwroty | |
|---|---|
int |
liczba całkowita wskazująca pierwszy uruchomiony poziom interfejsu API urządzenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getLogcat
public InputStreamSource getLogcat ()
Pobiera strumień zrzutu danych logcat.
Działa w 2 trybach:
TestDeviceOptions.getMaxLogcatDataSize() bajtów bieżącej zawartości rejestrowanego w tle logcatu.
| Zwroty | |
|---|---|
InputStreamSource |
|
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Pobiera strumień zrzutu ostatnich maxBytes danych logcat.
Przydatne w sytuacjach, gdy chcesz często robić zrzuty przechwyconych danych logcat bez ponoszenia potencjalnie dużych kosztów związanych z zajmowaniem miejsca na dysku przez pełny zrzut getLogcat().
| Parametry | |
|---|---|
maxBytes |
int: maksymalna ilość danych do zwrócenia. Powinna to być ilość, która
zmieści się w pamięci. |
| Zwroty | |
|---|---|
InputStreamSource |
|
getLogcatDump
public InputStreamSource getLogcatDump ()
Pobierz zrzut bieżącego dziennika logcat z urządzenia. W przeciwieństwie do metody getLogcat() ta metoda zawsze zwraca statyczny zrzut logcat.
Ma tę wadę, że jeśli urządzenie jest niedostępne, nic nie zostanie zwrócone.
| Zwroty | |
|---|---|
InputStreamSource |
InputStreamSource danych logcat. Jeśli nie uda się przechwycić danych logcat, zwracany jest pusty strumień. |
getLogcatSince
public InputStreamSource getLogcatSince (long date)
Pobiera strumień zrzutu przechwyconych danych logcat od podanej daty. Należy używać czasu na urządzeniu getDeviceDate().
| Parametry | |
|---|---|
date |
long: w milisekundach od początku epoki, kiedy rozpocząć zrzut, aż do chwili obecnej.
(można go uzyskać za pomocą polecenia „date +%s”) |
| Zwroty | |
|---|---|
InputStreamSource |
|
getMacAddress
public String getMacAddress ()
Zwraca adres MAC urządzenia lub wartość null, jeśli nie można go pobrać z urządzenia.
| Zwroty | |
|---|---|
String |
|
getMainUserId
public Integer getMainUserId ()
Zwraca główny identyfikator użytkownika.
| Zwroty | |
|---|---|
Integer |
identyfikator użytkownika głównego, jeśli taki istnieje, lub wartość null, jeśli nie ma użytkownika głównego. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
Pobiera informacje o modułach głównych zainstalowanych na urządzeniu.
| Zwroty | |
|---|---|
|
ERROR(/Set) z String modułów głównych zainstalowanych obecnie na urządzeniu. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników działających jednocześnie. Domyślna wartość to 0.
| Zwroty | |
|---|---|
int |
liczbę całkowitą wskazującą liczbę użytkowników działających jednocześnie, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników. Domyślna wartość to 0.
| Zwroty | |
|---|---|
int |
liczba całkowita wskazująca liczbę obsługiwanych użytkowników; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getMicrodroidProcess
public Process getMicrodroidProcess ()
| Zwroty | |
|---|---|
Process |
Zwraca proces maszyny wirtualnej Microdroid. Jeśli TestDevice nie jest Microdroidem, zwraca wartość null. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Zwraca IDeviceStateMonitor powiązany z urządzeniem.
| Zwroty | |
|---|---|
IDeviceStateMonitor |
|
getMountPoint
public String getMountPoint (String mountName)
Zwraca punkt podłączenia.
Wysyła zapytanie bezpośrednio do urządzenia, jeśli informacje w pamięci podręcznej w IDevice są niedostępne.
DO ZROBIENIA: przenieś to działanie do IDevice.getMountPoint(String)
| Parametry | |
|---|---|
mountName |
String: nazwa punktu podłączania |
| Zwroty | |
|---|---|
String |
punkt podłączenia lub null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Zwraca wartość MountPointInfo odpowiadającą określonej ścieżce punktu podłączania lub null, jeśli w tej ścieżce nie ma niczego podłączonego lub w inny sposób nie pojawia się ona w pliku /proc/mounts jako punkt podłączania.
| Parametry | |
|---|---|
mountpoint |
String |
| Zwroty | |
|---|---|
ITestDevice.MountPointInfo |
ERROR(/List) z MountPointInfo zawierający informacje z pliku „/proc/mounts”. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getMountPointInfo
publicgetMountPointInfo ()
Zwraca przeanalizowaną wersję informacji z pliku /proc/mounts na urządzeniu.
| Zwroty | |
|---|---|
|
ERROR(/List) z MountPointInfo zawierający informacje z pliku „/proc/mounts”. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getOptions
public TestDeviceOptions getOptions ()
Pobierz opcje testu dla urządzenia.
| Zwroty | |
|---|---|
TestDeviceOptions |
TestDeviceOptions powiązane z testowanym urządzeniem. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
Metoda pomocnicza do określania ilości wolnego miejsca na partycji urządzenia.
| Parametry | |
|---|---|
partition |
String |
| Zwroty | |
|---|---|
long |
ilość wolnego miejsca w KB, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getPrimaryUserId
public Integer getPrimaryUserId ()
Zwraca podstawowy identyfikator użytkownika.
| Zwroty | |
|---|---|
Integer |
userId głównego użytkownika, jeśli taki istnieje, lub wartość null, jeśli nie ma głównego użytkownika. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getProcessByName
public ProcessInfo getProcessByName (String processName)
Metoda pomocnicza uruchamia polecenia „pidof” i „stat” i zwraca obiekt ProcessInfo z identyfikatorem PID i czasem rozpoczęcia procesu.
| Parametry | |
|---|---|
processName |
String: ciąg znaków z nazwą procesu. |
| Zwroty | |
|---|---|
ProcessInfo |
ProcessInfo dla danego procesu o nazwie processName |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getProcessPid
public String getProcessPid (String process)
Zwraca identyfikator procesu usługi lub wartość null, jeśli wystąpił błąd.
| Parametry | |
|---|---|
process |
String: Ciąg znaków z nazwą procesu. |
| Zwroty | |
|---|---|
String |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getProductType
public String getProductType ()
Wygodna metoda uzyskiwania typu produktu tego urządzenia.
Ta metoda działa, gdy urządzenie jest w trybie adb lub fastboot.
| Zwroty | |
|---|---|
String |
nazwę typu produktu String; Nie może mieć wartości null. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getProductVariant
public String getProductVariant ()
Wygodna metoda pobierania wersji produktu tego urządzenia.
Ta metoda działa, gdy urządzenie jest w trybie adb lub fastboot.
| Zwroty | |
|---|---|
String |
nazwę wersji produktu String lub null, jeśli nie można jej określić; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getProperty
public String getProperty (String name)
Pobierz z urządzenia wartość danej właściwości.
| Parametry | |
|---|---|
name |
String: nazwa usługi |
| Zwroty | |
|---|---|
String |
wartość właściwości lub null, jeśli nie istnieje. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Pobierz bieżący tryb odzyskiwania używany na urządzeniu.
| Zwroty | |
|---|---|
ITestDevice.RecoveryMode |
bieżący tryb odzyskiwania używany na urządzeniu; |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. Format to PNG.
DO ZROBIENIA: rozszerzyć powyższe implementacje, aby obsługiwały parametry „format” i „rescale”
| Parametry | |
|---|---|
displayId |
long: identyfikator ekranu, z którego ma zostać zrobiony zrzut. |
| Zwroty | |
|---|---|
InputStreamSource |
InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getScreenshot
public InputStreamSource getScreenshot (String format)
Robi zrzut ekranu urządzenia. Zalecamy używanie zamiast tego metody getScreenshot(format) z kodowaniem JPEG, aby uzyskać mniejszy rozmiar.
| Parametry | |
|---|---|
format |
String: obsługiwane formaty PNG i JPEG |
| Zwroty | |
|---|---|
InputStreamSource |
InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Robi zrzut ekranu urządzenia. Zalecamy używanie getScreenshot(String) zamiast tego formatu, ponieważ w przypadku kodowania JPEG rozmiar jest mniejszy.
| Parametry | |
|---|---|
format |
String: obsługiwane formaty PNG i JPEG |
rescale |
boolean: czy zrzut ekranu ma zostać przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu. |
| Zwroty | |
|---|---|
InputStreamSource |
InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getScreenshot
public InputStreamSource getScreenshot ()
Robi zrzut ekranu urządzenia.
| Zwroty | |
|---|---|
InputStreamSource |
InputStreamSource zrzutu ekranu w formacie PNG lub null, jeśli zrzut ekranu nie został wykonany. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getSerialNumber
public String getSerialNumber ()
Wygodny sposób na uzyskanie numeru seryjnego tego urządzenia.
| Zwroty | |
|---|---|
String |
numer seryjny String; |
getSetting
public String getSetting (int userId,
String namespace,
String key)Zwraca wartość żądanego ustawienia. Przestrzeń nazw musi być jedną z tych wartości: {"system", "secure", "global"}
| Parametry | |
|---|---|
userId |
int |
namespace |
String |
key |
String |
| Zwroty | |
|---|---|
String |
wartość powiązana z przestrzenią nazw:klucz użytkownika. Wartość null, jeśli nie znaleziono. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getSetting
public String getSetting (String namespace,
String key)Patrz getSetting(int, String, String) i wykonywane na użytkowniku systemu.
| Parametry | |
|---|---|
namespace |
String |
key |
String |
| Zwroty | |
|---|---|
String |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getSimOperator
public String getSimOperator ()
Zwraca operatora karty SIM lub wartość null, jeśli nie jest dostępny lub urządzenie jest niedostępne.
| Zwroty | |
|---|---|
String |
|
getSimState
public String getSimState ()
Zwraca stan karty SIM lub wartość null, jeśli karta SIM jest niedostępna lub urządzenie jest niedostępne.
| Zwroty | |
|---|---|
String |
|
getTombstones
publicgetTombstones ()
Pobierz i zwróć listę znaczników usunięcia z urządzeń. Wymaga dostępu do roota.
metoda działa w trybie „najlepsze starania”, więc jeśli z jakiegokolwiek powodu nie uda się pobrać znacznika usunięcia, nie będzie go na liście. Tylko instrukcja DeviceNotAvailableException spowoduje wcześniejsze zakończenie metody.
| Zwroty | |
|---|---|
|
Lista plików tombstone. Jeśli nie ma plików tombstone, lista jest pusta. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getTotalMemory
public long getTotalMemory ()
Zwraca łączny rozmiar pamięci fizycznej w bajtach lub –1 w przypadku błędu wewnętrznego.
| Zwroty | |
|---|---|
long |
|
getTrackingSerial
public String getTrackingSerial ()
Na potrzeby zarządzania urządzeniem pobierz numer seryjny używany do śledzenia urządzenia.
| Zwroty | |
|---|---|
String |
|
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
Pobierz nazwy pakietów aplikacji, które można odinstalować. Obecnie są to pakiety inne niż systemowe i zaktualizowane pakiety systemowe.
| Zwroty | |
|---|---|
|
ERROR(/Set) nazw pakietów, których nie można odinstalować, zainstalowanych obecnie na urządzeniu.String |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getUseFastbootErase
public boolean getUseFastbootErase ()
Sprawdza, czy do wyczyszczenia partycji na urządzeniu należy użyć polecenia fastboot erase czy fastboot format.
| Zwroty | |
|---|---|
boolean |
true czy zostanie użyte polecenie fastboot erase, czy false polecenie fastboot format. |
getUserFlags
public int getUserFlags (int userId)
Znajdź i zwróć flagi danego użytkownika. Flagi są zdefiniowane w klasie „android.content.pm.UserInfo” w projekcie Android Open Source.
| Parametry | |
|---|---|
userId |
int |
| Zwroty | |
|---|---|
int |
flagi powiązane z podanym identyfikatorem użytkownika, jeśli zostaną znalezione, lub -10000 w innych przypadkach. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getUserInfos
publicgetUserInfos ()
Pobiera mapę identyfikatorów użycia do UserInfo na urządzeniu. Zwróci błąd DeviceRuntimeException, jeśli dane wyjściowe z urządzenia nie będą zgodne z oczekiwaniami.
| Zwroty | |
|---|---|
|
lista obiektów UserInfo. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getUserSerialNumber
public int getUserSerialNumber (int userId)
Zwraca numer seryjny powiązany z identyfikatorem userId, jeśli zostanie znaleziony, lub wartość -10000 w innych przypadkach.
| Parametry | |
|---|---|
userId |
int |
| Zwroty | |
|---|---|
int |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
handleAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Przetwarzanie danego zdarzenia DeviceEvent. Może przełączyć urządzenie w nowy stan. Będzie informować IDeviceMonitor o wszelkich zmianach stanu.
Przetwórz zdarzenie DeviceEvent, które może, ale nie musi, przenieść to urządzenie do nowego stanu przydziału.
| Parametry | |
|---|---|
event |
DeviceEvent |
| Zwroty | |
|---|---|
IManagedTestDevice.DeviceEventResponse |
|
hasFeature
public boolean hasFeature (String feature)
Sprawdź, czy funkcja jest dostępna na urządzeniu.
| Parametry | |
|---|---|
feature |
String: format powinien mieć postać „feature: |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli funkcja została znaleziona. W przeciwnym razie wartość false. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
initializeConnection
public void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Zainicjuj połączenie z urządzeniem. Ta funkcja jest wywoływana przez funkcję preInvocationSetup, ale w rzadkich przypadkach może być konieczne jej oddzielne wywołanie podczas tworzenia połączenia w trakcie konfiguracji urządzenia.
| Parametry | |
|---|---|
info |
IBuildInfo |
attributes |
MultiMap |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
installPackage
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 ponownie zainstalować aplikację. |
extraArgs |
String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”. |
| Zwroty | |
|---|---|
String |
String z kodem błędu lub null w przypadku powodzenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
installPackage
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)Zainstaluj pakiet Androida na urządzeniu.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas instalacji.
| Parametry | |
|---|---|
packageFile |
File: plik APK do zainstalowania |
reinstall |
boolean: true, jeśli należy ponownie zainstalować aplikację. |
grantPermissions |
boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane podczas instalacji. |
extraArgs |
String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”. |
| Zwroty | |
|---|---|
String |
String z kodem błędu lub null w przypadku powodzenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
installPackageForUser
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 ponownie zainstalować aplikację. |
userId |
int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać zainstalowana aplikacja. |
extraArgs |
String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”. |
| Zwroty | |
|---|---|
String |
String z kodem błędu lub null w przypadku powodzenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas instalacji.
| Parametry | |
|---|---|
packageFile |
File: plik APK do zainstalowania |
reinstall |
boolean: true, jeśli należy ponownie zainstalować aplikację. |
grantPermissions |
boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane podczas instalacji. |
userId |
int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać zainstalowana aplikacja. |
extraArgs |
String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”. |
| Zwroty | |
|---|---|
String |
String z kodem błędu lub null w przypadku powodzenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
installPackageWithIncrementalMode
public boolean installPackageWithIncrementalMode (File[] apkFiles,
String[] extraArgs,
String userId)Instaluje pliki APK w trybie przyrostowym.
| Parametry | |
|---|---|
apkFiles |
File: pliki APK do zainstalowania. |
extraArgs |
String |
userId |
String |
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
| Zwroty | |
|---|---|
boolean |
|
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczanie aplikacji
| Zwroty | |
|---|---|
boolean |
Prawda, jeśli wyliczanie aplikacji jest obsługiwane, w przeciwnym razie fałsz. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
Sprawdzanie, czy platforma na urządzeniu obsługuje omijanie blokady niskiego docelowego pakietu SDK podczas instalowania aplikacji
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli obejście blokady niskiego docelowego pakietu SDK jest obsługiwane, w przeciwnym razie wartość false. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isDebugfsMounted
public boolean isDebugfsMounted ()
Sprawdź, czy debugfs jest zamontowany.
| Zwroty | |
|---|---|
boolean |
true, jeśli debugfs jest zamontowany |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isDeviceEncrypted
public boolean isDeviceEncrypted ()
Wyświetla informację o tym, czy urządzenie jest zaszyfrowane.
| Zwroty | |
|---|---|
boolean |
true – jeśli urządzenie jest zaszyfrowane. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isDirectory
public boolean isDirectory (String path)
Zwraca wartość Prawda, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość Fałsz.
| Parametry | |
|---|---|
path |
String |
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isEnableAdbRoot
public boolean isEnableAdbRoot ()
| Zwroty | |
|---|---|
boolean |
true czy na urządzeniu ma być włączony dostęp do roota przez adb; |
isEncryptionSupported
public boolean isEncryptionSupported ()
Wyświetla informację o tym, czy urządzenie obsługuje szyfrowanie.
| Zwroty | |
|---|---|
boolean |
true – jeśli urządzenie obsługuje szyfrowanie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isExecutable
public boolean isExecutable (String fullPath)
Zwraca wartość Prawda, jeśli ścieżka pliku na urządzeniu prowadzi do pliku wykonywalnego, w przeciwnym razie zwraca wartość Fałsz.
| Parametry | |
|---|---|
fullPath |
String |
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isFastbootEnabled
public boolean isFastbootEnabled ()
Zwraca wartość, jeśli na urządzeniu jest dostępny tryb Fastboot.
| Zwroty | |
|---|---|
boolean |
|
isHeadless
public boolean isHeadless ()
Zwraca wartość „true”, jeśli urządzenie nie ma ekranu, w przeciwnym razie zwraca wartość „false”.
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Zwraca informację o tym, czy urządzenie korzysta z trybu użytkownika systemu bez interfejsu graficznego.
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani obniżyć jego uprawnień do poziomu użytkownika bez uprawnień administracyjnych.
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isMultiUserSupported
public boolean isMultiUserSupported ()
Określa, czy obsługiwany jest tryb wielu użytkowników.
| Zwroty | |
|---|---|
boolean |
wartość „true”, jeśli obsługiwanych jest wielu użytkowników, w przeciwnym razie „false”. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)Wysyła zapytanie do urządzenia o daną nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana dla tego użytkownika.
| Parametry | |
|---|---|
packageName |
String: pakiet, który sprawdzamy pod kątem instalacji. |
userId |
String: identyfikator użytkownika, dla którego sprawdzamy, czy pakiet jest zainstalowany. Jeśli wartość to null, używana będzie wartość zero. |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli pakiet jest zgłaszany jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Wysyłaj do urządzenia zapytania o daną nazwę pakietu, aby sprawdzić, czy jest on obecnie zainstalowany.
| Parametry | |
|---|---|
packageName |
String |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli pakiet jest zgłaszany jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isRuntimePermissionSupported
public boolean isRuntimePermissionSupported ()
Sprawdzanie, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie działania
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli uprawnienia czasu działania są obsługiwane. W przeciwnym razie wartość false. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Zwraca wartość „prawda”, jeśli urządzenie jest w stanie TestDeviceState.FASTBOOT lub TestDeviceState.FASTBOOTD.
| Zwroty | |
|---|---|
boolean |
|
isUserRunning
public boolean isUserRunning (int userId)
Sprawdź, czy dany użytkownik jest aktywny.
| Parametry | |
|---|---|
userId |
int |
| Zwroty | |
|---|---|
boolean |
Wartość „prawda”, jeśli użytkownik biegnie. W innych przypadkach wartość „fałsz”. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isUserSecondary
public boolean isUserSecondary (int userId)
Zwraca informację, czy określony użytkownik jest użytkownikiem dodatkowym na podstawie jego flag.
| Parametry | |
|---|---|
userId |
int |
| Zwroty | |
|---|---|
boolean |
Wartość „true”, jeśli użytkownik jest dodatkowy, w przeciwnym razie „false”. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isUserVisible
public boolean isUserVisible (int userId)
Sprawdza, czy dany użytkownik jest widoczny.
„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „prawdziwym” użytkownikiem i dlatego może uruchamiać działania (zwykle na domyślnym ekranie).
| Parametry | |
|---|---|
userId |
int |
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu.
„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „prawdziwym” użytkownikiem i dlatego może uruchamiać działania na tym wyświetlaczu.
| Parametry | |
|---|---|
userId |
int |
displayId |
int |
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Zwraca informację, czy urządzenie zezwala na uruchamianie użytkowników w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
W takim przypadku możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean), przekazując wyświetlacz zwrócony przez funkcję listDisplayIdsForStartingVisibleBackgroundUsers() (który powinien zawierać ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Zwraca informację, czy urządzenie zezwala na uruchamianie użytkownikom widocznym w tle.
Jeśli tak, możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean), przekazując wyświetlacz zwrócony przez funkcję listDisplayIdsForStartingVisibleBackgroundUsers().
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isWifiEnabled
public boolean isWifiEnabled ()
Sprawdź, czy Wi-Fi jest włączone.
Sprawdza, czy Wi-Fi jest włączone na urządzeniu. Przydatne do sprawdzania stanu Wi-Fi przed testami, które nie powinny być przeprowadzane przy włączonym Wi-Fi, np. testami danych komórkowych.
| Zwroty | |
|---|---|
boolean |
true, jeśli Wi-Fi jest włączone. false jeśli jest wyłączona |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
listDisplayIds
publiclistDisplayIds ()
Zbierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, zgodnie z raportem „dumpsys SurfaceFlinger”.
| Zwroty | |
|---|---|
|
Lista wyświetlaczy. Domyślna zawsze zwraca domyślny wyświetlacz 0. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Pobiera listę wyświetlaczy, których można używać do start a user visible in the background.
| Zwroty | |
|---|---|
|
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
listUsers
publiclistUsers ()
Pobiera listę użytkowników na urządzeniu. Wyrzuci wyjątek DeviceRuntimeException, jeśli dane wyjściowe z urządzenia nie będą zgodne z oczekiwaniami.
| Zwroty | |
|---|---|
|
lista identyfikatorów użytkowników; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
logAnrs
public boolean logAnrs (ITestLogger logger)
Zbiera i rejestruje błędy ANR z urządzenia.
| Parametry | |
|---|---|
logger |
ITestLogger: ITestLogger do rejestrowania błędów ANR. |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli rejestrowanie się powiodło. W przeciwnym razie wartość false. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)Metoda pomocnicza służąca do tworzenia raportu o błędzie i przesyłania go do osób zgłaszających.
| Parametry | |
|---|---|
dataName |
String: nazwa, pod którą zostanie zgłoszony raport o błędzie. |
listener |
ITestLogger: ITestLogger, aby zarejestrować raport o błędzie. |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli rejestrowanie się powiodło. W przeciwnym razie wartość false. |
logOnDevice
public void logOnDevice (String tag,
Log.LogLevel level,
String format,
Object... args)Zapisz wiadomość w logcat urządzenia. Jest to bezpieczne wywołanie, które nie spowoduje błędu nawet wtedy, gdy rejestrowanie się nie powiedzie.
| Parametry | |
|---|---|
tag |
String: Tag, pod którym rejestrujemy wiadomość w logcat. |
level |
Log.LogLevel: poziom debugowania wiadomości w logcat. |
format |
String: format wiadomości. |
args |
Object: argumenty, które mają zostać zastąpione za pomocą String.format(). |
nonBlockingReboot
public void nonBlockingReboot ()
Wydaje polecenie ponownego uruchomienia urządzenia i zwraca wynik po zakończeniu polecenia oraz gdy urządzenie nie jest już widoczne dla adb.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
postAdbRootAction
public void postAdbRootAction ()
Zastąp, jeśli urządzenie wymaga podjęcia określonych działań po uzyskaniu dostępu do roota za pomocą ADB i przed ponownym połączeniem z siecią. Domyślna implementacja nie obejmuje żadnych dodatkowych działań. Na tym etapie nie ma gwarancji, że polecenie adb root będzie włączone.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
postAdbUnrootAction
public void postAdbUnrootAction ()
Zastąp, jeśli po odrootowaniu za pomocą ADB i przed ponownym połączeniem urządzenia z siecią trzeba wykonać na nim określone działania. Domyślna implementacja nie obejmuje żadnych dodatkowych działań. Na tym etapie nie ma gwarancji, że adb root zostanie wyłączony.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
postBootSetup
public void postBootSetup ()
Wykonaj instrukcje, aby skonfigurować urządzenie do testowania po każdym uruchomieniu.
Powinien być wywoływany po pełnym uruchomieniu lub udostępnieniu urządzenia.
W normalnych okolicznościach nie trzeba wywoływać tej metody bezpośrednio, ponieważ implementacje powinny automatycznie wykonywać te czynności podczas ponownego uruchamiania.
Może być konieczne wywołanie tej funkcji, gdy urządzenie uruchamia się ponownie z powodu innych zdarzeń (np. po zakończeniu polecenia aktualizacji fastboot).
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania.
| Parametry | |
|---|---|
exception |
Throwable: jeśli wystąpił błąd wywołania, jest to ostateczny wyjątek. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Dodatkowe czynności wymagane do skonfigurowania urządzenia, które zostaną wykonane na urządzeniu przed wywołaniem przepływu.
| Parametry | |
|---|---|
info |
IBuildInfo: IBuildInfo urządzenia. |
attributes |
MultiMap: atrybuty przechowywane w kontekście wywołania. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
pullDir
public boolean pullDir (String deviceFilePath,
File localDir,
int userId)Rekursywne pobieranie zawartości katalogu z urządzenia.
| Parametry | |
|---|---|
deviceFilePath |
String: bezwzględna ścieżka pliku źródła zdalnego |
localDir |
File: lokalny katalog, do którego mają być pobierane pliki. |
userId |
int: identyfikator użytkownika, z którego chcesz pobrać dane |
| Zwroty | |
|---|---|
boolean |
true jeśli plik został pobrany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pullDir
public boolean pullDir (String deviceFilePath,
File localDir)Rekursywne pobieranie zawartości katalogu z urządzenia.
| Parametry | |
|---|---|
deviceFilePath |
String: bezwzględna ścieżka pliku źródła zdalnego |
localDir |
File: lokalny katalog, do którego mają być pobierane pliki. |
| Zwroty | |
|---|---|
boolean |
true jeśli plik został pobrany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public boolean pullFile (String remoteFilePath,
File localFile)Pobiera plik z urządzenia.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
localFile |
File: lokalny plik, w którym będą przechowywane treści. Jeśli nie jest pusta, zawartość zostanie zastąpiona. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został pobrany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public File pullFile (String remoteFilePath,
int userId)Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym ERROR(/File) i zwraca ten File.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
userId |
int: identyfikator użytkownika, z którego chcesz pobrać dane. |
| Zwroty | |
|---|---|
File |
ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta). |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public File pullFile (String remoteFilePath)
Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym ERROR(/File) i zwraca ten File.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
| Zwroty | |
|---|---|
File |
ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta). |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public boolean pullFile (String remoteFilePath,
File localFile,
int userId)Pobiera plik z urządzenia.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
localFile |
File: lokalny plik, w którym będą przechowywane treści. Jeśli nie jest pusta, zawartość zostanie zastąpiona. |
userId |
int: identyfikator użytkownika, z którego chcesz pobrać dane. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został pobrany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pullFileContents
public String pullFileContents (String remoteFilePath)
Pobiera plik z urządzenia i zwraca jego zawartość.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
| Zwroty | |
|---|---|
String |
String zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta). |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
Wygodna metoda pobierania pliku z pamięci zewnętrznej urządzenia, zapisywania go w lokalnym pliku tymczasowym ERROR(/File) i zwracania odwołania do tego pliku File.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka do pliku na urządzeniu, względna w stosunku do punktu montowania zewnętrznej pamięci masowej urządzenia |
| Zwroty | |
|---|---|
File |
ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta). |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pushDir
public boolean pushDir (File localFileDir,
String deviceFilePath,
excludedDirectories) Rekursywne przesyłanie zawartości katalogu na urządzenie z wykluczeniem niektórych katalogów, które są filtrowane.
| Parametry | |
|---|---|
localFileDir |
File: katalog lokalny do wypychania |
deviceFilePath |
String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego |
excludedDirectories |
: Zestaw nazw wykluczonych katalogów, które nie powinny być przesyłane. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pushDir
public boolean pushDir (File localFileDir,
String deviceFilePath)Rekursywne przekazywanie zawartości katalogu na urządzenie.
| Parametry | |
|---|---|
localFileDir |
File: katalog lokalny do wypychania |
deviceFilePath |
String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pushDir
public boolean pushDir (File localFileDir,
String deviceFilePath,
int userId)Rekursywne przekazywanie zawartości katalogu na urządzenie.
| Parametry | |
|---|---|
localFileDir |
File: katalog lokalny do wypychania |
deviceFilePath |
String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego |
userId |
int: identyfikator użytkownika, do którego ma zostać wysłane powiadomienie. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pushFile
public boolean pushFile (File localFile,
String remoteFilePath,
boolean evaluateContentProviderNeeded)Wariant pushFile(File, String), który może opcjonalnie uwzględniać ocenę potrzeb dostawcy treści.
| Parametry | |
|---|---|
localFile |
File: plik lokalny do przesłania |
remoteFilePath |
String: bezwzględna ścieżka pliku w miejscu docelowym |
evaluateContentProviderNeeded |
boolean: czy sprawdzić, czy potrzebujemy dostawcy treści. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pushFile
public boolean pushFile (File localFile,
String remoteFilePath)Przekazywanie pliku na urządzenie. Domyślnie używa dostawcy treści.
| Parametry | |
|---|---|
localFile |
File: plik lokalny do przesłania |
remoteFilePath |
String: bezwzględna ścieżka pliku w miejscu docelowym |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pushFile
public boolean pushFile (File localFile,
String remoteFilePath,
int userId)Przekazywanie pliku na urządzenie. Domyślnie używa dostawcy treści.
| Parametry | |
|---|---|
localFile |
File: plik lokalny do przesłania |
remoteFilePath |
String: bezwzględna ścieżka pliku w miejscu docelowym |
userId |
int: identyfikator użytkownika, do którego ma zostać wysłane powiadomienie. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pushString
public boolean pushString (String contents,
String remoteFilePath)Przesyłanie na urządzenie pliku utworzonego z ciągu znaków
| Parametry | |
|---|---|
contents |
String: zawartość pliku do przesłania, |
remoteFilePath |
String: bezwzględna ścieżka pliku w miejscu docelowym |
| Zwroty | |
|---|---|
boolean |
true, jeśli ciąg znaków został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
Uruchom ponownie
public void reboot (String reason)
Uruchamia ponownie urządzenie w trybie adb z podanym parametrem reason, który będzie zachowywany po ponownym uruchomieniu.
Blokuje do momentu, aż urządzenie stanie się dostępne.
Przyczynę ostatniego ponownego uruchomienia można uzyskać, wysyłając zapytanie o właściwość sys.boot.reason.
| Parametry | |
|---|---|
reason |
String: przyczyna ponownego uruchomienia lub null, jeśli nie podano przyczyny. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
Uruchom ponownie
public void reboot ()
Uruchamia ponownie urządzenie w trybie adb.
Blokuje do momentu, aż urządzenie stanie się dostępne.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoBootloader
public void rebootIntoBootloader ()
Uruchamia ponownie urządzenie w trybie programu rozruchowego.
Blokuje działanie do momentu przejścia urządzenia w tryb programu rozruchowego.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Uruchamia ponownie urządzenie w trybie fastbootd.
Blokuje działanie do momentu przejścia urządzenia w tryb fastbootd.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoRecovery
public void rebootIntoRecovery ()
Uruchamia ponownie urządzenie w trybie odzyskiwania adb.
Blokuje do momentu przejścia urządzenia w tryb odzyskiwania
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoSideload
public void rebootIntoSideload ()
Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania).
Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania).
Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku
| Parametry | |
|---|---|
autoReboot |
boolean: czy po wgraniu aplikacji urządzenie ma się automatycznie uruchomić ponownie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
rebootUntilOnline
public void rebootUntilOnline ()
Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
rebootUntilOnline
public void rebootUntilOnline (String reason)
Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.
| Parametry | |
|---|---|
reason |
String: przyczyna ponownego uruchomienia lub null, jeśli nie podano przyczyny. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
rebootUserspace
public void rebootUserspace ()
Ponowne uruchomienie tylko części urządzenia w przestrzeni użytkownika.
Blokuje do momentu, aż urządzenie stanie się dostępne.
OSTRZEŻENIE. Ponowne uruchamianie w przestrzeni użytkownika jest obecnie w fazie rozwoju. Korzystasz z tej funkcji na własne ryzyko.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
Alternatywa dla rebootUserspace() ()}, która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
recoverDevice
public boolean recoverDevice ()
Próbuje przywrócić komunikację z urządzeniem.
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli próba odzyskania zakończyła się powodzeniem. Wartość false, jeśli odzyskiwanie zostało pominięte. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest już dostępne; |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Rejestruje IDeviceActionReceiver na tym urządzeniu.
Wszystkie zarejestrowane IDeviceActionReceiver zostaną powiadomione przed rozpoczęciem działania urządzenia i po jego zakończeniu.
| Parametry | |
|---|---|
deviceActionReceiver |
IDeviceActionReceiver: IDeviceActionReceiver, który zostanie zarejestrowany. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Ustaw partycję systemową na urządzeniu jako tylko do odczytu. Może ponownie uruchomić urządzenie.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
remountSystemWritable
public void remountSystemWritable ()
Ustaw partycję systemową na urządzeniu jako zapisywalną. Może ponownie uruchomić urządzenie.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
remountVendorReadOnly
public void remountVendorReadOnly ()
Ustaw partycję dostawcy na urządzeniu jako tylko do odczytu. Może ponownie uruchomić urządzenie.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
remountVendorWritable
public void remountVendorWritable ()
Ustaw partycję dostawcy na urządzeniu jako zapisywalną. Może ponownie uruchomić urządzenie.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
removeAdmin
public boolean removeAdmin (String componentName,
int userId)Usuwa administratora urządzenia z konta użytkownika i zwraca true, jeśli operacja się uda, a w przeciwnym razie false.
| Parametry | |
|---|---|
componentName |
String: administratora urządzenia do usunięcia. |
userId |
int: użytkownika, w którego profilu znajduje się administrator urządzenia. |
| Zwroty | |
|---|---|
boolean |
Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
removeOwners
public void removeOwners ()
Usuń wszystkich obecnych właścicieli profilu urządzenia, dokładając wszelkich starań.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
removeUser
public boolean removeUser (int userId)
Usuń danego użytkownika z urządzenia.
| Parametry | |
|---|---|
userId |
int: użytkownika, który ma zostać usunięty. |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli użytkownik został usunięty. W przeciwnym razie wartość false. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
resetContentProviderSetup
public void resetContentProviderSetup ()
Zresetuj flagę konfiguracji dostawcy treści, aby ponownie ją wywołać.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Wygodna metoda wykonywania ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z co najmniej 1 odbiorcą przekazanym jako parametr.
| Parametry | |
|---|---|
runner |
IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy. |
listeners |
ITestLifeCycleReceiver: odbiorcy wyników testu |
| Zwroty | |
|---|---|
boolean |
true jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go ukończyć, ale przywracanie zakończyło się powodzeniem. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Uruchamia testy z instrumentacją i umożliwia przywracanie urządzeń.
Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a odzyskiwanie się powiedzie, wszyscy odbiorcy zostaną poinformowani o niepowodzeniu testu, a funkcja zwróci wartość „false”. Polecenie testowe nie zostanie ponownie uruchomione. W razie potrzeby rozmówcy mogą ponowić próbę.
Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a odzyskiwanie się nie powiedzie, wszyscy odbiorcy zostaną poinformowani o niepowodzeniu testu (testRunFailed), a następnie zostanie zgłoszony wyjątek DeviceNotAvailableException.
| Parametry | |
|---|---|
runner |
IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy. |
listeners |
: odbiorcy wyników testu |
| Zwroty | |
|---|---|
boolean |
true jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go ukończyć z powodu wyjątku w komunikacji z urządzeniem, ale przywracanie zakończyło się pomyślnie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Tak samo jak ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), ale
przeprowadza test dla danego użytkownika.
| Parametry | |
|---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Tak samo jak ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...), ale przeprowadza test dla danego użytkownika.
| Parametry | |
|---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
setAdbPath
public void setAdbPath (String adbPath)
Ustawia ścieżkę do pliku binarnego adb, który ma być używany.
| Parametry | |
|---|---|
adbPath |
String |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Wstawia używany element IConfiguration.
| Parametry | |
|---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
| Parametry | |
|---|---|
avdInfo |
GceAvdInfo |
setDate
public void setDate (Date date)
Ustawia datę na urządzeniu
Uwaga: ustawienie daty na urządzeniu wymaga dostępu do roota.
| Parametry | |
|---|---|
date |
Date: określ konkretną datę; jeśli null, użyje daty hosta. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika.
| Parametry | |
|---|---|
componentName |
String: administratora urządzenia na właściciela urządzenia. |
userId |
int: użytkownika, w którego kraju mieszka właściciel urządzenia. |
| Zwroty | |
|---|---|
boolean |
Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Zaktualizuj stan urządzenia.
| Parametry | |
|---|---|
deviceState |
TestDeviceState: TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
W przypadku emulatora ustaw SizeLimitedOutputStream, aby rejestrować dane wyjściowe.
| Parametry | |
|---|---|
output |
SizeLimitedOutputStream: aby rejestrować dane wyjściowe. |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Ustawia Process, gdy urządzenie jest emulatorem.
| Parametry | |
|---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Ustaw opcję fastboot dla urządzenia. Należy go ustawić, gdy urządzenie zostanie po raz pierwszy przydzielone.
| Parametry | |
|---|---|
fastbootEnabled |
boolean: czy na urządzeniu jest dostępny tryb fastboot |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Ustawia ścieżkę do pliku binarnego fastboot, który ma być używany.
Wymaga to nadal, aby zasada isFastbootEnabled() miała wartość Prawda, aby włączyć funkcje fastboot.
| Parametry | |
|---|---|
fastbootPath |
String |
setIDevice
public void setIDevice (IDevice newDevice)
Zaktualizuj urządzenie IDevice powiązane z tym urządzeniem ITestDevice.
Nowy identyfikator IDevice musi odnosić się do tego samego urządzenia fizycznego co bieżące odniesienie. Ta metoda zostanie wywołana, jeśli DDMS przydzieli nowy obiekt IDevice.
| Parametry | |
|---|---|
newDevice |
IDevice: IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Określa czas (w milisekundach) oczekiwania przed rozpoczęciem rejestrowania logcat na urządzeniu online.
| Parametry | |
|---|---|
delay |
int: opóźnienie w milisekundach |
setOptions
public void setOptions (TestDeviceOptions options)
Ustaw TestDeviceOptions na urządzeniu
| Parametry | |
|---|---|
options |
TestDeviceOptions |
setProperty
public boolean setProperty (String propKey,
String propValue)Ustawia na urządzeniu podaną wartość właściwości. Wymaga, aby adb root miało wartość true.
| Parametry | |
|---|---|
propKey |
String: klucz, który ma zostać ustawiony. |
propValue |
String: wartość właściwości do ustawienia. |
| Zwroty | |
|---|---|
boolean |
zwraca True, jeśli polecenie setprop zostało wykonane prawidłowo, a w przeciwnym razie zwraca wartość False. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Ustaw numer IDeviceRecovery, który ma być używany na tym urządzeniu. Należy go ustawić, gdy urządzenie zostanie po raz pierwszy przydzielone.
| Parametry | |
|---|---|
recovery |
IDeviceRecovery: IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Ustaw bieżący tryb odzyskiwania, który ma być używany na urządzeniu.
Służy do określania metody odzyskiwania, która ma być używana w przypadku problemu z komunikacją z urządzeniem. Zalecamy używanie tej metody tylko w razie potrzeby (np. gdy platforma nie działa itp.).
| Parametry | |
|---|---|
mode |
ITestDevice.RecoveryMode: czy tryb „przywracaj tylko do momentu połączenia z siecią” ma być włączony. |
setSetting
public void setSetting (String namespace,
String key,
String value)Patrz setSetting(int, String, String, String) i wykonywane na użytkowniku systemu.
| Parametry | |
|---|---|
namespace |
String |
key |
String |
value |
String |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)Dodaj wartość ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu. Przestrzeń nazw musi być jedną z tych wartości: {"system", "secure", "global"}
| Parametry | |
|---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Wstrzykuje instancję ITestLogger
| Parametry | |
|---|---|
testLogger |
ITestLogger |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
Do celów zarządzania urządzeniami śledź numer seryjny, którego używamy do odwoływania się do urządzenia.
| Parametry | |
|---|---|
trackingSerial |
String |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
Określ, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie fastboot erase czy fastboot format.
| Parametry | |
|---|---|
useFastbootErase |
boolean: true, jeśli ma być użyte polecenie fastboot erase, lub false, jeśli ma być użyte polecenie fastboot format. |
startLogcat
public void startLogcat ()
Rozpocznij przechwytywanie danych wyjściowych logcat z urządzenia w tle.
Nie będzie to miało wpływu, jeśli dane wyjściowe logcat są już rejestrowane. Dane można później pobrać za pomocą funkcji getLogcat.
Gdy urządzenie nie jest już używane, należy wywołać funkcję stopLogcat().
Zwykle nie trzeba wywoływać funkcji startLogcat() i stopLogcat() w kontekście wywołania TF, ponieważ framework TF uruchamia i zatrzymuje logcat.
startTradeInModeTesting
public boolean startTradeInModeTesting (int timeoutMs)
Włącz tryb testowania wymiany za dopłatą. Urządzenie zostanie wyczyszczone i uruchomione ponownie.
| Parametry | |
|---|---|
timeoutMs |
int |
| Zwroty | |
|---|---|
boolean |
Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
startUser
public boolean startUser (int userId)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda nie wykonuje żadnej operacji.
| Parametry | |
|---|---|
userId |
int: użytkownika, aby rozpocząć w tle |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli użytkownik został uruchomiony w tle. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
startUser
public boolean startUser (int userId,
boolean waitFlag)Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda nie wykonuje żadnej operacji. Możesz podać dodatkową flagę, aby poczekać, aż operacja zacznie działać.
| Parametry | |
|---|---|
userId |
int: użytkownika, aby rozpocząć w tle |
waitFlag |
boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany. |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli użytkownik został uruchomiony w tle. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli umożliwia mu uruchamianie aktywności na tym wyświetlaczu).
UWAGA: to polecenie nie sprawdza, czy użytkownik istnieje, czy wyświetlacz jest dostępny, device supports such feature itp.
| Parametry | |
|---|---|
userId |
int: użytkownika, aby rozpocząć w tle |
displayId |
int: wyświetlany użytkownikowi na początku |
waitFlag |
boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany. |
| Zwroty | |
|---|---|
boolean |
true – jeśli użytkownikowi udało się uruchomić widoczną w tle aplikację. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
stopEmulatorOutput
public void stopEmulatorOutput ()
Zamknij i usuń dane wyjściowe emulatora.
stopLogcat
public void stopLogcat ()
Zatrzymuje rejestrowanie danych wyjściowych logcat z urządzenia i odrzuca aktualnie zapisane dane logcat.
Nie będzie mieć wpływu, jeśli dane wyjściowe logcat nie są rejestrowane.
stopTradeInModeTesting
public void stopTradeInModeTesting ()
Zakończ testowanie trybu wymiany za dopłatą.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
stopUser
public boolean stopUser (int userId)
Zatrzymuje danego użytkownika. Jeśli użytkownik jest już zatrzymany, ta metoda nie wykonuje żadnych działań. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.
| Parametry | |
|---|---|
userId |
int: użytkownika, którego chcesz zatrzymać. |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli użytkownik został zatrzymany. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)Zatrzymanie danego użytkownika. Można podać dodatkowe flagi, aby poczekać na wprowadzenie zmian, i wymusić zakończenie sesji użytkownika. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.
| Parametry | |
|---|---|
userId |
int: użytkownika, którego chcesz zatrzymać. |
waitFlag |
boolean: spowoduje, że polecenie będzie czekać, aż użytkownik się zatrzyma. |
forceFlag |
boolean: wymusi zatrzymanie użytkownika. |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli użytkownik został zatrzymany. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
switchToAdbTcp
public String switchToAdbTcp ()
Przełącz urządzenie w tryb adb-over-tcp.
| Zwroty | |
|---|---|
String |
numer seryjny urządzenia TCP lub null, jeśli nie można było przełączyć urządzenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
switchToAdbUsb
public boolean switchToAdbUsb ()
Przełącz urządzenie w tryb adb over usb.
| Zwroty | |
|---|---|
boolean |
true, jeśli przełączanie się powiodło, w przeciwnym razie false. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
switchUser
public boolean switchUser (int userId)
Przełącz na inny identyfikator użytkownika z domyślnym czasem oczekiwania. switchUser(int, long).
| Parametry | |
|---|---|
userId |
int |
| Zwroty | |
|---|---|
boolean |
Wartość „true”, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
switchUser
public boolean switchUser (int userId,
long timeout)Przełącz na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem. Próba wyłączenia blokady ekranu po zmianie użytkownika zakończyła się powodzeniem.
| Parametry | |
|---|---|
userId |
int |
timeout |
long: czas oczekiwania przed zwróceniem wartości false w przypadku niepowodzenia przełączania użytkownika. |
| Zwroty | |
|---|---|
boolean |
Wartość „true”, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
syncFiles
public boolean syncFiles (File localFileDir,
String deviceFilePath)Przyrostowo synchronizuje zawartość lokalnego katalogu plików z urządzeniem.
Decyduje, które pliki przesłać, porównując sygnatury czasowe plików lokalnych z ich zdalnymi odpowiednikami. Na urządzenie zostaną przesłane tylko „nowsze” lub nieistniejące pliki. Dlatego obciążenie powinno być stosunkowo małe, jeśli zestaw plików na urządzeniu jest już aktualny.
Ukryte pliki (których nazwy zaczynają się od „.”) zostaną zignorowane.
Przykład użycia: syncFiles("/tmp/files", "/sdcard") utworzy katalog /sdcard/files, jeśli jeszcze nie istnieje, i rekursywnie przeniesie zawartość /tmp/files do /sdcard/files.
| Parametry | |
|---|---|
localFileDir |
File: lokalny katalog plików zawierający pliki do rekurencyjnego wypychania. |
deviceFilePath |
String: ścieżka bezwzględna do katalogu głównego zdalnego miejsca docelowego. Wszystkie katalogi w tej ścieżce pliku muszą być czytelne. Na przykład próba przesłania pliku do katalogu /data/local/tmp, gdy adb nie ma uprawnień roota, zakończy się niepowodzeniem. |
| Zwroty | |
|---|---|
boolean |
true, jeśli pliki zostały zsynchronizowane. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
takeBugreport
public Bugreport takeBugreport ()
Pobiera raport o błędzie i zwraca go w obiekcie Bugreport, aby go obsłużyć. W razie problemu zwraca wartość null. Plik, do którego odwołuje się obiekt Bugreport, musi zostać wyczyszczony za pomocą funkcji Bugreport.close().
| Zwroty | |
|---|---|
Bugreport |
|
uninstallPackage
public String uninstallPackage (String packageName)
Odinstaluj pakiet Androida z urządzenia.
| Parametry | |
|---|---|
packageName |
String: pakiet na Androida do odinstalowania. |
| Zwroty | |
|---|---|
String |
String z kodem błędu lub null w przypadku powodzenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
uninstallPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)Odinstaluj pakiet Androida z urządzenia dla danego użytkownika.
| Parametry | |
|---|---|
packageName |
String: pakiet na Androida do odinstalowania. |
userId |
int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać odinstalowana aplikacja. |
| Zwroty | |
|---|---|
String |
String z kodem błędu lub null w przypadku powodzenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
unlockDevice
public boolean unlockDevice ()
Odblokowuje urządzenie, jeśli jest ono zaszyfrowane.
Ta metoda może ponownie uruchomić platformę, ale nie wywoła funkcjipostBootSetup(). Dlatego urządzenie może nie być w pełni gotowe do testowania, gdy ta metoda zwróci wynik.
| Zwroty | |
|---|---|
boolean |
true – jeśli operacja się powiedzie lub urządzenie nie jest zaszyfrowane. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Blokuje do momentu ustawienia flagi zakończenia rozruchu urządzenia.
| Parametry | |
|---|---|
timeOut |
long: czas w milisekundach, przez jaki należy czekać na ustawienie flagi. |
| Zwroty | |
|---|---|
boolean |
wartość true, jeśli flaga zakończenia uruchamiania urządzenia jest ustawiona w okresie oczekiwania; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania. Używa domyślnego limitu czasu.
| Zwroty | |
|---|---|
boolean |
Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli przywracanie jest wyłączone i niedostępne. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania.
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zwroty | |
|---|---|
boolean |
Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli przywracanie jest wyłączone i niedostępne. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne, bez uwzględniania ścieżki przywracania.
| Parametry | |
|---|---|
waitTime |
long |
| Zwroty | |
|---|---|
boolean |
Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli jest niedostępne. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Blokuje działanie, dopóki urządzenie nie będzie widoczne w trybie fastboot. Użyj domyślnego limitu czasu.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Blokuje możliwość przejścia urządzenia w stan „adb recovery” (uwaga: różni się od IDeviceRecovery).
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zwroty | |
|---|---|
boolean |
true jeśli urządzenie uruchomi się w trybie odzyskiwania przed upływem czasu.
W innych przypadkach false |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blokuje możliwość przejścia urządzenia w stan „adb sideload”
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zwroty | |
|---|---|
boolean |
true, jeśli urządzenie uruchomi się w trybie sideload przed upływem czasu. W innych przypadkach false
|
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Blokuje urządzenie, aby było niedostępne, tzn. nie było widoczne w adb.
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zwroty | |
|---|---|
boolean |
true, jeśli urządzenie stanie się niedostępne przed upływem czasu.
W innych przypadkach false |
waitForDeviceOnline
public void waitForDeviceOnline ()
Blokuje, dopóki urządzenie nie będzie widoczne przez adb. Używa domyślnego limitu czasu
Pamiętaj, że po zakończeniu procesu urządzenie może nie reagować na polecenia. Zamiast niej używaj zasady waitForDeviceAvailable().
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
Blokuje, dopóki urządzenie nie będzie widoczne przez adb.
Pamiętaj, że po zakończeniu procesu urządzenie może nie reagować na polecenia. Zamiast niej używaj zasady waitForDeviceAvailable().
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Czeka, aż urządzenie odpowie na podstawowe polecenie powłoki adb.
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zwroty | |
|---|---|
boolean |
true, jeśli urządzenie zacznie odpowiadać przed upływem czasu waitTime. |
Metody chronione
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
| Parametry | |
|---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command,
boolean forceExitStatusDetection)Tworzy polecenie systemu operacyjnego dla danej sesji polecenia powłoki adb i argumentów.
| Parametry | |
|---|---|
command |
String |
forceExitStatusDetection |
boolean |
| Zwroty | |
|---|---|
String[] |
|
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature,
int strictMinLevel)| Parametry | |
|---|---|
feature |
String |
strictMinLevel |
int |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Utwórz RebootDeviceAction, który będzie używany podczas restartowania.
| Parametry | |
|---|---|
rebootMode |
NativeDevice.RebootMode: tryb ponownego uruchomienia. |
reason |
String: w przypadku tego ponownego uruchomienia. |
| Zwroty | |
|---|---|
NativeDevice.RebootDeviceAction |
utworzony RebootDeviceAction. |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Wykonaj ponowne uruchomienie za pomocą ADB.
| Parametry | |
|---|---|
rebootMode |
NativeDevice.RebootMode: tryb ponownego uruchomienia. |
reason |
String: w przypadku tego ponownego uruchomienia. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
metoda pomocnicza do zgłaszania wyjątku, jeśli uprawnienia czasu działania nie są obsługiwane;
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getApiLevelSafe
protected int getApiLevelSafe ()
| Zwroty | |
|---|---|
int |
|
getRunUtil
protected IRunUtil getRunUtil ()
Uzyskaj instancję RunUtil, której chcesz używać.
| Zwroty | |
|---|---|
IRunUtil |
|
internalGetProperty
protected String internalGetProperty (String propName,
String fastbootVar,
String description)Pobiera właściwość urządzenia z pamięci podręcznej ddmlib (domyślnie) i wraca do polecenia `adb shell getprop` lub `fastboot getvar` w zależności od tego, czy urządzenie jest w trybie Fastboot.
| Parametry | |
|---|---|
propName |
String: nazwa właściwości urządzenia zwrócona przez polecenie `adb shell getprop` |
fastbootVar |
String: nazwa odpowiedniej zmiennej fastboot, o którą chcesz wysłać zapytanie. Jeśli null, zapytanie fastboot nie zostanie wysłane. |
description |
String: Prosty opis zmiennej. Pierwsza litera powinna być duża. |
| Zwroty | |
|---|---|
String |
Ciąg tekstowy, który może zawierać wartość null lub być pusty, zawierający wartość danej właściwości. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isInRebootCallback
protected boolean isInRebootCallback ()
Zwraca informację, czy wywołania zwrotne ponownego uruchomienia są obecnie wykonywane. Jeśli wartość jest prawdziwa, wszystkie publiczne interfejsy API do ponownego uruchamiania powinny być wyłączone.
| Zwroty | |
|---|---|
boolean |
|
isNewer
protected boolean isNewer (File localFile,
IFileEntry entry)Zwraca true, jeśli plik lokalny jest nowszy niż plik zdalny. IFileEntry dokładny co do minuty. W przypadku równych czasów plik zostanie uznany za nowszy.
| Parametry | |
|---|---|
localFile |
File |
entry |
IFileEntry |
| Zwroty | |
|---|---|
boolean |
|
notifyRebootEnded
protected void notifyRebootEnded ()
Wysyła powiadomienie do wszystkich IDeviceActionReceiver o zakończeniu ponownego uruchamiania.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
notifyRebootStarted
protected void notifyRebootStarted ()
Powiadamia wszystkie urządzenia IDeviceActionReceiver o rozpoczęciu ponownego uruchamiania.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
performDeviceAction
protected boolean performDeviceAction (String actionDescription,
NativeDevice.DeviceAction action,
int retryAttempts)Wykonuje działanie na tym urządzeniu. Próbuje przywrócić urządzenie i opcjonalnie ponowić wykonanie polecenia, jeśli działanie się nie powiedzie.
| Parametry | |
|---|---|
actionDescription |
String: krótki opis działania, które ma zostać wykonane. Służy tylko do rejestrowania. |
action |
NativeDevice.DeviceAction: działanie do wykonania |
retryAttempts |
int: ponowna próba wykonania działania w przypadku niepowodzenia, ale odzyskania danych |
| Zwroty | |
|---|---|
boolean |
true, jeśli działanie zostało wykonane |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli próba odzyskania się nie powiedzie lub osiągnięto maksymalną liczbę prób bez powodzenia; |
postAdbReboot
protected void postAdbReboot (NativeDevice.RebootMode rebootMode)
Możliwe dodatkowe działania, które można wykonać po ponownym uruchomieniu.
| Parametry | |
|---|---|
rebootMode |
NativeDevice.RebootMode |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
prePostBootSetup
protected void prePostBootSetup ()
Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w celu przeprowadzenia konfiguracji po uruchomieniu.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath,
File localFile)| Parametry | |
|---|---|
remoteFilePath |
String |
localFile |
File |
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
setClock
protected void setClock (Clock clock)
Ustaw instancję zegara, której chcesz używać.
| Parametry | |
|---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Oznacza urządzenie testowe jako microdroid i ustawia jego identyfikator klienta.
| Parametry | |
|---|---|
process |
Process: proces maszyny wirtualnej Microdroid. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
| Parametry | |
|---|---|
deviceOptions |
|
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Wykonuje proste polecenie fastboot ze zmiennymi środowiskowymi i zgłasza stan polecenia.
| Parametry | |
|---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
| Zwroty | |
|---|---|
CommandResult |
|
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Wykonuje proste polecenie fastboot i zgłasza jego stan.
| Parametry | |
|---|---|
timeout |
long |
fullCmd |
String |
| Zwroty | |
|---|---|
CommandResult |
|
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc,
long time)Poczekaj, aż urządzenie stanie się niedostępne (przestanie przesyłać raporty do adb).
| Parametry | |
|---|---|
operationDesc |
String: nazwa operacji, która oczekuje na niedostępność. |
time |
long: czas oczekiwania na wystąpienie stanu niedostępności. |
| Zwroty | |
|---|---|
boolean |
Wartość „prawda”, jeśli urządzenie stało się niedostępne. |