В состав Android SDK входит эмулятор Android-устройства — виртуальное устройство, работающее на вашем компьютере. Эмулятор Android позволяет разрабатывать и тестировать приложения для Android без использования физического устройства.
На этой странице описаны функции командной строки, которые можно использовать с эмулятором Android. Информацию об использовании пользовательского интерфейса эмулятора Android см. в разделе «Запуск приложений в эмуляторе Android» .
Запустите эмулятор
Используйте команду emulator для запуска эмулятора, это альтернатива запуску вашего проекта или запуску его через AVD Manager .
Вот базовый синтаксис командной строки для запуска виртуального устройства из терминала:
emulator -avd avd_name [ {-option [value]} … ]
Или
emulator @avd_name [ {-option [value]} … ]
Например, если вы запустите эмулятор из Android Studio, работающей на Mac, стандартная командная строка будет выглядеть примерно так:
/Users/janedoe/Library/Android/sdk/emulator/emulator -avd Pixel8_API_34 -netdelay none -netspeed full -qt-hide-window -grpc-use-token -idle-grpc-timeout
Обратите внимание, что аргументы -qt-hide-window -grpc-use-token -idle-grpc-timeout используются только для запуска окна эмулятора в Android Studio. Если вы хотите запустить эмулятор в отдельном окне, не используйте эти дополнительные параметры.
Вы можете указать параметры запуска при запуске эмулятора, но не после его запуска.
Чтобы получить список имен AVD, введите следующую команду:
emulator -list-avds
Используйте эту опцию для отображения списка имен AVD из домашнего каталога Android. Вы можете переопределить домашний каталог по умолчанию, установив переменную среды ANDROID_SDK_HOME , которая указывает корневой каталог пользователя, где хранится вся конфигурация и содержимое AVD.
Вы можете установить переменную среды в окне терминала перед запуском виртуального устройства или через пользовательские настройки в операционной системе. Например, в файле .bashrc в Linux.
Чтобы остановить эмулятор Android, закройте окно эмулятора.
Установите приложение
Помимо установки приложения через Android Studio или пользовательский интерфейс эмулятора , вы можете установить приложение на виртуальное устройство, используя утилиту adb .
Чтобы использовать adb для установки, запуска и тестирования вашего приложения, выполните следующие общие шаги:
- Соберите и упакуйте ваше приложение в APK-файл, как описано в разделе «Сборка и запуск приложения» .
- Запустите эмулятор из командной строки, как описано в предыдущем разделе, используя все необходимые параметры запуска.
- Установите приложение с помощью
adb. - Запустите и протестируйте свое приложение на эмуляторе.
Во время работы эмулятора вы можете использовать консоль эмулятора для выполнения необходимых команд.
Чтобы удалить приложение, сделайте это так же, как и на устройстве Android.
Виртуальное устройство сохраняет приложение и данные о его состоянии после перезапусков в разделе пользовательских данных на диске ( userdata-qemu.img ). Чтобы очистить эти данные, запустите эмулятор с параметром -wipe-data или очистите данные в диспетчере AVD. Дополнительную информацию о разделе пользовательских данных и других хранилищах см. в следующем разделе.
Примечание: Утилита adb рассматривает виртуальное устройство как реальное физическое устройство. По этой причине вам может потребоваться использовать флаг -d с некоторыми распространенными командами adb , такими как install . Флаг -d позволяет указать, какое из нескольких подключенных устройств использовать в качестве цели команды. Если вы не укажете -d , эмулятор выберет первое устройство в своем списке.
Разберитесь с каталогами и файлами по умолчанию.
Эмулятор использует связанные файлы, из которых наиболее важными являются системный и файловый каталоги AVD. Понимание структуры каталогов и файлов эмулятора полезно при указании параметров командной строки, хотя обычно нет необходимости изменять каталоги или файлы по умолчанию.
Эмулятор Android использует гипервизор ( QEMU ).
Системный каталог AVD
В системном каталоге находятся образы системы Android, которые эмулятор использует для имитации операционной системы. В этом каталоге находятся файлы, доступные только для чтения и специфичные для каждой платформы, используемые всеми AVD одного типа, включая файлы уровня API, архитектуры процессора и варианта Android. Расположение файлов по умолчанию следующее:
- macOS и Linux -
~/Library/Android/sdk/system-images/android- apiLevel / variant / arch / - Windows -
C:\Users\ user \Library\Android\sdk\system-images\android- apiLevel \ variant \ arch \
Где:
-
apiLevel— это числовой уровень API или буква для предварительных версий. Например,android-Vобозначает предварительную версию Android VanillaIceCream. После выпуска он стал уровнем API 35, обозначенным какandroid-35. -
variant— это имя, соответствующее конкретным функциям, реализованным в образе системы. Например,google_apisилиandroid-wear. -
arch— это целевая архитектура процессора. Например,x86.
Используйте параметр -sysdir , чтобы указать другой системный каталог для AVD.
Эмулятор считывает следующие файлы из системного каталога:
Таблица 1. Файлы системного каталога, считываемые эмулятором Android.
| Файл | Описание | Возможность указать другой файл |
|---|---|---|
kernel-qemu или kernel-ranchu | Двоичный образ ядра для AVD. kernel-ranchu основан на эмуляторе QEMU. | -kernel |
ramdisk.img | Образ загрузочного раздела. Это подмножество файла system.img , загружаемое ядром изначально, до монтирования образа системы. Обычно он содержит всего несколько исполняемых файлов и скриптов инициализации. | -ramdisk |
system.img | Исходная версия образа системы, доступная только для чтения. В частности, это раздел, содержащий системные библиотеки и данные, соответствующие уровню и варианту API. | -system |
userdata.img | Начальная версия раздела данных, который отображается как data/ в эмулируемой системе и содержит все доступные для записи данные для AVD. Эмулятор использует этот файл при создании нового AVD или при использовании опции ‑wipe-data . Для получения дополнительной информации см. описание файла userdata-qemu.img в следующем разделе. | -initdata-init-data |
Каталог данных AVD
Каталог данных AVD, также называемый каталогом содержимого, является специфическим для конкретного экземпляра AVD и содержит все изменяемые данные для этого AVD.
Местоположение по умолчанию следующее, где name — это имя AVD:
- macOS и Linux -
~/.android/avd/ name .avd/ - Windows 10 и выше -
C:\Users\ user \.android\ name .avd\
Используйте параметр -datadir , чтобы указать другой каталог данных AVD.
В таблице ниже перечислены наиболее важные файлы, содержащиеся в этом каталоге:
Таблица 2. Важные файлы в каталоге данных AVD.
| Файл | Описание | Возможность указать другой файл |
|---|---|---|
userdata-qemu.img | Содержимое раздела данных, который в эмулируемой системе отображается как Каждый экземпляр виртуального устройства использует записываемый образ пользовательских данных для хранения данных, специфичных для пользователя и сессии. Например, он использует образ для хранения данных об установленных приложениях, настройках, базах данных и файлах уникального пользователя. У каждого пользователя есть свой каталог | -data |
cache.img | Образ раздела кэша, который отображается в эмулируемой системе как cache/ . Он пуст при первом создании AVD или использовании параметра -wipe-data . В нем хранятся временные файлы для загрузки, и он заполняется менеджером загрузок, а иногда и самой системой. Например, браузер использует его для кэширования загруженных веб-страниц и изображений во время работы эмулятора. При выключении виртуального устройства файл удаляется. Вы можете сохранить файл, используя параметр -cache . | -cache |
sdcard.img | (Необязательно) Образ раздела SD-карты, позволяющий имитировать SD-карту на виртуальном устройстве. Вы можете создать файл образа SD-карты в AVD Manager или с помощью инструмента При определении AVD в диспетчере AVD можно выбрать использование автоматически управляемого файла SD-карты или файла, созданного с помощью инструмента Вы можете просматривать, отправлять и удалять файлы с имитированной SD-карты, используя пользовательский интерфейс эмулятора или утилиту Чтобы скопировать файлы на SD-карту перед загрузкой, смонтируйте образ как циклическое устройство, а затем скопируйте файлы. Или используйте утилиту, например, пакет Эмулятор рассматривает файл как набор байтов, поэтому формат SD-карты не имеет значения. Параметр | -sdcard |
Список каталогов и файлов, используемых эмулятором.
Узнать местоположение файлов можно двумя способами:
- При запуске эмулятора из командной строки используйте параметр
-debug init-verboseили -debug. Посмотрите на вывод. - Используйте команду
-help- optionemulator, чтобы вывести список каталогов по умолчанию. Например:emulator -help-datadir
Use '-datadir <dir>' to specify a directory where writable image files will be searched. On this system, the default directory is: /Users/me/.android See '-help-disk-images' for more information about disk image files.
Параметры запуска из командной строки
В этом разделе перечислены параметры, которые можно указать в командной строке при запуске эмулятора.
Примечание: Эмулятор Android постоянно находится в разработке для повышения его надежности. Для получения информации о проблемах, связанных с различными параметрами командной строки, и для сообщения об ошибках, см. систему отслеживания ошибок Android .
Часто используемые варианты
В таблице ниже перечислены параметры запуска командной строки, которые вы, возможно, будете использовать чаще всего:
Таблица 3. Часто используемые параметры командной строки.
| Параметр командной строки | Описание |
|---|---|
| Быстрая загрузка | |
-no-snapshot-load | Выполняет холодную перезагрузку и сохраняет состояние эмулятора при выходе. |
-no-snapshot-save | При возможности выполняет быструю загрузку, но не сохраняет состояние эмулятора при выходе. |
-no-snapshot | Полностью отключает функцию быстрой загрузки и не загружает и не сохраняет состояние эмулятора. |
| Аппаратное обеспечение устройства | |
-camera-back mode-camera-front mode | Задает режим эмуляции для камеры, направленной назад или вперед. Это переопределяет любые настройки камеры в AVD.
Например: emulator @Pixel8_API_34 -camera-back webcam0 |
-webcam-list | Отображает список веб-камер на вашем компьютере для разработки, доступных для эмуляции. Например:emulator @Pixel8_API_34 -webcam-list
List of web cameras connected to the computer:
Camera 'webcam0' is connected to device 'webcam0'
on channel 0 using pixel format 'UYVY' В примере первая Начиная с версии SDK Tools 25.2.4, требуется указать имя AVD. |
| Образы дисков и память | |
-memory size | Указывает физический размер оперативной памяти, от 1536 до 8192 МБ. Например: emulator @Pixel8_API_34 -memory 2048 Это значение переопределяет настройку AVD. |
-sdcard filepath | Указывает имя файла и путь к образу раздела SD-карты. Например: emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img Если файл не найден, эмулятор всё равно запустится, но без SD-карты. Команда выдаст предупреждение « Нет образа SD-карты» . Если вы не укажете этот параметр, по умолчанию будет использоваться файл |
-wipe-data | Удаляет пользовательские данные и копирует данные из исходного файла данных. Эта опция очищает данные для виртуального устройства и возвращает его в то же состояние, в котором оно было определено изначально. Все установленные приложения и настройки удаляются. Например:emulator @Pixel8_API_34 -wipe-data По умолчанию файл пользовательских данных называется |
| Отлаживать | |
-debug tags | Включает или отключает отображение отладочных сообщений для одного или нескольких тегов. Разделяйте несколько тегов пробелом, запятой или столбцом. Например:$ emulator @Pixel8_API_34 -debug init,metrics Чтобы отключить тег, поставьте перед ним дефис (-). Например, следующая опция отображает все отладочные сообщения, кроме тех, которые относятся к сетевым сокетам и метрикам: Для получения списка тегов и описаний используйте параметр emulator -help-debug-tags Вы можете определить теги отладки по умолчанию в переменной среды ANDROID_VERBOSE=socket,gles Это эквивалентно использованию: или |
-debug- tag-debug-no- tag | Включает определенный тип отладочных сообщений. Используйте форму no , чтобы отключить определенный тип отладочных сообщений. Например:emulator @Pixel8_API_34 -debug-all -debug-no-metrics Для получения списка тегов используйте команду |
-logcat logtags | Включает отображение сообщений Logcat для одного или нескольких тегов и записывает их в окно терминала. Например, следующая команда включает сообщения об ошибках от всех компонентов:emulator @Pixel8_API_34 -logcat *:e
В следующем примере отображаются сообщения компонентов GSM на уровне информативного журнала: emulator @Pixel8_API_34 -logcat '*:s GSM:i' Если вы не укажете параметр Для получения дополнительной информации о Logcat и |
-show-kernel | Отображает отладочные сообщения ядра в окне терминала. Например:emulator @Pixel8_API_34 -show-kernel Одно из применений этой опции — проверка корректности процесса загрузки. |
-verbose | Выводит сообщения об инициализации эмулятора в окно терминала. Например:emulator @Pixel8_API_34 -verbose Эта опция отображает, какие файлы и настройки фактически выбраны при запуске виртуального устройства, определенного в AVD. Эта опция аналогична указанию параметра |
| Сеть | |
-dns-server servers | Использует указанные DNS-серверы. servers — это список из четырех имен DNS-серверов или IP-адресов, разделенных запятыми. Например:emulator @Pixel8_API_34 -dns-server 192.0.2.0, По умолчанию эмулятор пытается определить используемые вами DNS-серверы и создает специальные псевдонимы в эмулируемой сети брандмауэра, чтобы разрешить системе Android напрямую подключаться к этим серверам. Используйте параметр |
-http-proxy proxy | Устанавливает все TCP-соединения через указанный HTTP/HTTPS-прокси. Если вашему эмулятору необходимо получать доступ к интернету через прокси-сервер, вы можете использовать эту опцию или переменную среды http_proxy для настройки соответствующего перенаправления. Например:emulator @Pixel8_API_34 -http-proxy myserver:1981
Префикс Если этот параметр не указан, эмулятор ищет переменную среды Примечание: При запуске нескольких эмуляторов этот флаг следует установить при первом запуске. |
-netdelay delay | Устанавливает эмуляцию задержки сети на одно из следующих значений
Например: emulator @Pixel8_API_34 -netdelay gsm Эмулятор поддерживает ограничение скорости сети, а также более высокие задержки соединения. Это можно определить либо через конфигурацию темы оформления, либо с помощью параметров Примечание: Этот параметр применяется к сетям Ethernet и сотовой связи. |
-netfast | Отключает ограничение скорости сети. Например:emulator @Pixel8_API_34 -netfast Этот параметр аналогичен параметрам Примечание: Этот параметр применяется к сетям Ethernet и сотовой связи. |
-netspeed speed | Задает параметры эмуляции скорости сети. Указывает максимальную скорость загрузки и выгрузки данных в сети, используя одно из следующих значений
Например: emulator @Pixel8_API_34 -netspeed edge Эмулятор поддерживает ограничение скорости сети, а также более высокие задержки соединения. Это можно определить либо через конфигурацию темы оформления, либо с помощью параметров Примечание: Этот параметр применяется к сетям Ethernet и сотовой связи. |
-netsim-args arguments | Передает дополнительные аргументы сетевому симулятору ( netsim ). arguments — это список флагов, разделённых пробелами.Например, чтобы включить захват пакетов и перенаправить запись логов в stderr: emulator @Pixel8_API_34 -netsim-args="--pcap --logtostderr" Для получения более подробной информации см. раздел «Расширенные сетевые возможности эмулятора» . |
-port port | Задает номер TCP-порта, используемого для консоли и adb . Например:emulator @Pixel8_API_34 -port 5556 Значение по умолчанию для первого экземпляра виртуального устройства, запущенного на вашем компьютере, равно 5554. Виртуальное устройство обычно занимает пару смежных портов: консольный порт и порт Назначение портов часто аналогично указанию Параметр Обратите внимание, что если значение |
-ports | Задает TCP-порты, используемые для консоли и adb . Например:emulator @Pixel8_API_34 -ports 5556,5559 Допустимый диапазон портов — от 5554 до 5682, что позволяет одновременно использовать 64 виртуальных устройства. Опция Мы рекомендуем по возможности использовать параметр Для получения дополнительной информации о настройке портов консоли и |
-tcpdump filepath | Захватывает сетевые пакеты и сохраняет их в файл. Например:emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap Используйте эту опцию, чтобы начать захват всех сетевых пакетов, передаваемых через виртуальную сеть Ethernet эмулятора. После этого вы можете использовать такой инструмент, как Wireshark, для анализа трафика. Обратите внимание, что этот параметр перехватывает все пакеты Ethernet и не ограничивается только TCP-соединениями. |
| Система | |
-accel mode | Настраивает ускорение виртуальной машины эмулятора. Например:emulator @Pixel8_API_34 -accel auto Ускоренная эмуляция работает только для образов систем x86 и x86_64. В Linux она использует KVM. В Windows и Mac она использует процессор Intel и драйвер Intel HAXM. Этот параметр игнорируется, если вы не эмулируете устройство x86 или x86_64. Допустимые значения для
Для получения дополнительной информации см. раздел «Настройка аппаратного ускорения для эмулятора Android» . |
-accel-check | Проверяет, установлен ли необходимый гипервизор для ускорения работы виртуальной машины эмулятора (HAXM или KVM). Например:emulator -accel-check Для получения дополнительной информации см. раздел «Проверка наличия установленного гипервизора» . |
-engine engine | Указывает используемый эмулятор:
Например: emulator @Pixel8_API_34 -engine auto Автоматическое определение должно выбирать значение, обеспечивающее наилучшую производительность при эмуляции конкретного AVD. Используйте параметр |
-gpu mode | Выбирает режим эмуляции графического процессора. Например:emulator @Pixel8_API_34 -gpu swiftshader_indirect Для получения дополнительной информации см. раздел «Настройка графического ускорения» . |
-no-accel | Отключает ускорение виртуальной машины эмулятора при использовании образа системы x86 или x86_64. Это полезно только для отладки и аналогично указанию параметра -accel off . Например:emulator @Pixel8_API_34 -no-accel Для получения дополнительной информации см. раздел «Настройка аппаратного ускорения для эмулятора Android» . |
-nojni-no-jni | Отключает расширенные проверки Java Native Interface (JNI) в среде выполнения Android Dalvik или ART. Например:emulator @Pixel8_API_34 -nojni При запуске виртуального устройства расширенные проверки JNI включены по умолчанию. Для получения дополнительной информации см. раздел «Советы по JNI» . |
-selinux {disabled|permissive} | Устанавливает модуль безопасности Security-Enhanced Linux ( SELinux ) в режим disabled или permissive в операционной системе Linux. Например:me-linux$ emulator @Pixel8_API_34 -selinux permissive По умолчанию SELinux находится в режиме |
-timezone timezone | Устанавливает часовой пояс для виртуального устройства вместо emulator @Pixel8_API_34 -timezone Europe/Paris По умолчанию эмулятор использует часовой пояс вашего компьютера для разработки. Используйте эту опцию, чтобы указать другой часовой пояс или если автоматическое определение работает некорректно. Значение
Указанный часовой пояс должен быть в базе данных zoneinfo . |
-version | Отображает номер версии эмулятора. Например:emulator @Pixel8_API_34 -version Или emulator -version |
| UI | |
-no-boot-anim | Отключает анимацию загрузки при запуске эмулятора для более быстрой загрузки. Например:emulator @Pixel8_API_34 -no-boot-anim На более медленных компьютерах эта опция может значительно ускорить процесс загрузки. |
-screen mode | Задает режим эмуляции сенсорного экрана. Например:emulator @Pixel8_API_34 -screen no-touch
|
Расширенные параметры
Параметры запуска из командной строки, представленные в следующей таблице, доступны, но редко используются обычным разработчиком приложений.
В описаниях под рабочим каталогом понимается текущий каталог в терминале, где вы вводите команды. Информацию о системном каталоге AVD и каталоге данных, а также о файлах, хранящихся в них, см. в разделе о каталогах и файлах по умолчанию .
Некоторые из этих вариантов подходят для сторонних разработчиков приложений, а некоторые используются преимущественно разработчиками платформ. Разработчики приложений создают приложения для Android и запускают их на определенных AVD. Разработчики платформ работают с системой Android и запускают ее внутри эмулятора без предварительно созданного AVD.
Таблица 4. Расширенные параметры командной строки
| Расширенные параметры | Краткое описание |
|---|---|
-bootchart timeout | Включает функцию загрузки с указанием времени ожидания в секундах. Некоторые образы системы Android имеют модифицированную систему инициализации, которая включает в себя функцию загрузки. С помощью этой опции вы можете передать системе период ожидания загрузки. Если в вашей системе инициализации функция загрузки не активирована, эта опция ничего не делает. Эта опция в первую очередь полезна разработчикам платформы, а не разработчикам сторонних приложений. Например: emulator @Pixel8_API_34 -bootchart 120 |
-cache filepath | Указывает файл образа раздела кэша. Предоставляет имя файла и абсолютный путь или путь относительно каталога данных для настройки файла постоянного кэша. Если файл не существует, эмулятор создаст его как пустой файл. Например: emulator @Pixel8_API_34 -cache ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img Если вы не используете эту опцию, по умолчанию будет создан временный файл с именем |
-cache-size size | Задает размер раздела кэша в МБ. Например: emulator @Pixel8_API_34 -cache-size 1000 Если этот параметр не указан, значение по умолчанию составляет 66 МБ. Обычно большинству разработчиков приложений этот параметр не нужен, за исключением случаев, когда им необходимо загружать очень большие файлы, превышающие размер кэша по умолчанию. Для получения дополнительной информации о файле кэша см. раздел «Каталог данных AVD» . |
-data filepath | Задает образ файла раздела пользовательских данных. Укажите имя файла и абсолютный путь или путь относительно рабочего каталога для создания постоянного файла пользовательских данных. Если файл не существует, эмулятор создает образ из файла Например: emulator @Pixel8_API_34 -data ~/.android/avd/Pixel8_API_34.avd/userdata-test.img Если вы не используете эту опцию, по умолчанию будет создан файл с именем |
-datadir dir | Указывает каталог данных, используя абсолютный путь. Для получения дополнительной информации см. раздел «Каталог данных AVD» . Например: emulator @Pixel8_API_34 -datadir ~/.android/avd/Pixel8_API_34.avd/mytest |
-force-32bit | Использует 32-битный эмулятор на 64-битных платформах. Иногда эта опция полезна для тестирования или отладки. Например, возникла проблема, когда эмулятор иногда не запускался на 64-битной Windows, но работал на 32-битной. Эта опция помогла провести сравнения для отладки проблемы. Вот пример: emulator @Pixel8_API_34 -force-32bit |
-help-disk-images | Получает справку об образах дисков. Эта опция предоставляет информацию, актуальную как для разработчиков приложений, так и для разработчиков платформ. Например: emulator -help-disk-images |
-help-char-devices | Получает справку по спецификациям символьного emulator -help-char-devices |
-help-sdk-images | Получает справку по образам дисков, важным для разработчиков приложений. Эта опция получает информацию о местоположении файлов образов для AVD, созданного с помощью инструментов SDK. Например: emulator -help-sdk-images |
-help-build-images | Предоставляет справку по образам дисков, актуальным для разработчиков платформы. Например: emulator -help-build-images |
-initdata filepath-init-data filepath | Указывает начальную версию раздела данных. После удаления пользовательских данных эмулятор копирует содержимое указанного файла в пользовательские данные (по умолчанию, файл Например: emulator @Pixel8_API_34 -initdata ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/userdata-test.img Если путь не указан, файл будет помещен в системный каталог. Дополнительную информацию см. в разделе «Системный каталог AVD» . |
-kernel filepath | Использует конкретное эмулируемое ядро. Если путь не указан, эмулятор будет искать его в системном каталоге. Используйте параметр‑show‑kernel для просмотра отладочных сообщений ядра.Например: emulator @Pixel8_API_34 -kernel ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/kernel-test.img -show-kernel Если этот параметр не указан, по умолчанию используется |
-noaudio-no-audio | Отключает поддержку звука для этого виртуального устройства. На некоторых компьютерах под управлением Linux и Windows установлены неисправные аудиодрайверы, вызывающие различные симптомы, например, препятствующие запуску эмулятора. В этом случае используйте этот параметр для решения проблемы. В качестве альтернативы можно использовать переменную среды Например: emulator @Pixel8_API_34 -noaudio |
-nocache-no-cache | Запускает эмулятор без раздела кэша. Если вы не используете этот параметр, по умолчанию используется временный файл с именем Например: emulator @Pixel8_API_34 -nocache |
-no-snapshot | Запрещает как автоматическую загрузку, так и сохранение, в результате чего эмулятор выполнит полную последовательность загрузки и потеряет свое состояние при закрытии. Он переопределяет параметр Например: emulator @Pixel8_API_34 -no-snapshot |
-no-snapshot-load | Предотвращает загрузку эмулятором состояния AVD из хранилища снимков. Выполняет полную загрузку. Например: emulator @Pixel8_API_34 -no-snapshot-load |
-no-snapshot-save | Предотвращает сохранение эмулятором состояния AVD в хранилище снимков при выходе, что означает потерю всех изменений. Например: emulator @Pixel8_API_34 -no-snapshot-save |
-no-snapshot-update-time | Не пытается немедленно скорректировать время на часах AVD при восстановлении снимка. Эта опция может быть полезна во время тестирования, поскольку позволяет избежать резкого скачка времени. Обновления времени по-прежнему отправляются на AVD примерно каждые 15 секунд. Например: emulator @Pixel8_API_34 -no-snapshot-update-time |
-no-snapstorage | Запускает эмулятор без монтирования файла для хранения или загрузки снимков состояния, принудительно выполняя полную загрузку и отключая функциональность создания снимков состояния. Этот параметр переопределяет параметры Например: emulator @Pixel8_API_34 -no-snapstorage |
-no-window | Отключает отображение графического окна в эмуляторе. Эта опция полезна при запуске эмулятора на серверах, не имеющих дисплея. Доступ к эмулятору можно получить через emulator @Pixel8_API_34 -no-window |
-partition-size size | Указывает размер системного раздела данных в МБ. Например: emulator @Pixel8_API_34 -partition-size 1024 |
-prop name = value | Устанавливает системное свойство Android в эмуляторе при его загрузке. emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args | Передает аргументы программному обеспечению эмулятора QEMU. При использовании этой опции убедитесь, что она указана последней, поскольку все последующие опции интерпретируются как специфические для QEMU. Эта опция довольно сложная и должна использоваться только разработчиками, хорошо знакомыми с QEMU и эмуляцией Android. |
-qemu -h | Отображает справку emulator -qemu -h |
-ramdisk filepath | Указывает образ загрузочного диска в оперативной памяти. Указывает имя файла и абсолютный путь или путь относительно рабочего каталога. Например: emulator @Pixel8_API_34 -ramdisk ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/ramdisk-test.img Если вы не используете этот параметр, по умолчанию будет использоваться файл |
-report-console socket | Перед началом эмуляции сообщает удаленной третьей стороне порт консоли. Это может быть полезно для скрипта автоматизированного тестирования.
Для получения дополнительной информации используйте параметр |
-shell | Создает консоль с правами root на текущем терминале. Этот параметр отличается от команды
Например: emulator @Pixel8_API_34 -shell |
-snapshot name | Указывает имя снимка в файле хранилища снимков для автоматического запуска и сохранения. Вместо выполнения полной последовательности загрузки эмулятор может возобновить выполнение с более раннего снимка состояния, что обычно значительно быстрее. Если вы укажете этот параметр, эмулятор загрузит снимок с указанным именем из образа снимка и сохранит его обратно под тем же именем при завершении работы. Если вы не используете эту опцию, по умолчанию выполняется полная загрузка системы. Если указанный снимок не существует, эмулятор вместо этого выполняет полную загрузку системы и операцию сохранения. Информацию о том, как указать файл хранилища моментальных снимков и файл по умолчанию, см. в описании параметра emulator @Pixel8_API_34 -snapshot snapshot2 Помните, что в процессе загрузки снимка все содержимое системы, пользовательские данные и образы SD-карт перезаписываются содержимым, которое они содержали на момент создания снимка. Если вы не сохраните эту информацию в другом снимке, все изменения, внесенные с тех пор, будут потеряны. Вы также можете создать снимок из консоли эмулятора, используя команду ` |
-snapshot-list | Отображает список доступных снимков. Эта команда выводит таблицу снимков, хранящихся в файле хранилища снимков, с которым был запущен эмулятор, а затем завершает работу. Если вы также укажете Например: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img Значения столбцов ID и TAG из выходных данных можно использовать в качестве аргументов для параметра |
-snapstorage filepath | Указывает файл репозитория, содержащий все снимки состояния. Все снимки, сделанные во время выполнения, сохраняются в этом файле. Восстановить во время работы эмулятора можно только снимки из этого файла. Например: emulator @Pixel8_API_34 -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img If you don't specify this option, the default is |
-sysdir dir | Specifies a system directory using an absolute path. For more information, see AVD system directory . For example: emulator @Pixel8_API_34 -sysdir ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/test |
-system filepath | Specifies an initial system file. Provides the filename and an absolute path or a path relative to the working directory. Например: emulator @Pixel8_API_34 -system ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/system-test.img If you don't use this option, the default is the |
-writable-system | Use this option to have a writable system image during your emulation session. To do so:
Using this flag creates a temporary copy of the system image that can be very large, up to several hundred MBs, but will be destroyed when the emulator exits. |
Deprecated options
The following command-line options are deprecated:
-
-audio-in -
-audio-out -
-charmap -
-code-profile -
-cpu-delay -
-dpi-device -
-dynamic_skin -
-enable-kvm -
-gps -
-image -
-keyset -
-help-keys -
-help-keyset-file -
-nand-limits -
-noskin -
-no-skin -
-onion -
-onion-alpha -
-onion-rotation -
-radio -
-ranchu -
-raw-keys -
-scale -
-shared-net-id -
-shell-serial -
-skin -
-skindir -
-trace -
-useaudio
Get help about command-line options
This section describes how to get help about the command-line options. It provides more in-depth information about the commonly used emulator command-line options that are available when you start the emulator.
List all emulator options
To print a list of all emulator options, including a short description, enter the following command:
emulator -help
Get detailed help for a specific option
To print help for a specific startup option, enter the following command:
emulator -help-option
Например:
emulator -help-netspeed
This help is more detailed than the description provided by the -help option.
Get detailed help for all options
To get detailed help for all emulator options, enter the following command:
emulator -help-all
List emulator environment variables
To get a list of emulator environment variables, enter the following command:
emulator -help-environment
You can set environment variables in the terminal window before launching a virtual device, or you can set it through your user settings in the operating system. For example, set it in your .bashrc file on Linux.
List debug tags
To print a list of tags for the -debug options, enter the following command:
emulator -help-debug-tags
The -debug options let you enable or disable debug messages from specific emulator components, as specified by the tags.