NativeDevice
public class NativeDevice
extends Object
implements IConfigurationReceiver , IManagedTestDevice , ITestLoggerReceiver
java.lang.Объект | |
↳ | com.android.tradefed.device.NativeDevice |
Реализация по умолчанию ITestDevice
для устройств Android с неполным стеком.
Краткое содержание
Вложенные классы | |
---|---|
class | NativeDevice.AdbAction |
class | NativeDevice.AdbShellAction |
class | NativeDevice.RebootDeviceAction |
Константы | |
---|---|
int | INVALID_USER_ID Значение, возвращаемое для любого недействительного/не найденного идентификатора пользователя: UserHandle определил значение -10000 |
long | MAX_HOST_DEVICE_TIME_OFFSET |
int | MAX_RETRY_ATTEMPTS количество попыток повтора команды по умолчанию для выполнения |
Поля | |
---|---|
public static final String | DEBUGFS_PATH |
protected static final String | SD_CARD |
protected static final String | STORAGE_EMULATED |
protected TestDeviceOptions | mOptions |
protected final IDeviceStateMonitor | mStateMonitor
|
Публичные конструкторы | |
---|---|
NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor) Создает |
Публичные методы | |
---|---|
void | batchPrefetchStartupBuildProps () Микрооптимизация (около 400 миллисекунд) путем предварительной загрузки всех необходимых нам свойств вместо вызова «adb getprop» для каждого из них. |
boolean | canSwitchToHeadlessSystemUser () Возвращает информацию о том, разрешено ли переключаться на пользователя SYSTEM без заголовка. |
boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) Проверьте, поддерживается ли в настоящее время функция, учитывая минимально поддерживаемый уровень. |
boolean | checkConnectivity () Проверьте, подключено ли устройство к сети. |
boolean | clearErrorDialogs () Попытайтесь закрыть все диалоговые окна с ошибками, отображаемые в данный момент в пользовательском интерфейсе устройства. |
void | clearLastConnectedWifiNetwork () Очищает последнюю подключенную сеть Wi-Fi. |
void | clearLogcat () Удаляет все накопленные данные logcat. |
boolean | connectToWifiNetwork ( Подключается к сети Wi-Fi. |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) Подключается к сети Wi-Fi. |
boolean | connectToWifiNetwork ( Подключается к сети Wi-Fi.f |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) Подключается к сети Wi-Fi. |
boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) Вариант |
boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) Вариант |
int | createUser (String name, boolean guest, boolean ephemeral) Создайте пользователя с заданным именем и предоставленными флагами. |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Создайте пользователя с заданным именем и предоставленными флагами. |
int | createUser (String name) Создайте пользователя с указанным именем и флагами по умолчанию 0. |
int | createUserNoThrow (String name) Создайте пользователя с указанным именем и флагами по умолчанию 0. |
DeviceInspectionResult | debugDeviceNotAvailable () Проверьте устройство и верните подробную информацию, если устройство станет недоступным. |
void | deleteFile (String deviceFilePath, int userId) Вспомогательный метод для удаления файла или каталога на устройстве. |
void | deleteFile (String deviceFilePath) Вспомогательный метод для удаления файла или каталога на устройстве. |
void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Удаляет зарегистрированный |
boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) Вспомогательный метод для проверки того, был ли выполнен мягкий перезапуск устройства, путем сравнения текущего system_server с предыдущим system_server |
boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Вспомогательный метод для проверки того, был ли выполнен мягкий перезапуск устройства с момента времени UTC с момента начала эпохи устройства и его |
boolean | disableAdbRoot () Отключает adb root. |
void | disableKeyguard () Попытки отключить блокировку клавиатуры. |
boolean | disableNetworkMonitor () Отключает мониторинг сети на устройстве. |
boolean | disconnectFromWifi () Отключается от сети Wi-Fi. |
boolean | doesFileExist (String deviceFilePath, int userId) Вспомогательный метод для определения наличия файла на устройстве для данного пользователя. |
boolean | doesFileExist (String deviceFilePath) Вспомогательный метод для определения существования файла на устройстве. |
File | dumpHeap (String process, String devicePath) Попытайтесь сделать дамп кучи из system_server. |
boolean | enableAdbRoot () Включает adb root. |
boolean | enableNetworkMonitor () Включает мониторинг сети на устройстве. |
String | executeAdbCommand (long timeout, String... cmdArgs) Вспомогательный метод, который выполняет команду adb как системную команду с указанным таймаутом. |
String | executeAdbCommand (long timeout, Вспомогательный метод, который выполняет команду adb как системную команду с указанным таймаутом. |
String | executeAdbCommand (String... cmdArgs) Вспомогательный метод, который выполняет команду adb как системную команду. |
CommandResult | executeFastbootCommand (String... cmdArgs) Вспомогательный метод, который выполняет команду fastboot как системную команду со временем ожидания по умолчанию 2 минуты. |
CommandResult | executeFastbootCommand (long timeout, String... cmdArgs) Вспомогательный метод, который выполняет команду fastboot как системную команду. |
CommandResult | executeLongFastbootCommand (String... cmdArgs) Вспомогательный метод, который выполняет длительную команду fastboot как системную команду. |
CommandResult | executeLongFastbootCommand ( Вспомогательный метод, который выполняет длительную команду fastboot как системную команду с системными переменными среды. |
String | executeShellCommand (String command) Вспомогательный метод, который выполняет команду оболочки adb и возвращает вывод в виде |
void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды. |
void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды. |
void | executeShellCommand (String command, IShellOutputReceiver receiver) Выполняет указанную команду оболочки adb, повторяя попытку несколько раз в случае сбоя команды. |
CommandResult | executeShellV2Command (String cmd) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде |
CommandResult | executeShellV2Command (String cmd, OutputStream pipeToOutput) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде |
CommandResult | executeShellV2Command (String cmd, File pipeAsInput) Вспомогательный метод, который выполняет команду оболочки adb и возвращает результаты в виде |
CommandResult | executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды. |
CommandResult | executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды. |
CommandResult | executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды. |
CommandResult | executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Выполняет команду оболочки adb с дополнительными параметрами для управления поведением команды. |
CommandResult | fastbootWipePartition (String partition) Вспомогательный метод, который стирает раздел устройства. |
| getActiveApexes () Получите информацию об APEX, активированных на устройстве. |
| getAllSettings (String namespace) Возвращает пары ключ-значение запрошенного пространства имен. |
DeviceAllocationState | getAllocationState () Верните текущее состояние выделения памяти устройству. |
String | getAndroidId (int userId) Найти и вернуть android-id, связанный с userId, или null, если не найден. |
| getAndroidIds () Создайте карту идентификаторов Android, соответствующих идентификаторам пользователей. |
int | getApiLevel () Получите уровень API устройства. |
PackageInfo | getAppPackageInfo (String packageName) Получить информацию о пакете, установленном на устройстве. |
| getAppPackageInfos () Получить информацию о пакетах, установленных на устройстве. |
String | getBasebandVersion () Удобный способ получить версию этого устройства с базовым диапазоном частот (радио). |
Integer | getBattery () Возвращает текущий уровень заряда батареи устройства или значение Null, если уровень заряда батареи недоступен. |
boolean | getBooleanProperty (String name, boolean defaultValue) Возвращает логическое значение заданного свойства. |
| getBootHistory () Вспомогательный метод собирает карту истории загрузки с указанием времени и причины загрузки. |
| getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) Вспомогательный метод собирает карту истории загрузки с указанием времени и причины загрузки с указанного времени с момента начала эпохи устройства и указанной единицы времени. |
String | getBootloaderVersion () Удобный способ получить версию загрузчика этого устройства. |
InputStreamSource | getBugreport () Извлекает отчет об ошибке из устройства. |
InputStreamSource | getBugreportz () Извлекает отчет об ошибке с устройства. |
String | getBuildAlias () Получите псевдоним сборки, которую в данный момент выполняет устройство. |
String | getBuildFlavor () Получите версию сборки для устройства. |
String | getBuildId () Получите сборку, которую в данный момент выполняет устройство. |
String | getBuildSigningKeys () Возвращает тип ключа, используемый для подписи образа устройства. Обычно устройства Android могут быть подписаны тестовыми ключами (как в AOSP) или ключами выпуска (контролируемыми отдельными производителями устройств). |
DeviceDescriptor | getCachedDeviceDescriptor () Возвращает кэшированный |
DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) Возвращает кэшированный |
String[] | getChildren (String path) Альтернатива использованию |
AbstractConnection | getConnection () Текущее соединение, связанное с устройством. |
ContentProviderHandler | getContentProvider (int userId) Возвращает |
DeviceFoldableState | getCurrentFoldableState () Возвращает текущее состояние складывания устройства или значение null, если возникли какие-либо проблемы. |
int | getCurrentUser () Возвращает идентификатор текущего работающего пользователя. |
String | getDeviceClass () Получите класс устройства. |
long | getDeviceDate () Возвращает дату устройства в миллисекундах с начала эпохи. |
DeviceDescriptor | getDeviceDescriptor () Верните |
DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) Верните |
TestDeviceState | getDeviceState () Получите состояние устройства. |
long | getDeviceTimeOffset (Date date) Помощник для получения разницы во времени между устройством и заданной |
InputStreamSource | getEmulatorOutput () Получить поток stdout и stderr эмулятора |
Process | getEmulatorProcess () Верните |
final File | getExecuteShellCommandLog () Журнал, содержащий все журналы |
long | getExternalStoreFreeSpace () Вспомогательный метод для определения объема свободного места на внешнем накопителе устройства. |
String | getFastbootPath () Возвращает путь к используемому двоичному файлу fastboot. |
String | getFastbootProductType () Удобный метод получения типа продукта этого устройства, когда оно находится в режиме быстрой загрузки. |
String | getFastbootProductVariant () Удобный метод получения типа продукта этого устройства, когда оно находится в режиме быстрой загрузки. |
String | getFastbootSerialNumber () Возвращает серийный номер режима быстрой загрузки. |
String | getFastbootVariable (String variableName) Извлечь указанное значение переменной fastboot из устройства. |
String | getFastbootVersion () Возвращает строку версии используемого двоичного файла fastboot. |
IFileEntry | getFileEntry (String path) Получить ссылку на удаленный файл на устройстве. |
IFileEntry | getFileEntry (FileListingService.FileEntry entry) Неофициальный помощник для получения |
| getFoldableStates () Возвращает список складных состояний на устройстве. |
IDevice | getIDevice () Возвращает ссылку на связанный ddmlib |
| getInstalledPackageNames () Получите имена пакетов приложений, имеющихся на устройстве. |
long | getIntProperty (String name, long defaultValue) Возвращает целочисленное значение указанного свойства с устройства. |
String | getIpAddress () Получает IP-адрес устройства. |
KeyguardControllerState | getKeyguardState () Возвращает объект для получения текущего состояния защиты клавиатуры или null, если не поддерживается. |
long | getLastExpectedRebootTimeMillis () Возвращает время последнего запуска перезагрузки API Tradefed в миллисекундах с момента EPOCH, возвращаемого |
int | getLaunchApiLevel () Получите первый запущенный уровень API устройства. |
InputStreamSource | getLogcat () Захватывает поток снимков данных LogCat. |
InputStreamSource | getLogcat (int maxBytes) Захватывает поток снимков последних |
InputStreamSource | getLogcatDump () Получите дамп текущего журнала событий для устройства. |
InputStreamSource | getLogcatSince (long date) Захватывает поток снимков захваченных данных LogCat, начиная с указанной даты. |
String | getMacAddress () Возвращает MAC-адрес устройства или null, если запрос с устройства не удался. |
Integer | getMainUserId () Возвращает основной идентификатор пользователя. |
| getMainlineModuleInfo () Получите информацию об основных модулях, установленных на устройстве. |
int | getMaxNumberOfRunningUsersSupported () Получите максимальное количество поддерживаемых одновременно работающих пользователей. |
int | getMaxNumberOfUsersSupported () Получите максимальное количество поддерживаемых пользователей. |
Process | getMicrodroidProcess () |
IDeviceStateMonitor | getMonitor () Верните |
String | getMountPoint (String mountName) Возвращает точку монтирования. |
ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) Возвращает |
| getMountPointInfo () Возвращает проанализированную версию информации в /proc/mounts на устройстве. |
TestDeviceOptions | getOptions () Получите параметры тестирования для устройства. |
long | getPartitionFreeSpace (String partition) Вспомогательный метод определения объема свободного места на разделе устройства. |
Integer | getPrimaryUserId () Возвращает основной идентификатор пользователя. |
ProcessInfo | getProcessByName (String processName) Вспомогательный метод запускает команды «pidof» и «stat» и возвращает объект |
String | getProcessPid (String process) Возвращает pid службы или null, если что-то пошло не так. |
String | getProductType () Удобный способ узнать тип продукта данного устройства. |
String | getProductVariant () Удобный способ получить вариант продукта этого устройства. |
String | getProperty (String name) Извлечь указанное значение свойства из устройства. |
ITestDevice.RecoveryMode | getRecoveryMode () Получите текущий режим восстановления, используемый для устройства. |
InputStreamSource | getScreenshot (long displayId) Делает снимок экрана с устройства с указанным идентификатором дисплея. |
InputStreamSource | getScreenshot (String format) Делает снимок экрана с устройства. |
InputStreamSource | getScreenshot (String format, boolean rescale) Делает снимок экрана с устройства. |
InputStreamSource | getScreenshot () Делает снимок экрана с устройства. |
String | getSerialNumber () Удобный способ получить серийный номер этого устройства. |
String | getSetting (int userId, String namespace, String key) Верните значение запрошенной настройки. |
String | getSetting (String namespace, String key) См. |
String | getSimOperator () Возвращает оператора SIM-карты или null, если он недоступен или устройство недоступно. |
String | getSimState () Возвращает состояние SIM-карты или null, если она недоступна или устройство недоступно. |
| getTombstones () Извлечь и вернуть список надгробий с устройств. |
long | getTotalMemory () Возвращает общий размер физической памяти в байтах или -1 в случае внутренней ошибки. |
String | getTrackingSerial () Для управления устройством получите серийный номер, используемый для отслеживания устройства. |
| getUninstallablePackageNames () Получите имена пакетов приложений, которые можно удалить. |
boolean | getUseFastbootErase () Узнайте, следует ли использовать fastboot erasure или fastboot format для очистки раздела на устройстве. |
int | getUserFlags (int userId) Найти и вернуть флаги указанного пользователя. |
| getUserInfos () Получает сопоставление useId с |
int | getUserSerialNumber (int userId) Возвращает серийный номер, связанный с идентификатором пользователя, если он найден, или -10000 в любых других случаях. |
IManagedTestDevice.DeviceEventResponse | handleAllocationEvent (DeviceEvent event) Обработать указанное DeviceEvent. Обработать DeviceEvent, который может перевести или не перевести это устройство в новое состояние распределения. |
boolean | hasFeature (String feature) Проверьте, доступна ли функция на устройстве. |
void | initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes) Инициализируйте подключение к устройству. |
String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Установите пакет Android на устройство. |
String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Установите пакет Android на устройство. |
String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Установить пакет Android на устройство для указанного пользователя. |
String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Установить пакет Android на устройство для указанного пользователя. |
void | invalidatePropertyCache () |
boolean | isAdbRoot () |
boolean | isAdbTcp () |
boolean | isAppEnumerationSupported () Проверьте, поддерживает ли платформа на устройстве перечисление приложений. |
boolean | isBypassLowTargetSdkBlockSupported () Проверьте, поддерживает ли платформа на устройстве обход блокировки SDK с низким уровнем таргета при установке приложений. |
boolean | isDebugfsMounted () Проверьте, смонтирован ли debugfs. |
boolean | isDeviceEncrypted () Возвращает, зашифровано ли устройство. |
boolean | isDirectory (String path) Возвращает True, если путь на устройстве является каталогом, в противном случае возвращает false. |
boolean | isEnableAdbRoot () |
boolean | isEncryptionSupported () Возвращает информацию о поддержке шифрования на устройстве. |
boolean | isExecutable (String fullPath) Возвращает True, если путь к файлу на устройстве является исполняемым файлом, в противном случае — false. |
boolean | isFastbootEnabled () Верните, доступна ли быстрая загрузка для устройства. |
boolean | isHeadless () Возвращает значение true, если устройство не имеет экрана, в противном случае возвращает значение false. |
boolean | isHeadlessSystemUserMode () Возвращает информацию о том, использует ли устройство режим пользователя безголовой системы. |
boolean | isMainUserPermanentAdmin () Возвращает, является ли основной пользователь постоянным администратором и не может ли он быть удален или понижен до статуса «не администратор». |
boolean | isMultiUserSupported () Определяет, поддерживается ли многопользовательский режим. |
boolean | isPackageInstalled (String packageName, String userId) Запросите у устройства заданное имя пакета и заданный идентификатор пользователя, чтобы проверить, установлен ли он в данный момент для этого пользователя. |
boolean | isPackageInstalled (String packageName) Запросите у устройства указанное имя пакета, чтобы проверить, установлен ли он в данный момент или нет. |
boolean | isRuntimePermissionSupported () Проверьте, поддерживает ли платформа на устройстве предоставление разрешений во время выполнения |
boolean | isStateBootloaderOrFastbootd () Возвращает true, если устройство находится в состоянии |
boolean | isUserRunning (int userId) Проверьте, запущен ли данный пользователь. |
boolean | isUserSecondary (int userId) Возвращает информацию о том, является ли указанный пользователь вторичным пользователем в соответствии с его флагами. |
boolean | isUserVisible (int userId) Проверяет, виден ли указанный пользователь. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Проверяет, виден ли указанный пользователь на указанном дисплее. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Возвращает, позволяет ли устройство запускать пользователей видимыми в фоновом режиме в |
boolean | isVisibleBackgroundUsersSupported () Возвращает информацию о том, позволяет ли устройство запускать пользователей в фоновом режиме. |
boolean | isWifiEnabled () Проверьте, включен ли Wi-Fi. |
| listDisplayIds () Соберите список доступных идентификаторов дисплеев на устройстве, как сообщает «dumpsys SurfaceFlinger». |
| listDisplayIdsForStartingVisibleBackgroundUsers () Получает список дисплеев, которые можно использовать для |
| listUsers () Получает список пользователей на устройстве. |
boolean | logAnrs ( ITestLogger logger) Собирает и регистрирует ANR с устройства. |
boolean | logBugreport (String dataName, ITestLogger listener) Вспомогательный метод для создания отчета об ошибке и его передачи авторам отчетов. |
void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Запишите сообщение в журнал событий устройства. |
void | mountDebugfs () Смонтировать debugfs. |
void | nonBlockingReboot () Выдает команду на перезагрузку устройства и возвращает результат после завершения команды и когда устройство больше не видно для adb. |
void | postAdbRootAction () Переопределите, если после adb root и до повторного подключения устройства к сети необходимо выполнить некоторые особые действия. |
void | postAdbUnrootAction () Переопределить, если после adb unroot и перед повторным подключением устройства к сети необходимо выполнить какие-либо особые действия. |
void | postBootSetup () Выполните инструкции по настройке устройства для тестирования после каждой загрузки. |
void | postInvocationTearDown (Throwable exception) Дополнительные шаги для очистки, необходимой для конкретного устройства, будут выполнены после завершения вызова. |
void | preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) Дополнительные шаги для настройки конкретного устройства, которые будут выполнены на устройстве перед потоком вызова. |
boolean | pullDir (String deviceFilePath, File localDir, int userId) Рекурсивно извлечь содержимое каталога с устройства. |
boolean | pullDir (String deviceFilePath, File localDir) Рекурсивно извлечь содержимое каталога с устройства. |
boolean | pullFile (String remoteFilePath, File localFile) Извлекает файл с устройства. |
File | pullFile (String remoteFilePath, int userId) Извлекает файл с устройства, сохраняет его в локальном временном |
File | pullFile (String remoteFilePath) Извлекает файл с устройства, сохраняет его в локальном временном |
boolean | pullFile (String remoteFilePath, File localFile, int userId) Извлекает файл с устройства. |
String | pullFileContents (String remoteFilePath) Извлекает файл с устройства и возвращает его содержимое. |
File | pullFileFromExternal (String remoteFilePath) Удобный метод для извлечения файла из внешнего хранилища устройства, сохранения его в локальном временном |
boolean | pushDir (File localFileDir, String deviceFilePath, Рекурсивно передать содержимое каталога на устройство, исключив некоторые отфильтрованные каталоги. |
boolean | pushDir (File localFileDir, String deviceFilePath) Рекурсивно передать содержимое каталога на устройство. |
boolean | pushDir (File localFileDir, String deviceFilePath, int userId) Рекурсивно передать содержимое каталога на устройство. |
boolean | pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded) Вариант |
boolean | pushFile (File localFile, String remoteFilePath) Передача файла на устройство. |
boolean | pushFile (File localFile, String remoteFilePath, int userId) Передача файла на устройство. |
boolean | pushString (String contents, String remoteFilePath) Передача файла, созданного из строки, на устройство |
void | reboot (String reason) Перезагружает устройство в режим adb с указанием |
void | reboot () Перезагружает устройство в режим adb. |
void | rebootIntoBootloader () Перезагружает устройство в режим загрузчика. |
void | rebootIntoFastbootd () Перезагружает устройство в режим fastbootd. |
void | rebootIntoRecovery () Перезагружает устройство в режим восстановления adb. |
void | rebootIntoSideload () Перезагружает устройство в режим adb sideload (обратите внимание, что это специальный режим при восстановлении) Блокируется до тех пор, пока устройство не перейдет в режим боковой загрузки |
void | rebootIntoSideload (boolean autoReboot) Перезагружает устройство в режим adb sideload (обратите внимание, что это специальный режим при восстановлении) Блокируется до тех пор, пока устройство не перейдет в режим боковой загрузки |
void | rebootUntilOnline () Альтернатива |
void | rebootUntilOnline (String reason) Альтернатива |
void | rebootUserspace () Перезагружает только пользовательскую часть устройства. |
void | rebootUserspaceUntilOnline () Альтернатива |
boolean | recoverDevice () Попытки восстановить связь с устройством. |
void | registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Регистрирует |
void | remountSystemReadOnly () Сделайте системный раздел на устройстве доступным только для чтения. |
void | remountSystemWritable () Сделайте системный раздел на устройстве доступным для записи. |
void | remountVendorReadOnly () Сделайте раздел поставщика на устройстве доступным только для чтения. |
void | remountVendorWritable () Сделайте раздел поставщика на устройстве доступным для записи. |
boolean | removeAdmin (String componentName, int userId) Удалить администратора указанного устройства для указанного пользователя и вернуть |
void | removeOwners () Приложите все усилия, чтобы удалить всех существующих владельцев профилей устройств. |
boolean | removeUser (int userId) Удалить указанного пользователя с устройства. |
void | resetContentProviderSetup () Сбросьте флаг настройки поставщика контента, чтобы снова активировать его. |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Удобный метод для выполнения |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, Проводит испытания приборов и обеспечивает восстановление устройств. |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, То же, что |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) То же, что и |
void | setConfiguration ( IConfiguration configuration) Внедряет используемую |
final void | setConnectionAvdInfo ( GceAvdInfo avdInfo) |
void | setDate (Date date) Устанавливает дату на устройстве Примечание: для установки даты на устройстве требуются права root. |
boolean | setDeviceOwner (String componentName, int userId) Установить компонент администратора устройства в качестве владельца устройства для данного пользователя. |
void | setDeviceState ( TestDeviceState deviceState) Обновите состояние устройства. |
void | setEmulatorOutputStream ( SizeLimitedOutputStream output) Для эмулятора установите |
void | setEmulatorProcess (Process p) Устанавливает |
void | setFastbootEnabled (boolean fastbootEnabled) Установите опцию быстрой загрузки для устройства. |
void | setFastbootPath (String fastbootPath) Задает путь к двоичному файлу fastboot, который следует использовать. |
void | setIDevice (IDevice newDevice) Обновите IDevice, связанный с этим ITestDevice. |
void | setLogStartDelay (int delay) Устанавливает время ожидания в мс перед началом сбора данных logcat для подключенного к сети устройства. |
void | setOptions ( TestDeviceOptions options) Установите |
boolean | setProperty (String propKey, String propValue) Устанавливает заданное значение свойства на устройстве. |
void | setRecovery ( IDeviceRecovery recovery) Установите |
void | setRecoveryMode ( ITestDevice.RecoveryMode mode) Установите текущий режим восстановления для устройства. |
void | setSetting (String namespace, String key, String value) См. |
void | setSetting (int userId, String namespace, String key, String value) Добавить значение настройки в пространство имен данного пользователя. |
void | setTestLogger ( ITestLogger testLogger) Внедряет экземпляр |
void | setTrackingSerial (String trackingSerial) Для управления устройством отслеживайте серийный номер, который мы используем для обозначения устройства. |
void | setUseFastbootErase (boolean useFastbootErase) Укажите, следует ли использовать fastboot erasure или fastboot format для очистки раздела на устройстве. |
void | startLogcat () Начать захват выходных данных logcat с устройства в фоновом режиме. |
boolean | startTradeInModeTesting (int timeoutMs) Включить тестовый режим обмена. |
boolean | startUser (int userId) Запускает заданного пользователя в фоновом режиме, если он в данный момент остановлен. |
boolean | startUser (int userId, boolean waitFlag) Запускает заданного пользователя в фоновом режиме, если он в данный момент остановлен. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Запускает заданного пользователя в фоновом режиме, видимого на заданном дисплее (т.е. позволяет пользователю запускать действия на этом дисплее). |
void | stopEmulatorOutput () Закройте и удалите вывод эмулятора. |
void | stopLogcat () Остановите сбор выходных данных Logcat с устройства и удалите текущие сохраненные данные Logcat. |
void | stopTradeInModeTesting () Прекратить тестирование в режиме обмена. |
boolean | stopUser (int userId) Останавливает указанного пользователя. |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Остановить указанного пользователя. |
String | switchToAdbTcp () Переключите устройство в режим adb-over-tcp. |
boolean | switchToAdbUsb () Переключите устройство в режим adb через USB. |
boolean | switchUser (int userId) Переключитесь на другой идентификатор пользователя с тайм-аутом по умолчанию. |
boolean | switchUser (int userId, long timeout) Переключитесь на другой идентификатор пользователя с указанным временем ожидания в качестве крайнего срока. |
boolean | syncFiles (File localFileDir, String deviceFilePath) Поэтапно синхронизирует содержимое локального файлового каталога с устройством. |
Bugreport | takeBugreport () Берем отчет об ошибке и возвращаем его в объект |
String | uninstallPackage (String packageName) Удалить пакет Android с устройства. |
String | uninstallPackageForUser (String packageName, int userId) Удалить пакет Android с устройства для указанного пользователя. |
boolean | unlockDevice () Разблокирует устройство, если оно находится в зашифрованном состоянии. |
void | unmountDebugfs () Размонтируйте debugfs. |
boolean | waitForBootComplete (long timeOut) Блокируется до тех пор, пока не будет установлен флаг завершения загрузки устройства. |
boolean | waitForDeviceAvailable () Ожидает, пока устройство станет отзывчивым и доступным для тестирования. |
boolean | waitForDeviceAvailable (long waitTime) Ожидает, пока устройство станет отзывчивым и доступным для тестирования. |
boolean | waitForDeviceAvailableInRecoverPath (long waitTime) Ожидает, пока устройство станет доступным и не будет реагировать, не принимая во внимание путь восстановления. |
void | waitForDeviceBootloader () Блокируется до тех пор, пока устройство не станет видимым через fastboot. |
boolean | waitForDeviceInRecovery (long waitTime) Блокирует переход устройства в состояние «adb recovery» (обратите внимание, что это отличается от |
boolean | waitForDeviceInSideload (long waitTime) Блокирует нахождение устройства в состоянии «adb sideload» |
boolean | waitForDeviceNotAvailable (long waitTime) Блокирует доступность устройства, т.е. отсутствие его в adb |
void | waitForDeviceOnline () Блокирует, пока устройство не станет видимым через adb. |
void | waitForDeviceOnline (long waitTime) Блокирует, пока устройство не станет видимым через adb. |
boolean | waitForDeviceShell (long waitTime) Ожидает, пока устройство отреагирует на базовую команду оболочки adb. |
Защищенные методы | |
---|---|
void | addExtraConnectionBuilderArgs ( DefaultConnection.ConnectionBuilder builder) |
String[] | buildAdbShellCommand (String command, boolean forceExitStatusDetection) Создает команду ОС для заданного сеанса команды оболочки adb и аргументов |
void | checkApiLevelAgainst (String feature, int strictMinLevel) |
NativeDevice.RebootDeviceAction | createRebootDeviceAction ( NativeDevice.RebootMode rebootMode, String reason) Создайте |
IRunUtil | createRunUtil () |
void | doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason) Выполните перезагрузку adb. |
void | ensureRuntimePermissionSupported () вспомогательный метод для создания исключения, если разрешение времени выполнения не поддерживается |
int | getApiLevelSafe () |
ITestLogger | getLogger () |
IRunUtil | getRunUtil () Получите экземпляр |
String | internalGetProperty (String propName, String fastbootVar, String description) Извлечь свойство устройства из кэша ddmlib по умолчанию и использовать `adb shell getprop` или `fastboot getvar` в зависимости от того, находится ли устройство в режиме быстрой загрузки или нет. |
boolean | isInRebootCallback () Возвращает информацию о том, выполняются ли в данный момент обратные вызовы перезагрузки. |
boolean | isNewer (File localFile, IFileEntry entry) Возвращает |
void | notifyRebootEnded () Уведомляет все |
void | notifyRebootStarted () Уведомляет все |
boolean | performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts) Выполняет действие на этом устройстве. |
void | postAdbReboot () Возможные дополнительные действия, которые можно выполнить после перезагрузки. |
void | prePostBootSetup () Позволяет каждому типу устройства (AndroidNativeDevice, TestDevice) переопределять этот метод для конкретной настройки после загрузки. |
boolean | pullFileInternal (String remoteFilePath, File localFile) |
void | setClock (Clock clock) Установите экземпляр часов для использования. |
void | setMicrodroidProcess (Process process) Помечает TestDevice как microdroid и устанавливает его CID. |
void | setTestDeviceOptions ( |
CommandResult | simpleFastbootCommand (long timeout, Выполняет простую команду fastboot с переменными среды и сообщает о состоянии команды. |
CommandResult | simpleFastbootCommand (long timeout, String[] fullCmd) Выполняет простую команду fastboot и сообщает о состоянии команды. |
boolean | waitForDeviceNotAvailable (String operationDesc, long time) Подождите, пока устройство станет недоступным (прекратится отправка сообщений в adb). |
Константы
НЕВЕРНЫЙ_ИД_ПОЛЬЗОВАТЕЛЯ
public static final int INVALID_USER_ID
Значение, возвращаемое для любого недействительного/не найденного идентификатора пользователя: UserHandle определил значение -10000
Постоянное значение: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Постоянное значение: 5000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
количество попыток повтора команды по умолчанию для выполнения
Постоянное значение: 2 (0x00000002)
Поля
DEBUGFS_PATH
public static final String DEBUGFS_PATH
SD_КАРТА
protected static final String SD_CARD
ХРАНЕНИЕ_ЭМУЛЯЦИЯ
protected static final String STORAGE_EMULATED
mОпции
protected TestDeviceOptions mOptions
mStateMonitor
protected final IDeviceStateMonitor mStateMonitor
Публичные конструкторы
NativeDevice
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Создает TestDevice
.
Параметры | |
---|---|
device | IDevice : связанный IDevice |
stateMonitor | IDeviceStateMonitor : используемый механизм IDeviceStateMonitor |
allocationMonitor | IDeviceMonitor : IDeviceMonitor для информирования об изменениях состояния распределения. Может быть null |
Публичные методы
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Микрооптимизация (около 400 миллисекунд) путем предварительной выборки всех необходимых нам свойств вместо вызова 'adb getprop' для каждого из них. То есть, извлечение всех свойств происходит так же быстро, как и извлечение одного. Такие вещи, как device.getApiLevel(), checkApiLevelAgainstNextRelease и getBuildAlias, все вызывают `adb getprop` под капотом. Мы извлекаем их за один вызов и вызываем NativeDevice.setProperty. Даже если мы этого не сделаем, NativeDevice сам вызовет setProperty и кэширует результат для будущих вызовов. Мы просто делаем это немного раньше. Если устройство находится в состоянии восстановления или есть другие ошибки при извлечении свойств, мы просто игнорируем их.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Возвращает информацию о том, разрешено ли переключаться на пользователя SYSTEM без заголовка.
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
проверкаApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Проверьте, поддерживается ли в настоящее время функция, учитывая минимально поддерживаемый уровень. Этот метод учитывает еще не выпущенные функции, прежде чем уровень API будет повышен.
Параметры | |
---|---|
strictMinLevel | int : Строгий минимально возможный уровень, поддерживающий функцию. |
Возвраты | |
---|---|
boolean | True, если уровень поддерживается. False в противном случае. |
Броски | |
---|---|
DeviceNotAvailableException |
checkConnectivity
public boolean checkConnectivity ()
Проверьте, подключено ли устройство к сети.
Возвраты | |
---|---|
boolean | true , если устройство имеет работающее сетевое подключение, false в противном случае. |
Броски | |
---|---|
DeviceNotAvailableException |
clearErrorDialogs
public boolean clearErrorDialogs ()
Попытайтесь закрыть все диалоговые окна с ошибками, отображаемые в данный момент в пользовательском интерфейсе устройства.
Возвраты | |
---|---|
boolean | true , если диалоги отсутствуют или диалоги были успешно очищены. false в противном случае. |
Броски | |
---|---|
DeviceNotAvailableException |
очиститьПоследнееПодключениеWi-FiСеть
public void clearLastConnectedWifiNetwork ()
Очищает последнюю подключенную сеть Wi-Fi. Это должно быть вызвано при запуске нового вызова, чтобы избежать подключения к сети Wi-Fi, использованной в предыдущем тесте, после перезагрузки устройства.
clearLogcat
public void clearLogcat ()
Удаляет все накопленные данные logcat.
Это полезно в случаях, когда вы хотите убедиться, чтоITestDevice.getLogcat()
возвращает только данные журнала, созданные после определенного момента (например, после прошивки новой сборки устройства и т. д.). connectToWifiСеть
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Подключается к сети Wi-Fi.
Включает Wi-Fi и блокирует до тех пор, пока не будет установлено успешное соединение с одной из сетей Wi-Fi, указанных в карте wifiSsidToPsk. После установки соединения экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice.disconnectFromWifi()
или ITestDevice.clearLastConnectedWifiNetwork()
.
Параметры | |
---|---|
wifiSsidToPsk | : Сопоставление идентификаторов SSID сетей Wi-Fi и паролей. |
scanSsid | boolean : следует ли сканировать скрытые SSID для этой сети. |
Возвраты | |
---|---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
Броски | |
---|---|
DeviceNotAvailableException |
connectToWifiСеть
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Подключается к сети Wi-Fi.
Включает Wi-Fi и блокирует до тех пор, пока не будет установлено успешное подключение к указанной сети Wi-Fi. После установки подключения экземпляр будет пытаться восстановить подключение после каждой перезагрузки, пока не будет вызванITestDevice.disconnectFromWifi()
или ITestDevice.clearLastConnectedWifiNetwork()
.Параметры | |
---|---|
wifiSsid | String : SSID Wi-Fi для подключения |
wifiPsk | String : парольная фраза PSK или ноль, если не зашифровано |
Возвраты | |
---|---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
Броски | |
---|---|
DeviceNotAvailableException |
connectToWifiСеть
public boolean connectToWifiNetwork (wifiSsidToPsk)
Подключается к сети Wi-Fi.
Включает Wi-Fi и блокирует до тех пор, пока не будет установлено успешное соединение с одной из сетей Wi-Fi, указанных в карте wifiSsidToPsk. После установки соединения экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice.disconnectFromWifi()
или ITestDevice.clearLastConnectedWifiNetwork()
Параметры | |
---|---|
wifiSsidToPsk | : Сопоставление идентификаторов SSID сетей Wi-Fi и паролей. |
Возвраты | |
---|---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
Броски | |
---|---|
DeviceNotAvailableException |
connectToWifiСеть
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Подключается к сети Wi-Fi.
Включает Wi-Fi и блокирует до тех пор, пока не будет установлено успешное подключение к указанной сети Wi-Fi. После установки подключения экземпляр будет пытаться восстановить подключение после каждой перезагрузки, пока не будет вызванITestDevice.disconnectFromWifi()
или ITestDevice.clearLastConnectedWifiNetwork()
.Параметры | |
---|---|
wifiSsid | String : SSID Wi-Fi для подключения |
wifiPsk | String : парольная фраза PSK или ноль, если не зашифровано |
scanSsid | boolean : следует ли сканировать скрытые SSID для этой сети. |
Возвраты | |
---|---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
Броски | |
---|---|
DeviceNotAvailableException |
Подключиться к сети Wi-Fi, если необходимо
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Вариант connectToWifiNetwork(String, String)
, который подключается только в том случае, если устройство в данный момент не подключено к сети.
Параметры | |
---|---|
scanSsid | boolean : следует ли сканировать скрытые SSID для этой сети |
Возвраты | |
---|---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
Броски | |
---|---|
DeviceNotAvailableException |
Подключиться к сети Wi-Fi, если необходимо
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Вариант connectToWifiNetwork(String, String)
, который подключается только в том случае, если устройство в данный момент не подключено к сети.
Возвраты | |
---|---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
Броски | |
---|---|
DeviceNotAvailableException |
создатьПользователь
public int createUser (String name, boolean guest, boolean ephemeral)
Создайте пользователя с заданным именем и предоставленными флагами.
Параметры | |
---|---|
name | String : пользователя, которого нужно создать на устройстве |
guest | boolean : включить пользовательский флаг --guest во время создания |
ephemeral | boolean : включить пользовательский флаг --ephemeral во время создания |
Возвраты | |
---|---|
int | идентификатор созданного пользователя |
Броски | |
---|---|
DeviceNotAvailableException |
создатьПользователь
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Создайте пользователя с заданным именем и предоставленными флагами.
Параметры | |
---|---|
name | String : пользователя, которого нужно создать на устройстве |
guest | boolean : включить пользовательский флаг --guest во время создания |
ephemeral | boolean : включить пользовательский флаг --ephemeral во время создания |
forTesting | boolean : включить тестовый флаг --for-testing во время создания |
Возвраты | |
---|---|
int | идентификатор созданного пользователя |
Броски | |
---|---|
DeviceNotAvailableException |
создатьПользователь
public int createUser (String name)
Создайте пользователя с указанным именем и флагами по умолчанию 0.
Параметры | |
---|---|
name | String : пользователя, которого нужно создать на устройстве |
Возвраты | |
---|---|
int | целое число для созданного идентификатора пользователя |
Броски | |
---|---|
DeviceNotAvailableException |
создатьUserNoThrow
public int createUserNoThrow (String name)
Создайте пользователя с указанным именем и флагами по умолчанию 0.
Параметры | |
---|---|
name | String : пользователя, которого нужно создать на устройстве |
Возвраты | |
---|---|
int | целое число для созданного идентификатора пользователя или -1 в случае ошибки. |
Броски | |
---|---|
DeviceNotAvailableException |
debugDeviceNotAvailable
public DeviceInspectionResult debugDeviceNotAvailable ()
Проверьте устройство и верните подробную информацию, если устройство станет недоступным.
Возвраты | |
---|---|
DeviceInspectionResult |
удалитьФайл
public void deleteFile (String deviceFilePath, int userId)
Вспомогательный метод для удаления файла или каталога на устройстве.
Параметры | |
---|---|
deviceFilePath | String : Абсолютный путь к файлу на устройстве. |
userId | int : идентификатор пользователя, которого нужно удалить |
Броски | |
---|---|
DeviceNotAvailableException |
удалитьФайл
public void deleteFile (String deviceFilePath)
Вспомогательный метод для удаления файла или каталога на устройстве.
Параметры | |
---|---|
deviceFilePath | String : Абсолютный путь к файлу на устройстве. |
Броски | |
---|---|
DeviceNotAvailableException |
отмените регистрациюDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Удаляет зарегистрированный IDeviceActionReceiver
.
Параметры | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : IDeviceActionReceiver , который будет удален. |
deviceSoftRestarted
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Вспомогательный метод для проверки, был ли выполнен мягкий перезапуск устройства путем сравнения текущего system_server с предыдущим system_server ProcessInfo
. Используйте getProcessByName(String)
для получения ProcessInfo
.
Параметры | |
---|---|
prevSystemServerProcess | ProcessInfo : предыдущий процесс system_server ProcessInfo . |
Возвраты | |
---|---|
boolean | true , если устройство перезапущено |
Броски | |
---|---|
DeviceNotAvailableException |
deviceSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Вспомогательный метод для проверки, был ли выполнен мягкий перезапуск устройства с момента времени UTC с момента эпохи от устройства и его ERROR(/TimeUnit)
. Мягкий перезапуск относится к system_server, перезапущенному вне жесткой перезагрузки устройства (например: запрошенная перезагрузка). Текущее значение utcEpochTime устройства в миллисекундах можно получить с помощью метода getDeviceDate()
.
Параметры | |
---|---|
utcEpochTime | long : время устройства в секундах с начала эпохи. |
timeUnit | TimeUnit : единица времени TimeUnit для заданного utcEpochTime. |
Возвраты | |
---|---|
boolean | true , если устройство перезапущено |
Броски | |
---|---|
DeviceNotAvailableException |
отключитьAdbRoot
public boolean disableAdbRoot ()
Отключает adb root.
Отключение adb root может привести к отключению устройства от adb. Этот метод будет блокироваться до тех пор, пока устройство не станет доступно.Возвраты | |
---|---|
boolean | true в случае успеха. |
Броски | |
---|---|
DeviceNotAvailableException |
отключитьKeyguard
public void disableKeyguard ()
Попытки отключить блокировку клавиатуры.
Сначала дождитесь готовности отправки ввода, это происходит примерно в то же время, когда устройство сообщает BOOT_COMPLETE, по-видимому, асинхронно, поскольку текущая реализация фреймворка имеет случайные состояния гонки. Затем отправляется команда на отключение keyguard (работает только на незащищенных)
Броски | |
---|---|
DeviceNotAvailableException |
отключитьNetworkMonitor
public boolean disableNetworkMonitor ()
Отключает мониторинг сети на устройстве.
Возвраты | |
---|---|
boolean | true , если мониторинг успешно отключен. false если мониторинг не удался. |
Броски | |
---|---|
DeviceNotAvailableException |
отключитьFromWiFi
public boolean disconnectFromWifi ()
Отключается от сети Wi-Fi.
Удаляет все сети из списка известных сетей и отключает Wi-Fi.Возвраты | |
---|---|
boolean | true , если отключение от сети Wi-Fi прошло успешно. false , если отключение не удалось. |
Броски | |
---|---|
DeviceNotAvailableException |
doesFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
Вспомогательный метод для определения наличия файла на устройстве для данного пользователя.
Параметры | |
---|---|
deviceFilePath | String : абсолютный путь к файлу на устройстве для проверки. |
userId | int : идентификатор пользователя, по которому проверяется существование файла |
Возвраты | |
---|---|
boolean | true если файл существует, в противном случае false . |
Броски | |
---|---|
DeviceNotAvailableException |
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Вспомогательный метод для определения существования файла на устройстве.
Параметры | |
---|---|
deviceFilePath | String : абсолютный путь к файлу на устройстве для проверки. |
Возвраты | |
---|---|
boolean | true если файл существует, в противном случае false . |
Броски | |
---|---|
DeviceNotAvailableException |
dumpHeap
public File dumpHeap (String process, String devicePath)
Попытаться сбросить кучу из system_server. Очистка сброшенного файла является обязанностью вызывающего.
Параметры | |
---|---|
process | String : имя процесса устройства, на котором будет создан дамп. |
devicePath | String : путь на устройстве, куда поместить дамп. Это должно быть место, где разрешения это позволяют. |
Возвраты | |
---|---|
File | ERROR(/File) содержащий отчет. Null, если что-то не удалось. |
Броски | |
---|---|
DeviceNotAvailableException |
включитьAdbRoot
public boolean enableAdbRoot ()
Включает adb root. Если настройка "enable-root" имеет значение "false", выведет сообщение и вернется без включения root.
Включение adb root может привести к отключению устройства от adb. Этот метод будет блокироваться до тех пор, пока устройство не станет доступно.Возвраты | |
---|---|
boolean | true в случае успеха. |
Броски | |
---|---|
DeviceNotAvailableException |
включитьNetworkMonitor
public boolean enableNetworkMonitor ()
Включает мониторинг сети на устройстве.
Возвраты | |
---|---|
boolean | true , если мониторинг включен успешно. false если мониторинг не удался. |
Броски | |
---|---|
DeviceNotAvailableException |
выполнитьAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
Вспомогательный метод, который выполняет команду adb как системную команду с указанным таймаутом.
Вместо этого следует использовать executeShellCommand(String)
везде, где это возможно, поскольку этот метод обеспечивает лучшее обнаружение сбоев и производительность.
Параметры | |
---|---|
timeout | long : время в миллисекундах, по истечении которого устройство будет считаться неотвечающим, 0L — без тайм-аута |
cmdArgs | String : команда adb и аргументы для запуска |
Возвраты | |
---|---|
String | stdout от команды. null если команда не была выполнена. |
Броски | |
---|---|
DeviceNotAvailableException |
выполнитьAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
Вспомогательный метод, который выполняет команду adb как системную команду с указанным таймаутом.
Вместо этого следует использовать executeShellCommand(String)
везде, где это возможно, поскольку этот метод обеспечивает лучшее обнаружение сбоев и производительность.
Параметры | |
---|---|
timeout | long : время в миллисекундах, по истечении которого устройство будет считаться неотвечающим, 0L — без тайм-аута |
envMap | : среда, устанавливаемая для команды |
cmdArgs | String : команда adb и аргументы для запуска |
Возвраты | |
---|---|
String | stdout от команды. null если команда не была выполнена. |
Броски | |
---|---|
DeviceNotAvailableException |
выполнитьAdbCommand
public String executeAdbCommand (String... cmdArgs)
Вспомогательный метод, который выполняет команду adb как системную команду.
executeShellCommand(String)
следует использовать вместо этого, где это возможно, так как этот метод обеспечивает лучшее обнаружение и производительность сбоя.Параметры | |
---|---|
cmdArgs | String : команда ADB и аргументы для запуска |
Возвраты | |
---|---|
String | stdout от команды. null если команда не удалось выполнить. |
Броски | |
---|---|
DeviceNotAvailableException |
ExecutefastBootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
Вспомогательный метод, который выполняет команду Fastboot в качестве системной команды с тайм -аутом по умолчанию 2 минуты.
Ожидается, что устройство уже находится в режиме Fastboot.
Параметры | |
---|---|
cmdArgs | String : команда Fastboot и аргументы для запуска |
Возвраты | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException |
ExecutefastBootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Вспомогательный метод, который выполняет команду Fastboot в качестве системной команды.
Ожидается, что устройство уже находится в режиме Fastboot.Параметры | |
---|---|
timeout | long : время в миллисекундах до истечения срока действия команды |
cmdArgs | String : команда Fastboot и аргументы для запуска |
Возвраты | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException |
executongfastbootcommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Вспомогательный метод, который выполняет много работает команда Fastboot в качестве системной команды.
Идентично дляexecuteFastbootCommand(String)
кроме как использует более длительный тайм -аут.Параметры | |
---|---|
cmdArgs | String : команда Fastboot и аргументы для запуска |
Возвраты | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException |
executongfastbootcommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Вспомогательный метод, который выполняет много работает команда Fastboot в качестве системной команды с переменными системной среды.
Идентично для executeFastbootCommand(String)
кроме как использует более длительный тайм -аут.
Параметры | |
---|---|
envVarMap | : Системная среда переменных, с которыми работает команда FastBoot |
cmdArgs | String : команда Fastboot и аргументы для запуска |
Возвраты | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public String executeShellCommand (String command)
Вспомогательный метод, который выполняет команду оболочки ADB и возвращает вывод в виде String
.
Параметры | |
---|---|
command | String : команда ADB Shell для запуска |
Возвраты | |
---|---|
String | вывод оболочки |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Выполняет команду ADB Shell, с большим количеством параметров для управления поведением команды.
Параметры | |
---|---|
command | String : команда ADB Shell для запуска |
receiver | IShellOutputReceiver : IShellOutputReceiver для прямого вывода оболочки. |
maxTimeToOutputShellResponse | long : максимальное количество времени, в течение которого команде разрешено не выводить никакого ответа; единица, как указано в timeUnit |
timeUnit | TimeUnit : единица для maxTimeToOutputShellResponse |
retryAttempts | int : максимальное количество раз, чтобы повторно выполнить команду, если она не удается из -за исключения. DeviceNotResponsiveException будет брошено, если retryAttempts выполняются без успеха. |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Выполняет команду ADB Shell, с большим количеством параметров для управления поведением команды.
Параметры | |
---|---|
command | String : команда ADB Shell для запуска |
receiver | IShellOutputReceiver : IShellOutputReceiver для прямого вывода оболочки. |
maxTimeoutForCommand | long : максимальный тайм -аут для завершения команды; единица, как указано в timeUnit |
maxTimeToOutputShellResponse | long : максимальное количество времени, в течение которого команде разрешено не выводить никакого ответа; единица, как указано в timeUnit |
timeUnit | TimeUnit : единица для maxTimeToOutputShellResponse |
retryAttempts | int : максимальное количество раз, чтобы повторно выполнить команду, если она не удается из -за исключения. DeviceNotResponsiveException будет брошено, если retryAttempts выполняются без успеха. |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Выполняет заданную команду ADB Shell, повторяя несколько раз, если команда не удается.
Более простой формыexecuteShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
со значениями по умолчанию.Параметры | |
---|---|
command | String : команда ADB Shell для запуска |
receiver | IShellOutputReceiver : IShellOutputReceiver для прямого вывода оболочки. |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellv2command
public CommandResult executeShellV2Command (String cmd)
Вспомогательный метод, который выполняет команду ADB Shell и возвращает результаты в качестве CommandResult
, правильно заполненной выходом состояния команды, Stdout и STDERR.
Параметры | |
---|---|
cmd | String : команда, которую следует запустить. |
Возвраты | |
---|---|
CommandResult | Результат в CommandResult . |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellv2command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Вспомогательный метод, который выполняет команду ADB Shell и возвращает результаты в качестве CommandResult
, правильно заполненной выходом состояния команды и STDERR. Stdout направлен на указанный поток.
Параметры | |
---|---|
cmd | String : команда, которую следует запустить. |
pipeToOutput | OutputStream : ERROR(/OutputStream) , где будет перенаправлен выход STD или нулевой. |
Возвраты | |
---|---|
CommandResult | Результат в CommandResult . |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellv2command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Вспомогательный метод, который выполняет команду ADB Shell и возвращает результаты в качестве CommandResult
заполненного заполненного выводом состояния команды, Stdout и Stderr.
Параметры | |
---|---|
cmd | String : команда, которую следует запустить. |
pipeAsInput | File : ERROR(/File) , которая будет передана в качестве входной команды, или NULL. |
Возвраты | |
---|---|
CommandResult | Результат в CommandResult . |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellv2command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Выполняет команду ADB Shell, с большим количеством параметров для управления поведением команды.
Параметры | |
---|---|
cmd | String : команда ADB Shell для запуска |
maxTimeoutForCommand | long : максимальный тайм -аут для завершения команды; единица, как указано в timeUnit |
timeUnit | TimeUnit : единица для maxTimeToOutputShellResponse |
retryAttempts | int : максимальное количество раз, чтобы повторно выполнить команду, если она не удается из -за исключения. DeviceNotResponsiveException будет брошено, если retryAttempts выполняются без успеха. |
Возвраты | |
---|---|
CommandResult |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellv2command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Выполняет команду ADB Shell, с большим количеством параметров для управления поведением команды.
Параметры | |
---|---|
cmd | String : команда ADB Shell для запуска |
maxTimeoutForCommand | long : максимальный тайм -аут для завершения команды; единица, как указано в timeUnit |
timeUnit | TimeUnit : единица для maxTimeToOutputShellResponse |
Возвраты | |
---|---|
CommandResult |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellv2command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Выполняет команду ADB Shell, с большим количеством параметров для управления поведением команды.
Параметры | |
---|---|
cmd | String : команда ADB Shell для запуска |
pipeAsInput | File : ERROR(/File) , которая будет передана в качестве входной команды, или NULL. |
pipeToOutput | OutputStream : ERROR(/OutputStream) , где будет перенаправлен выход STD или нулевой. |
maxTimeoutForCommand | long : максимальный тайм -аут для завершения команды; единица, как указано в timeUnit |
timeUnit | TimeUnit : единица для maxTimeToOutputShellResponse |
retryAttempts | int : максимальное количество раз, чтобы повторно выполнить команду, если она не удается из -за исключения. DeviceNotResponsiveException будет брошено, если retryAttempts выполняются без успеха. |
Возвраты | |
---|---|
CommandResult |
Броски | |
---|---|
DeviceNotAvailableException |
executeShellv2command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Выполняет команду ADB Shell, с большим количеством параметров для управления поведением команды.
Параметры | |
---|---|
cmd | String : команда ADB Shell для запуска |
pipeAsInput | File : ERROR(/File) , которая будет передана в качестве входной команды, или NULL. |
pipeToOutput | OutputStream : ERROR(/OutputStream) , где будет перенаправлен выход STD или нулевой. |
pipeToError | OutputStream : ERROR(/OutputStream) , где будет перенаправлена ошибка STD или нулевой. |
maxTimeoutForCommand | long : максимальный тайм -аут для завершения команды; единица, как указано в timeUnit |
timeUnit | TimeUnit : единица для maxTimeToOutputShellResponse |
retryAttempts | int : максимальное количество раз, чтобы повторно выполнить команду, если она не удается из -за исключения. DeviceNotResponsiveException будет брошено, если retryAttempts выполняются без успеха. |
Возвраты | |
---|---|
CommandResult |
Броски | |
---|---|
DeviceNotAvailableException |
Fastbootwipepartition
public CommandResult fastbootWipePartition (String partition)
Вспомогательный метод, который вытирает раздел для устройства.
ЕслиgetUseFastbootErase()
true
, то Fastboot Erase будет использоваться для вытирания разделения. Затем устройство должно создать файловую систему в следующий раз, когда устройство загружается. В противном случае используется формат Fastboot, который создаст новую файловую систему на устройстве. Ожидается, что устройство уже находится в режиме Fastboot.Параметры | |
---|---|
partition | String : раздел, чтобы стереть |
Возвраты | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException |
GetActiveApexes
publicgetActiveApexes ()
Принесите информацию об апексах, активированных на устройстве.
Возвраты | |
---|---|
| ERROR(/Set) ApexInfo , в настоящее время активированная на устройстве |
Броски | |
---|---|
DeviceNotAvailableException |
GetallSettings
publicgetAllSettings (String namespace)
Вернуть клавишу пары запрошенного пространства имен.
Параметры | |
---|---|
namespace | String : должен быть один из {"Система", "Secure", "Global"} |
Возвраты | |
---|---|
| Карта паров значений ключей. NULL, если пространство имен не поддерживается. |
Броски | |
---|---|
DeviceNotAvailableException |
getallocationstate
public DeviceAllocationState getAllocationState ()
Вернуть текущее состояние устройства
Возвраты | |
---|---|
DeviceAllocationState |
GetAndroidid
public String getAndroidId (int userId)
Найдите и верните Android-ID, связанный с пользовательским, нулевым, если не найден.
Параметры | |
---|---|
userId | int |
Возвраты | |
---|---|
String |
Броски | |
---|---|
DeviceNotAvailableException |
GetAndroidids
publicgetAndroidIds ()
Создайте карту идентификаторов Android, найденные соответствующие идентификаторы пользователей. Не существует страхования, что каждый идентификатор пользователя найдет идентификатор Android, связанный с этой функцией, поэтому некоторые идентификаторы пользователей могут соответствовать NULL.
Возвраты | |
---|---|
| Карта идентификаторов Android нашел соответствующие идентификаторы пользователей. |
Броски | |
---|---|
DeviceNotAvailableException |
getapilevel
public int getApiLevel ()
Получите уровень API устройства. По умолчанию в UNKNOWN_API_LEVEL
.
Возвраты | |
---|---|
int | целое число, указывающее уровень устройства API |
Броски | |
---|---|
DeviceNotAvailableException |
getAppCpackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Получите информацию о пакете, установленном на устройстве.
Параметры | |
---|---|
packageName | String |
Возвраты | |
---|---|
PackageInfo | PackageInfo или null , если информация не может быть извлечена |
Броски | |
---|---|
DeviceNotAvailableException |
getapppackageinfos
publicgetAppPackageInfos ()
Получите информацию о пакетах, установленных на устройстве.
Возвраты | |
---|---|
| ERROR(/List) PackageInfo S, установленные на устройстве. |
Броски | |
---|---|
DeviceNotAvailableException |
GetBaseBandversion
public String getBasebandVersion ()
Удобный метод для получения версии BASEBAND (радио) этого устройства. Получение радиостанции зависит от устройства, поэтому она может не вернуть правильную информацию для всех устройств. Этот метод опирается на пропиточную пропиточку GSM.version.baseband, чтобы вернуть правильную информацию версии. Это не точнее для некоторых устройств CDMA, и версия, возвращенная здесь, может не соответствовать версии, сообщенной Fastboot, и не может вернуть версию для радио CDMA. TL; DR Этот метод сообщает только о точной версии, если свойство gsm.version.baseband такое же, как версия, возвращаемая fastboot getvar version-baseband
.
Возвраты | |
---|---|
String | Версия String Base Base или null если она не может быть определена (устройство не имеет радиоприемника или версии. Строка не может быть прочитана) |
Броски | |
---|---|
DeviceNotAvailableException |
getbattery
public Integer getBattery ()
Возвращает текущий уровень батареи устройства или нулевой, если уровень батареи недоступен.
Возвраты | |
---|---|
Integer |
getbooleanproperty
public boolean getBooleanProperty (String name, boolean defaultValue)
Возвращает логическое значение данного имущества.
Параметры | |
---|---|
name | String : имя свойства |
defaultValue | boolean : значение по умолчанию, чтобы вернуть, если свойство пустое или не существует. |
Возвраты | |
---|---|
boolean | true , если свойство имеет значение "1" , "y" , "yes" , "on" или "true" , false если свойство имеет значение "0" , "n" , "no" , "off" , "false" или defaultValue иначе. |
Броски | |
---|---|
DeviceNotAvailableException |
GetBoothistory
publicgetBootHistory ()
Помощный метод собирает карту истории загрузки с временем загрузки и разумом загрузки.
Возвраты | |
---|---|
| Карта времени загрузки (UTC Time in Second As Epoch) и разум загрузки |
Броски | |
---|---|
DeviceNotAvailableException |
GetBoothistorySince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Helper Method собирает карту истории загрузки с временем загрузки и разумом загрузки с момента указанного эпохи с устройства и указанного временного блока. Текущее устройство Upcepochtime в миллисекунде может быть получено методом getDeviceDate()
.
Параметры | |
---|---|
utcEpochTime | long : время устройства с эпохи. |
timeUnit | TimeUnit : Time Unit TimeUnit . |
Возвраты | |
---|---|
| Карта времени загрузки (UTC Time in Second As Epoch) и разум загрузки |
Броски | |
---|---|
DeviceNotAvailableException |
GetBootloaderversion
public String getBootloaderVersion ()
Удобный метод, чтобы получить версию загрузчика этого устройства.
Попытается получить версию загрузчика из текущего состояния устройства. (IE, если устройство находится в режиме Fastboot, оно попытается получить версию из Fastboot)Возвраты | |
---|---|
String | версия загрузчика String или null , если ее нельзя найти |
Броски | |
---|---|
DeviceNotAvailableException |
GetBugReport
public InputStreamSource getBugreport ()
Получает ошибку с устройства.
Реализация этого гарантированно будет продолжать работать на устройстве без SDCARD (или где SDCARD еще не установлен).
Возвраты | |
---|---|
InputStreamSource | InputStreamSource , который будет производить содержимое BugReport по требованию. В случае сбоя, InputStreamSource будет создавать пустую ERROR(/InputStream) . |
getbugreportz
public InputStreamSource getBugreportz ()
Получает Bugreportz с устройства. ZIP Format Bugreport содержит основные ошибки и другие файлы журнала, которые полезны для отладки.
Поддерживается только для «версии ADB»> 1.0.36
Возвраты | |
---|---|
InputStreamSource | InputStreamSource of zip -файла, содержащий BugReportz, возвращайте NULL в случае сбоя. |
getbuildalias
public String getBuildAlias ()
Получите псевдоним сборки, которую в настоящее время работает устройство.
Строительный псевдоним, как правило, является более читаемой строкой, чем идентификатор сборки (обычно число для сборки Nexus). Например, Final Android 4.2.
Возвраты | |
---|---|
String | Сборка псевдонима или отступайте, чтобы построить идентификатор, если его нельзя получить |
Броски | |
---|---|
DeviceNotAvailableException |
GetBuildFlavor
public String getBuildFlavor ()
Получите вкус сборки для устройства.
Возвраты | |
---|---|
String | Вкус сборки или нулевой, если его нельзя было извлечь |
Броски | |
---|---|
DeviceNotAvailableException |
getbuildid
public String getBuildId ()
Получить сборку, которую в настоящее время работает.
Возвраты | |
---|---|
String | идентификатор сборки или IBuildInfo.UNKNOWN_BUILD_ID если его нельзя получить |
Броски | |
---|---|
DeviceNotAvailableException |
GetBuildSigningKeys
public String getBuildSigningKeys ()
Возвращает тип ключа, используемый для подписи изображения устройства
Обычно устройства Android могут быть подписаны с помощью тестовых скинков (например, в AOSP) или выпуска (контролируемые отдельными производителями устройств)
Возвраты | |
---|---|
String | Ключ подписания, если найден, но иначе. |
Броски | |
---|---|
DeviceNotAvailableException |
GetCachedDevicedEscriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Возвращает кэшированный DeviceDescriptor
если устройство выделено, в противном случае возвращает текущий DeviceDescriptor
.
Возвраты | |
---|---|
DeviceDescriptor |
GetCachedDevicedEscriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Возвращает кэшированный DeviceDescriptor
если устройство выделено, в противном случае возвращает текущий DeviceDescriptor
.
Параметры | |
---|---|
shortDescriptor | boolean : ограничить ли дескриптор минимальной информацией |
Возвраты | |
---|---|
DeviceDescriptor |
getChildren
public String[] getChildren (String path)
Альтернатива использованию IFileEntry
, который иногда не будет работать из -за разрешений.
Параметры | |
---|---|
path | String : это путь на устройстве, где выполнять поиск |
Возвраты | |
---|---|
String[] | Массив строки, содержащей весь файл в пути на устройстве. |
Броски | |
---|---|
DeviceNotAvailableException |
GetConnection
public AbstractConnection getConnection ()
Текущее соединение, связанное с устройством.
Возвраты | |
---|---|
AbstractConnection |
GetContentProvider
public ContentProviderHandler getContentProvider (int userId)
Возвращает ContentProviderHandler
или NULL, если нет.
Поставщик контента может быть использован повторно, если он был построен ранее с тем же userId
.
Параметры | |
---|---|
userId | int : идентификатор пользователя для инициализации поставщика контента. |
Возвраты | |
---|---|
ContentProviderHandler |
Броски | |
---|---|
DeviceNotAvailableException |
GetCurrentFoldAbleState
public DeviceFoldableState getCurrentFoldableState ()
Возвращает текущее складное состояние устройства или NULL, если возникли некоторые проблемы.
Возвраты | |
---|---|
DeviceFoldableState |
Броски | |
---|---|
DeviceNotAvailableException |
GetCurrentUser
public int getCurrentUser ()
Верните идентификатор текущего работающего пользователя. В случае ошибки вернуть -10000.
Возвраты | |
---|---|
int |
Броски | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Получить класс устройства.
Возвраты | |
---|---|
String | класс String устройства. |
getDevedate
public long getDeviceDate ()
Верните дату устройства в миллисекунду с эпохи.
Возвраты | |
---|---|
long | дата устройства в формате эпоха. |
Броски | |
---|---|
DeviceNotAvailableException |
getDevicedescriptor
public DeviceDescriptor getDeviceDescriptor ()
Верните DeviceDescriptor
из информации об устройстве, чтобы получить информацию на нем, не передавая фактический объект устройства.
Возвраты | |
---|---|
DeviceDescriptor |
getDevicedescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Верните DeviceDescriptor
из информации об устройстве, чтобы получить информацию на нем, не передавая фактический объект устройства.
Параметры | |
---|---|
shortDescriptor | boolean : ограничить ли дескриптор минимальной информацией |
Возвраты | |
---|---|
DeviceDescriptor |
GetDeviceState
public TestDeviceState getDeviceState ()
Получите состояние устройства.
Возвраты | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Помощник, чтобы получить разницу во времени между устройством и данной ERROR(/Date)
. Используйте эпохи Время внутри.
Параметры | |
---|---|
date | Date |
Возвраты | |
---|---|
long | разница в миллисекундах |
Броски | |
---|---|
DeviceNotAvailableException |
GetEmulatorOutput
public InputStreamSource getEmulatorOutput ()
Получите поток эмулятора stdout и stderr
Возвраты | |
---|---|
InputStreamSource | Выход эмулятора |
GetEmulatorProcess
public Process getEmulatorProcess ()
Вернуть Process
, соответствующий этому эмулятору.
Возвраты | |
---|---|
Process | Process или null |
GetExeCuteShellCommandLog
public final File getExecuteShellCommandLog ()
Журнал, который содержит все журналы executeShellCommand(String)
.
Возвраты | |
---|---|
File |
GetExternalStoreFreespace
public long getExternalStoreFreeSpace ()
Вспомогательный метод для определения количества свободного места на внешнем хранилище устройства.
Возвраты | |
---|---|
long | количество свободного места в КБ |
Броски | |
---|---|
DeviceNotAvailableException |
GetFastBootPath
public String getFastbootPath ()
Возвращает путь использования бинарного двора Fastboot. По -прежнему требует, чтобы isFastbootEnabled()
был правдой, чтобы функции FastBoot были включены.
Возвраты | |
---|---|
String |
GetFastBootProductType
public String getFastbootProductType ()
Удобный метод, чтобы получить тип продукта этого устройства в режиме Fastboot.
Этот метод следует использовать только в том случае, если устройство должно быть в Fastboot. Это немного безопаснее, чем общий методgetProductType()
в этом случае, потому что ItestDevice будет знать, чтобы восстановить устройство в FastBoot, если устройство находится в неправильном состоянии или не отвечает.Возвраты | |
---|---|
String | Имя типа String или null если оно не может быть определена |
Броски | |
---|---|
DeviceNotAvailableException |
GetFastBootProductVariant
public String getFastbootProductVariant ()
Удобный метод, чтобы получить тип продукта этого устройства в режиме Fastboot.
Этот метод следует использовать только в том случае, если устройство должно быть в Fastboot. Это немного безопаснее, чем общий методgetProductType()
в этом случае, потому что ItestDevice будет знать, чтобы восстановить устройство в FastBoot, если устройство находится в неправильном состоянии или не отвечает.Возвраты | |
---|---|
String | Имя типа String или null если оно не может быть определена |
Броски | |
---|---|
DeviceNotAvailableException |
GetFastBootSerialNumber
public String getFastbootSerialNumber ()
Возвращает серийный номер режима Fastboot.
Возвраты | |
---|---|
String |
GetFastBootVariable
public String getFastbootVariable (String variableName)
Получите заданное значение переменной Fastboot с устройства.
Параметры | |
---|---|
variableName | String : имя переменной |
Возвраты | |
---|---|
String | значение свойства или null , если его не существует |
Броски | |
---|---|
DeviceNotAvailableException |
GetFastBootVersion
public String getFastbootVersion ()
Возвращает строку версии бинарного бинарства Fastboot. Или ноль, если что -то пойдет не так.
Возвраты | |
---|---|
String |
GetFileEntry
public IFileEntry getFileEntry (String path)
Получить ссылку на удаленный файл на устройстве.
Параметры | |
---|---|
path | String : Путь файла для извлечения. Может быть абсолютным путем или пути относительно '/'. (т.е. поддерживается как «/Система», так и «Системная» синтаксис) |
Возвраты | |
---|---|
IFileEntry | IFileEntry или null , если файл на данном path не может быть найден |
Броски | |
---|---|
DeviceNotAvailableException |
GetFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Неофициальный помощник, чтобы получить FileEntry
из неровного пути. FixMe: Refactor Система файлов, чтобы она была доступна из любого пути. (даже не корень).
Параметры | |
---|---|
entry | FileListingService.FileEntry : FileEntry не обязательно корни, как требуется ddmlib. |
Возвраты | |
---|---|
IFileEntry | FileEntryWrapper, представляющий файл. |
Броски | |
---|---|
| com.android.tradefed.device.devicenotavailableexception |
DeviceNotAvailableException |
GetFoldablestates
publicgetFoldableStates ()
Возвращает список складных состояний на устройстве. Можно получить с помощью "cmd device_state print-states".
Возвраты | |
---|---|
|
Броски | |
---|---|
DeviceNotAvailableException |
getidevice
public IDevice getIDevice ()
Возвращает ссылку на связанный Ddmlib IDevice
.
IDevice
может выделяться DDMS каждый раз, когда устройство отключается и воссоединяется с ADB. Таким образом, вызывающие абоненты не должны соблюдать ссылку на IDevice
, потому что эта ссылка может стать устаревшей.Возвраты | |
---|---|
IDevice | IDevice |
GetInstalledPackageNames
publicgetInstalledPackageNames ()
Принесите имена пакетов приложений, присутствующие на устройстве.
Возвраты | |
---|---|
| ERROR(/Set) из имен пакетов String , установленных в настоящее время на устройстве. |
Броски | |
---|---|
DeviceNotAvailableException |
GetIntProperty
public long getIntProperty (String name, long defaultValue)
Возвращает целочисленное значение данного свойства с устройства.
Параметры | |
---|---|
name | String : имя свойства |
defaultValue | long : значение по умолчанию, чтобы вернуть, если свойство пустое или не существует. |
Возвраты | |
---|---|
long | Значение свойства или defaultValue если свойство пустое, не существует или не имеет целочисленного значения. |
Броски | |
---|---|
DeviceNotAvailableException |
getipaddress
public String getIpAddress ()
Получает IP -адрес устройства.
Возвраты | |
---|---|
String | IP -адрес устройства или null , если у устройства нет IP -адреса |
Броски | |
---|---|
DeviceNotAvailableException |
GetKeyGuardState
public KeyguardControllerState getKeyguardState ()
Верните объект, чтобы получить текущее состояние KeyGuard или NULL, если не поддерживается.
Возвраты | |
---|---|
KeyguardControllerState | KeyguardControllerState , содержащий снимок состояния KeyGuard, и возвращает NULL, если запрос KeyGuard не поддерживается. |
Броски | |
---|---|
DeviceNotAvailableException |
getLastexpectedReboottimeMillis
public long getLastExpectedRebootTimeMillis ()
Возвращает в последний раз, когда Tradefed API запускал перезагрузку в миллисекундах с момента Epoch, которая была возвращена System.currentTimeMillis()
.
Возвраты | |
---|---|
long |
getlaunchapilevel
public int getLaunchApiLevel ()
Получите первый запуск устройства API -уровень. По умолчанию в UNKNOWN_API_LEVEL
.
Возвраты | |
---|---|
int | целое число, указывающее на первый запуск уровня устройства API |
Броски | |
---|---|
DeviceNotAvailableException |
getlogcat
public InputStreamSource getLogcat ()
Захватывает потоки снимков данных LogCat.
Работает в двух режимах:
TestDeviceOptions.getMaxLogcatDataSize()
Байты текущего содержимого фонового захвата logCatВозвраты | |
---|---|
InputStreamSource |
getlogcat
public InputStreamSource getLogcat (int maxBytes)
Получает потоки снимков последних maxBytes
данных захваченных данных logcat.
Полезно для случаев, когда вы хотите сделать частые снимки полученных данных LogCat, не подвергаясь потенциально большому наказанию на дисковое пространство, получая весь снимки getLogcat()
.
Параметры | |
---|---|
maxBytes | int : максимальное количество данных для возврата. Должно быть количество, которое может удобно вписаться в память |
Возвраты | |
---|---|
InputStreamSource |
getlogcatdump
public InputStreamSource getLogcatDump ()
Получите дамп текущего logcat для устройства. В отличие от getLogcat()
, этот метод всегда будет возвращать статический дамп logCat.
Имеет недостаток, что ничего не будет возвращено, если устройство не будет достижимо.
Возвраты | |
---|---|
InputStreamSource | InputStreamSource данных logCat. Пустой поток возвращается, если не удастся получить данные logcat. |
getLogcatsInce
public InputStreamSource getLogcatSince (long date)
Получите поток моментальных снимков полученных данных LogCat, запуская предоставленную дату. Время на устройстве должно использоваться getDeviceDate()
.
Параметры | |
---|---|
date | long : в миллисекунде, так как эпохи формат, когда начинать снимки до настоящего времени. (можно получить с помощью «даты +%s») |
Возвраты | |
---|---|
InputStreamSource |
getMacaddress
public String getMacAddress ()
Возвращает MAC -адрес устройства, NULL, если он не может запросить с устройства.
Возвраты | |
---|---|
String |
getMainuserid
public Integer getMainUserId ()
Возвращает основной идентификатор пользователя.
Возвраты | |
---|---|
Integer | ID пользователя основного пользователя, если он есть, и NULL, если нет основного пользователя. |
Броски | |
---|---|
DeviceNotAvailableException |
getMainLineModuleinfo
publicgetMainlineModuleInfo ()
Получите информацию о модулях Mainline, установленных на устройстве.
Возвраты | |
---|---|
| ERROR(/Set) модулей Mainline String , в настоящее время установленных на устройстве. |
Броски | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfrunningUserssUpported
public int getMaxNumberOfRunningUsersSupported ()
Получите максимальное количество поддерживаемых одновременно запуска пользователей. По умолчанию к 0.
Возвраты | |
---|---|
int | целое число, указывающее количество одновременно работающих пользователей |
Броски | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfusers поддерживает
public int getMaxNumberOfUsersSupported ()
Получите максимальное количество поддерживаемых пользователей. По умолчанию к 0.
Возвраты | |
---|---|
int | целое число, указывающее количество поддерживаемых пользователей |
Броски | |
---|---|
DeviceNotAvailableException |
getmicrodroidprocess
public Process getMicrodroidProcess ()
Возвраты | |
---|---|
Process | Возвращает процесс Microdroid VM. Если TestDevice не является микродоидом, возвращает NULL. |
GetMonitor
public IDeviceStateMonitor getMonitor ()
Верните IDeviceStateMonitor
, связанный с устройством.
Возвраты | |
---|---|
IDeviceStateMonitor |
GetMountPoint
public String getMountPoint (String mountName)
Возвращает точку крепления.
Запрашивает устройство напрямую, если кэшированная информация вIDevice
недоступна. TODO: Переместите это поведение в IDevice.getMountPoint(String)
Параметры | |
---|---|
mountName | String : название точки крепления |
Возвраты | |
---|---|
String | точка горы или null |
GetMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Возвращает установку MountPointInfo
соответствующую указанному пути MountPoint, или null
если этот путь ничего не устанавливается или иным образом не отображается в /proc /mounts в качестве точки крепления.
Параметры | |
---|---|
mountpoint | String |
Возвраты | |
---|---|
ITestDevice.MountPointInfo | ERROR(/List) MountPointInfo содержащая информацию в "/proc/mounts" |
Броски | |
---|---|
DeviceNotAvailableException |
GetMountPointInfo
publicgetMountPointInfo ()
Возвращает проанализированную версию информации в /proc /mounts на устройстве
Возвраты | |
---|---|
| ERROR(/List) MountPointInfo содержащая информацию в "/proc/mounts" |
Броски | |
---|---|
DeviceNotAvailableException |
GetOptions
public TestDeviceOptions getOptions ()
Принесите параметры теста для устройства.
Возвраты | |
---|---|
TestDeviceOptions | TestDeviceOptions , связанные с тестовым устройством. |
GetPartitionFreespace
public long getPartitionFreeSpace (String partition)
Вспомогательный метод для определения количества свободного места на разделе устройства.
Параметры | |
---|---|
partition | String |
Возвраты | |
---|---|
long | количество свободного места в КБ |
Броски | |
---|---|
DeviceNotAvailableException |
GetPrimaryUserid
public Integer getPrimaryUserId ()
Возвращает основной идентификатор пользователя.
Возвраты | |
---|---|
Integer | Пользовательский идентификатор основного пользователя, если он есть, и нулевой, если нет основного пользователя. |
Броски | |
---|---|
DeviceNotAvailableException |
GetProcessByName
public ProcessInfo getProcessByName (String processName)
Помощный метод запускает команду «pidof» и «stat» и возвращает объект ProcessInfo
с PID и временем запуска процесса данного процесса.
Параметры | |
---|---|
processName | String : строка имени Proces. |
Возвраты | |
---|---|
ProcessInfo | ProcessInfo данного имени процесса |
Броски | |
---|---|
DeviceNotAvailableException |
GetProcessPid
public String getProcessPid (String process)
Возвращает пид Сервиса или NULL, если что -то пошло не так.
Параметры | |
---|---|
process | String : строка имени Proces. |
Возвраты | |
---|---|
String |
Броски | |
---|---|
DeviceNotAvailableException |
GetProductType
public String getProductType ()
Метод удобства для получения типа продукта этого устройства.
Этот метод будет работать, если устройство находится в режиме ADB или Fastboot.Возвраты | |
---|---|
String | Название типа продукта String . Не будет нулевым |
Броски | |
---|---|
DeviceNotAvailableException |
GetProductvariant
public String getProductVariant ()
Метод удобства для получения варианта продукта этого устройства.
Этот метод будет работать, если устройство находится в режиме ADB или Fastboot.Возвраты | |
---|---|
String | Имя варианта продукта String или null , если оно не может быть определена |
Броски | |
---|---|
DeviceNotAvailableException |
GetProperty
public String getProperty (String name)
Получить заданное значение свойства с устройства.
Параметры | |
---|---|
name | String : имя свойства |
Возвраты | |
---|---|
String | значение свойства или null , если его не существует |
Броски | |
---|---|
DeviceNotAvailableException |
getRecoverymode
public ITestDevice.RecoveryMode getRecoveryMode ()
Получите текущий режим восстановления, используемый для устройства.
Возвраты | |
---|---|
ITestDevice.RecoveryMode | Текущий режим восстановления, используемый для устройства. |
GetScreenshot
public InputStreamSource getScreenshot (long displayId)
Занимает скриншот с данного идентификатора дисплея. Формат PNG.
TODO: расширить реализации выше, чтобы поддержать «формат» и «Rescale»
Параметры | |
---|---|
displayId | long : идентификатор дисплея экрана, чтобы получить скриншот от. |
Возвраты | |
---|---|
InputStreamSource | InputStreamSource снимка экрана в формате или null , если скриншот не был успешным. |
Броски | |
---|---|
DeviceNotAvailableException |
GetScreenshot
public InputStreamSource getScreenshot (String format)
Занимает скриншот с устройства. Рекомендуется использовать GetScreenshot (формат) вместо кодирования JPEG для меньшего размера
Параметры | |
---|---|
format | String : поддерживается PNG, JPEG |
Возвраты | |
---|---|
InputStreamSource | InputStreamSource снимка экрана в формате или null , если скриншот не был успешным. |
Броски | |
---|---|
DeviceNotAvailableException |
GetScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Занимает скриншот с устройства. Рекомендуется использовать getScreenshot(String)
вместо этого с кодированием JPEG для меньшего размера.
Параметры | |
---|---|
format | String : поддерживается PNG, JPEG |
rescale | boolean : если скриншот следует изменить, чтобы уменьшить размер полученного изображения |
Возвраты | |
---|---|
InputStreamSource | InputStreamSource снимка экрана в формате или null , если скриншот не был успешным. |
Броски | |
---|---|
DeviceNotAvailableException |
GetScreenshot
public InputStreamSource getScreenshot ()
Занимает скриншот с устройства.
Возвраты | |
---|---|
InputStreamSource | InputStreamSource снимка экрана в формате PNG или null , если скриншот не был успешным. |
Броски | |
---|---|
DeviceNotAvailableException |
GetSerialNumber
public String getSerialNumber ()
Удобный метод, чтобы получить серийный номер этого устройства.
Возвраты | |
---|---|
String | String номер строки |
GetSetting
public String getSetting (int userId, String namespace, String key)
Вернуть значение запрошенного настройки. Пространство имен должно быть одним из: {"System", "Secure", "Global"}
Параметры | |
---|---|
userId | int |
namespace | String |
key | String |
Возвраты | |
---|---|
String | Значение, связанное с пространством имен: ключ пользователя. Нулевой, если не найден. |
Броски | |
---|---|
DeviceNotAvailableException |
GetSetting
public String getSetting (String namespace, String key)
См. getSetting(int, String, String)
и выполнено на системном пользователе.
Параметры | |
---|---|
namespace | String |
key | String |
Возвраты | |
---|---|
String |
Броски | |
---|---|
DeviceNotAvailableException |
Getsimoperator
public String getSimOperator ()
Верните оператор SIM -карты или NULL, если недоступно или если устройство недоступно.
Возвраты | |
---|---|
String |
GetSimstate
public String getSimState ()
Верните состояние SIM -карты или NULL, если недоступно, или устройство недоступно.
Возвраты | |
---|---|
String |
GetTombstones
publicgetTombstones ()
Принесите и верните список надгробий с устройств. Требуется корень.
Метод наиболее эффективен, поэтому, если один надгробный камень не может быть привлечен по любой причине, он будет отсутствовать в списке. Только DeviceNotAvailableException
завершит метод рано.
Возвраты | |
---|---|
| Список файлов надгробных плитов, пустые, если нет надгробия. |
Броски | |
---|---|
DeviceNotAvailableException |
GettotalMemory
public long getTotalMemory ()
Возвращает общий размер физической памяти в байтах или -1 в случае внутренней ошибки
Возвраты | |
---|---|
long |
GetTrackingSerial
public String getTrackingSerial ()
Для цели управления устройствами используйте последовательность для отслеживания устройства.
Возвраты | |
---|---|
String |
GetUninStallablePackageNames
publicgetUninstallablePackageNames ()
Принесите названия пакетов приложений, которые могут быть удалены. В настоящее время это определяется как несистемные пакеты и обновленные пакеты систем.
Возвраты | |
---|---|
| ERROR(/Set) удаленных имен пакетов String , установленных в настоящее время на устройстве. |
Броски | |
---|---|
DeviceNotAvailableException |
getusefastbooterase
public boolean getUseFastbootErase ()
Получите, использовать ли Fastboot Erase или Fastboot Format, чтобы вытирать раздел на устройстве.
Возвраты | |
---|---|
boolean | true , если будет использоваться Fastboot Erase или false если будет использоваться формат Fastboot. |
getuserflags
public int getUserFlags (int userId)
Найдите и верните флаги данного пользователя. Флаги определены в классе «android.content.pm.userinfo» в проекте Android с открытым исходным кодом.
Параметры | |
---|---|
userId | int |
Возвраты | |
---|---|
int | Флаги, связанные с предоставленным пользователем, если найдено, -10000 в любых других случаях. |
Броски | |
---|---|
DeviceNotAvailableException |
getuserinfos
publicgetUserInfos ()
Получает карту ssisiD для UserInfo
на устройстве. Выбросит DeviceRuntimeException
, если вывод с устройства не такой, как ожидалось.
Возвраты | |
---|---|
| Список объектов пользователя. |
Броски | |
---|---|
DeviceNotAvailableException |
getuserserialnumber
public int getUserSerialNumber (int userId)
Верните серийный номер, связанный с идентификатором пользователя, если найден, -10000 в любых других случаях.
Параметры | |
---|---|
userId | int |
Возвраты | |
---|---|
int |
Броски | |
---|---|
DeviceNotAvailableException |
HandLeallocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Обработайте заданное устройство. Может переходить к новому состоянию. Сообщит IDeviceMonitor
о любых переходах штата.
Обработайте устройство, которое может или не может перевести это устройство в новое состояние распределения.
Параметры | |
---|---|
event | DeviceEvent |
Возвраты | |
---|---|
IManagedTestDevice.DeviceEventResponse |
HASFEATURE
public boolean hasFeature (String feature)
Проверьте, доступна ли функция на устройстве.
Параметры | |
---|---|
feature | String : какой формат должен быть »функция: |
Возвраты | |
---|---|
boolean | Верно, если функция найдена, неверно в противном случае. |
Броски | |
---|---|
DeviceNotAvailableException |
инициализоологичное соединение
public void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Инициализируйте соединение с устройством. Это называется PreinvocationSetUp, но в редких случаях может потребоваться отдельно при создании соединения во время настройки устройства.
Параметры | |
---|---|
info | IBuildInfo |
attributes | MultiMap |
Броски | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Установите пакет Android на устройство.
Параметры | |
---|---|
packageFile | File : файл APK для установки |
reinstall | boolean : true если необходимо выполнить переустановку |
extraArgs | String : необязательные дополнительные аргументы для прохождения. См. «ADB Shell PM -H» для доступных вариантов. |
Возвраты | |
---|---|
String | String с кодом ошибки или null , если успех. |
Броски | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Установите пакет Android на устройство.
ПРИМЕЧАНИЕ. Только использование вариантов, которые требуют явного управления предоставлением разрешения во время выполнения во время установки, должны вызвать эту функцию.
Параметры | |
---|---|
packageFile | File : файл APK для установки |
reinstall | boolean : true если необходимо выполнить переустановку |
grantPermissions | boolean : если все разрешения на выполнение должны быть предоставлены во время установки |
extraArgs | String : необязательные дополнительные аргументы для прохождения. См. «ADB Shell PM -H» для доступных вариантов. |
Возвраты | |
---|---|
String | String с кодом ошибки или null , если успех. |
Броски | |
---|---|
DeviceNotAvailableException |
InstallPackageForuser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Установите пакет Android на устройство для данного пользователя.
Параметры | |
---|---|
packageFile | File : файл APK для установки |
reinstall | boolean : true если необходимо выполнить переустановку |
userId | int : INTEGER ID пользователя для установки. |
extraArgs | String : необязательные дополнительные аргументы для прохождения. См. «ADB Shell PM -H» для доступных вариантов. |
Возвраты | |
---|---|
String | String с кодом ошибки или null , если успех. |
Броски | |
---|---|
DeviceNotAvailableException |
InstallPackageForuser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Установите пакет Android на устройство для данного пользователя.
ПРИМЕЧАНИЕ. Только использование вариантов, которые требуют явного управления предоставлением разрешения во время выполнения во время установки, должны вызвать эту функцию.
Параметры | |
---|---|
packageFile | File : файл APK для установки |
reinstall | boolean : true если необходимо выполнить переустановку |
grantPermissions | boolean : если все разрешения на выполнение должны быть предоставлены во время установки |
userId | int : INTEGER ID пользователя для установки. |
extraArgs | String : необязательные дополнительные аргументы для прохождения. См. «ADB Shell PM -H» для доступных вариантов. |
Возвраты | |
---|---|
String | String с кодом ошибки или null , если успех. |
Броски | |
---|---|
DeviceNotAvailableException |
InvalidatePropertyCache
public void invalidatePropertyCache ()
ISADBTCP
public boolean isAdbTcp ()
Возвраты | |
---|---|
boolean |
isappenumerationsupported
public boolean isAppEnumerationSupported ()
Проверьте, поддерживает ли платформа на устройстве перечисление приложений
Возвраты | |
---|---|
boolean | Верно, если поддержано перечисление приложений, в противном случае неверно |
Броски | |
---|---|
DeviceNotAvailableException |
isbypasslowtargetsdkblocksupported
public boolean isBypassLowTargetSdkBlockSupported ()
Проверьте, поддерживает ли платформа на устройстве обход низкого целевого блока SDK в установке приложения
Возвраты | |
---|---|
boolean | Верно, если поддерживается обходной блок SDK с низким целевым |
Броски | |
---|---|
DeviceNotAvailableException |
isdebugfsmounted
public boolean isDebugfsMounted ()
Проверьте, устанавливаются ли отладки.
Возвраты | |
---|---|
boolean | true , если отладки установлены |
Броски | |
---|---|
DeviceNotAvailableException |
IsdeviceEncrypted
public boolean isDeviceEncrypted ()
Возвращает, если устройство зашифровано.
Возвраты | |
---|---|
boolean | true , если устройство зашифровано. |
Броски | |
---|---|
DeviceNotAvailableException |
Isdirectory
public boolean isDirectory (String path)
Верните True, если путь на устройстве является каталогом, false в противном случае.
Параметры | |
---|---|
path | String |
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
ISENABLEADBROOT
public boolean isEnableAdbRoot ()
Возвраты | |
---|---|
boolean | true , если root ADB должен быть включен на устройстве |
ISENCRYPTIONSUPPODED
public boolean isEncryptionSupported ()
Возвращает, если на устройстве поддерживается шифрование.
Возвраты | |
---|---|
boolean | true , если устройство поддерживает шифрование. |
Броски | |
---|---|
DeviceNotAvailableException |
Испытательный
public boolean isExecutable (String fullPath)
Возвращает true, если путь файла на устройстве является исполняемым файлом, False в противном случае.
Параметры | |
---|---|
fullPath | String |
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
isfastbootenabled
public boolean isFastbootEnabled ()
Вернитесь, если Fastboot доступен для устройства.
Возвраты | |
---|---|
boolean |
это безгона
public boolean isHeadless ()
Верните True, если устройство без головы (без экрана), false в противном случае.
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
ishheadlesssystemusermode
public boolean isHeadlessSystemUserMode ()
Возвращает, использует ли устройство пользовательский режим системы без головы.
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
IsmainuserpermanentAdmin
public boolean isMainUserPermanentAdmin ()
Возвращает, является ли основной пользователь постоянным администратором и не может быть удален или понижен до статуса не админи.
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
Ismultiusersupported
public boolean isMultiUserSupported ()
Определяет, поддерживается ли многопользователь.
Возвраты | |
---|---|
boolean | Верно, если поддерживается мульти -пользователем, в противном случае неверно |
Броски | |
---|---|
DeviceNotAvailableException |
IspackageInstalled
public boolean isPackageInstalled (String packageName, String userId)
Запросите устройство для заданного имени пакета и предоставленного идентификатора пользователя, чтобы проверить, установлен ли оно в настоящее время или нет для этого пользователя.
Параметры | |
---|---|
packageName | String : пакет, который мы проверяем, если он установлен. |
userId | String : идентификатор пользователя, который мы проверяем, для пакета установлен. Если NULL, первичный пользователь Zero будет использоваться. |
Возвраты | |
---|---|
boolean | Правда, если пакет сообщается, как установлен. Неверно иначе. |
Броски | |
---|---|
DeviceNotAvailableException |
IspackageInstalled
public boolean isPackageInstalled (String packageName)
Запросите устройство для заданного имени пакета, чтобы проверить, установлена ли оно в настоящее время или нет.
Параметры | |
---|---|
packageName | String |
Возвраты | |
---|---|
boolean | Правда, если пакет сообщается, как установлен. Неверно иначе. |
Броски | |
---|---|
DeviceNotAvailableException |
isruntimepermissionsupported
public boolean isRuntimePermissionSupported ()
Проверьте, поддерживает ли платформа на устройстве предоставление разрешений на выполнение
Возвраты | |
---|---|
boolean | Верно, если разрешение на выполнение поддерживается, в противном случае неверно. |
Броски | |
---|---|
DeviceNotAvailableException |
ISSTATEBOUTORORORFASTBOOTD
public boolean isStateBootloaderOrFastbootd ()
Возвращает True, если устройство находится в TestDeviceState.FASTBOOT
или TestDeviceState.FASTBOOTD
.
Возвраты | |
---|---|
boolean |
Isuserrunning
public boolean isUserRunning (int userId)
Проверьте, работает ли данный пользователь.
Параметры | |
---|---|
userId | int |
Возвраты | |
---|---|
boolean | Верно, если пользователь работает, ложь в любых других случаях. |
Броски | |
---|---|
DeviceNotAvailableException |
isusersecondator
public boolean isUserSecondary (int userId)
Верните, является ли указанный пользователь вторичным пользователем в соответствии с его флагами.
Параметры | |
---|---|
userId | int |
Возвраты | |
---|---|
boolean | Верно, если пользователь второстепенный, в противном случае неверно. |
Броски | |
---|---|
DeviceNotAvailableException |
ИСПОРТИВНО
public boolean isUserVisible (int userId)
Проверяет, виден ли данный пользователь.
«Видимый» пользователь - это пользователь, который взаимодействует с «человеческим» пользователем и, следовательно, может запустить запуск (обычно на дисплее по умолчанию).
Параметры | |
---|---|
userId | int |
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
isuservisibleondisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Проверяет, виден ли данный пользователь на данном дисплее.
«Видимый» пользователь - это пользователь, который взаимодействует с «человеческим» пользователем и, следовательно, может запустить деятельность запуска на этом дисплее.
Параметры | |
---|---|
userId | int |
displayId | int |
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
IsvisiblebackgroundusersondefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Возвращает, позволяет ли устройство запустить пользователей видимыми в фоновом режиме в ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
Если это произойдет, вы можете позвонить startVisibleBackgroundUser(int, int, boolean)
, передавая дисплей, возвращенный listDisplayIdsForStartingVisibleBackgroundUsers()
, который должен включать ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
Isvisiblebackgroundusers поддерживает
public boolean isVisibleBackgroundUsersSupported ()
Возвращает, позволяет ли устройство запустить пользователей видимыми в фоновом режиме.
Если это произойдет, вы можете позвонить в startVisibleBackgroundUser(int, int, boolean)
, пропустив дисплей, возвращенный listDisplayIdsForStartingVisibleBackgroundUsers()
.
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
Iswifienabled
public boolean isWifiEnabled ()
Проверьте, если Wi -Fi включен.
Проверяет, включен ли Wi -Fi на устройстве. Полезно для утверждения статуса Wi -Fi перед тестами, которые не должны работать с Wi -Fi, например, тесты мобильных данных.Возвраты | |
---|---|
boolean | true , если Wi -Fi включен. false если отключено |
Броски | |
---|---|
DeviceNotAvailableException |
ListDisplayids
publiclistDisplayIds ()
Соберите список доступных дисплеев идентификатора на устройстве, как сообщается «Dimpsys Surfaceflinger».
Возвраты | |
---|---|
| Список дисплеев. По умолчанию всегда возвращает дисплей по умолчанию 0. |
Броски | |
---|---|
DeviceNotAvailableException |
ListDisplayidsforStartingVisibleBackgroundusers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Получает список дисплеев, которые можно использовать для start a user visible in the background
.
Возвраты | |
---|---|
|
Броски | |
---|---|
DeviceNotAvailableException |
Listususers
publiclistUsers ()
Получает список пользователей на устройстве. Выбросит DeviceRuntimeException
если вывод с устройства не такой, как ожидалось.
Возвраты | |
---|---|
| Список идентификаторов пользователей. |
Броски | |
---|---|
DeviceNotAvailableException |
Loganrs
public boolean logAnrs (ITestLogger logger)
Собирает и регистрирует ANR с устройства.
Параметры | |
---|---|
logger | ITestLogger : ITestLogger для регистрации ANR. |
Возвраты | |
---|---|
boolean | Правда, если журнал был успешным, в противном случае ложь. |
Броски | |
---|---|
DeviceNotAvailableException |
LogBugReport
public boolean logBugreport (String dataName, ITestLogger listener)
Помощный метод для того, чтобы принять бур, и регистрировать его журналистам.
Параметры | |
---|---|
dataName | String : Имя, под которым будет сообщено о Bugreport. |
listener | ITestLogger : ITestLogger для регистрации Bugreport. |
Возвраты | |
---|---|
boolean | Правда, если журнал был успешным, в противном случае ложь. |
логогад
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Зарегистрируйте сообщение в logcat устройства. Это безопасный вызов, который не будет выносить, даже если журнал не удастся.
Параметры | |
---|---|
tag | String : тег, при котором мы регистрируем наше сообщение в logCat. |
level | Log.LogLevel : уровень отладки сообщения в logcat. |
format | String : формат сообщения. |
args | Object : ARG, которые должны быть заменены через string.format (). |
Неблокировка
public void nonBlockingReboot ()
Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.
Броски | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
Override if the device needs some specific actions to be taken after adb root and before the device is back online. Default implementation doesn't include any addition actions. adb root is not guaranteed to be enabled at this stage.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
Override if the device needs some specific actions to be taken after adb unroot and before the device is back online. Default implementation doesn't include any additional actions. adb root is not guaranteed to be disabled at this stage.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public void postBootSetup ()
Perform instructions to configure device for testing that after every boot.
Should be called after device is fully booted/available In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot. Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)Броски | |
---|---|
DeviceNotAvailableException |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Extra steps for device specific required clean up that will be executed after the invocation is done.
Параметры | |
---|---|
exception | Throwable : if any, the final exception raised by the invocation failure. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.
Параметры | |
---|---|
info | IBuildInfo : The IBuildInfo of the device. |
attributes | MultiMap : The attributes stored in the invocation context |
Броски | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
pullDir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
Recursively pull directory contents from device.
Параметры | |
---|---|
deviceFilePath | String : the absolute file path of the remote source |
localDir | File : the local directory to pull files into |
userId | int : the user id to pull from |
Возвраты | |
---|---|
boolean | true if file was pulled successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
pullDir
public boolean pullDir (String deviceFilePath, File localDir)
Recursively pull directory contents from device.
Параметры | |
---|---|
deviceFilePath | String : the absolute file path of the remote source |
localDir | File : the local directory to pull files into |
Возвраты | |
---|---|
boolean | true if file was pulled successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile)
Retrieves a file off device.
Параметры | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
Возвраты | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath, int userId)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
Параметры | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
userId | int : The user id to pull from |
Возвраты | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Броски | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
Параметры | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Возвраты | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Броски | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Retrieves a file off device.
Параметры | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
userId | int : The user id to pull from |
Возвраты | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
Retrieves a file off device, and returns the contents.
Параметры | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Возвраты | |
---|---|
String | A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Броски | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File)
, and return a reference to that File
.
Параметры | |
---|---|
remoteFilePath | String : the path to file on device, relative to the device's external storage mountpoint |
Возвраты | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Броски | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Recursively push directory contents to device while excluding some directories that are filtered.
Параметры | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
excludedDirectories | : Set of excluded directories names that shouldn't be pushed. |
Возвраты | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Recursively push directory contents to device.
Параметры | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
Возвраты | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Recursively push directory contents to device.
Параметры | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
userId | int : the user id to push to |
Возвраты | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variant of pushFile(File, String)
which can optionally consider evaluating the need for the content provider.
Параметры | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
evaluateContentProviderNeeded | boolean : whether to check if we need the content provider |
Возвраты | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath)
Push a file to device. By default using a content provider.
Параметры | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
Возвраты | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, int userId)
Push a file to device. By default using a content provider.
Параметры | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
userId | int : the userId to push to |
Возвраты | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
pushString
public boolean pushString (String contents, String remoteFilePath)
Push file created from a string to device
Параметры | |
---|---|
contents | String : the contents of the file to push |
remoteFilePath | String : the remote destination absolute file path |
Возвраты | |
---|---|
boolean | true if string was pushed successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
перезагрузить
public void reboot (String reason)
Reboots the device into adb mode with given reason
to be persisted across reboot.
Blocks until device becomes available.
Last reboot reason can be obtained by querying sys.boot.reason
propety.
Параметры | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Броски | |
---|---|
DeviceNotAvailableException |
перезагрузить
public void reboot ()
Reboots the device into adb mode.
Blocks until device becomes available.Броски | |
---|---|
DeviceNotAvailableException |
rebootIntoBootloader
public void rebootIntoBootloader ()
Reboots the device into bootloader mode.
Blocks until device is in bootloader mode.Броски | |
---|---|
DeviceNotAvailableException |
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Reboots the device into fastbootd mode.
Blocks until device is in fastbootd mode.
Броски | |
---|---|
DeviceNotAvailableException |
rebootIntoRecovery
public void rebootIntoRecovery ()
Reboots the device into adb recovery mode.
Blocks until device enters recoveryБроски | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload ()
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Броски | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Параметры | |
---|---|
autoReboot | boolean : whether to automatically reboot the device after sideload |
Броски | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline ()
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Броски | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline (String reason)
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Параметры | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Броски | |
---|---|
DeviceNotAvailableException |
rebootUserspace
public void rebootUserspace ()
Reboots only userspace part of device.
Blocks until device becomes available.
WARNING. Userspace reboot is currently under active development, use it on your own risk.
Броски | |
---|---|
DeviceNotAvailableException |
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
An alternate to rebootUserspace()
()} that only blocks until device is online ie visible to adb.
Броски | |
---|---|
DeviceNotAvailableException |
recoverDevice
public boolean recoverDevice ()
Attempts to recover device communication.
Возвраты | |
---|---|
boolean | True if recovery attempted and successful, returns False if recovery was skipped |
Броски | |
---|---|
DeviceNotAvailableException | if device is no longer available |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registers a IDeviceActionReceiver
for this device.
All registered IDeviceActionReceiver
s will be notified before a device action starts and after the device action ends.
Параметры | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : A IDeviceActionReceiver which will be registered. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Make the system partition on the device read-only. May reboot the device.
Броски | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Make the system partition on the device writable. May reboot the device.
Броски | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
Make the vendor partition on the device read-only. May reboot the device.
Броски | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
Make the vendor partition on the device writable. May reboot the device.
Броски | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
Remove given device admin in given user and return true
if it is successful, false
otherwise.
Параметры | |
---|---|
componentName | String : of device admin to be removed. |
userId | int : of user that the device admin lives in. |
Возвраты | |
---|---|
boolean | True if it is successful, false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Remove all existing device profile owners with the best effort.
Броски | |
---|---|
DeviceNotAvailableException |
removeUser
public boolean removeUser (int userId)
Remove a given user from the device.
Параметры | |
---|---|
userId | int : of the user to remove |
Возвраты | |
---|---|
boolean | true if we were successful in removing the user, false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
resetContentProviderSetup
public void resetContentProviderSetup ()
Reset the flag for content provider setup in order to trigger it again.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
with one or more listeners passed as parameters.
Параметры | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners | ITestLifeCycleReceiver : the test result listener(s) |
Возвраты | |
---|---|
boolean | true if test command completed. false if it failed to complete, but recovery succeeded |
Броски | |
---|---|
DeviceNotAvailableException |
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Runs instrumentation tests, and provides device recovery.
If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.
If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.
Параметры | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners | : the test result listeners |
Возвраты | |
---|---|
boolean | true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded |
Броски | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Same as ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
but runs the test for the given user.
Параметры | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
|
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Same as ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
but runs the test for a given user.
Параметры | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Injects the IConfiguration
in use.
Параметры | |
---|---|
configuration | IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Параметры | |
---|---|
avdInfo | GceAvdInfo |
setDate
public void setDate (Date date)
Sets the date on device
Note: setting date on device requires root
Параметры | |
---|---|
date | Date : specify a particular date; will use host date if null |
Броски | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
Set a device admin component as device owner in given user.
Параметры | |
---|---|
componentName | String : of device admin to be device owner. |
userId | int : of the user that the device owner lives in. |
Возвраты | |
---|---|
boolean | True if it is successful, false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Update the device's state.
Параметры | |
---|---|
deviceState | TestDeviceState : the TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
For emulator set SizeLimitedOutputStream
to log output
Параметры | |
---|---|
output | SizeLimitedOutputStream : to log the output |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Sets the Process
, when this device is an emulator.
Параметры | |
---|---|
p | Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Set the fastboot option for the device. Should be set when device is first allocated.
Параметры | |
---|---|
fastbootEnabled | boolean : whether fastboot is available for the device or not |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled()
to be true, to have fastboot functions enabled.
Параметры | |
---|---|
fastbootPath | String |
setIDevice
public void setIDevice (IDevice newDevice)
Update the IDevice associated with this ITestDevice.
The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDeviceПараметры | |
---|---|
newDevice | IDevice : the IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Sets the time in ms to wait before starting logcat capture for a online device.
Параметры | |
---|---|
delay | int : the delay in ms |
setOptions
public void setOptions (TestDeviceOptions options)
Set the TestDeviceOptions
for the device
Параметры | |
---|---|
options | TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
Sets the given property value on the device. Requires adb root is true.
Параметры | |
---|---|
propKey | String : The key targeted to be set. |
propValue | String : The property value to be set. |
Возвраты | |
---|---|
boolean | returns True if the setprop command was successful, False otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Set the IDeviceRecovery
to use for this device. Should be set when device is first allocated.
Параметры | |
---|---|
recovery | IDeviceRecovery : the IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Set the current recovery mode to use for the device.
Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etcПараметры | |
---|---|
mode | ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not. |
setSetting
public void setSetting (String namespace, String key, String value)
See setSetting(int, String, String, String)
and performed on system user.
Параметры | |
---|---|
namespace | String |
key | String |
value | String |
Броски | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}
Параметры | |
---|---|
userId | int |
namespace | String |
key | String |
value | String |
Броски | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Injects the ITestLogger
instance
Параметры | |
---|---|
testLogger | ITestLogger |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
For device management purpose track the serial we use for referencing the device.
Параметры | |
---|---|
trackingSerial | String |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
Set whether to use fastboot erase or fastboot format to wipe a partition on the device.
Параметры | |
---|---|
useFastbootErase | boolean : true if fastboot erase should be used or false if fastboot format should be used. |
startLogcat
public void startLogcat ()
Start capturing logcat output from device in the background.
Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat. When the device is no longer in use,stopLogcat()
must be called. startLogcat()
and stopLogcat()
do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat. startTradeInModeTesting
public boolean startTradeInModeTesting (int timeoutMs)
Enable testing trade-in mode. The device will be wiped and will reboot.
Параметры | |
---|---|
timeoutMs | int |
Возвраты | |
---|---|
boolean | True if we were successful, false otherwise |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
startUser
public boolean startUser (int userId)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.
Параметры | |
---|---|
userId | int : of the user to start in the background |
Возвраты | |
---|---|
boolean | true if the user was successfully started in the background. |
Броски | |
---|---|
DeviceNotAvailableException |
startUser
public boolean startUser (int userId, boolean waitFlag)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.
Параметры | |
---|---|
userId | int : of the user to start in the background |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Возвраты | |
---|---|
boolean | true if the user was successfully started in the background. |
Броски | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).
NOTE: this command doesn't check if the user exists, display is available, device supports such feature
, etc.
Параметры | |
---|---|
userId | int : of the user to start in the background |
displayId | int : display to start user visible on |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Возвраты | |
---|---|
boolean | true if the user was successfully started visible in the background. |
Броски | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Close and delete the emulator output.
stopLogcat
public void stopLogcat ()
Stop capturing logcat output from device, and discard currently saved logcat data.
Will have no effect if logcat output is not being captured.stopTradeInModeTesting
public void stopTradeInModeTesting ()
Stop trade-in mode testing.
Броски | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId)
Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.
Параметры | |
---|---|
userId | int : of the user to stop. |
Возвраты | |
---|---|
boolean | true if the user was successfully stopped. |
Броски | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.
Параметры | |
---|---|
userId | int : of the user to stop. |
waitFlag | boolean : will make the command wait until user is stopped. |
forceFlag | boolean : will force stop the user. |
Возвраты | |
---|---|
boolean | true if the user was successfully stopped. |
Броски | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public String switchToAdbTcp ()
Switch device to adb-over-tcp mode.
Возвраты | |
---|---|
String | the tcp serial number or null if device could not be switched |
Броски | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Switch device to adb over usb mode.
Возвраты | |
---|---|
boolean | true if switch was successful, false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId)
Switch to another userId with a default timeout. switchUser(int, long)
.
Параметры | |
---|---|
userId | int |
Возвраты | |
---|---|
boolean | True if the new userId matches the userId provider. False otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId, long timeout)
Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.
Параметры | |
---|---|
userId | int |
timeout | long : to wait before returning false for switch-user failed. |
Возвраты | |
---|---|
boolean | True if the new userId matches the userId provider. False otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
syncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
Incrementally syncs the contents of a local file directory to device.
Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date. Hidden files (with names starting with ".") will be ignored. Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.Параметры | |
---|---|
localFileDir | File : the local file directory containing files to recursively push. |
deviceFilePath | String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail |
Возвраты | |
---|---|
boolean | true if files were synced successfully. false otherwise. |
Броски | |
---|---|
DeviceNotAvailableException |
takeBugreport
public Bugreport takeBugreport ()
Take a bugreport and returns it inside a Bugreport
object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close()
.
Возвраты | |
---|---|
Bugreport |
uninstallPackage
public String uninstallPackage (String packageName)
Uninstall an Android package from device.
Параметры | |
---|---|
packageName | String : the Android package to uninstall |
Возвраты | |
---|---|
String | a String with an error code, or null if success. |
Броски | |
---|---|
DeviceNotAvailableException |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
Uninstall an Android package from device for a given user.
Параметры | |
---|---|
packageName | String : the Android package to uninstall |
userId | int : the integer user id to uninstall for. |
Возвраты | |
---|---|
String | a String with an error code, or null if success. |
Броски | |
---|---|
DeviceNotAvailableException |
unlockDevice
public boolean unlockDevice ()
Unlocks the device if the device is in an encrypted state.
This method may restart the framework but will not callpostBootSetup()
. Therefore, the device might not be fully ready to be tested when this method returns.Возвраты | |
---|---|
boolean | true if successful or if the device is unencrypted. |
Броски | |
---|---|
DeviceNotAvailableException |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Blocks until the device's boot complete flag is set.
Параметры | |
---|---|
timeOut | long : time in msecs to wait for the flag to be set |
Возвраты | |
---|---|
boolean | true if device's boot complete flag is set within the timeout |
Броски | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Waits for the device to be responsive and available for testing. Uses default timeout.
Возвраты | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Броски | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Waits for the device to be responsive and available for testing.
Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Возвраты | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Броски | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Waits for the device to be responsive and available without considering recovery path.
Параметры | |
---|---|
waitTime | long |
Возвраты | |
---|---|
boolean | True if device is available, False if unavailable. |
Броски | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Blocks until device is visible via fastboot. Use default timeout.
Броски | |
---|---|
DeviceNotAvailableException |
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery
).
Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Возвраты | |
---|---|
boolean | true if device boots into recovery before time expires. false otherwise |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blocks for the device to be in the 'adb sideload' state
Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Возвраты | |
---|---|
boolean | true if device boots into sideload before time expires. false otherwise |
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Blocks for the device to be not available ie missing from adb
Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Возвраты | |
---|---|
boolean | true if device becomes not available before time expires. false otherwise |
waitForDeviceOnline
public void waitForDeviceOnline ()
Blocks until device is visible via adb. Uses default timeout
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Броски | |
---|---|
DeviceNotAvailableException |
waitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
Blocks until device is visible via adb.
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Броски | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Waits for device to be responsive to a basic adb shell command.
Параметры | |
---|---|
waitTime | long : the time in ms to wait |
Возвраты | |
---|---|
boolean | true if device becomes responsive before waitTime elapses. |
Protected methods
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Параметры | |
---|---|
builder | DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Builds the OS command for the given adb shell command session and args
Параметры | |
---|---|
command | String |
forceExitStatusDetection | boolean |
Возвраты | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Параметры | |
---|---|
feature | String |
strictMinLevel | int |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Create a RebootDeviceAction
to be used when performing a reboot action.
Параметры | |
---|---|
rebootMode | NativeDevice.RebootMode : a mode of this reboot. |
reason | String : for this reboot. |
Возвраты | |
---|---|
NativeDevice.RebootDeviceAction | the created RebootDeviceAction . |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Perform a adb reboot.
Параметры | |
---|---|
rebootMode | NativeDevice.RebootMode : a mode of this reboot. |
reason | String : for this reboot. |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
helper method to throw exception if runtime permission isn't supported
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Возвраты | |
---|---|
int |
internalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.
Параметры | |
---|---|
propName | String : The name of the device property as returned by `adb shell getprop` |
fastbootVar | String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted |
description | String : A simple description of the variable. First letter should be capitalized. |
Возвраты | |
---|---|
String | A string, possibly null or empty, containing the value of the given property |
Броски | |
---|---|
DeviceNotAvailableException |
isInRebootCallback
protected boolean isInRebootCallback ()
Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.
Возвраты | |
---|---|
boolean |
isNewer
protected boolean isNewer (File localFile, IFileEntry entry)
Return true
if local file is newer than remote file. IFileEntry
being accurate to the minute, in case of equal times, the file will be considered newer.
Параметры | |
---|---|
localFile | File |
entry | IFileEntry |
Возвраты | |
---|---|
boolean |
notifyRebootEnded
protected void notifyRebootEnded ()
Notifies all IDeviceActionReceiver
about reboot end event.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notifyRebootStarted
protected void notifyRebootStarted ()
Notifies all IDeviceActionReceiver
about reboot start event.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
performDeviceAction
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Performs an action on this device. Attempts to recover device and optionally retry command if action fails.
Параметры | |
---|---|
actionDescription | String : a short description of action to be performed. Used for logging purposes only. |
action | NativeDevice.DeviceAction : the action to be performed |
retryAttempts | int : the retry attempts to make for action if it fails but recovery succeeds |
Возвраты | |
---|---|
boolean | true if action was performed successfully |
Броски | |
---|---|
DeviceNotAvailableException | if recovery attempt fails or max attempts done without success |
postAdbReboot
protected void postAdbReboot ()
Possible extra actions that can be taken after a reboot.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
prePostBootSetup
protected void prePostBootSetup ()
Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Параметры | |
---|---|
remoteFilePath | String |
localFile | File |
Возвраты | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
setClock
protected void setClock (Clock clock)
Set the Clock instance to use.
Параметры | |
---|---|
clock | Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Marks the TestDevice as microdroid and sets its CID.
Параметры | |
---|---|
process | Process : Process of the Microdroid VM. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Параметры | |
---|---|
deviceOptions | |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Executes a simple fastboot command with environment variables and report the status of the command.
Параметры | |
---|---|
timeout | long |
envVarMap |
|
fullCmd | String |
Возвраты | |
---|---|
CommandResult |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Executes a simple fastboot command and report the status of the command.
Параметры | |
---|---|
timeout | long |
fullCmd | String |
Возвраты | |
---|---|
CommandResult |
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Wait to see the device going unavailable (stop reporting to adb).
Параметры | |
---|---|
operationDesc | String : The name of the operation that is waiting for unavailable. |
time | long : The time to wait for unavailable to occur. |
Возвраты | |
---|---|
boolean | True if device did become unavailable. |
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-06-12 UTC.