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

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

Таблица 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 . Диспетчер устройств — это инструмент, который можно запустить из 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. При необходимости измените свойства 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 переопределяют свойства профиля оборудования, а свойства эмулятора, которые вы устанавливаете во время работы эмулятора, переопределяют их оба.

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