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

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

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

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

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

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

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

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

Если ваше приложение объявляет элемент <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
  %
  

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

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. Нажмите «Готово» .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Свойства AVD

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

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

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

Свойства аппаратного профиля

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

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

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

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

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

Тема оформления эмулятора 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 в исходном коде инструментов.