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

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

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

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

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

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

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

О AVD

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Кожа

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

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

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

Создать AVD

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

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

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

   

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Свойства АВД

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

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

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

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

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

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

Некоторые свойства отключены для некоторых типов устройств. Например, свойство "Round" доступно только на устройствах 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 в исходном коде инструментов.

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

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

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

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

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

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

О AVD

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Кожа

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

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

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

Создать AVD

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

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

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

   

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Свойства АВД

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

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

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

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

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

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

Некоторые свойства отключены для некоторых типов устройств. Например, свойство «круглый» доступна только на устройствах 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 эмулятора в исходном коде инструментов.

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

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

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

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

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

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

Об AVDS

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

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

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

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

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

Устройства с этим логотипом и типом устройства «телефона» также соответствуют 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. Измените свойства AVD по мере необходимости, а затем нажмите « Закончить» .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ваш новый аппаратный профиль появляется в окне «Выбор аппаратного обеспечения» . Вы можете создать 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 переопределяют свойства профиля оборудования и свойства эмулятора, которые вы устанавливаете, когда эмулятор работает от переопределения их обоих.

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

Некоторые свойства отключены для некоторых типов устройств. Например, свойство «круглый» доступна только на устройствах 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 эмулятора в исходном коде инструментов.