Каждое запущенное виртуальное устройство предоставляет консоль, которая позволяет запрашивать и контролировать эмулируемую среду устройства. Например, с помощью консоли можно управлять перенаправлением портов, характеристиками сети и событиями телефонии во время работы приложения в эмуляторе.
Для выполнения следующих команд у вас уже должен быть запущен эмулятор. Подробную информацию о работе с эмулятором можно найти в статьях Запуск приложений в эмуляторе Android и Запуск эмулятора из командной строки.
Как начать и завершить сеанс в консоли
Чтобы получить доступ к консоли и вводить команды из окна терминала, подключитесь к порту консоли по протоколу Telnet и укажите токен аутентификации. Когда в консоли появляется надпись OK, это означает, что она готова к приему команд. Типичного запроса не существует.
Чтобы подключиться к консоли работающего виртуального устройства, выполните следующие действия:
Откройте окно терминала и введите следующую команду:
telnet localhost console-portНомер порта консоли указывается в заголовке окна эмулятора, если он запущен в отдельном окне, но не в окне инструмента. Например, заголовок окна для эмулятора, использующего порт консоли 5554, может быть Pixel8_API_34:5554. Кроме того, команда
adb devicesвыводит список запущенных виртуальных устройств и номера их портов консоли. Подробнее о запросах для устройств…Примечание. Эмулятор прослушивает подключения на портах с 5554 по 5585 и принимает подключения только от localhost.
Когда в консоли появится сообщение OK, введите команду
auth auth_token.Прежде чем вводить команды консоли, эмулятор консоли требует аутентификации.
auth_tokenдолжно совпадать с содержимым файла.emulator_console_auth_tokenв вашем домашнем каталоге.Если такого файла нет, команда
telnet localhost console-portсоздаст его и добавит в него случайно сгенерированный токен аутентификации. Чтобы отключить аутентификацию, удалите токен из файла.emulator_console_auth_tokenили создайте пустой файл, если он не существует.После подключения к консоли введите команды консоли.
Введите
help,help commandилиhelp-verbose, чтобы посмотреть список команд консоли и узнать о них больше.Чтобы выйти из сеанса консоли, введите
quitилиexit.
Вот пример сеанса:
$ telnet localhost 5554
Trying ::1...
telnet: connect to address ::1: Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Android Console: Authentication required
Android Console: type 'auth <auth_token>' to authenticate
Android Console: you can find your <auth_token> in
'/Users/me/.emulator_console_auth_token'
OK
auth 123456789ABCdefZ
Android Console: type 'help' for a list of commands
OK
help-verbose
Android console command help:
help|h|? Prints a list of commands
help-verbose Prints a list of commands with descriptions
ping Checks if the emulator is alive
automation Manages emulator automation
event Simulates hardware events
geo Geo-location commands
gsm GSM related commands
cdma CDMA related commands
crash Crashes the emulator instance
crash-on-exit Simulates crash on exit for the emulator instance
kill Terminates the emulator instance
restart Restarts the emulator instance
network Manages network settings (ethernet and cellular only)
power Power related commands
quit|exit Quits control session
redir Manages port redirections
sms SMS related commands
avd Controls virtual device execution
qemu QEMU-specific commands
sensor Manages emulator sensors
physics Manages physical model
finger Manages emulator finger print
debug Controls the emulator debug output tags
rotate Rotates the screen clockwise by 90 degrees
screenrecord Records the emulator's display
fold Folds the device
unfold Unfolds the device
multidisplay Configures the multi-display
nodraw turn on/off NoDraw mode. (experimental)
resize-display resize the display resolution to the preset size
virtualscene-image customize virtualscene image for virtulscene camera
proxy manage network proxy server settings
phonenumber set phone number for the device
try 'help <command>' for command-specific help
OK
exit
Connection closed by foreign host.
Команды, не требующие ответа
Если вам не нужно, чтобы сеанс оставался открытым, используйте сокращение adb emu, которое выполняет команду и сразу же возвращает управление вызывающей оболочке:
adb emu command commandParameter
Вызов с помощью adb emu подключается к доступному эмулятору. Если у вас одновременно запущено несколько эмуляторов, необходимо передать серийный номер нужного эмулятора:
adb -s emulator-serial emu command commandParameter
Справочник по командам эмулятора
Ниже перечислены команды консоли эмулятора с их параметрами и значениями.
Общие команды
avd {stop| start| status| name}Запрашивает, контролирует и управляет виртуальным устройством следующим образом:- stop – останавливает выполнение задачи.
- start – запуск устройства.
- status – запрашивает статус виртуального устройства (может быть "работает" или "остановлено");
- name – запрашивает название виртуального устройства.
avd snapshot {list| save name| load name| delete name}Сохраняет и восстанавливает состояние устройства в виде снимков следующим образом:- list – показывает все сохраненные снимки.
- save name – сохраняет снимок под указанным именем.
- load name – загрузить снимок с указанным названием.
- delete name – удаляет снимок с указанным названием.
В следующем примере сохраняется снимок с названием
firstactivitysnapshot:avd snapshot save firstactivitysnapshotfold – складывает устройство, чтобы показать его в конфигурации с меньшим экраном, если устройство складное и в данный момент разложено.
unfold – разворачивает устройство, чтобы показать его экран в разложенном виде (если устройство складное и в данный момент сложено).
kill – завершает работу виртуального устройства.
ping – проверяет, работает ли виртуальное устройство.
rotate – поворачивает изображение против часовой стрелки с шагом 45 градусов.
Как вызвать сбой эмулятора
crash – сбой эмулятора во время работы приложения;
crash-on-exit – при выходе из приложения происходит сбой эмулятора.
Отладка тегов
debug tags ... – включает или отключает сообщения отладки из определенных частей эмулятора. Параметр tags должен быть значением из списка тегов отладки, который появляется при выполнении
emulator -help-debug-tags. Дополнительную информацию о параметре-help-debug-tagsможно найти в таблице часто используемых параметров. В примере ниже показано, как включить тег радио.debug radio
Переадресация портов
redir list – показывает текущие перенаправления портов.
redir add protocol:host-port:guest-portДобавляет новое перенаправление портов:- protocol – tcp или udp.
- host-port – номер порта, который нужно открыть на хосте.
- guest-port – номер порта для маршрутизации данных в эмуляторе.
redir del protocol:host-portУдаляет перенаправление портов.- protocol – tcp или udp.
- host-port – номер порта, который нужно открыть на хосте.
Географическое местоположение
Задает географическое местоположение, которое передается приложениям, запущенным в эмуляторе, путем отправки в эмулятор GPS-координат.
После запуска виртуального устройства можно выполнить одну из следующих команд: Эмулятор задает указанное вами местоположение, создавая фиктивный поставщик данных о местоположении. Этот поставщик отвечает на запросы слушателей местоположения, заданные приложениями, и передает местоположение в LocationManager. Любое приложение может запросить у менеджера местоположения текущие координаты GPS для эмулируемого устройства, вызвав метод LocationManager.getLastKnownLocation("gps").
geo fix longitude latitude [altitude] [satellites] [velocity]– отправляет в эмулятор GPS-координаты. Укажите долготу и широту в десятичных градусах. Укажите число от 1 до 12, чтобы задать количество спутников, которые будут использоваться для определения местоположения, а также высоту в метрах и скорость в узлах.geo nmea sentence– отправляет на эмулируемое устройство строку NMEA 0183, как если бы она была отправлена с эмулируемого GPS-модема. Начните предложение с "$GP". В настоящее время поддерживаются только предложения $GPGGA и $GPRCM. Ниже приведен пример предложения GPGGA (Global Positioning System Fix Data), которое получает время, местоположение и данные о фиксации для GPS-приемника:geo nmea $GPGGA,hhmmss.ss,llll.ll,a,yyyyy.yy,a,x,xx,x.x,x.x,M,x.x,M,x.x,xxxx
Имитация аппаратных событий
Подсистема аппаратных событий в консоли эмулятора позволяет имитировать практически любое физическое взаимодействие с устройством. К ним относятся физические кнопки, сенсорный экран, жесты, поворотные переключатели, джойстики и аппаратные переключатели.
event types: список всех типов фиктивных событий. Если у события есть коды, их количество указано в скобках справа. Пример выходных данных:event types event <type> can be an integer or one of the following aliases: EV_SYN EV_KEY (405 code aliases) EV_REL (2 code aliases) EV_ABS (27 code aliases) EV_MSC EV_SW (4 code aliases) EV_LED EV_SND EV_REP EV_FF EV_PWR EV_FF_STATUS EV_MAX OKevent send types [types ...]– отправляет один или несколько типов фиктивных событий.event codes type– коды событий для указанного типа фиктивного события.event send type[:code]:[value] [...]– отправляет одно или несколько фиктивных событий с необязательными кодами и значениями кодов.
EV_KEY — Key Code References
Тип события EV_KEY используется для имитации нажатия и отпускания кнопок. В таблицах ниже приведены коды клавиш, разделенные по категориям. Для каждого кода клавиши значение 1 имитирует нажатие, а значение 0 – отпускание. Значение 2 соответствует повторному нажатию клавиши.
Дополнительная таблица А. Ключи системы Android
| Код | Описание |
|---|---|
KEY_HOME |
Триггер кнопки главного экрана |
KEY_BACK |
Триггер кнопки "Назад" |
KEY_MENU |
Кнопка меню (дополнительное меню) |
KEY_POWER |
Кнопка питания (нажатие/долгое нажатие) |
KEY_VOLUMEUP |
Триггер кнопки увеличения громкости |
KEY_VOLUMEDOWN |
Триггер кнопки уменьшения громкости |
KEY_CAMERA |
Физическая кнопка спуска затвора |
KEY_FOCUS |
Автофокус камеры |
KEY_SEARCH |
Триггер кнопки поиска |
KEY_SLEEP |
Триггер команды перехода в спящий режим |
KEY_WAKEUP |
Триггер команды выхода из спящего режима |
KEY_NOTIFICATION |
Открыть панель уведомлений |
KEY_MUTE |
Отключить вывод системного звука |
KEY_MICMUTE |
Отключить микрофон |
KEY_BRIGHTNESSDOWN |
Уменьшить яркость экрана |
KEY_BRIGHTNESSUP |
Увеличить яркость экрана |
KEY_PHONE |
Открыть приложение для звонков по умолчанию |
KEY_SEND |
Отправка или инициирование телефонного звонка |
KEY_HEADSETHOOK |
Кнопка на гарнитуре (ответить/повесить трубку) |
KEY_SCREEN |
Команда для активации заставки |
KEY_CONFIG |
Меню настроек системы |
KEY_SWITCHVIDEOMODE |
Переключить режим видео в системе |
KEY_KBDILLUMTOGGLE |
Включить или отключить подсветку клавиатуры |
Таблица B. Элементы управления воспроизведением медиаконтента
| Код | Описание |
|---|---|
KEY_PLAYPAUSE |
Переключить воспроизведение и паузу |
KEY_PLAY |
Запустить воспроизведение медиаконтента |
KEY_PAUSECD |
Приостановить воспроизведение CD |
KEY_STOPCD |
Остановить воспроизведение CD |
KEY_NEXTSONG |
Перейти к следующему треку |
KEY_PREVIOUSSONG |
Перейти к предыдущему треку |
KEY_REWIND |
Перемотать активный трек |
KEY_FASTFORWARD |
Перемотать текущий трек вперед |
KEY_RECORD |
Записать команду триггера |
KEY_SHUFFLE |
Включить или отключить перемешивание |
KEY_REPEAT |
Включить или отключить повторное воспроизведение |
KEY_MEDIA |
Триггер мультимедийной клавиши |
Подтаблица C. Навигация и общие сочетания клавиш
| Код | Описание |
|---|---|
KEY_UP |
D-pad — вверх |
KEY_DOWN |
D-pad — вниз |
KEY_LEFT |
D-pad — влево |
KEY_RIGHT |
D-pad: вправо |
KEY_PAGEUP |
Переход на страницу вверх |
KEY_PAGEDOWN |
Переход на страницу вниз |
KEY_INSERT |
Вставить триггер клавиши |
KEY_DELETE |
Удалить триггер клавиши |
KEY_ENTER |
Триггер клавиши Ввод |
KEY_ESC |
Триггер клавиши Escape |
KEY_TAB |
Триггер клавиши Tab |
KEY_SPACE |
Триггер клавиши "Пробел" |
KEY_BACKSPACE |
Триггер клавиши Backspace |
KEY_CLEAR |
Очистить буфер ввода |
KEY_CANCEL |
Отменить активное действие |
KEY_OK |
Подтвердить выбор |
KEY_SELECT |
Триггер выбора объекта |
KEY_GOTO |
Перейти к назначенному месту |
KEY_HELP |
Доступ к контекстной справке |
Таблица D. Буквенно-цифровые символы и символы клавиатуры
- Стандартные буквы алфавита: от
KEY_AдоKEY_Z(26 кодов). - Клавиши цифровой клавиатуры: от
KEY_1доKEY_0(10 кодов).
| Код | Символ персонажа |
|---|---|
KEY_COMMA |
, |
KEY_DOT |
. |
KEY_SLASH |
/ |
KEY_SEMICOLON |
; |
KEY_APOSTROPHE |
' |
KEY_GRAVE |
\` |
KEY_MINUS |
- |
KEY_EQUAL |
= |
KEY_LEFTBRACE |
[ |
KEY_RIGHTBRACE |
] |
KEY_BACKSLASH |
\ |
KEY_KPASTERISK |
* (цифровая клавиатура) |
KEY_KPPLUS |
+ (цифровая клавиатура) |
KEY_KPMINUS |
- (цифровая клавиатура) |
KEY_KPDOT |
. (цифровая клавиатура) |
KEY_KPSLASH |
/ (цифровая клавиатура) |
KEY_KPENTER |
Ввод (цифровая клавиатура) |
KEY_KPEQUAL |
= (цифровая клавиатура) |
KEY_KPCOMMA |
, (цифровая клавиатура) |
KEY_KPJPCOMMA |
, (японская раскладка) |
KEY_KPLEFTPAREN |
( (цифровая клавиатура) |
KEY_KPRIGHTPAREN |
) (цифровая клавиатура) |
KEY_KPPLUSMINUS |
± (цифровая клавиатура) |
Подтаблица E: клавиши-модификаторы и функциональные клавиши
- Стандартные функциональные клавиши: от
KEY_F1доKEY_F24(24 кода).
| Код | Описание |
|---|---|
KEY_LEFTSHIFT |
Модификатор клавиатуры Left Shift |
KEY_RIGHTSHIFT |
Правая клавиша Shift |
KEY_LEFTCTRL |
Левая клавиша Ctrl |
KEY_RIGHTCTRL |
Правая клавиша-модификатор Ctrl |
KEY_LEFTALT |
Левая клавиша-модификатор Alt |
KEY_RIGHTALT |
Правая клавиша Alt |
KEY_LEFTMETA |
Левая клавиша Meta/Command |
KEY_RIGHTMETA |
Правая клавиша Meta/Command |
KEY_CAPSLOCK |
Переключатель Caps Lock на клавиатуре |
KEY_NUMLOCK |
Переключатель Num Lock |
KEY_SCROLLLOCK |
Переключатель Scroll Lock на клавиатуре |
KEY_COMPOSE |
Помощник по созданию персонажей |
KEY_FN |
Клавиша Fn на физической клавиатуре |
KEY_FN_ESC |
Сочетания функциональных клавиш |
KEY_FN_1 |
Быстрая клавиша для специальной функции 1 |
KEY_FN_2 |
Специальная функция 2 |
KEY_FN_D |
Сочетание клавиш для специальной функции D |
KEY_FN_E |
Специальная функция E |
KEY_FN_F |
Специальная функция F |
KEY_FN_S |
Быстрая клавиша S для специальной функции |
KEY_FN_B |
Специальная функция 2 |
Дополнительная таблица F. Геймпады и джойстики
| Код | Описание |
|---|---|
BTN_A/BTN_B/BTN_C |
Кнопки A, B и C на контроллере |
BTN_X/BTN_Y/BTN_Z |
Кнопки X, Y и Z на лицевой стороне контроллера |
BTN_START |
Кнопка меню "Пуск" на геймпаде |
BTN_SELECT |
Кнопка Select на геймпаде |
BTN_MODE |
Переключатель режима контроллера |
BTN_TL/BTN_TR |
Левый и правый бамперы |
BTN_TL2/BTN_TR2 |
Левый и правый аналоговые триггеры |
BTN_THUMBL/BTN_THUMBR |
Нажатие левого/правого стика |
BTN_DPAD_UP |
Триггер "Кнопка "Вверх" на d-pad геймпада" |
BTN_DPAD_DOWN |
Триггер "Кнопка "Вниз" на d-pad геймпада" |
BTN_DPAD_LEFT |
Левый триггер D-pad на геймпаде |
BTN_DPAD_RIGHT |
Правый триггер на d-pad геймпада |
BTN_THUMB |
Основной триггер джойстика |
BTN_TOP/BTN_TOP2 |
Верхние кнопки джойстика |
BTN_PINKIE |
Триггеры кнопки джойстика для мизинца |
BTN_BASE – _BASE6 |
Кнопки на основании платформы джойстика |
BTN_DEAD |
Флаг неактивной мертвой зоны геймпада |
BTN_TRIGGER |
Физический триггер на джойстике |
BTN_JOYSTICK |
Общий код ввода джойстика |
Дополнительная таблица G. Ввод с помощью мыши, сенсорного экрана и стилуса
| Код | Описание |
|---|---|
BTN_MOUSE |
Общее событие указателя мыши |
BTN_LEFT |
Нажатие левой кнопки мыши |
BTN_RIGHT |
Нажатие правой кнопки мыши |
BTN_MIDDLE |
Нажатие на колесо прокрутки |
BTN_SIDE |
Триггер боковой клавиши навигации |
BTN_EXTRA |
Триггер дополнительной кнопки мыши |
BTN_FORWARD |
нажатие кнопки "Вперед" в браузере; |
BTN_BACK |
нажать кнопку "Назад" в браузере |
BTN_TASK |
Клавиша переключения задач |
BTN_TOUCH |
Обнаружен физический контакт с экраном |
BTN_STYLUS |
Близость активного стилуса |
BTN_STYLUS2 |
Дополнительная кнопка на стилусе |
BTN_TOOL_PEN |
Идентификатор инструмента стилуса |
BTN_TOOL_RUBBER |
Идентификатор ластика стилуса |
BTN_TOOL_BRUSH |
Идентификатор инструмента "Кисть" |
BTN_TOOL_PENCIL |
Идентификатор инструмента "Карандаш для черчения" |
BTN_TOOL_AIRBRUSH |
Идентификатор инструмента "Аэрограф" |
BTN_TOOL_FINGER |
Касание сенсорного экрана пальцем |
BTN_TOOL_MOUSE |
Идентификатор внешней мыши |
BTN_TOOL_LENS |
Инструмент "Оптическая лупа" |
BTN_TOOL_DOUBLETAP |
Параметр скорости двойного нажатия для жестов |
BTN_TOOL_TRIPLETAP |
Параметр скорости тройного нажатия |
Подтаблица H. Ярлыки приложений
| Код | Целевое действие |
|---|---|
KEY_WWW |
Запускает браузер по умолчанию. |
KEY_MAIL |
Открывает почтовый клиент по умолчанию |
KEY_BOOKMARKS |
Открыть список закладок браузера |
KEY_CALC |
Открыть калькулятор |
KEY_FILE |
Открывает проводник по локальным файлам |
KEY_EDIT |
Триггер редактирования документа |
KEY_NEW |
Триггер создания документа |
KEY_OPEN |
Триггер открытия документа |
KEY_SAVE |
Триггер задачи сохранения файла |
KEY_CLOSE |
Триггер задачи закрытия файла |
KEY_PRINT |
Триггер задачи печати файла |
KEY_COPY |
Копирование в буфер обмена |
KEY_PASTE |
Действие по вставке из буфера обмена |
KEY_CUT |
Действие по вырезанию в буфер обмена |
KEY_UNDO |
Отмена действия с буфером обмена |
KEY_REDO |
Повторить действие с буфером обмена |
KEY_CANCEL |
Триггер отмены процесса буферизации |
KEY_FIND |
Утилита для поиска документов |
KEY_REFRESH |
Утилита обновления документов |
KEY_EXIT |
Утилита для закрытия документов |
KEY_DOCUMENTS |
Запускает портал системных документов |
KEY_HOMEPAGE |
Запускает браузер на главной странице |
KEY_FAVORITES |
Открывает портал избранного в браузере |
KEY_CHAT |
Запускает мессенджер |
KEY_EMAIL |
Триггер запуска дополнительного адреса электронной почты |
KEY_FINANCE |
Открыть утилиту для работы с акциями и финансами |
KEY_SPORT |
Открыть утилиту для отслеживания спортивных событий |
KEY_SHOP |
Открыть портал цифровых покупок |
KEY_PLAYER |
Открыть основной медиапроигрыватель |
KEY_MP3 |
Открыть основной MP3-плеер |
KEY_TEXT |
Открыть текстовый редактор по умолчанию |
KEY_LIST |
Открыть контрольный список |
KEY_MEMO |
Открыть блокнот или заметки |
KEY_CALENDAR |
Открывает календарь или повестку дня |
KEY_DIRECTORY |
Открывает системный каталог адресов |
KEY_COMPUTER |
Открыть спецификации |
KEY_TV/KEY_TV2 |
Запуск телевизионного портала |
KEY_RADIO |
Запускает радио. |
KEY_CD/KEY_DVD |
Активирует оптический привод |
KEY_AUDIO/KEY_VIDEO |
Доступ к спецификациям медиаконтента |
KEY_TUNER |
Настройка ресиверов и тюнеров |
KEY_SAT/KEY_SAT2 |
Настройка спутниковых фидов |
KEY_TAPE |
Включить кассетную деку |
KEY_VCR |
Воспроизвести фид проигрывателя VCR |
KEY_VCR2 |
Воспроизвести фид проигрывателя VCR 2 |
KEY_AUX |
Входы вспомогательных портов для носителей |
KEY_SETUP |
Меню настройки конфигурации |
KEY_PROG1 – _PROG4 |
Пользовательские ключи программ |
KEY_ZOOM |
Переключатель масштаба области просмотра |
KEY_MODE |
Выбор режима области просмотра |
KEY_KEYBOARD |
Показать/скрыть виртуальную клавиатуру |
KEY_LANGUAGE |
Как изменить язык аудиодорожки |
KEY_TITLE |
Открыть меню названия медиафайла |
KEY_SUBTITLE |
Открыть или закрыть интерфейс субтитров |
KEY_ANGLE |
Как изменить ракурс камеры |
KEY_EPG |
Открыть телегид |
KEY_PVR |
Открыть персональный видеорекордер |
KEY_MHP |
Открытая мультимедийная платформа для дома |
KEY_CHANNEL |
Открыть каналы ТВ-тюнера |
KEY_CHANNELUP |
Переключить на следующий телеканал |
KEY_CHANNELDOWN |
Переключить на предыдущий телеканал |
KEY_RED |
Красная интерактивная кнопка |
KEY_GREEN |
Интерактивная кнопка зеленого цвета. |
KEY_YELLOW |
Желтая интерактивная кнопка |
KEY_BLUE |
Синяя интерактивная кнопка |
KEY_FIRST |
Выберите первый вариант товара |
KEY_LAST |
Выбрать последний вариант |
KEY_NEXT |
Выбрать следующий вариант звуковой дорожки |
KEY_PREVIOUS |
Выбрать предыдущую звуковую дорожку |
KEY_RESTART |
Перезапустить цикл медиатрека |
KEY_SLOW |
Замедленное воспроизведение |
KEY_AB |
Повтор фрагмента от точки А до точки Б |
KEY_PLAYCD |
Команда воспроизведения CD-деки |
KEY_PAUSECD |
Команда приостановки воспроизведения на CD-деке |
KEY_STOPCD |
Команда остановки CD-деки |
KEY_DIGITS |
Команда ввода с цифровой клавиатуры |
KEY_TEEN |
Вариант "Значения для подростков" на клавиатуре |
KEY_TWEN |
Вариант значений клавиатуры twen |
KEY_DEL_EOL |
Удалить до конца буфера строки |
KEY_DEL_EOS |
Удалить до конца буфера экрана |
KEY_INS_LINE |
Вставить буфер новой строки |
KEY_BRL_DOT1 – _DOT8 |
Ввод с помощью кнопок дисплея Брайля |
KEY_VOICECOMMAND |
Запускает приложение голосового помощника. |
KEY_SELECTIVE_SCREEN |
Запускает создание скриншота области экрана |
KEY_BATTERY |
Запрашивает уведомления о состоянии батареи. |
KEY_STAR/KEY_SHARP |
Символы на клавиатуре телефона |
KEY_PLUS |
Символ плюса на клавиатуре телефона |
KEY_INFO |
Показать оверлей информационной панели |
KEY_TIME |
Показывать текущее время |
KEY_VENDOR |
Запрашивает спецификации поставщиков |
KEY_ARCHIVE |
Открывает локальный архиватор |
KEY_PROGRAM |
Настраивает параметры программы |
KEY_POWER2 |
Включает резервное питание |
EV_ABS – события абсолютного движения.
Тип события EV_ABS необходим для точной симуляции касаний, перетаскивания, жестов сведения и разведения пальцев, а также управления джойстиком. Абсолютные координаты, указанные ниже, напрямую соответствуют физическому разрешению экрана.
| Код | Диапазон координат | Описание |
|---|---|---|
ABS_MT_TRACKING_ID |
-1 или ≥0 |
Идентификатор отслеживания; -1 завершает касание |
ABS_MT_POSITION_X |
0 – 1767 |
Координата X (Pixel Fold) |
ABS_MT_POSITION_Y |
0 – 2207 |
Координата Y (Pixel Fold) |
ABS_MT_TOUCH_MAJOR |
пиксели | Ширина главной оси области касания |
ABS_MT_TOUCH_MINOR |
пиксели | Ширина малой оси области касания |
ABS_MT_WIDTH_MAJOR |
пиксели | Ширина большой оси инструмента |
ABS_MT_WIDTH_MINOR |
пиксели | Ширина малой оси инструмента |
ABS_MT_ORIENTATION |
0 – 255 |
Угол ориентации контакта |
ABS_MT_PRESSURE |
0 – 255 |
Величина силы контакта |
ABS_MT_DISTANCE |
mm | Расстояние от экрана |
ABS_MT_TOOL_TYPE |
0 – 2 |
0 – палец, 1 – ручка, 2 – карандаш |
ABS_MT_BLOB_ID |
Целое число | Идентификатор объекта blob контакта |
ABS_MT_TOOL_X |
пиксели | Координата X инструмента |
ABS_MT_TOOL_Y |
пиксели | Координата Y инструмента |
ABS_MT_SLOT |
0 – N |
Активный слот (протокол B) |
ABS_X/_Y/_Z |
аналоговый | Оси координат джойстика |
ABS_RX/_RY/_RZ |
аналоговый | Оси вращения джойстика |
ABS_THROTTLE/_BRAKE |
аналоговый | Педали и рулевое управление |
ABS_HAT0X/_HAT0Y |
-1/0/1 |
Кнопки D-pad и переключатели POV |
ABS_PRESSURE |
0 – 255 |
Сила нажатия стилуса или указателя |
ABS_DISTANCE |
mm | Расстояние наведения (стилус) |
ABS_TILT_X/_TILT_Y |
градусы | Углы наклона стилуса |
ABS_VOLUME |
аналоговый | Уровни громкости контроллера |
Сенсорное взаимодействие в Android основано на протоколах мультисенсорного ввода. Современные эмуляторы реализуют как протокол A (без отслеживания состояния, отправка пакетов контактов, разделенных метками синхронизации), так и протокол B (с отслеживанием состояния, назначение контактов выделенным слотам отслеживания). Протокол B позволяет эффективно отслеживать несколько одновременных касаний для таких жестов, как масштабирование.
EV_REL и EV_SW – движение и аппаратные переключатели
Категория событий EV_REL управляет относительными изменениями указателя или координат, что в основном используется для эмуляции движений внешней мыши или колесика прокрутки. Категория событий EV_SW управляет переключателями физических устройств, например определяет, сложен ли раскладной телефон или планшет, или подключено ли внешнее аудиооборудование.
| Код | Значения | Описание |
|---|---|---|
REL_X |
Delta | Горизонтальное движение курсора |
REL_Y |
Delta | Вертикальное движение курсора |
SW_LID |
0/1 |
Статус крышки ноутбука (0 – открыта, 1 – закрыта) |
SW_TABLET_MODE |
0/1 |
Статус режима планшета (0 – отключен, 1 – активен). |
SW_HEADPHONE_INSERT |
0/1 |
Статус гнезда для наушников (0 – не подключено, 1 – подключено) |
SW_MICROPHONE_INSERT |
0/1 |
Статус разъема для микрофона (0 – не подключен, 1 – подключен) |
Синтаксис отправки команд
Чтобы отправить эти коды, отформатируйте команду консоли, указав типы, коды и значения, разделенные двоеточиями. В одной строке можно указать несколько изменений координат. Важно всегда добавлять в конце метку синхронизации (EV_SYN:0:0), чтобы фреймворк эмулятора объединял и обрабатывал эти входные данные вместе.
Примеры скриптов событий и жестов
Поскольку Telnet позволяет отправлять составные параметры, вы можете имитировать реалистичные последовательности физических жестов. Ниже приведены структуры скриптов необработанных событий для автоматизации жестов из консоли хоста.
Имитация нажатия на экран
Чтобы выполнить нажатие на экран по целевым координатам, назначьте идентификатор отслеживания, укажите координаты X и Y на экране, сымитируйте касание, синхронизируйте и отпустите.
# Press down at coordinate (400, 800) and sync
event send EV_ABS:ABS_MT_TRACKING_ID:1
OK
event send EV_ABS:ABS_MT_POSITION_X:400
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Lift finger up and sync
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK
Как имитировать вертикальную прокрутку (пролистывание)
Чтобы выполнить прокрутку, удерживайте палец на начальной координате, отправьте промежуточные кадры координат движения и отпустите палец в конце.
# Finger touch down at start coordinate (500, 1600)
event send EV_ABS:ABS_MT_TRACKING_ID:2
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1600
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Move coordinates upward dynamically
event send EV_ABS:ABS_MT_POSITION_Y:1200
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:400
OK
event send EV_SYN:0:0
OK
# Finger release at coordinate (500, 400)
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK
Имитация жеста сведения пальцев
Чтобы активировать масштабирование двумя пальцами, используйте активные слоты MT (0 и 1) для отслеживания и координации двух одновременных координат касания, удаляющихся друг от друга.
# Finger 1 down at (500, 1000) using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:10
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Finger 2 down at (600, 1000) using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:11
OK
event send EV_ABS:ABS_MT_POSITION_X:600
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_SYN:0:0
OK
# Fingers slide apart from each other
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_POSITION_X:300
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_POSITION_X:800
OK
event send EV_SYN:0:0
OK
# Lift Finger 1 using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_SYN:0:0
OK
# Lift Finger 2 using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK
Как имитировать переключение наушников
Имитирует подключение и отключение гнезда для наушников, чтобы проверить переключение маршрутизации аудио. Значение 1 означает, что наушники подключены, а 0 – что они отключены.
# Simulate headphones plugged in
event send EV_SW:SW_HEADPHONE_INSERT:1 EV_SYN:0:0
OK
# Simulate headphones unplugged
event send EV_SW:SW_HEADPHONE_INSERT:0 EV_SYN:0:0
OK
Как найти коды событий консоли на реальном устройстве
Чтобы узнать точную последовательность синтаксиса событий для любого настраиваемого действия или жеста кнопки, подключитесь с помощью adb shell и запустите утилиту диагностики getevent.
При взаимодействии с графическим интерфейсом эмулятора в консоли будут выводиться точные коды, типы и позиции событий.
# Run getevent to monitor input events dynamically
adb shell getevent -lt
/dev/input/event12: EV_KEY KEY_POWER DOWN
/dev/input/event12: EV_SYN SYN_REPORT 00000000
/dev/input/event12: EV_KEY KEY_POWER UP
/dev/input/event12: EV_SYN SYN_REPORT 00000000
- event text message – отправляет строку символов, имитирующих нажатия клавиш. Сообщение должно быть строкой в кодировке UTF-8. Записи Unicode сопоставляются в обратном порядке в соответствии с текущей клавиатурой устройства, а неподдерживаемые символы удаляются без уведомления.
Управление питанием
power display – показывает состояние батареи и зарядного устройства.
power ac {on| off} – включает или отключает зарядку от сети переменного тока.
power status {unknown| charging| discharging| not-charging| full} – изменяет статус батареи на указанный.
power present {true| false} – задает состояние наличия батареи.
power health {unknown| good| overheat| dead| overvoltage| failure} – задает состояние батареи.
power capacity percent – устанавливает состояние оставшейся емкости батареи в процентах от 0 до 100.
Статус сетевого подключения (только Ethernet и мобильная сеть).
network status – проверяет статус сети, текущую задержку и скорость.
network delay latencyИзменяет эмулируемую задержку сети.Эмулятор позволяет имитировать различные уровни задержки сети, чтобы вы могли протестировать приложение в условиях, приближенных к реальным. Вы можете задать уровень или диапазон задержки при запуске эмулятора или изменить задержку в консоли во время работы приложения в эмуляторе.
Формат задержки сети может быть одним из следующих (числа указаны в миллисекундах):
Формат задержки в сети:
gprs – GPRS, диапазон задержки от 150 до 550.
edge – EDGE/EGPRS, задержка от 80 до 400.
umts – UMTS/3G, диапазон задержки от 35 до 200.
none – задержка отсутствует.
num – эмулирует указанную задержку в миллисекундах.
min:max – эмулирует указанный диапазон задержки.
Чтобы задать задержку при запуске эмулятора, используйте параметр
-netdelayс поддерживаемым значением задержки. Примеры:emulator -netdelay gprs emulator -netdelay 40,100Чтобы изменить задержку сети во время работы эмулятора, подключитесь к консоли и используйте команду
network delay:network delay gprs network delay 40 100network speed speedЭмулятор позволяет имитировать различные скорости передачи данных по сети. Вы можете задать скорость передачи данных или диапазон при запуске эмулятора или использовать консоль, чтобы изменить скорость во время работы приложения в эмуляторе.Формат скорости сети может быть одним из следующих (числа указаны в килобитах в секунду):
Формат скорости сети:
gsm – GSM/CSD со скоростью 14, 4 Мбит/с в обоих направлениях.
hscsd – HSCSD со скоростью 14,4 Мбит/с для исходящего трафика и 43,2 Мбит/с для входящего.
gprs – GPRS со скоростью 40,0 Кбит/с для исходящего трафика и 80,0 Кбит/с для входящего.
edge – EDGE/EGPRS со скоростью 118,4 Кбит/с для исходящего трафика и 236,8 Кбит/с для входящего.
umts – UMTS/3G со скоростью 128, 0 Кбит/с для исходящего трафика и 1920 Кбит/с для входящего.
hsdpa: HSDPA, скорость передачи данных – 348,0 Кбит/с, скорость скачивания – 14 400,0 Кбит/с.
lte – LTE со скоростью 58 000 Кбит/с для загрузки и 173 000 Кбит/с для скачивания.
evdo – EVDO со скоростью 75 000 бит/с для исходящего трафика и 280 000 бит/с для входящего.
full – неограниченная скорость, которая зависит от скорости подключения компьютера к интернету.
num – точная скорость в килобитах в секунду, которая используется как для загрузки, так и для скачивания.
up:down – задает точные значения скорости загрузки и скачивания в килобитах в секунду.
Чтобы задать скорость сети при запуске эмулятора, используйте параметр
-netspeed. Примеры:emulator -netspeed gsm @Pixel_API_26 emulator -netspeed 14.4,80 @Pixel_API_26Чтобы изменить скорость сети во время работы эмулятора, подключитесь к консоли и используйте команду
network speed:network speed 14.4 80network capture {start| stop} fileОтправляет пакеты в файл. Ниже приведены параметры и их значения.Примечание. Начиная с эмулятора Android 36.5 и более поздних версий, трафик Wi-Fi-подключения по умолчанию обрабатывается netsim. Команда консоли для записи сетевого трафика записывает только устаревший трафик сотовой сети/WAN, маршрутизируемый через стек slirp QEMU. Чтобы записать пакеты Wi-Fi, Bluetooth или расширенной сети в современных версиях эмулятора, ознакомьтесь с разделом Запись сетевого трафика в руководстве по расширенным сетевым возможностям эмулятора.
start file – начать перехват сетевых пакетов. В целях безопасности название файла не должно содержать разделителей пути, таких как
/, и символов... Файл с данными о перехвате пакетов будет сохранен в папкеconsole_out/в каталоге контента AVD (например,~/.android/avd/avd_name.avd/console_out/file).stop file – прекратить отправку пакетов в указанный файл.
Эмуляция телефонии
Эмулятор Android включает собственные эмулируемые модемы GSM и CDMA, которые позволяют имитировать функции телефонии в эмуляторе. Например, с помощью GSM можно имитировать входящие телефонные звонки, а также устанавливать и разрывать подключения для передачи данных. Для CDMA нужно указать источник подписки и предпочтительный список роуминга. Система Android обрабатывает смоделированные вызовы точно так же, как и реальные. Эмулятор не поддерживает аудиовызовы.
gsm {call| accept| cancel| busy} phonenumberПараметры gsm:- call – имитирует входящий звонок с указанного номера.
- accept – принимает входящий вызов с номера phonenumber и меняет статус вызова на active. Вы можете изменить статус вызова на активный, только если текущий статус – "Ожидание" или "Удержание".
- cancel – завершает входящий или исходящий звонок на номер phonenumber.
- busy – завершает исходящий вызов на номер телефона и меняет статус вызова на "Занято". Изменить статус вызова на "Занято" можно, только если текущий статус – "Ожидание".
gsm {data| voice} stateКоманда data state изменяет состояние подключения для передачи данных GPRS, а команда voice state – состояние подключения для передачи голоса GPRS.- unregistered – сеть недоступна.
- home – устройство находится в домашней сети, роуминг не используется.
- roaming – роуминг.
- searching – поиск сетей.
- denied – только экстренные вызовы.
- off – то же, что и unregistered.
- on – то же, что и home.
gsm hold – переводит вызов в режим удержания. Перевести вызов в режим удержания можно, только если он активен или находится в режиме ожидания.
gsm list – список всех входящих и исходящих вызовов и их статусов.
gsm status – сообщает текущий статус голосовой связи и передачи данных GSM. Значения соответствуют описанным для команд передачи голоса и данных.
gsm signal {rssi| ber}Изменяет уровень сигнала (rssi) и частоту появления ошибочных битов (ber) в течение следующих 15 секунд. Ниже приведены параметры и их значения.- rssi: диапазон от 0 до 31, а также 99 для неизвестного значения.
- ber – коэффициент битовых ошибок. Диапазон значений: от 0 до 7. Значение 99 означает, что коэффициент неизвестен.
gsm signal-profile num – задает профиль уровня сигнала. num – число от 0 до 4.
cdma ssource sourceЗадает текущий источник подписки CDMA, где источник – это сетевой белый список, содержащий абонентов оператора CDMA и их значения, как указано ниже.- nv – считывает подписку из энергонезависимой памяти.
- ruim – считывает подписку со съемного модуля идентификации пользователя (RUIM).
cdma prl_version version – выводит текущую версию списка предпочтительных сетей роуминга (PRL). Номер версии базы данных PRL, которая содержит информацию, используемую при выборе и получении системы.
Управление датчиками в эмуляторе
Эти команды связаны с датчиками, доступными в AVD. Помимо использования команды sensor, вы можете просматривать и изменять настройки в эмуляторе на экране Virtual sensors (Виртуальные датчики) на вкладках Accelerometer (Акселерометр) и Additional sensors (Дополнительные датчики).
Статус датчиков. Список всех датчиков и их статусов.
sensor get sensor-name – получить настройки для датчика с указанным названием. В следующем примере показано, как получить значение для датчика ускорения:
sensor get acceleration acceleration = 2.23517e-07:9.77631:0.812348Значения ускорения, разделенные двоеточиями (
:), относятся к координатам x, y и z виртуальных датчиков.sensor set sensor-name value-x:value-y:value-z – задает значения для sensor-name. В следующем примере для датчика ускорения задаются значения x, y и z, разделенные двоеточиями.
sensor set acceleration 2.23517e-07:9.77631:0.812348
Эмуляция SMS
sms send sender-phone-number textmessageГенерирует эмулированное входящее SMS-сообщение. Ниже приведен список параметров и их значений.- sender-phone-number – содержит произвольную строку цифр.
- textmessage – SMS.
В следующем примере сообщение "Привет" отправляется на номер 4085555555:
sms send 4085555555 hi there
Консоль перенаправляет SMS-сообщение в платформу Android, которая передает его мессенджеру в эмуляторе, например приложению "Сообщения". Если вы передаете 10 цифр, приложение форматирует их как номер телефона. Более длинные или короткие числовые строки отображаются в том виде, в котором вы их отправили.
Симуляция отпечатка пальца
finger touch fingerprint-id – имитирует прикосновение пальца к сканеру.
finger remove – имитирует убирание пальца.
Инструкции по использованию этих команд приведены в разделе Симуляция и проверка цифровых отпечатков.
Запись экрана
Команда screen record позволяет записывать видео высокого качества с физического экрана эмулятора прямо из хост-системы. Это очень полезно для конвейеров непрерывной интеграции и автоматических отчетов об ошибках.
screenrecord {start| stop} fileЗапускает или останавливает запись экрана.- start file – начать запись видео. Файл должен иметь расширение
.webm. Записанное видео сохраняется в каталоге вывода консоли виртуального устройства Android:~/.android/avd/avd_name.avd/console_out/file. - stop file – останавливает активный процесс записи экрана.
- start file – начать запись видео. Файл должен иметь расширение
Автоматизация и макросы
Подсистема автоматизации позволяет разработчикам записывать переходы между состояниями макросов на работающем виртуальном устройстве и воспроизводить их для выполнения автоматизированных тестовых потоков.
automation {record| stop-record| play| stop-play}Управляет автоматическими записями макросов.- record – начать запись изменений состояния устройства и входных данных.
- stop-record – останавливает текущий сеанс записи макроса.
- play – воспроизведение записанной последовательности макроса.
- stop-play – останавливает активную последовательность воспроизведения макроса.
Физика (6DoF)
Физические команды управляют регистрацией фундаментальной истины пространственных поз для моделей физического движения с шестью степенями свободы (6DoF), которые используются для симуляции расширенного отслеживания движения.
physics {record-gt| stop}Управляет записями физических моделей поз.- record-gt – начать запись фундаментальной истины о перемещении с шестью степенями свободы.
- stop – останавливает текущий процесс записи фундаментальной истины.
Расширенные настройки управления устройствами
В этом разделе собраны узкоспециализированные конечные точки команд консоли для расширенных конфигураций эмуляции, включая сетевые прокси-серверы, конфигурации с несколькими дисплеями, переопределения рендеринга и прямую отладку гипервизора.
multidisplay {add| del}Добавляет или удаляет дополнительные виртуальные мониторы для тестирования конфигураций с несколькими экранами. Примечание. Дополнительные мониторы не поддерживаются в профилях складных устройств, таких как Pixel Fold, и в эмуляторе Resizable.proxy {set| clear}Программная настройка переадресации прокси-сервера из консоли.- set host port – задает настройки прокси-сервера.
- clear – сброс настроек прокси-сервера до значений по умолчанию. Примечание. Операции с наборами прокси-серверов не выполняются в средах выполнения без графического интерфейса.
virtualscene-image {wall| table} image_pathПозволяет настроить фон или горизонтальные столы, которые показываются на видеопотоке с камеры виртуальной сцены, с помощью пользовательского графического файла.resize-display scaleДинамически настраивает разрешение экрана между заданными масштабами. Примечание. Настройка разрешения не поддерживается в конфигурациях без монитора.nodraw {on| off}Отключает отрисовку физического графического интерфейса пользователя на экране хоста, чтобы снизить нагрузку на системную память и графический процессор во время выполнения большого количества фоновых автоматических действий без графического интерфейса.grpc portНастраивает расширенное программное управление устройствами через конечные точки настраиваемых портов gRPC.qemu monitorПредоставляет прямой интерактивный доступ к терминалу консоли базового гипервизора. Эту команду можно ввести только в активных сеансах консоли Telnet.icebox track pidПозволяет автоматически создавать снимки системы, когда в указанном процессе приложения возникает необработанное исключение или сбой.phonenumber numberЗадает виртуальный местный номер телефона целевого устройства.
Программный интерфейс gRPC
Современные версии эмулятора поддерживают мощный программный интерфейс gRPC наряду с устаревшей консолью Telnet. Консоль Telnet отлично подходит для быстрых интерактивных сеансов или базовых скриптов, а интерфейс gRPC разработан для высокопроизводительного, безопасного и надежного автоматизированного управления в средах непрерывной интеграции (CI) и безголовых средах. Благодаря конечным точкам прямого обслуживания gRPC устраняет необходимость анализировать текстовые потоки, управлять подтверждениями сеансов терминала или открывать незашифрованные порты локального хоста.
Чтобы выбрать между устаревшей консолью Telnet и современным программным интерфейсом gRPC, ознакомьтесь со следующим сравнением производительности, безопасности и функциональных возможностей:
| Функция | Консоль Telnet | Интерфейс gRPC |
|---|---|---|
| Для чего подходит | Ручная отладка, интерактивные сеансы. | CI/CD без графического интерфейса, тяжелые автоматизированные тестовые стенды. |
| Скорость | Медленнее. Текстовые заголовки, задержка подключения. | Оптимизированный; мультиплексированный HTTP/2, быстрый протокол. |
| Безопасность | Без шифрования; локальные порты (5554–5585). | Может быть защищен TLS, работает по сети. |
| Streams | Не поддерживается. Доступны только запросы и ответы. | Потоки для logcat, запись аудио гостя. |
| Медиафайлы | Записывает выходные файлы на диск хоста или гостя. | Прямые двоичные буферы, передаваемые по сети. |
| Гостевая ОС | Доступны только фиксированные команды эмулятора. | Выполняет нативные команды оболочки bash гостевой ОС. |
Запуск и вызов gRPC
Чтобы использовать конечные точки gRPC, запустите эмулятор Android из командной строки и добавьте флаг -grpc, указав целевой порт обратной связи.
# Start the emulator with the gRPC service enabled on port 8556
emulator -grpc localhost:8556 @Pixel_Fold
После запуска эмулятора с включенным сервисом gRPC вы можете выполнять программные вызовы RPC. Для тестирования в командной строке используйте утилиту grpcurl, чтобы взаимодействовать с сервисами эмулятора. Все запросы форматируются в JSON и отправляются в виде обычного текста.
# Query the status of the virtual device using grpcurl
grpcurl -plaintext -d '{}' localhost:8556 \
android.emulation.control.EmulatorController/getStatus
# Simulate an incoming phone call
grpcurl -plaintext -d '{"operation": "InitCall", "number": "1234567890"}' localhost:8556 \
android.emulation.control.EmulatorController/sendPhone
# Simulate typing text into the guest OS
grpcurl -plaintext -d '{"text": "Hello"}' localhost:8556 \
android.emulation.control.EmulatorController/sendKey
Сопоставление консоли Telnet с сервисом gRPC
В таблице ниже показано, как устаревшие команды консоли Telnet сопоставляются с соответствующими сервисами и методами gRPC. Это поможет вам понять, как автоматизировать распространенные взаимодействия с виртуальными устройствами.
| Категория | Устаревшая команда Telnet | Сервис/метод gRPC |
|---|---|---|
| Статус | ping |
EmulatorController/getStatus |
| Статус | avd name |
incubating.AvdService/getAvdInfo |
| Статус | kill |
EmulatorController/setVmState |
| Статус | restart |
EmulatorController/setVmState |
| Власть | power display |
EmulatorController/getBattery |
| Власть | power capacity |
EmulatorController/setBattery |
| Геотаргетинг | geo fix |
EmulatorController/setGps |
| Датчики | sensor set |
incubating.SensorService/setSensor |
| Биометрия. | finger touch |
EmulatorController/sendFingerprint |
| Осанка | posture |
EmulatorController/setPosture |
| Осанка | physics/fold |
EmulatorController/setPhysicalModel |
| SMS | sms send |
EmulatorController/sendSms |
| GSM Call | gsm call |
EmulatorController/sendPhone |
| GSM Call | phonenumber |
EmulatorController/setPhoneNumber |
| Переадресация | redir add |
Waterfall/ForwardPort |
| Ввод данных | event send EV_KEY |
EmulatorController/sendKey |
| Ввод данных | event send EV_ABS |
EmulatorController/sendTouch |
| Медиафайлы | screenrecord |
incubating.ScreenRecording |
| Отрисовка | nodraw |
EmulatorController/setDisplayMode |
| Снимки | avd snapshot list |
SnapshotService/ListSnapshots |
| Снимки | avd snapshot load/save |
SnapshotService/LoadSnapshot |
Программные команды, уникальные для gRPC
Интерфейс gRPC предоставляет несколько передовых возможностей, которые физически невозможно реализовать через устаревшие консольные подключения Telnet. К ним относятся прямая потоковая передача logcat, двунаправленная запись или вставка аудио, изменение графического интерфейса хоста и прямой доступ к оболочке.
| Сервис/метод gRPC | Параметр | Возможности |
|---|---|---|
streamLogcat |
{"maxLines": 100} |
Передает выходные данные logcat гостевой системы. |
streamAudio |
{} |
Передает звук из динамика по проводу. |
injectAudio |
{"audio": "..."} |
Внедряет аудиопотоки микрофона. |
UiController |
{"theme": "DARK"} |
Изменение тем окон хоста |
Waterfall/Exec |
{"cmd": "ls"} |
Выполняет команды оболочки гостевой ОС. |
Симуляция и проверка отпечатка пальца
Используйте команду finger, чтобы смоделировать и проверить аутентификацию по отпечатку пальца в приложении. Вам потребуется SDK Tools 24.3 или более поздней версии и Android 6.0 (уровень API 23) или более поздней версии.
Чтобы смоделировать и проверить аутентификацию по отпечатку пальца, выполните следующие действия:
Если у вас ещё нет идентификатора отпечатка пальца, зарегистрируйте новый отпечаток в эмуляторе, выбрав Настройки > Безопасность > Отпечаток пальца и следуя инструкциям по регистрации.
Настройте в приложении аутентификацию по отпечатку пальца. После этого на устройстве появится экран аутентификации по отпечатку пальца.
Когда в приложении появится экран аутентификации по отпечатку пальца, перейдите в консоль и введите команду
finger touchи созданный идентификатор отпечатка пальца. Это имитирует касание пальцем.Затем введите команду
finger remove, чтобы симулировать поднятие пальца. Приложение должно реагировать так, как если бы пользователь коснулся сканера отпечатков пальцев, а затем убрал палец.