Создание виртуальных устройств и управление ими

Виртуальное устройство Android (AVD) — это конфигурация, которая определяет характеристики телефона Android, планшета, Wear OS, Android TV или устройства Automotive OS, которые вы хотите смоделировать в Android Emulator . Диспетчер устройств — это инструмент, который вы можете запустить из Android Studio, который помогает вам создавать и управлять AVD.

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

• На экране приветствия Android Studio выберите Дополнительные действия > Диспетчер виртуальных устройств .

• После открытия проекта выберите Вид > Окна инструментов > Диспетчер устройств в главном меню, затем нажмите + , а затем нажмите Создать виртуальное устройство .

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

Если вы хотите использовать виртуальные устройства для запуска автоматизированных инструментальных тестов масштабируемым и самоуправляемым способом, рассмотрите возможность использования Gradle Managed Devices .

О AVD

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

Мы рекомендуем вам создать AVD для каждого образа системы, который ваше приложение может потенциально поддерживать на основе настройки <uses-sdk> в вашем манифесте.

Профиль оборудования

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

Определение устройства, отмеченное логотипом Google Play в столбце Play Store , включает в себя как приложение Google Play Store, так и доступ к сервисам Google Play, включая вкладку Google Play в диалоговом окне «Расширенные элементы управления» , которая предоставляет удобную кнопку для обновления сервисов Google Play на устройстве.

Устройства с этим логотипом и типом устройства «Телефон» также соответствуют стандарту CTS и могут использовать образы системы, включающие приложение Play Store.

Системные образы

Образ системы, помеченный API Google, включает доступ к сервисам Google Play .

Вкладка «Рекомендуемые» содержит список рекомендуемых образов системы. Другие вкладки содержат более полный список. Правая панель описывает выбранный образ системы.

Если вы видите значок загрузки рядом с образом системы, этот образ в настоящее время не установлен на вашей машине разработки. Щелкните значок, чтобы загрузить образ системы. Для загрузки образов системы необходимо подключение к Интернету.

Уровень API целевого устройства важен, поскольку ваше приложение не работает на системном образе с уровнем API ниже требуемого для вашего приложения, как указано в атрибуте minSdk в файле манифеста приложения. Для получения дополнительной информации о связи между уровнем API системы и minSdk см. раздел Version your app .

Если ваше приложение объявляет элемент <uses-library> в файле манифеста, приложению требуется системный образ, включающий эту внешнюю библиотеку. Чтобы запустить приложение на эмуляторе, создайте AVD, включающий требуемую библиотеку. Для этого вам может потребоваться использовать дополнительный компонент для платформы AVD; например, дополнительный компонент Google APIs содержит библиотеку Google Maps.

Для обеспечения безопасности приложений и единообразной работы с физическими устройствами образы системы, включающие Google Play Store, подписываются ключом выпуска, что означает, что с помощью этих образов невозможно получить повышенные привилегии (root).

Если вам требуются повышенные привилегии (root) для устранения неполадок в работе приложений, вы можете использовать системные образы Android Open Source Project (AOSP), которые не включают приложения или службы Google. Затем вы можете использовать команды adb root и adb unroot для переключения между обычными и повышенными привилегиями:

  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  % adb root
  restarting adbd as root
  % adb shell
  emu64a:/ #
  emu64a:/ # exit
  % adb unroot
  restarting adbd as non root
  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  %
  

Примечание: При запуске с обычным уровнем привилегий приглашение оболочки заканчивается символом $ , но при запуске с повышенными привилегиями (root) приглашение оболочки заканчивается символом # .

Складское помещение

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

Кожа

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

AVD и функции приложения

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

Создать AVD

Чтобы создать новый AVD:

1. Откройте диспетчер устройств.
2. Нажмите «Создать устройство» .

   Появится окно «Выбор оборудования» .

   

   Обратите внимание, что только некоторые профили оборудования включают Play Store . Эти профили полностью совместимы с CTS и могут использовать образы системы, включающие приложение Play Store.

3. Выберите профиль оборудования, затем нажмите «Далее» .

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

   Появится окно «Образ системы» .

   
4. Выберите образ системы для определенного уровня API, а затем нажмите Далее .

Появится окно «Проверка конфигурации» .


5. Измените свойства AVD по мере необходимости, а затем нажмите кнопку Готово .

   Нажмите «Показать дополнительные настройки» , чтобы отобразить дополнительные настройки, например, скин.

Новый AVD появится на вкладке «Виртуальный» диспетчера устройств и в меню целевого устройства.

Чтобы создать AVD, начиная с копии:

1. На вкладке «Виртуальные» диспетчера устройств нажмите «Меню» . и выберите Дублировать .

   Появится окно «Проверка конфигурации» .

2. Нажмите «Назад» , если вам необходимо внести изменения в окна «Образ системы» или «Выбор оборудования» .
3. Внесите необходимые изменения и нажмите «Готово» .

   AVD отображается на вкладке «Виртуальный» диспетчера устройств.

Создать профиль оборудования

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

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

Чтобы создать новый профиль оборудования с самого начала:

1. В окне «Выбор оборудования» нажмите «Новый профиль оборудования» .

2. В окне «Настройка профиля оборудования» измените свойства профиля оборудования по мере необходимости.

   
3. Нажмите «Готово» .

   Ваш новый профиль оборудования появится в окне Select Hardware . Вы можете создать AVD , который использует профиль оборудования, нажав Next или Cancel, чтобы вернуться на вкладку Virtual или в меню целевого устройства.

Чтобы создать профиль оборудования, используя копию в качестве отправной точки:

1. В окне «Выбор оборудования» выберите профиль оборудования и нажмите «Клонировать устройство» или щелкните правой кнопкой мыши профиль оборудования и выберите «Клонировать» .

2. В окне «Настройка профиля оборудования» измените свойства профиля оборудования по мере необходимости.
3. Нажмите «Готово» .

Ваш новый профиль оборудования появится в окне Select Hardware . Вы можете создать AVD , который использует профиль оборудования, нажав Next или Cancel, чтобы вернуться на вкладку Virtual или в меню целевого устройства.

Редактировать существующие AVD

На вкладке «Виртуальные» диспетчера устройств можно выполнять следующие операции с AVD:

• Чтобы отредактировать AVD, нажмите «Изменить этот AVD». и внесите изменения.
• Чтобы удалить AVD, нажмите Меню.и выберите Удалить .
• Чтобы отобразить связанные файлы AVD INI и IMG на диске, нажмите Менюи выберите Показать на диске .
• Чтобы просмотреть сведения о конфигурации AVD, которые можно включить в отчеты об ошибках для команды Android Studio, нажмите «Меню».и выберите Просмотреть подробности .

Редактировать существующие профили оборудования

Вы не можете редактировать или удалять предварительно загруженные профили оборудования, но вы можете выполнять следующие операции с другими профилями оборудования из окна «Выбор оборудования» :

• Чтобы отредактировать профиль оборудования, выберите его и нажмите Изменить устройство . Вы также можете щелкнуть правой кнопкой мыши профиль оборудования и выбрать Изменить . Затем внесите изменения.
• Чтобы удалить профиль оборудования, щелкните его правой кнопкой мыши и выберите Удалить .

Запустить и остановить эмулятор и очистить данные

На вкладке «Виртуальный» можно выполнять следующие операции на эмуляторе:

• Чтобы запустить эмулятор, использующий AVD, нажмите «Запустить». .
• Чтобы остановить работающий эмулятор, нажмите Меню.и выберите Стоп .
• Чтобы очистить данные эмулятора, нажмите Меню.и выберите Очистить данные .

Импорт и экспорт профилей оборудования

В окне «Выбор оборудования» вы можете импортировать и экспортировать профили оборудования следующим образом:

• Чтобы импортировать профиль оборудования, нажмите «Импорт профилей оборудования» и выберите на своем компьютере XML-файл, содержащий определение.
• Чтобы экспортировать профиль оборудования, щелкните его правой кнопкой мыши и выберите Экспорт . Укажите место, где вы хотите сохранить XML-файл, содержащий определение.

Свойства АВД

Конфигурация AVD определяет взаимодействие между компьютером разработки и эмулятором, а также свойства, которые вы хотите переопределить в профиле оборудования. Вы можете указать следующие свойства для конфигураций AVD в окне Проверка конфигурации . Свойства с меткой (Дополнительно) отображаются только в том случае, если вы нажмете Показать дополнительные параметры .

Свойства конфигурации AVD переопределяют свойства профиля оборудования, а свойства эмулятора, которые вы устанавливаете во время работы эмулятора, переопределяют и те, и другие.

Таблица 1. Свойства конфигурации AVD

АВД-собственность	Описание
Имя АВД	Введите имя для AVD. Имя может содержать заглавные или строчные буквы, цифры, точки, подчеркивания, скобки, тире и пробелы. Имя файла, в котором хранится конфигурация AVD, выводится из имени AVD.
AVD ID (Расширенный)	Просмотр идентификатора AVD. Идентификатор AVD выводится из имени AVD. Вы можете использовать идентификатор для ссылки на AVD из командной строки.
Профиль оборудования	Нажмите «Изменить» , чтобы выбрать другой профиль оборудования в окне «Выбор оборудования» .
Образ системы	Нажмите Изменить , чтобы выбрать другой образ системы из окна Образ системы . Для загрузки нового образа требуется активное подключение к Интернету.
Ориентация на стартапы	Выберите вариант начальной ориентации эмулятора: Портрет: ориентирован больше в высоту, чем в ширину Пейзаж: ориентирован в ширину, а не в высоту Опция включается только в том случае, если она поддерживается в профиле оборудования. При запуске AVD в эмуляторе вы можете изменить ориентацию, если в профиле оборудования поддерживаются как портретная, так и альбомная ориентация.
Камера (Расширенная)	Выберите опцию для всех включенных камер. Настройки Emulated и VirtualScene создают изображение, сгенерированное программным обеспечением, в то время как настройка Webcam использует веб-камеру вашего компьютера разработки для съемки Параметры камеры доступны только в том случае, если камера поддерживается в профиле оборудования. Они недоступны для Wear OS, Android TV или Google TV.
Сеть: Скорость (Расширенная)	Выберите сетевой протокол для определения скорости передачи данных: GSM: Глобальная система мобильной связи HSCSD: высокоскоростная передача данных по коммутируемым каналам GPRS: Универсальная служба пакетной радиосвязи EDGE: улучшенные скорости передачи данных для GSM Evolution UMTS: Универсальная система мобильной связи HSDPA: высокоскоростной пакетный доступ по нисходящей линии связи LTE: долгосрочная эволюция Полная (по умолчанию): передача данных настолько быстро, насколько позволяет ваш компьютер.
Сеть: Задержка (Расширенная)	Выберите сетевой протокол, чтобы указать, сколько времени потребуется протоколу для передачи пакета данных из одной точки в другую.
Эмулируемая производительность: графика	Выберите способ отображения графики в эмуляторе: Аппаратное обеспечение: используйте видеокарту вашего компьютера для более быстрой визуализации. Программное обеспечение: эмулирует графику в программном обеспечении, что полезно, если у вас возникли проблемы с рендерингом на вашей видеокарте. Автоматически: позвольте эмулятору выбрать лучший вариант на основе вашей видеокарты.
Эмулированная производительность: вариант загрузки (расширенный)	Выберите способ загрузки AVD: Холодная перезагрузка: устройство включается каждый раз из выключенного состояния. Быстрая загрузка: устройство загружает состояние устройства из сохраненного снимка.
Эмулируемая производительность: многоядерный процессор (расширенный)	Выберите количество ядер процессора на вашем компьютере, которые вы хотите использовать для эмулятора. Использование большего количества ядер процессора ускоряет эмулятор.
Память и хранилище: ОЗУ (расширенная)	Переопределить объем оперативной памяти на устройстве, установленный производителем оборудования. Увеличение размера использует больше ресурсов на вашем компьютере, но поддерживает более быструю работу эмулятора. Введите размер оперативной памяти и выберите единицы измерения: B (байт), KB (килобайт), MB (мегабайт), GB (гигабайт) или TB (терабайт).
Память и хранилище: VM Heap (расширенная)	Переопределить размер кучи виртуальной машины, установленный производителем оборудования. Введите размер кучи и выберите единицы измерения: B (байт), KB (килобайт), MB (мегабайт), GB (гигабайт) или TB (терабайт).
Память и хранилище: Внутреннее хранилище (расширенное)	Переопределить объем несъемной памяти, доступной на устройстве, установленный производителем оборудования. Введите размер и выберите единицы измерения: B (байт), KB (килобайт), MB (мегабайт), GB (гигабайт) или TB (терабайт).
Память и хранилище: SD-карта (расширенная)	Укажите объем съемной памяти, доступной для хранения данных на устройстве. Чтобы использовать виртуальную SD-карту, управляемую Android Studio, выберите Studio-managed , введите размер и выберите единицы измерения: B (байт), KB (килобайт), MB (мегабайт), GB (гигабайт) или TB (терабайт). Для использования камеры рекомендуется не менее 100 МБ. Для управления пространством в файле выберите Внешний файл и нажмите ... , чтобы указать файл и местоположение. Для получения дополнительной информации см. каталог данных mksdcard и AVD .
Рамка устройства: включить рамку устройства	Выберите этот параметр, чтобы включить рамку вокруг окна эмулятора, имитирующую внешний вид реального устройства.
Пользовательское определение скина (расширенное)	Выберите скин, который управляет тем, как выглядит устройство при отображении в эмуляторе. Указание слишком большого для скина размера экрана может означать, что экран будет обрезан, и вы не сможете видеть весь экран. Для получения дополнительной информации см. раздел Создание скина эмулятора .
Клавиатура: включить ввод с клавиатуры (расширенные настройки)	Выберите эту опцию, чтобы использовать аппаратную клавиатуру для взаимодействия с эмулятором. Эта опция отключена для Wear OS и Android TV.

Свойства профиля оборудования

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

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

Некоторые свойства отключены для некоторых типов устройств. Например, свойство "Round" доступно только на устройствах Wear OS.

Таблица 2. Свойства конфигурации профиля оборудования

Свойство профиля оборудования	Описание
Имя устройства	Введите имя для профиля оборудования. Имя может содержать заглавные или строчные буквы, цифры, точки, подчеркивания, скобки и пробелы. Имя файла, в котором хранится профиль оборудования, выводится из имени профиля оборудования.
Тип устройства	Выберите один из следующих вариантов: Телефон/Планшет Носить ОС Android-ТВ Гугл ТВ Устройство ChromeOS Android-автомобильный
Экран: Размер экрана	Укажите физический размер экрана в дюймах, измеренный по диагонали. Если размер больше экрана вашего компьютера, он уменьшается при запуске.
Экран: Разрешение экрана	Введите ширину и высоту в пикселях, чтобы указать общее количество пикселей на моделируемом экране.
Экран: Круглый	Выберите этот параметр, если устройство имеет круглый экран, например, некоторые устройства Wear OS.
Память: ОЗУ	Введите размер оперативной памяти устройства и выберите единицы измерения: Б (байт), КБ (килобайт), МБ (мегабайт), ГБ (гигабайт) или ТБ (терабайт).
Ввод: имеет аппаратные кнопки (Назад/Домой/Меню)	Выберите этот параметр, если на вашем устройстве есть аппаратные кнопки навигации. Отмените выбор, если эти кнопки реализованы только в программном обеспечении. Если вы выберете этот параметр, кнопки не будут отображаться на экране. В любом случае вы можете использовать боковую панель эмулятора для имитации нажатия кнопок.
Ввод: есть аппаратная клавиатура	Выберите этот параметр, если на вашем устройстве есть аппаратная клавиатура. Отмените выбор, если ее нет. Если вы выберете этот параметр, клавиатура не появится на экране. В любом случае вы можете использовать клавиатуру компьютера для отправки нажатий клавиш в эмулятор.
Ввод: Стиль навигации	Выберите один из следующих вариантов: None: нет аппаратного управления. Навигация осуществляется через программное обеспечение. D-pad: поддержка навигационной панели. Трекбол Колесо Эти параметры предназначены для управления оборудованием на самом устройстве. Однако события, отправляемые на устройство внешним контроллером, те же самые.
Поддерживаемые состояния устройства	Выберите один или оба варианта: Портрет: ориентирован больше в высоту, чем в ширину Пейзаж: ориентирован в ширину, а не в высоту Необходимо выбрать хотя бы один вариант. Если выбрать оба варианта, можно переключаться между ориентациями в эмуляторе.
Камеры	Чтобы включить камеру, выберите один или оба варианта: Задняя камера: объектив направлен в сторону от пользователя. Фронтальная камера: объектив обращен к пользователю Если камера включена, вы можете использовать веб-камеру вашего компьютера для разработки или фотографию, предоставленную эмулятором, для имитации фотосъемки на основе параметров, выбранных вами в конфигурации AVD.
Датчики: Акселерометр	Выберите этот вариант, если устройство оснащено оборудованием, помогающим определять его ориентацию.
Датчики: Гироскоп	Выберите этот вариант, если устройство имеет оборудование, которое определяет вращение или скручивание. В сочетании с акселерометром гироскоп может обеспечить более плавное определение ориентации и поддерживать шестиосевую систему ориентации.
Датчики: GPS	Выберите этот параметр, если устройство оснащено оборудованием, поддерживающим спутниковую навигационную систему глобального позиционирования (GPS).
Датчики: Датчик приближения	Выберите этот параметр, если устройство оснащено оборудованием, которое определяет, когда устройство находится близко к лицу пользователя во время телефонного разговора, чтобы отключить ввод с экрана.
Скин по умолчанию	Выберите скин, который управляет тем, как выглядит устройство при отображении в эмуляторе. Указание размера экрана, который слишком велик для разрешения, может означать, что экран будет обрезан, и вы не сможете увидеть весь экран. Подробнее см. в разделе ниже о создании скина эмулятора .

Создать скин эмулятора

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

Каждый скин эмулятора содержит:

• Файл hardware.ini
• Файлы макетов для поддерживаемых ориентаций и физических конфигураций
• Файлы изображений для элементов отображения, таких как фон, клавиши и кнопки

Чтобы создать и использовать пользовательский скин:

1. Создайте каталог, в котором вы сможете сохранять файлы конфигурации вашего скина.
2. Определите внешний вид скина в текстовом файле с именем layout . Этот файл определяет множество характеристик скина, таких как размер и активы изображения для определенных кнопок. Например:

   parts {
       device {
           display {
               width   320
               height  480
               x       0
               y       0
           }
       }
   
       portrait {
           background {
               image background_port.png
           }
   
           buttons {
               power {
                   image  button_vertical.png
                   x 1229
                   y 616
               }
           }
       }
       ...
   }
   

3. Добавьте в этот же каталог растровые файлы изображений устройства.
4. Укажите дополнительные конфигурации устройства, зависящие от оборудования, в INI-файле для настроек устройства, например hw.keyboard и hw.lcd.density .
5. Заархивируйте файлы в папке скина и выберите файл архива в качестве пользовательского скина.

Более подробную информацию о создании скинов эмулятора см. в спецификации файла скина эмулятора Android в исходном коде инструментов.