РодноеУстройство
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 () Возвращает, разрешено ли переключение на безголового пользователя системы. |
boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) Проверьте, поддерживается ли функция в настоящее время с учетом минимально поддерживаемого уровня. |
boolean | checkConnectivity () Убедитесь, что устройство имеет подключение к сети. |
boolean | clearErrorDialogs () Попытайтесь закрыть все диалоговые окна ошибок, отображаемые в настоящее время в пользовательском интерфейсе устройства. |
void | clearLastConnectedWifiNetwork () Очищает последнюю подключенную сеть Wi-Fi. |
void | clearLogcat () Удаляет все накопленные данные logcat. |
boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Подключается к сети Wi-Fi. |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) Подключается к сети Wi-Fi. |
boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Подключается к сети 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. |
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 () Отключает адб рут. |
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, envMap, String... cmdArgs) executeAdbCommand (long timeout, envMap, String... cmdArgs) Вспомогательный метод, который выполняет команду adb как системную команду с указанным тайм-аутом. |
String | executeAdbCommand (String... cmdArgs) Вспомогательный метод, который выполняет команду adb как системную команду. |
CommandResult | executeFastbootCommand (String... cmdArgs) Вспомогательный метод, который выполняет команду быстрой загрузки как системную команду с тайм-аутом по умолчанию 2 минуты. |
CommandResult | executeFastbootCommand (long timeout, String... cmdArgs) Вспомогательный метод, который выполняет команду быстрой загрузки как системную команду. |
CommandResult | executeLongFastbootCommand (String... cmdArgs) Вспомогательный метод, который выполняет длительную команду быстрой загрузки как системную команду. |
CommandResult | executeLongFastbootCommand ( envVarMap, String... cmdArgs) executeLongFastbootCommand ( envVarMap, String... cmdArgs) Вспомогательный метод, который выполняет длительную команду быстрой загрузки как системную команду с переменными системной среды. |
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, связанный с идентификатором пользователя, нулевой, если он не найден. |
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 () Возвращает ссылку на связанный |
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-адрес устройства, нулевой, если не удалось выполнить запрос с устройства. |
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 (String format) Делает скриншот с устройства. |
InputStreamSource | getScreenshot (long displayId) Делает снимок экрана с устройства с заданным идентификатором дисплея. |
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-карты или ноль, если он недоступен или устройство недоступно. |
String | getSimState () Верните состояние SIM-карты или нулевое значение, если оно недоступно или устройство недоступно. |
getTombstones () Получите и верните список надгробий с устройств. | |
long | getTotalMemory () Возвращает общий размер физической памяти в байтах или -1 в случае внутренней ошибки. |
String | getTrackingSerial () Для управления устройством получите серийный номер, используемый для отслеживания устройства. |
getUninstallablePackageNames () Получите имена пакетов приложений, которые можно удалить. | |
boolean | getUseFastbootErase () Узнайте, следует ли использовать Fastboot Erase или Fastboot Format для очистки раздела на устройстве. |
int | getUserFlags (int userId) Найдите и верните флаги данного пользователя. |
getUserInfos () Получает сопоставление useId с | |
int | getUserSerialNumber (int userId) Возвращает серийный номер, связанный с идентификатором пользователя, если он найден, -10000 в любых других случаях. |
IManagedTestDevice.DeviceEventResponse | handleAllocationEvent (DeviceEvent event) Обработать данное DeviceEvent. Обработайте DeviceEvent, который может перевести или не перевести это устройство в новое состояние распределения. |
boolean | hasFeature (String feature) Проверьте, доступна ли функция на устройстве. |
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) Зарегистрируйте сообщение в logcat устройства. |
void | mountDebugfs () Смонтируйте отладочную файлы. |
void | nonBlockingReboot () Выдает команду на перезагрузку устройства и возвращает результат после завершения команды и когда устройство больше не отображается в adb. |
void | postAdbRootAction () Переопределить, если устройству необходимо выполнить какие-то определенные действия после получения root-доступа adb и до того, как устройство снова подключится к сети. |
void | postAdbUnrootAction () Переопределить, если устройству необходимо выполнить какие-то определенные действия после отключения adb и до того, как устройство снова подключится к сети. |
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, excludedDirectories) pushDir (File localFileDir, String deviceFilePath, excludedDirectories) Рекурсивно отправлять содержимое каталога на устройство, исключая некоторые фильтруемые каталоги. |
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 (обратите внимание, что это специальный режим в режиме восстановления) Блокируется до тех пор, пока устройство не перейдет в режим неопубликованной загрузки. |
void | rebootIntoSideload (boolean autoReboot) Перезагружает устройство в режим боковой загрузки adb (обратите внимание, что это специальный режим в режиме восстановления) Блокируется до тех пор, пока устройство не перейдет в режим неопубликованной загрузки. |
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, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Запускает инструментальные тесты и обеспечивает восстановление устройства. |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) То же, что |
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 Erase или Fastboot Format для очистки раздела на устройстве. |
void | startLogcat () Начните захват вывода logcat с устройства в фоновом режиме. |
boolean | startUser (int userId) Запускает данного пользователя в фоновом режиме, если он в данный момент остановлен. |
boolean | startUser (int userId, boolean waitFlag) Запускает данного пользователя в фоновом режиме, если он в данный момент остановлен. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Запускает данного пользователя в фоновом режиме, видимом на данном дисплее (т. е. позволяя пользователю запускать действия на этом дисплее). |
void | stopEmulatorOutput () Закройте и удалите вывод эмулятора. |
void | stopLogcat () Прекратите захват вывода logcat с устройства и удалите текущие сохраненные данные logcat. |
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 () Отмонтируйте отладочные файлы. |
boolean | waitForBootComplete (long timeOut) Блокируется до тех пор, пока не будет установлен флаг завершения загрузки устройства. |
boolean | waitForDeviceAvailable () Ожидает, пока устройство ответит и будет доступно для тестирования. |
boolean | waitForDeviceAvailable (long waitTime) Ожидает, пока устройство ответит и будет доступно для тестирования. |
boolean | waitForDeviceAvailableInRecoverPath (long waitTime) Ожидает, пока устройство ответит и станет доступным, не учитывая путь восстановления. |
void | waitForDeviceBootloader () Блокируется до тех пор, пока устройство не станет видимым через fastboot. |
boolean | waitForDeviceInRecovery (long waitTime) Блокирует нахождение устройства в состоянии «восстановление adb» (обратите внимание, что это отличается от |
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 () Получите экземпляр |
void | initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes) |
String | internalGetProperty (String propName, String fastbootVar, String description) Получите свойство устройства из кэша ddmlib по умолчанию и вернитесь к `adb Shell getprop` или `fastboot getvar` в зависимости от того, находится ли устройство в режиме Fastboot или нет. |
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) Установите экземпляр Clock для использования. |
void | setMicrodroidProcess (Process process) Помечает TestDevice как microdroid и устанавливает его CID. |
void | setTestDeviceOptions ( deviceOptions) setTestDeviceOptions ( deviceOptions) |
CommandResult | simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) Выполняет простую команду быстрой загрузки с переменными среды и сообщает о состоянии команды. |
CommandResult | simpleFastbootCommand (long timeout, String[] fullCmd) Выполняет простую команду быстрой загрузки и сообщает о состоянии команды. |
boolean | waitForDeviceNotAvailable (String operationDesc, long time) Подождите, пока устройство станет недоступным (прекратите отправлять отчеты в adb). |
Константы
INVALID_USER_ID
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
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
Общественные конструкторы
РодноеУстройство
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Создает TestDevice
.
Параметры | |
---|---|
device | IDevice : связанный IDevice |
stateMonitor | IDeviceStateMonitor : используемый механизм IDeviceStateMonitor |
allocationMonitor | IDeviceMonitor : IDeviceMonitor для информирования об изменениях состояния распределения. Может быть нулевым |
Публичные методы
Пакетная сборкаPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Микрооптимизация (около 400 миллис) путем предварительной выборки всех необходимых нам реквизитов вместо вызова adb getprop для каждого из них. т.е. получение всех свойств происходит так же быстро, как и получение одного. Такие вещи, как device.getApiLevel(), checkApiLevelAgainstNextRelease и getBuildAlias, все «под капотом» вызывают adb getprop. Мы извлекаем их одним вызовом и вызываем NativeDevice.setProperty. Даже если мы этого не сделаем, NativeDevice сам вызовет setProperty и кэширует результат для будущих вызовов. Просто мы делаем это немного раньше. Если устройство находится в процессе восстановления или есть другие ошибки при получении реквизитов, мы просто игнорируем их.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Возвращает, разрешено ли переключение на безголового пользователя системы.
Возврат | |
---|---|
boolean |
Броски | |
---|---|
DeviceNotAvailableException |
проверкаApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Проверьте, поддерживается ли функция в настоящее время с учетом минимально поддерживаемого уровня. Этот метод учитывает еще не выпущенные функции до повышения уровня API.
Параметры | |
---|---|
strictMinLevel | int : Строгий минимальный возможный уровень, поддерживающий эту функцию. |
Возврат | |
---|---|
boolean | Истинно, если уровень поддерживается. В противном случае неверно. |
Броски | |
---|---|
DeviceNotAvailableException |
checkConnectivity
public boolean checkConnectivity ()
Убедитесь, что устройство имеет подключение к сети.
Возврат | |
---|---|
boolean | true , если устройство имеет работающее сетевое соединение, в противном случае false . |
Броски | |
---|---|
DeviceNotAvailableException |
ClearErrorDialogs
public boolean clearErrorDialogs ()
Попытайтесь закрыть все диалоговые окна ошибок, отображаемые в настоящее время в пользовательском интерфейсе устройства.
Возврат | |
---|---|
boolean | true , если диалоговые окна не присутствовали или диалоги были успешно очищены. false в противном случае. |
Броски | |
---|---|
DeviceNotAvailableException |
ClearLastConnectedWiFiNetwork
public void clearLastConnectedWifiNetwork ()
Очищает последнюю подключенную сеть Wi-Fi. Это следует вызывать при запуске нового вызова, чтобы избежать подключения к сети Wi-Fi, использованной в предыдущем тесте, после перезагрузки устройства.
очиститьLogcat
public void clearLogcat ()
Удаляет все накопленные данные logcat.
Это полезно в тех случаях, когда вы хотите, чтобыITestDevice#getLogcat()
возвращал данные журнала, созданные после определенного момента (например, после прошивки новой сборки устройства и т. д.). ConnectToWiFiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Подключается к сети Wi-Fi.
Включает Wi-Fi и блокирует его до тех пор, пока не будет установлено успешное соединение с одной из сетей Wi-Fi, указанных на карте wifiSsidToPsk. После установления соединения экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice#disconnectFromWifi()
или ITestDevice#clearLastConnectedWifiNetwork()
.
Параметры | |
---|---|
wifiSsidToPsk | |
scanSsid | boolean : следует ли сканировать скрытые SSID для этой сети. |
Возврат | |
---|---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
Броски | |
---|---|
DeviceNotAvailableException |
ConnectToWiFiNetwork
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 |
ConnectToWiFiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk)
Подключается к сети Wi-Fi.
Включает Wi-Fi и блокирует его до тех пор, пока не будет установлено успешное соединение с одной из сетей Wi-Fi, указанных на карте wifiSsidToPsk. После установки соединения экземпляр будет пытаться восстановить соединение после каждой перезагрузки, пока не будет вызван ITestDevice#disconnectFromWifi()
или ITestDevice#clearLastConnectedWifiNetwork()
f
Параметры | |
---|---|
wifiSsidToPsk |
Возврат | |
---|---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
Броски | |
---|---|
DeviceNotAvailableException |
ConnectToWiFiNetwork
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 |
ConnectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Вариант connectToWifiNetwork(String, String)
который подключается только в том случае, если устройство в данный момент не имеет подключения к сети.
Параметры | |
---|---|
scanSsid | boolean : следует ли сканировать скрытый SSID для этой сети. |
Возврат | |
---|---|
boolean | true , если подключение к сети Wi-Fi успешно. false в противном случае |
Броски | |
---|---|
DeviceNotAvailableException |
ConnectToWifiNetworkIfNeeded
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 |
createUserNoThrow
public int createUserNoThrow (String name)
Создайте пользователя с заданным именем и флагами по умолчанию 0.
Параметры | |
---|---|
name | String : пользователя, которого нужно создать на устройстве. |
Возврат | |
---|---|
int | целое число для созданного идентификатора пользователя или -1 в случае ошибки. |
Броски | |
---|---|
DeviceNotAvailableException |
удалить файл
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 , который будет удален. |
устройствоSoftRestarted
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Вспомогательный метод для проверки плавного перезапуска устройства путем сравнения текущего system_server с предыдущим system_server ProcessInfo
. Используйте getProcessByName(String)
для получения ProcessInfo
.
Параметры | |
---|---|
prevSystemServerProcess | ProcessInfo : предыдущий процесс system_server ProcessInfo . |
Возврат | |
---|---|
boolean | true , если устройство перезапущено |
Броски | |
---|---|
DeviceNotAvailableException |
устройствоSoftRestartedSince
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. Этот метод будет заблокирован до тех пор, пока устройство не станет доступным.Возврат | |
---|---|
boolean | true в случае успеха. |
Броски | |
---|---|
DeviceNotAvailableException |
отключитьKeyguard
public void disableKeyguard ()
Пытается отключить защиту клавиатуры.
Сначала подождите, пока будет готова диспетчеризация ввода. Это происходит примерно в то же время, когда устройство сообщает BOOT_COMPLETE, по-видимому, асинхронно, поскольку текущая реализация платформы время от времени имеет состояние гонки. Затем отправляется команда для отключения защиты клавиатуры (работает только на незащищенных устройствах).
Броски | |
---|---|
DeviceNotAvailableException |
отключитьNetworkMonitor
public boolean disableNetworkMonitor ()
Отключает мониторинг сети на устройстве.
Возврат | |
---|---|
boolean | true , если мониторинг успешно отключен. false если это не удалось. |
Броски | |
---|---|
DeviceNotAvailableException |
отключить от Wi-Fi
public boolean disconnectFromWifi ()
Отключается от сети Wi-Fi.
Удаляет все сети из списка известных сетей и отключает Wi-Fi.Возврат | |
---|---|
boolean | true , если успешно отключено от сети Wi-Fi. false , если отключение не удалось. |
Броски | |
---|---|
DeviceNotAvailableException |
делаетFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
Вспомогательный метод, позволяющий определить, существует ли файл на устройстве для данного пользователя.
Параметры | |
---|---|
deviceFilePath | String : абсолютный путь к файлу на устройстве для проверки. |
userId | int : идентификатор пользователя, по которому можно проверить существование файла. |
Возврат | |
---|---|
boolean | true , если файл существует, в противном случае false . |
Броски | |
---|---|
DeviceNotAvailableException |
делаетFileExist
public boolean doesFileExist (String deviceFilePath)
Вспомогательный метод для определения существования файла на устройстве.
Параметры | |
---|---|
deviceFilePath | String : абсолютный путь к файлу на устройстве для проверки. |
Возврат | |
---|---|
boolean | true , если файл существует, в противном случае false . |
Броски | |
---|---|
DeviceNotAvailableException |
дампКуча
public File dumpHeap (String process, String devicePath)
Попытайтесь сбросить кучу с system_server. Ответственность за очистку сброшенного файла лежит на вызывающей стороне.
Параметры | |
---|---|
process | String : имя процесса устройства, на который создается дамп кучи. |
devicePath | String : путь на устройстве, куда поместить дамп. Это должно быть место, где разрешения позволяют это. |
Возврат | |
---|---|
File | ERROR(/File) содержащая отчет. Нуль, если что-то не удалось. |
Броски | |
---|---|
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 | стандартный вывод из команды. null , если команда не была выполнена. |
Броски | |
---|---|
DeviceNotAvailableException |
выполнитьAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
Вспомогательный метод, который выполняет команду adb как системную команду с указанным тайм-аутом.
Вместо этого везде, где это возможно, следует executeShellCommand(String)
, так как этот метод обеспечивает лучшее обнаружение сбоев и производительность.
Параметры | |
---|---|
timeout | long : время в миллисекундах, по истечении которого устройство считается не отвечающим, 0L — без тайм-аута. |
envMap | |
cmdArgs | String : команда adb и аргументы для запуска. |
Возврат | |
---|---|
String | стандартный вывод из команды. null , если команда не была выполнена. |
Броски | |
---|---|
DeviceNotAvailableException |
выполнитьAdbCommand
public String executeAdbCommand (String... cmdArgs)
Вспомогательный метод, который выполняет команду adb как системную команду.
Вместо этого везде, где это возможно, следуетexecuteShellCommand(String)
, так как этот метод обеспечивает лучшее обнаружение сбоев и производительность.Параметры | |
---|---|
cmdArgs | String : команда adb и аргументы для запуска. |
Возврат | |
---|---|
String | стандартный вывод из команды. null , если команда не была выполнена. |
Броски | |
---|---|
DeviceNotAvailableException |
выполнитьFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
Вспомогательный метод, который выполняет команду быстрой загрузки как системную команду с тайм-аутом по умолчанию 2 минуты.
Предполагается использовать, когда устройство уже находится в режиме быстрой загрузки.
Параметры | |
---|---|
cmdArgs | String : команда fastboot и аргументы для запуска. |
Возврат | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException |
выполнитьFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Вспомогательный метод, который выполняет команду быстрой загрузки как системную команду.
Предполагается использовать, когда устройство уже находится в режиме быстрой загрузки.Параметры | |
---|---|
timeout | long : время в миллисекундах до истечения срока действия команды. |
cmdArgs | String : команда fastboot и аргументы для запуска. |
Возврат | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException |
выполнитьLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Вспомогательный метод, который выполняет длительную команду быстрой загрузки как системную команду.
ИдентиченexecuteFastbootCommand(String)
за исключением того, что используется более длительный тайм-аут.Параметры | |
---|---|
cmdArgs | String : команда fastboot и аргументы для запуска. |
Возврат | |
---|---|
CommandResult | CommandResult, содержащий вывод команды |
Броски | |
---|---|
DeviceNotAvailableException |
выполнитьLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Вспомогательный метод, который выполняет длительную команду быстрой загрузки как системную команду с переменными системной среды.
Идентично для executeFastbootCommand(String)
кроме как использует более длительный тайм -аут.
Параметры | |
---|---|
envVarMap | |
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 | Версия BaseBand String или 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 (String format)
Занимает скриншот с устройства. Рекомендуется использовать GetScreenshot (формат) вместо кодирования JPEG для меньшего размера
Параметры | |
---|---|
format | String : поддерживается PNG, JPEG |
Возврат | |
---|---|
InputStreamSource | InputStreamSource снимка экрана в формате или null , если скриншот не был успешным. |
Броски | |
---|---|
DeviceNotAvailableException |
GetScreenshot
public InputStreamSource getScreenshot (long displayId)
Занимает скриншот с данного идентификатора дисплея. Формат PNG.
TODO: расширить реализации выше, чтобы поддержать «формат» и «Rescale»
Параметры | |
---|---|
displayId | long : идентификатор дисплея экрана, чтобы получить скриншот от. |
Возврат | |
---|---|
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 |
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 ()
Выпускает команду для перезагрузки устройства и возвращается по команде, и когда устройство больше не видно для ADB.
Броски | |
---|---|
DeviceNotAvailableException |
почтовое обороты
public void postAdbRootAction ()
Переопределите, если устройству нужны определенные действия, которые необходимо предпринять после корня ADB, и до того, как устройство вернется в Интернет. Реализация по умолчанию не включает никаких действий с добавлением. На этом этапе корень ADB не гарантированно будет включен.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
почтовое обоснование
public void postAdbUnrootAction ()
Переопределите, если устройству нужны определенные действия, которые необходимо предпринять после ADB Unroot, и до того, как устройство вернется в Интернет. Реализация по умолчанию не включает никаких дополнительных действий. ADB Root не гарантированно будет отключен на этом этапе.
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postbootsetup
public void postBootSetup ()
Выполните инструкции по настройке устройства для тестирования его после каждой загрузки.
Следует вызвать после того, как устройство полностью загружается/доступно В обычных обстоятельствах этот метод не должен быть явно называется, так как реализации должны выполнять эти шаги автоматически при выполнении перезагрузки. Если это может потребоваться, когда устройства перезагружаются из -за других событий (например, когда завершена команда Fastboot Update)Броски | |
---|---|
DeviceNotAvailableException |
PostInvocationTeardown
public void postInvocationTearDown (Throwable exception)
Дополнительные шаги для конкретного устройства требуемой очистки, которые будут выполнены после выполнения вызова.
Параметры | |
---|---|
exception | Throwable : если таковые имеются, окончательное исключение, поднятое сбоем вызова. |
PreinvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Дополнительные шаги для конкретной устройства требуемой настройки, которая будет выполнена на устройстве до потока вызова.
Параметры | |
---|---|
info | IBuildInfo : IBuildInfo устройства. |
attributes | MultiMap : атрибуты, хранящиеся в контексте вызова |
Броски | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
Пульдир
public boolean pullDir (String deviceFilePath, File localDir, int userId)
Рекурсивно вытащить содержимое каталога с устройства.
Параметры | |
---|---|
deviceFilePath | String : абсолютный путь файла удаленного источника |
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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) |
Throws | |
---|---|
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) |
Throws | |
---|---|
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. |
Throws | |
---|---|
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) |
Throws | |
---|---|
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) |
Throws | |
---|---|
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 |
Возврат | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
DeviceNotAvailableException |
перезагрузить
public void reboot ()
Reboots the device into adb mode.
Blocks until device becomes available.Throws | |
---|---|
DeviceNotAvailableException |
rebootIntoBootloader
public void rebootIntoBootloader ()
Reboots the device into bootloader mode.
Blocks until device is in bootloader mode.Throws | |
---|---|
DeviceNotAvailableException |
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Reboots the device into fastbootd mode.
Blocks until device is in fastbootd mode.
Throws | |
---|---|
DeviceNotAvailableException |
rebootIntoRecovery
public void rebootIntoRecovery ()
Reboots the device into adb recovery mode.
Blocks until device enters recoveryThrows | |
---|---|
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
Throws | |
---|---|
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 |
Throws | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline ()
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Throws | |
---|---|
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. |
Throws | |
---|---|
DeviceNotAvailableException |
rebootUserspace
public void rebootUserspace ()
Reboots only userspace part of device.
Blocks until device becomes available.
ПРЕДУПРЕЖДЕНИЕ. Userspace reboot is currently under active development, use it on your own risk.
Throws | |
---|---|
DeviceNotAvailableException |
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
An alternate to rebootUserspace()
()} that only blocks until device is online ie visible to adb.
Throws | |
---|---|
DeviceNotAvailableException |
recoverDevice
public boolean recoverDevice ()
Attempts to recover device communication.
Возврат | |
---|---|
boolean | True if recovery attempted and successful, returns False if recovery was skipped |
Throws | |
---|---|
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.
Throws | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Make the system partition on the device writable. May reboot the device.
Throws | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
Make the vendor partition on the device read-only. May reboot the device.
Throws | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
Make the vendor partition on the device writable. May reboot the device.
Throws | |
---|---|
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.
Throws | |
---|---|
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. |
Throws | |
---|---|
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 |
Throws | |
---|---|
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 |
Возврат | |
---|---|
boolean | true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded |
Throws | |
---|---|
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 |
Throws | |
---|---|
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 |
Throws | |
---|---|
DeviceNotAvailableException |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Внедряет используемый IConfiguration
.
Параметры | |
---|---|
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 |
Throws | |
---|---|
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. |
Throws | |
---|---|
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 |
УстановитьОпции
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. |
Throws | |
---|---|
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 |
Throws | |
---|---|
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. 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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Close and delete the emulator output.
stopLogcat
public void stopLogcat ()
Stop capturing logcat output from device, and discard currently saved logcat data.
Will have no effect if logcat output is not being captured.stopUser
public boolean stopUser (int userId)
Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.
Параметры | |
---|---|
userId | int : of the user to stop. |
Возврат | |
---|---|
boolean | true if the user was successfully stopped. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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 |
Throws | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Switch device to adb over usb mode.
Возврат | |
---|---|
boolean | true if switch was successful, false otherwise. |
Throws | |
---|---|
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. В противном случае неверно. |
Throws | |
---|---|
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. В противном случае неверно. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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 |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
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. |
Throws | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Blocks until device is visible via fastboot. Use default timeout.
Throws | |
---|---|
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.Throws | |
---|---|
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 |
Throws | |
---|---|
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. |
Защищенные методы
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. |
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
helper method to throw exception if runtime permission isn't supported
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Возврат | |
---|---|
int |
initializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Параметры | |
---|---|
info | IBuildInfo |
attributes | MultiMap |
Throws | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
internalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.
Параметры | |
---|---|
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.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notifyRebootStarted
protected void notifyRebootStarted ()
Notifies all IDeviceActionReceiver
about reboot start event.
Throws | |
---|---|
| 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 |
Throws | |
---|---|
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.
Throws | |
---|---|
| 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.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Параметры | |
---|---|
remoteFilePath | String |
localFile | File |
Возврат | |
---|---|
boolean |
Throws | |
---|---|
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 и ее аффилированных лиц.
Последнее обновление: 2024-08-13 UTC.