Расширенные настройки и справка

Эмулятор позволяет развертывать приложение на нескольких экранах с настраиваемыми размерами. Это помогает тестировать приложения, поддерживающие многооконный режим и несколько экранов. Во время работы виртуального устройства можно добавить до двух дополнительных дисплеев, выполнив следующие действия:

1. Чтобы добавить дисплей, нажмите Добавить дополнительный дисплей.
2. В меню под заголовком Дополнительные дисплеи выполните одно из следующих действий:
   1. Выберите одно из стандартных соотношений сторон.
   2. Выберите Другой и задайте высоту, ширину и разрешение для своего экрана.
3. Чтобы добавить третий экран, нажмите Добавить дополнительный экран ещё раз.
4. Нажмите Применить изменения, чтобы добавить указанные дисплеи в запущенное виртуальное устройство.

Эмулятор позволяет имитировать различные условия сети. Вы можете указать приблизительную скорость передачи данных для разных сетевых протоколов или выбрать вариант Полная, при котором данные будут передаваться с максимально возможной для вашего компьютера скоростью. Указание сетевого протокола всегда занимает больше времени, чем полный вариант. Также можно указать статус голосовой сети и сети передачи данных, например роуминг. Значения по умолчанию задаются в AVD.

Выберите Тип сети:

• GSM – глобальная система мобильной связи.
• HSCSD – высокоскоростная передача данных с коммутацией каналов.
• GPRS – пакетная радиосвязь общего назначения.
• EDGE – технология передачи данных с повышенной скоростью для GSM Evolution.
• UMTS – универсальная мобильная телекоммуникационная система.
• HSPDA – высокоскоростной пакетный доступ к нисходящей линии связи.
• LTE: Long-Term Evolution
• 5G – мобильная сеть пятого поколения.
• Полный (по умолчанию). Используется сеть, предоставленная компьютером.

Выберите уровень сигнала:

• Нет
• Плохо
• Умеренный (по умолчанию)
• Хорошее
• Отлично

Выберите Статус голосовой связи, Статус передачи данных или оба варианта.

• Главная (по умолчанию)
• Роуминг
• Поиск…
• Запрещено (только экстренные вызовы)
• Не зарегистрировано (отключено)

Вы можете имитировать свойства батареи устройства, чтобы проверить, как приложение работает в разных условиях. Чтобы выбрать Уровень заряда, используйте ползунок.

Выберите значение параметра Подключение зарядного устройства:

• Нет
• Зарядное устройство переменного тока

Выберите значение Состояние батареи:

• Хорошее (по умолчанию)
• Сбой
• Dead
• Перенапряжение
• Перегрев
• Неизвестно

Выберите значение Статус батареи :

• Неизвестно
• Зарядка (по умолчанию)
• Разряжается
• Устройство не заряжается
• Полный

Если в режиме камеры используется сцена окружения, заданная в файле конфигурации окружения AVD, вы можете перезагрузить настройки сцены, чтобы динамически изменить исходный контент во время выполнения.

Эмулятор позволяет имитировать информацию о местоположении устройства. Например, если вы нажмете "Мое местоположение" в Google Картах, а затем отправите местоположение, оно будет показано на карте.

Настройки геоданных устройства разделены на две вкладки: Отдельные точки и Маршруты.

Отдельные точки

На вкладке Отдельные точки можно использовать компонент webview Google Карт, чтобы искать объекты инфраструктуры так же, как в приложении или браузере. Когда вы ищете или выбираете местоположение на карте, вы можете сохранить его, нажав Сохранить точку в нижней части карты. Все сохраненные местоположения перечислены в правой части окна Extended controls (Расширенные настройки).

Чтобы задать в эмуляторе местоположение, выбранное на карте, нажмите кнопку Set location (Задать местоположение) в правом нижнем углу окна Extended controls (Расширенные настройки).

Маршруты

Как и вкладка Single points (Отдельные точки), вкладка Routes (Маршруты) содержит компонент WebView Google Карт, который можно использовать для создания маршрута между двумя или более местоположениями. Чтобы создать и сохранить маршрут, выполните следующие действия:

1. В режиме карты используйте текстовое поле, чтобы найти первый пункт назначения в маршруте.
2. Выберите местоположение из результатов поиска.
3. Нажмите кнопку Навигация .
4. Выберите на карте начальную точку маршрута.
5. Чтобы добавить в маршрут больше остановок, нажмите Добавить пункт назначения (необязательно).
6. Чтобы сохранить маршрут, нажмите Сохранить маршрут на карте.
7. Укажите название маршрута и нажмите Сохранить.

Чтобы эмулятор следовал сохраненному маршруту, выберите его в списке Сохраненные маршруты и нажмите Воспроизвести маршрут в правом нижнем углу окна Расширенные элементы управления. Чтобы остановить симуляцию, нажмите Остановить маршрут.

Чтобы эмулятор непрерывно следовал по указанному маршруту, включите переключатель Повторить воспроизведение. Чтобы изменить скорость, с которой эмулятор следует по указанному маршруту, выберите вариант в меню Скорость воспроизведения.

Как импортировать данные GPX и KML

Чтобы использовать географические данные из файла формата обмена данными GPS (GPX) или языка разметки Keyhole (KML):

1. Нажмите Загрузить GPX/KML.
2. В диалоговом окне выберите файл на компьютере и нажмите Открыть.
3. При необходимости выберите Скорость.

По умолчанию скорость соответствует значению Задержка (Скорость 1X). Вы можете увеличить скорость в два раза (Скорость 2X), в три раза (Скорость 3X) и т. д.

4. Нажмите Выполнить .

Эмулятор позволяет имитировать входящие телефонные звонки и текстовые сообщения.

Чтобы инициировать вызов эмулятора, выполните следующие действия:

1. Выберите или введите номер телефона в поле От.
2. Нажмите Позвонить на устройство.
3. При необходимости нажмите Удерживать вызов.
4. Чтобы завершить звонок, нажмите Завершить звонок.

Чтобы отправить текстовое сообщение на эмулятор:

1. Выберите или введите номер телефона в поле От.
2. Введите текст в поле SMS-сообщение.
3. Нажмите Отправить сообщение.

Если в профиле оборудования AVD включены кнопки навигации, вы можете использовать их в эмуляторе. Однако не все устройства поддерживают крестовину, например часы Android. Кнопки имитируют следующие действия:

В целях конфиденциальности и повышения производительности ввод с микрофона по умолчанию отключен в эмуляторе Android. Чтобы включить ввод с микрофона, выберите Включить доступ к микрофону организатора. В эмуляторе Android также есть элементы управления для симуляции проводной гарнитуры:

• Enable Host Microphone Access (Разрешить доступ к микрофону хоста). Если этот параметр включен, эмулятор получает аудиовход от микрофона хоста. Если параметр отключен, эмулятор не получает аудиовход. Обратите внимание, что при первом включении этой функции операционная система (Windows, macOS или Linux) может запросить разрешение на доступ к микрофону.
• Имитировать подключение гарнитуры. Имитирует подключение гарнитуры к аудиоразъему 3,5 мм. При этом отправляются события переключения SW_HEADPHONE_INSERT и SW_MICROPHONE_INSERT, которые сообщают системе Android об имитации подключения оборудования. Гарнитура будет распознаваться как устройство с микрофоном, только если выбран параметр Виртуальный микрофон подключен.
• Virtual microphone attached (Виртуальный микрофон подключен). Доступно, только если включен параметр Simulate Insert Headset (Имитировать подключение гарнитуры). Этот параметр позволяет симулировать наличие микрофона у подключенной гарнитуры. Если включить этот параметр, будет отправляться событие SW_MICROPHONE_INSERT.
• Голосовой помощник. Эта кнопка имитирует активацию голосового помощника устройства. При нажатии на нее отправляется ключевое событие KEYCODE_ASSIST, которое запускает приложение-помощник, например Google Ассистента. Эта кнопка недоступна на устройствах с уровнем API ниже 24 (Android 7.0) и на виртуальных устройствах Android Automotive.

Этот элемент управления может имитировать 10 разных сканирований отпечатка пальца. Вы можете использовать его, чтобы протестировать интеграцию отпечатков пальцев в приложении. Эта функция отключена в Android 5.1 (уровень API 22) и более ранних версиях, а также в Wear OS.

Чтобы симулировать сканирование отпечатка пальца на виртуальном устройстве:

1. Как подготовить приложение к получению цифрового отпечатка
2. Выберите значение Цифровой отпечаток.
3. Нажмите Сенсорный датчик.

С помощью этого элемента управления можно проверить, как приложение реагирует на изменение положения или ориентации устройства или на то и другое одновременно. Например, вы можете имитировать жесты, такие как наклон и поворот. Акселерометр не отслеживает абсолютное положение устройства, а только определяет, когда оно меняется. Этот элемент управления имитирует реакцию акселерометра и магнитометра на перемещение или поворот реального устройства.

Чтобы использовать этот элемент управления, необходимо включить датчик акселерометра в AVD.

В отчетах о контроллере TYPE_ACCELEROMETER события регистрируются по осям X, Y и Z. Эти значения включают гравитацию. Например, если устройство находится в открытом космосе, ускорение будет равно нулю (все значения x, y и z равны 0). Если устройство находится на Земле и лежит экраном вверх на столе, то ускорение будет равно 0, 0 и 9, 8 из-за гравитации.

Также элемент управления сообщает о событиях TYPE_MAGNETIC_FIELD и измеряет магнитное поле по осям X, Y и Z в микротеслах (мкТл).

Чтобы повернуть устройство вокруг осей X, Y и Z, выберите Повернуть и выполните одно из следующих действий:

• Перемещайте ползунки Рысканье, Тангаж и Крен и наблюдайте за изменениями в верхнем окне.
• Переместите изображение устройства на верхней панели и посмотрите, как меняются значения Рыскание, Тангаж и Крен, а также значения акселерометра.

Подробнее о том, как рассчитываются рыскание, тангаж и крен, читайте в разделе Вычисление ориентации устройства.

Чтобы переместить устройство по горизонтали (x) или вертикали (y), нажмите Переместить и выполните одно из следующих действий:

• Перемещайте ползунки X и Y и наблюдайте за изменением положения на верхней панели.
• Переместите изображение устройства в верхней части экрана и посмотрите, как меняются значения ползунков X и Y и результирующие значения акселерометра.

Чтобы повернуть устройство на 0, 90, 180 или 270 градусов:

• В разделе Поворот экрана выберите нужный вариант.

По мере того как вы настраиваете устройство, поля Полученные значения будут меняться. Это значения, к которым может получить доступ приложение.

Подробнее об этих датчиках рассказывается в статьях Обзор датчиков, Датчики движения и Датчики положения.

Эмулятор может имитировать различные датчики положения и окружающей среды. С помощью этого инструмента можно настраивать следующие датчики, чтобы тестировать их в приложении:

• Датчик температуры окружающей среды измеряет температуру воздуха.
• Магнитное поле. Этот датчик положения измеряет магнитное поле окружающей среды по осям X, Y и Z. Значения указываются в микротеслах (мкТл).
• Датчик приближения. Измеряет расстояние до объекта. Например, он может сообщить телефону, что лицо находится близко к нему, чтобы сделать звонок. Чтобы использовать этот элемент управления, необходимо включить датчик расстояния в AVD.
• Освещенность. Этот датчик окружающей среды измеряет освещенность. Значения указываются в люксах.
• Давление. Этот датчик измеряет давление окружающего воздуха. Значения указаны в миллибарах (гектопаскалях).
• Относительная влажность. Этот датчик измеряет относительную влажность воздуха.

Дополнительную информацию об этих датчиках можно найти в статьях Обзор датчиков, Датчики положения и Датчики окружающей среды .

• Тема окна эмулятора – выберите Светлая или Темная.
• Send keyboard shortcuts to (Отправлять сочетания клавиш в). По умолчанию некоторые сочетания клавиш запускают быстрые клавиши управления эмулятором. Если вы разрабатываете приложение, в котором используются сочетания клавиш, например для устройств с Bluetooth-клавиатурой, вы можете изменить этот параметр, чтобы отправлять все данные с клавиатуры на виртуальное устройство, в том числе те, которые в эмуляторе являются сочетаниями клавиш.
• Место сохранения скриншотов. Нажмите на значок папки, чтобы указать, куда сохранять скриншоты экрана эмулятора.
• Использовать обнаруженное местоположение ADB. Если вы запускаете эмулятор из Android Studio, выберите этот параметр (по умолчанию). Если вы запускаете эмулятор не из Android Studio и хотите, чтобы он использовал определенный исполняемый файл adb, снимите этот флажок и укажите местоположение SDK Tools. Если этот параметр задан неправильно, такие функции, как создание скриншотов и установка приложений путем перетаскивания, не будут работать.
• Когда отправлять отчеты о сбоях. Выберите Всегда, Никогда или Спрашивать.
• Show window frame around device (Показывать рамку окна вокруг устройства). По умолчанию эмуляторы с файлами оболочки устройства показываются без рамки окна.

Подробнее об использовании прокси-серверов с эмулятором Android …

• Ускорение обработки графики. Выберите тип ускорения обработки графики.
  • Автовыбор. Автоматически выбирает аппаратное или программное ускорение графики в зависимости от конфигурации системы. Эмулятор оценивает возможности графического процессора и совместимость драйверов, чтобы определить наиболее стабильный бэкенд.
  • Программное обеспечение. Выбирает оптимальные драйверы программной отрисовки на основе конфигурации AVD, запрошенных функций и показателей качества эмулятора.
  • Аппаратное. Для максимальной производительности используется графический процессор компьютера. Рекомендуется для повышения производительности, но в некоторых конфигурациях оборудования могут возникать ошибки совместимости.
  Для более точного управления выбором графического бэкенда можно использовать -gpu параметр командной строки.
• Уровень API OpenGL ES. Выберите максимальную версию OpenGL ES, которую будет использовать эмулятор.
  • Автовыбор. Эмулятор выбирает версию OpenGL ES на основе поддержки хоста и гостя.
  • Максимальная версия средства визуализации (до OpenGL ES 3.1). Попытка использовать максимальную версию OpenGL ES.
  • Совместимость (OpenGL ES 1.1/2.0). Используйте версию OpenGL ES, совместимую с большинством сред.

На этой панели представлен полный список быстрых клавиш для эмулятора. Чтобы открыть эту панель во время работы в эмуляторе, нажмите F1 (Command + / в macOS).

Чтобы сочетания клавиш работали, для параметра Send keyboard shortcuts (Отправлять сочетания клавиш) на панели настроек General (Общие) должно быть выбрано значение Emulator controls (default) (Элементы управления эмулятором (по умолчанию)).

Этот пункт меню недоступен, если эмулятор запущен в режиме встроенного окна в Android Studio. Если вы используете эмулятор во встроенном режиме, сочетания клавиш можно найти в разделе File (Файл) (Android Studio в macOS) > Settings (Настройки) > Keymap (Раскладка клавиатуры) в разделе Running Devices (Запущенные устройства).

Чтобы перейти к онлайн-документации по эмулятору, нажмите Документация.

Чтобы сообщить об ошибке в эмуляторе, нажмите Отправить отзыв. Подробнее о том, как сообщить об ошибке в эмуляторе…

Этот пункт меню недоступен, если эмулятор запущен во встроенном режиме в Android Studio. Если вы используете эмулятор в встроенном режиме, откройте шаблон отчета об ошибке, нажав Help > Submit a Bug Report (Справка > Отправить сообщение об ошибке), и вручную добавьте сведения об ошибках эмулятора Android.

Посмотрите, какой порт adb использует эмулятор, а также номера версий Android и эмулятора. Сравните последнюю доступную версию эмулятора с вашей, чтобы определить, установлено ли у вас последнее ПО.

Серийный номер эмулятора – emulator-adb_port. Его можно указать, например, в качестве параметра командной строки adb.