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

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

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

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

Открытие диспетчера устройств с экрана приветствия

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

Новое окно диспетчера устройств

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

Список диспетчера устройств

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

О АВД

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 см. в разделе Версия вашего приложения .

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

Чтобы обеспечить безопасность приложения и единообразную работу с физическими устройствами, образы системы с включенным магазином Google Play подписываются ключом выпуска, что означает, что вы не можете получить повышенные привилегии (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
  %
  

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

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

Кожа

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

Возможности AVD и приложения

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

Создать AVD

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

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

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

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

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

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

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

  4. Выберите образ системы для определенного уровня API и нажмите «Далее» .
  5. Появится окно «Проверка конфигурации» .

  6. При необходимости измените свойства AVD и нажмите «Готов��» .

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

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

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

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

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

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

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

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

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

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

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

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

    Диалоговое окно «Настроить профиль оборудования»
  3. Нажмите «Готово» .

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

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

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

  2. В окне «Настройка профиля оборудования» при необходимости измените свойства профиля оборудования .
  3. Нажмите «Готово» .
  4. ��аш новый профиль оборудования появится в окне «Выбор оборудования» . Вы можете создать AVD , использующий профиль оборудова��ия, нажав «Далее» или «Отмена» , чтобы вернуться на вкладку «Виртуальный» или в меню целевого устройства.

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

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

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

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

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

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

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

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

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

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

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

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

Свойства АВД

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

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

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

недвижимость АВД Описание
Имя АВД Введите имя AVD. Имя может содержать прописные или строчные буквы, цифры, точки, символы подчеркивания, круглые скобки, тире и пробелы. Имя файла, хранящего конфигурацию AVD, происходит от имени AVD.
Идентификатор AVD (расширенный) Просмотрите идентификатор AVD. Идентификатор AVD получается из имени AVD. Вы можете использовать идентификатор для ссылки на AVD из командной строки.
Профиль оборудования Нажмите « Изменить» , чтобы выбрать другой профиль оборудования в окне «Выбор оборудования» .
Образ системы Нажмите « Изменить» , чтобы выбрать другой образ системы в окне «Образ системы» . Для загрузки нового изображения требуется активное подключение к Интернету.
Ориентация на стартап

Выберите вариант начальной ориентации эмулятора:

  • Портрет: ориентирован выше ширины
  • Пейзаж: ориентирован в ширину, а не в высоту.

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

Камера (дополнительно)

Выберите вариант для всех включенных камер. Параметры «Эмулированный» и «VirtualScene» создают изображение, созданное программным обеспечением, а параметр «Веб-камера» использует веб-камеру вашего компьютера разработки для съемки изображения.

Параметры камеры доступны только в том случае, если камера поддерживается в профиле оборудования. Они недоступны для Wear OS, Android TV или Google TV.

Сеть: Скорость (Дополнительно)

Выберите сетевой протокол для определения скорости передачи данных:

  • GSM: Глобальная система мобильной связи
  • HSCSD: высокоскоростная передача данных с коммутацией каналов
  • GPRS: универсальная служба пакетной радиосвязи
  • EDGE: повышенная скорость передачи данных для GSM Evolution
  • UMTS: Универсальная система мобильной связи.
  • HSDPA: высокоскоростной пакетный доступ по нисходящей линии связи
  • LTE: долгосрочная эволюция
  • Полный (по умолчанию): Передавайте данные так быстро, как позволяет ваш компьютер.
Сеть: Задержка (дополнительно) Выберите сетевой протокол, чтобы указать, сколько времени потребуется протоколу для передачи пакета данных из одной точки в другую.
Эмулируемая производительность: графика

Выберите способ рендеринга графики в эмуляторе:

  • Аппаратное обеспечение: используйте видеокарту вашего компьютера для более быстрого рендеринга.
  • Программное обеспечение: эмулируйте графику в программном обеспечении, что полезно, если у вас возникли проблемы с рендерингом на вашей видеокарте.
  • Автоматически: позвольте эмулятору выбрать лучший вариант в зависимости от вашей видеокарты.
Эмулируемая производительность: вариант загрузки (дополнительно)

    Выберите способ загрузки AVD:

  • Холодная перезагрузка: устройство каждый раз включается из выключенного состояния.
  • Быстрая загрузка: устройство загружает состояние устройства из сохраненного снимка.
Эмулируемая производительность: многоядерный процессор (расширенный) Выберите количество ядер процессора вашего компьютера, которое вы хотите использовать для эмулятора. Использование большего количества ядер процессора ускоряет работу эмулятора.
Память и хранилище: ОЗУ (расширенное) Переопределить объем оперативной памяти на устройстве, установленный производителем оборудования. Увеличение размера требует больше ресурсов вашего компьютера, но обеспечивает более быструю работу эмулятора. Введите размер ОЗУ и выберите единицы измерения: B (байт), КБ (килобайт), МБ (мегабайт), ГБ (гигабайт) или ТБ (терабайт).
Память и хранилище: куча виртуальной машины (дополнительно) Переопределить размер кучи виртуальной машины, установленный производителем оборудования. Введите размер кучи и выберите единицы измерения: B (байт), КБ (килобайт), МБ (мегабайт), ГБ (гигабайт) или ТБ (терабайт).
Память и хранилище: Внутреннее хранилище (расширенное) Переопределить объем несъемной памяти, доступной на устройстве, установленный производителем оборудования. Введите размер и выберите единицы измерения: B (байт), КБ (килобайт), МБ (мегабайт), ГБ (гигабайт) или ТБ (терабайт).
Память и хранилище: SD-карта (дополнительно)

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

Чтобы использовать виртуальную SD-карту, управляемую Android Studio, выберите «Управляется Studio» , введите размер и выберите единицы измерения: B (байт), КБ (килобайт), МБ (мегабайт), ГБ (гигабайт) или ТБ ( терабайт). Для использования камеры рекомендуется минимум 100 МБ.

Чтобы управлять пространством в файле, выберите «Внешний файл» и нажмите «...» , чтобы указать файл и местоположение.

Дополнительную информацию см. в mksdcard и каталог данных AVD .

Фрейм устройства: включить фрейм устройства Выберите, чтобы включить рамку вокруг окна эмулятора, имитирующую внешний вид реального устройства.
Пользовательское определение скина (расширенное) Выберите обложку, которая определяет внешний вид устройства при отображении в эмуляторе. Указание размера экрана, слишком большого для скина, может привести к тому, что экран будет обрезан, и вы не сможете видеть весь экран. Дополнительную информацию см. в разделе «Создание скина эмулятора» .
Клавиатура: включить ввод с клавиатуры (дополнительно) Выберите этот вариант, чтобы использовать аппаратную клавиатуру для взаимодействия с эмулятором. Эта опция отключена для Wear OS и Android TV.

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

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

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

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

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

Свойство профиля оборудования Описание
Имя устройства Введите имя профиля оборудования. Имя может содержать прописные или строчные буквы, цифры, точки, символы подчеркивания, круглые скобки и пробелы. Имя файла, в котором хранится профиль оборудования, происходит от имени профиля оборудования.
Тип устройства

Выберите один из следующих вариантов:

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

Выберите один из следующих вариантов:

  • Нет: нет аппаратного контроля. Навигация осуществляется через программное обеспечение.
  • D-pad: поддержка направленной панели.
  • Трекбол
  • Колесо

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

Поддерживаемые состояния устройства

Выберите один или оба варианта:

  • Портрет: ориентирован выше ширины
  • Пейзаж: ориентирован в ширину, а не в высоту.

Вы должны выбрать хотя бы один вариант. Если вы выберете оба варианта, вы сможете переключаться между ориентациями в эмуляторе.

Камеры

Чтобы включить камеру, выберите один или оба варианта:

  • Задняя камера: объектив направлен в сторону от пользователя.
  • Фронтальная камера: объектив обращен к пользователю.

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

Датчики: Акселерометр Выберите этот параметр, если устройство оснащено оборудованием, которое помогает ему определять его ориентацию.
Датчики: гироскоп Выберите этот параметр, если устройство оснащено оборудованием, определяющим вращение или поворот. В сочетании с акселерометром гироскоп может обеспечить более плавное определение ориентации и поддерживать шестиосную систему ориентации.
Датчики: GPS Выберите этот вариант, если устройство оснащено оборудованием, поддерживающим спутниковую навигационную систему Global Positioning System (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 в исходном коде инструментов.

,

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

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

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

Открытие диспетчера устройств с экрана приветствия

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

Новое окно диспетчера устройств

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

Список диспетчера устройств

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

О АВД

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 см. в разделе Версия вашего приложения .

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

Чтобы обеспечить безопасность приложения и единообразную работу с физическими устройствами, образы системы с включенным магазином Google Play подписываются ключом выпуска, что означает, что вы не можете получить повышенные привилегии (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
  %
  

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

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

Кожа

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

Возможности AVD и приложения

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

Создать AVD

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

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

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

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

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

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

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

  4. Выберите образ системы для определенного уровня API и нажмите «Далее» .
  5. Появится окно «Проверка конфигурации» .

  6. При необходимости измените свойства AVD и нажмите «Готово» .

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

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

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

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

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

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

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

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

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

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

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

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

    Диалоговое окно «Настроить профиль оборудования»
  3. Нажмите «Готово» .

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

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

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

  2. В окне «Настройка профиля оборудования» при необходимости измените свойства профиля оборудования .
  3. Нажмите «Готово» .
  4. Ваш новый профиль оборудования появится в окне «Выбор оборудования» . Вы можете создать AVD , использующий профиль оборудования, нажав «Далее» или «Отмена» , чтобы вернуться на вкладку «Виртуальный» или в меню целевого устройства.

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

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

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

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

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

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

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

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

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

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

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

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

Свойства АВД

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

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

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

недвижимость АВД Описание
Имя АВД Введите имя AVD. Имя может содержать прописные или строчные буквы, цифры, точки, символы по��черкивания, круглые скобки, тире и пробелы. Имя файла, хранящего конфигурацию AVD, происходит от имени AVD.
Идентификатор AVD (расширенный) Просмотрите идентификатор AVD. Идентификатор AVD получается из имени AVD. Вы можете использовать идентификатор для ссылки на AVD из командной строки.
Профиль оборудования Нажмите « Изменить» , чтобы выбрать другой профиль оборудования в окне «Выбор оборудования» .
Образ системы Нажмите « Изменить» , чтобы выбрать другой образ системы в окне «Образ системы» . Для загрузки нового изображения требуется активное подключение к Интернету.
Ориентация на стартап

Выберите вариант начальной ориентации эмулятора:

  • Портрет: ориентирован выше ширины
  • Пейзаж: ориентирован в ширину, а не в высоту.

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

Камера (дополнительно)

Выберите вариант для всех включенных камер. Настройки «Эмуляция» и «Виртуальная сцена» создают изображение, созданное программным обеспечением, а настройка «Веб-камера» использует веб-камеру вашего компьютера разработки для съемки изображения.

Параметры камеры доступны только в том случае, если камера поддерживается в профиле оборудования. Они недоступны для Wear OS, Android TV или Google TV.

Сеть: Скорость (Дополнительно)

Выберите сетевой протокол для определения скорости передачи данных:

  • GSM: Глобальная система мобильной связи
  • HSCSD: высокоскоростная передача данных с коммутацией каналов
  • GPRS: универсальная служба пакетной радиосвязи
  • EDGE: повышенная скорость передачи данных для GSM Evolution
  • UMTS: Универсальная система мобильной связи.
  • HSDPA: высокоскоростной пакетный доступ по нисходящей линии связи
  • LTE: долгосрочная эволюция
  • Полный (по умолчанию): Передавайте данные так быстро, как позволяет ваш компьютер.
Сеть: Задержка (дополнительно) Выберите сетевой протокол, чтобы указать, сколько ��ремени потребуется протоколу для передачи пакета данных из одной точки в другую.
Эмулируемая производительность: графика

Выберите способ рендеринга графики в эмуляторе:

  • Аппаратное обеспечение: используйте видеокарту вашего компьютера для более быстрого рендеринга.
  • Про��раммное обеспечение: эмулируйте графику в программном обеспечении, что полезно, если у вас возникли проблемы с рендерингом на вашей видеокарте.
  • Автоматически: позвольте эмулятору выбрать лучший вариант в зависимости от вашей видеокарты.
Эмулируемая производительность: вариант загрузки (дополнительно)

    Выберите способ загрузки AVD:

  • Холодная перезагрузка: устройство каждый раз включается из выключенного состояния.
  • Быстрая загрузка: устройство загружает состояние устройства из сохраненного снимка.
Эмулируемая производительность: многоядерный процессор (расширенный) Выберите количество ядер процессора вашего компьютера, которое вы хотите использовать для эмулятора. Использование большего количества процессорных ядер ускоряет работу эмулятора.
Память и хранилище: ОЗУ (расширенное) Переопределить объем оперативной памяти на устройстве, установленный производителем оборудования. Увеличение размера требует больше ресурсов вашего компьютера, но обеспечивает более быструю работу эмулятора. Введите размер ОЗУ и выберите единицы измерения: B (байт), КБ (килобайт), МБ (мегабайт), ГБ (гигабайт) или ТБ (терабайт).
Память и хранилище: куча виртуальной машины (дополнительно) Переопределить размер кучи виртуальной машины, установленный производителем оборудования. Введите размер кучи и выберите единицы измерения: B (байт), КБ (килобайт), МБ (мегабайт), ГБ (гигабайт) или ТБ (терабайт).
Память и хранилище: внутреннее хранилище (расширенное) Переопределите количество не вносимого пространства памяти, доступное на устройстве, установленном производителем аппаратного обеспечения. Введите размер и выберите подразделения, один из B (байт), кб (килобит), MB (мегабайт), GB (Gigabyte) или TB (Terabyte).
Память и хранение: SD -карта (Advanced)

Укажите количество съемного пространства памяти, доступное для хранения данных на устройстве.

Чтобы использовать виртуальную SD-карту, управляемую Android Studio, Select Studio, управляемый , введите размер и выберите подразделения, один из B (байт), кб (килобит), MB (мегабит), GB (Gigabyte) или TB ( Терабайт). Для использования камеры рекомендуется минимум 100 МБ.

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

Для получения дополнительной информации см. mksdcard и AVD Dataly Data .

Рамка устройства: включить рамку устройства Выберите, чтобы включить раму вокруг окна эмулятора, которое имитирует внешний вид реального устройства.
Пользовательское определение кожи (продвинутое) Выберите кожу, которая контролирует, как выглядит устройство при отображении в эмуляторе. Указание размер экрана, который слишком большой для кожи, может означать, что экран отрезан, так что вы не можете увидеть весь экран. См. Раздел «Создать кожу эмулятора» для получения дополнительной информации.
Клавиатура: включить вход клавиатуры (Advanced) Выберите эту опцию, чтобы использовать аппаратную клавиатуру для взаимодействия с эмулятором. Эта опция отключена для ОС Wear и Android TV.

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

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

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

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

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

Свойство профиля аппаратного обеспечения Описание
Имя устройства Введите имя для аппаратного профиля. Название может содержать прописные или строчные буквы, числа, периоды, подчеркивание, скобки и пространства. Имя файла, хранящего аппаратный профиль, получено от имени профиля оборудования.
Тип устройства

Выберите один из следующих вариантов:

  • Телефон/планшет
  • Носить ОС
  • Андроид ТВ
  • Гугл ТВ
  • Устройство Chromeos
  • Android Автомобильная промышленность
Экран: размер экрана Укажите физический размер экрана в дюймах, измеренный на диагонали. Если размер больше экрана вашего компьютера, он уменьшен в размере при запуске.
Экран: разрешение экрана Введите ширину и высоту в п��кселях, чтобы указать общее количество пикселей на смоделированном экране.
Экран: круглый Выберите эту опцию, если у устройства есть круглый экран, например, некоторые устройства износа ОС.
Память: ОЗУ Введите размер оперативной памяти устройства и выберите единицы, один из B (байт), кб (килобит), MB (мегабайт), GB (Gigabyte) или TB (Terabyte).
Ввод: имеет аппаратные кнопки (обратно/дом/меню) Выберите эту опцию, если у вашего устройства есть аппаратные кнопки навигации. Отмените его, если эти кнопки реализованы только в программном обеспечении. Если вы выберете эту опцию, кнопки не отображаются на экране. В любом случае вы можете использовать боковую панель эмулятора для моделирования нажатия кнопок.
Ввод: имеет аппаратную клавиатуру Выберите эту опцию, если у вашего устройства есть аппаратная клавиатура. Отмените это, если это не так. Если вы выберете эту опцию, на экране нет клавиатуры. В любом случае вы можете использовать клавиатуру компьютера для отправки клавишных на эмулятор.
Ввод: стиль навигации

Выберите один из следующих вариантов:

  • Нет: нет аппаратных элементов управления. Навигация проходит через программное обеспечение.
  • 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 эмулятора в исходном коде инструментов.

,

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

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

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

Открытие диспетчера устройств с приветственного экрана

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

Новое окно диспетчера устройств

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

Список диспетчера устройств

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

Об AVDS

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

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

Аппаратный профиль

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

Диалог выбора аппаратного обеспечения

Определение устройства, помеченное логотипом Google Play в столбце Play Store устройство.

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

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

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

Диалог изображения системы

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

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

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

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

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

Если вам нужны повышенные привилегии (root) для помощи при устр��не��и�� ��е��ол��док �� ��риложени��, вы можете использовать системы системного проекта Android с открытым исходным кодом (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
  %
  

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

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

Кожа

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

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

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

Создать AVD

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

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

    Появится окно «Выбор аппаратного обеспечения» .

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

  3. Выберите аппаратный профиль, затем нажмите Далее .

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

    Появляется окно изображения системы .

  4. Выберите изображение системы для определенного уровня API, а затем нажмите «Далее» .
  5. Появится окно проверки конфигурации .

  6. Измените свойства AVD по мере необходимости, а затем нажмите «Закончить» .

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

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

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

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

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

  2. Нажмите предыдущий , если вам нужно внести изменения в системном изображении или выберите аппаратные окна.
  3. Внесите любые изменения, которые вам нужны, а затем нажмите «Закончить» .

    AVD появляется на виртуальной вкладке диспетчера устройств.

Создать аппаратный профиль

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

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

Для создания нового аппаратного профиля с самого начала:

  1. В окне «Выбрать аппаратное обеспечение» нажмите «Новый аппаратный профиль» .
  2. В окне «Настройка аппаратного профиля» измените свойства аппаратного профиля по мере необходимости.

    Диалог настройки аппаратного профиля аппаратного обеспечения
  3. Нажмите «Готово» .

    Ваш новый аппаратный профиль появляется в окне «Выбор аппаратного обеспечения» . Вы можете создать AVD , который использует аппаратный профиль, нажав дальше или нажмите «Отмена» , чтобы вернуться на вкладку «Виртуальное» или меню «Целевое устройство».

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

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

  2. В окне «Настройка аппаратного профиля» измените свойства аппаратного профиля по мере необходимости.
  3. Нажмите «Готово» .
  4. Ваш новый аппаратный профиль появляется в окне «Выбор аппаратного обеспечения» . Вы можете создать AVD , который использует аппаратный профиль, нажав дальше или нажмите «Отмена» , чтобы вернуться на вкладку «Виртуальное» или меню «Целевое устройство».

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

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

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

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

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

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

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

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

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

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

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

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

AVD Properties

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

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

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

AVD Property Описание
AVD имя Введите имя для AVD. Название может содержать прописные или строчные буквы, числа, периоды, подчеркивание, скобки, тире и пространства. Имя хранилища файла Конфигурация AVD получено от имени AVD.
AVD ID (Advanced) Посмотреть идентификатор AVD. ID AVD получен из имени AVD. Вы можете использовать идентификатор для обозначения AVD из командной строки.
Аппаратный профиль Нажмите « Изменить» , чтобы выбрать другой аппаратный профиль в окне «Выбрать аппаратное обеспечение» .
Образ системы Нажмите «Изменить» , чтобы выбрать другое системное изображение в окне изображения системы . Активное подключение к Интернету требуется для загрузки нового изображения.
Ориентация стартапа

Выберите опцию для начальной ориентации эмулятора:

  • Портрет: ориентирован выше, чем широкий
  • Ландшафт: ориентирован шире, чем высокий

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

Камера (продвинутая)

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

Параметры камеры доступны только в том случае, если камера поддерживается в профиле оборудования. Они недоступны для ОС Wear, Android TV или Google TV.

Сеть: скорость (продвинутая)

Выберите сетевой протокол, чтобы определить скорость передачи данных:

  • GSM: Global System for Mobile Communications
  • HSCSD: высокоскоростные данные, переключенные
  • GPRS: общее пакетное радио служба
  • Edge: повышенные показатели передачи данных для эволюции GSM
  • UMTS: универсальная мобильная телекоммуникационная система
  • HSDPA: высокоскоростный доступ к пакетам нисходящей линии связи
  • LTE: долгосрочная эволюция
  • Полный (по умолчанию): передача данных так быстро, как позволяет ваш компьютер.
Сеть: задержка (продвинутая) Выберите сетевой протокол, чтобы установить, сколько времени требуется для протокола, чтобы передавать пакет данных из одной точки в другую точку.
Эмулированная производительность: графика

Выберите, как графика отображается в эмуляторе:

  • Аппаратное обеспечение: используйте компьютерную видеокарту для более быстрого рендеринга.
  • Программное обеспечение: эмуляция графики в программном обеспечении, что полезно, если у вас есть проблема с рендерингом в вашей видеокарте.
  • Automatic: пусть эмулятор определит лучший вариант на основе вашей видеокарты.
Эмулированная производительность: опция загрузки (Advanced)

    Выберите, как сапоги AVD:

  • Холодная загрузка: устройство каждый раз приводит к тому, что из состояния выключения устройства.
  • Быстрая загрузка: устройство загружает состояние устройства из сохраненного снимка.
Эмулированная производительность: многоядерный процессор (Advanced) Выберите количество ядер процессоров на своем компьютере, которые вы хотите использовать для эмулятора. Использование большего количества процессоров ускоряет эмулятор.
Память и хранилище: ОЗУ (расширенный) Переопределите количество оперативной памяти на устройстве, установленном производителем оборудования. Увеличение размера использует больше ресурсов на вашем компьютере, но поддерживает более быструю работу эмулятора. Введите размер оперативной памяти и выберите подразделения, один из B (байт), кб (килобит), MB (мегабайт), GB (Gigabyte) или TB (Terabyte).
Память и хранилище: VM Heap (Advanced) Переопределите размер кучи виртуальной машины, установленным производителем аппаратного обеспечения. Введите размер кучи и выберите подразделения, один из B (байт), кб (килобит), MB (мегабайт), GB (Gigabyte) или TB (Terabyte).
Память и хранилище: внутреннее хранилище (расширенное) Переопределите количество не вносимого пространства памяти, доступное на устройстве, установленном производителем аппаратного обеспечения. Введите размер и выберите подразделения, один из B (байт), кб (килобит), MB (мегабайт), GB (Gigabyte) или TB (Terabyte).
Память и хранение: SD -карта (Advanced)

Укажите количество съемного пространства памяти, доступное для хранения данных на устройстве.

Чтобы использовать виртуальную SD-карту, управляемую Android Studio, Select Studio, управляемый , введите размер �� выберите подразделения, один из B (байт), кб (килобит), MB (мегабит), GB (Gigabyte) или TB ( Терабайт). Для использования камеры рекомендуется минимум 100 МБ.

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

Для получения дополнительной информации см. mksdcard и AVD Dataly Data .

Рамка устройства: включить рамку устройства Выберите, чтобы включить раму вокруг окна эмулятора, которое имитирует внешний вид реального устройства.
Пользовательское определение кожи (продвинутое) Выберите кожу, которая контролирует, как выглядит устройство при отображении в эмуляторе. Указание размер экрана, который слишком большой для кожи, может означать, что экран отрезан, так что вы не можете увидеть весь экран. См. Раздел «Создать кожу эмулятора» для получения дополнительной информации.
Клавиатура: включить вход клавиатуры (Advanced) Выберите эту опцию, чтобы использовать аппаратную клавиатуру для взаимодействия с эмулятором. Эта опция отключена для ОС Wear и Android TV.

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

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

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

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

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

Свойство профиля аппаратного обеспечения Описание
Имя устройства Введите имя для аппаратного профиля. Название может содержать прописные или строчные буквы, числа, периоды, подчеркивание, скобки и пространства. Имя файла, хранящего аппаратный профиль, получено от имени профиля оборудования.
Тип устройства

Выберите один из следующих вариантов:

  • Телефон/планшет
  • Носить ОС
  • Андроид ТВ
  • Гугл ТВ
  • Устройство Chromeos
  • Android Автомобильная промышленность
Экран: размер экрана Укажите физический размер экрана в дюймах, измеренный на диагонали. Если размер больше экрана ва��его компьютера, он уменьшен в размере при запуске.
Экран: разрешение экрана Введите ширину и высоту в пикселях, чтобы указать общее количество пикселей на смоделированном экране.
Экран: круглый Выберите эту опцию, если у устройства есть круглый экран, например, некоторые устройства износа ОС.
Память: ОЗУ Введите размер оперативной памяти устройства и выберите единицы, один из B (байт), кб (килобит), MB (мегабайт), GB (Gigabyte) или TB (Terabyte).
Ввод: имеет аппаратные кнопки (обратно/дом/меню) Выберите эту опцию, если у вашего устройства есть аппаратные кнопки навигации. Отмените его, если эти кнопки реализованы только в программном обеспечении. Если вы выберете эту опцию, кнопки не отображаются на экране. В любом случае вы можете использовать боковую панель эмулятора для моделирования нажатия кнопок.
Ввод: имеет аппаратную клавиатуру Выберите эту опцию, если у вашего устройства есть аппаратная клавиатура. Отмените это, если это не так. Если вы выберете эту опцию, на экране нет клавиатуры. В любом случае вы можете использовать клавиатуру компьютера для отправки клавишных на эмулятор.
Ввод: стиль навигации

Выберите один из следующих вариантов:

  • Нет: нет аппаратных элементов управления. Навигация проходит через программное обеспечение.
  • 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 эмулятора в исходном коде инструментов.

,

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

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

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

Открытие диспетчера устройств с приветственного экрана

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

Новое окно диспетчера устройств

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

Список диспетчера устройств

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

Об AVDS

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

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

Аппаратный профиль

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

Диалог выбора аппаратного обеспечения

Определение устройства, помеченное логотипом Google Play в столбце Play Store устройство.

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

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

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

Диалог изображения системы

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

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

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

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

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

Если вам нужны повышенные привилегии (root) для помощи при устранении неполадок в приложении, вы можете использовать системы системного проекта Android с открытым исходным кодом (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
  %
  

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

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

Кожа

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

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

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

Создать AVD

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

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

    Появится окно «Выбор аппаратного обеспечения» .

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

  3. Выберите аппаратный профиль, затем нажмите Далее .

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

    Появляется окно изображения системы .

  4. Выберите изображение системы для определенного уровня API, а затем нажмите «Далее» .
  5. Появится окно проверки конфигурации .

  6. Измените свойства AVD по мере необходимости, а затем нажмите «Закончить» .

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

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

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

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

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

  2. Нажмите предыдущий , если вам нужно внести изменения в системном изображении или выберите аппаратные окна.
  3. Внесите любые изменения, которые вам нужны, а затем нажмите «Закончить» .

    AVD появляется на виртуальной вкладке диспетчера устройств.

Создать аппаратный профиль

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

You can define a new hardware profile from the beginning or copy a hardware profile as a starting point. The preloaded hardware profiles aren't editable.

To create a new hardware profile from the beginning:

  1. In the Select Hardware window, click New Hardware Profile .
  2. In the Configure Hardware Profile window, change the hardware profile properties as needed.

    The Configure hardware profile dialog
  3. Нажмите «Готово» .

    Your new hardware profile appears in the Select Hardware window. You can create an AVD that uses the hardware profile by clicking Next or click Cancel to return to the Virtual tab or target device menu.

To create a hardware profile using a copy as a starting point:

  1. In the Select Hardware window, select a hardware profile and click Clone Device or right-click a hardware profile and select Clone .

  2. In the Configure Hardware Profile window, change the hardware profile properties as needed.
  3. Нажмите «Готово» .
  4. Your new hardware profile appears in the Select Hardware window. You can create an AVD that uses the hardware profile by clicking Next or click Cancel to return to the Virtual tab or target device menu.

Edit existing AVDs

You can perform the following operations on an AVD from the Device Manager's Virtual tab:

  • To edit an AVD, click Edit this AVD and make your changes.
  • To delete an AVD, click Menuand select Delete .
  • To show the associated AVD INI and IMG files on disk, click Menuand select Show on Disk .
  • To view AVD configuration details that you can include in bug reports to the Android Studio team, click Menuand select View Details .

Edit existing hardware profiles

You can't edit or delete the preloaded hardware profiles, but you can perform the following operations on other hardware profiles from the Select Hardware window:

  • To edit a hardware profile, select it and click Edit Device . You can also right-click a hardware profile and select Edit . Next, make your changes.
  • To delete a hardware profile, right-click it and select Delete .

Run and stop an emulator and clear data

From the Virtual tab, you can perform the following operations on an emulator:

  • To run an emulator that uses an AVD, click Launch .
  • To stop a running emulator, click Menuand select Stop .
  • To clear the data for an emulator, click Menuand select Wipe Data .

Import and export hardware profiles

From the Select Hardware window, you can import and export hardware profiles as follows:

  • To import a hardware profile, click Import Hardware Profiles and select the XML file on your computer containing the definition.
  • To export a hardware profile, right-click it and select Export . Specify the location where you want to store the XML file containing the definition.

AVD properties

The AVD configuration specifies the interaction between the development computer and the emulator as well as properties you want to override in the hardware profile. You can specify the following properties for AVD configurations in the Verify Configuration window. The properties labeled (Advanced) are only displayed if you click Show Advanced Settings .

AVD configuration properties override hardware profile properties, and emulator properties that you set while the emulator is running override them both.

Table 1. AVD configuration properties

AVD property Описание
AVD Name Enter a name for the AVD. The name can contain uppercase or lowercase letters, numbers, periods, underscores, parentheses, dashes, and spaces. The name of the file storing the AVD configuration is derived from the AVD name.
AVD ID (Advanced) View the AVD ID. The AVD ID is derived from the AVD name. You can use the ID to refer to the AVD from the command line.
Hardware Profile Click Change to select a different hardware profile from the Select Hardware window.
Образ системы Click Change to select a different system image from the System Image window. An active internet connection is required to download a new image.
Startup orientation

Select an option for the initial emulator orientation:

  • Portrait: oriented taller than wide
  • Landscape: oriented wider than tall

An option is enabled only if it's supported in the hardware profile. When running the AVD in the emulator, you can change the orientation if both portrait and landscape are supported in the hardware profile.

Camera (Advanced)

Select an option for any enabled cameras. The Emulated and VirtualScene settings produce a software-generated image, while the Webcam setting uses your development computer's webcam to take a picture

Camera options are available only if a camera is supported in the hardware profile. They are not available for Wear OS, Android TV, or Google TV.

Network: Speed (Advanced)

Select a network protocol to determine the speed of data transfer:

  • GSM: Global System for Mobile Communications
  • HSCSD: High-Speed Circuit-Switched Data
  • GPRS: Generic Packet Radio Service
  • EDGE: Enhanced Data rates for GSM Evolution
  • UMTS: Universal Mobile Telecommunications System
  • HSDPA: High-Speed Downlink Packet Access
  • LTE: Long-Term Evolution
  • Full (default): Transfer data as quickly as your computer allows.
Network: Latency (Advanced) Select a network protocol to set how much time it takes for the protocol to transfer a data packet from one point to another point.
Emulated Performance: Graphics

Select how graphics are rendered in the emulator:

  • Hardware: use your computer graphics card for faster rendering.
  • Software: emulate the graphics in software, which is useful if you're having a problem with rendering in your graphics card.
  • Automatic: let the emulator decide the best option based on your graphics card.
Emulated Performance: Boot option (Advanced)

    Select how the AVD boots:

  • Cold boot: the device powers up each time from the device-off state.
  • Quick boot: the device loads the device state from a saved snapshot.
Emulated Performance: Multi-Core CPU (Advanced) Select the number of processor cores on your computer that you want to use for the emulator. Using more processor cores speeds up the emulator.
Memory and Storage: RAM (Advanced) Override the amount of RAM on the device set by the hardware manufacturer. Increasing the size uses more resources on your computer but supports faster emulator operation. Enter a RAM size and select the units, one of B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte), or TB (terabyte).
Memory and Storage: VM Heap (Advanced) Override the VM heap size set by the hardware manufacturer. Enter a heap size and select the units, one of B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte), or TB (terabyte).
Memory and Storage: Internal Storage (Advanced) Override the amount of non-removable memory space available on the device set by the hardware manufacturer. Enter a size and select the units, one of B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte), or TB (terabyte).
Memory and Storage: SD Card (Advanced)

Specify the amount of removable memory space available to store data on the device.

To use a virtual SD card managed by Android Studio, select Studio-managed , enter a size, and select the units, one of B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte), or TB (terabyte). A minimum of 100 MB is recommended to use the camera.

To manage the space in a file, select External file and click ... to specify the file and location.

For more information, see mksdcard and AVD data directory .

Device Frame: Enable Device Frame Select to enable a frame around the emulator window that mimics the look of a real device.
Custom Skin Definition (Advanced) Select a skin that controls what the device looks like when displayed in the emulator. Specifying a screen size that's too big for the skin can mean that the screen is cut off, so you can't see the whole screen. See the Create an emulator skin section for more information.
Keyboard: Enable Keyboard Input (Advanced) Select this option to use your hardware keyboard to interact with the emulator. This option is disabled for Wear OS and Android TV.

Hardware profile properties

You can specify the following properties for hardware profiles in the Configure Hardware Profile window. AVD configuration properties override hardware profile properties, and emulator properties that you set while the emulator is running override them both.

The predefined hardware profiles included with the Device Manager aren't editable. However, you can copy the profiles and edit the copies.

Some properties are disabled for some device types. For example, the "Round" property is only available on Wear OS devices.

Table 2. Hardware profile configuration properties

Hardware profile property Описание
Имя устройства Enter a name for the hardware profile. The name can contain uppercase or lowercase letters, numbers, periods, underscores, parentheses, and spaces. The name of the file storing the hardware profile is derived from the hardware profile name.
Тип устройства

Выберите один из следующих вариантов:

  • Телефон/планшет
  • Носить ОС
  • Андроид ТВ
  • Гугл ТВ
  • ChromeOS Device
  • Android Автомобильная промышленность
Screen: Screen Size Specify the physical size of the screen in inches, measured on the diagonal. If the size is larger than your computer screen, it's reduced in size at launch.
Screen: Screen Resolution Enter a width and height in pixels to specify the total number of pixels on the simulated screen.
Screen: Round Select this option if the device has a round screen, such as some Wear OS devices.
Memory: RAM Enter the RAM size of the device and select the units, one of B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte), or TB (terabyte).
Input: Has Hardware Buttons (Back/Home/Menu) Select this option if your device has hardware navigation buttons. Deselect it if these buttons are implemented in software only. If you select this option, the buttons don't appear on the screen. In either case, you can use the emulator side panel to simulate pressing the buttons.
Input: Has Hardware Keyboard Select this option if your device has a hardware keyboard. Deselect it if it doesn't. If you select this option, a keyboard doesn't appear on the screen. In either case, you can use your computer keyboard to send keystrokes to the emulator.
Input: Navigation Style

Выберите один из следующих вариантов:

  • None: no hardware controls. Navigation is through software.
  • D-pad: directional pad support.
  • Трекбол
  • Колесо

These options are for hardware controls on the device itself. However, the events sent to the device by an external controller are the same.

Supported device states

Select one or both options:

  • Portrait: oriented taller than wide
  • Landscape: oriented wider than tall

You must select at least one option. If you select both options, you can switch between orientations in the emulator.

Камеры

To enable the camera, select one or both options:

  • Back-Facing Camera: the lens facing away from the user
  • Front-Facing Camera: the lens facing the user

If the camera is enabled, you can use your development machine's webcam or a photo provided by the emulator to simulate taking a photo, based on the options you select in the AVD configuration.

Датчики: Акселерометр Select this option if the device has hardware that helps it determine its orientation.
Датчики: гироскоп Select this option if the device has hardware that detects rotation or twist. In combination with an accelerometer, a gyroscope can provide smoother orientation detection and support a six-axis orientation system.
Sensors: GPS Select this option if the device has hardware that supports the Global Positioning System (GPS) satellite-based navigation system.
Sensors: Proximity Sensor Select this option if the device has hardware that detects when the device is close to the user's face during a phone call to disable input from the screen.
Скин по умолчанию Select a skin that controls what the device looks like when displayed in the emulator. Specifying a screen size that's too big for the resolution can mean that the screen is cut off, so you can't see the whole screen. See the section that follows about creating an emulator skin for more information.

Create an emulator skin

An Android emulator skin is a collection of files that define the visual and control elements of an emulator display. If the skin definitions available in the AVD settings don't meet your requirements, you can create your own custom skin definition and then apply it to your AVD.

Each emulator skin contains:

  • A hardware.ini file
  • Layout files for supported orientations and physical configurations
  • Image files for display elements, such as background, keys, and buttons

To create and use a custom skin:

  1. Create a directory where you can save your skin configuration files.
  2. Define the visual appearance of the skin in a text file named layout . This file defines many characteristics of the skin, such as the size and image assets for specific buttons. Например:

    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. Add bitmap files of the device images to the same directory.
  4. Specify additional hardware-specific device configurations in an INI file for the device settings, such as hw.keyboard and hw.lcd.density .
  5. Archive the files in the skin folder and select the archive file as a custom skin.

For more detailed information about creating emulator skins, see the Android Emulator Skin File Specification in the tools source code.