从命令行启动模拟器

数据分区的內容，在模拟系统中显示为 data/。当您创建新的 AVD 或使用 -wipe-data 选项将 AVD 重置为出厂默认值时，模拟器会复制系统目录中的 userdata.img 文件来创建此文件。

每个虚拟设备实例都使用可写的用户数据映像来存储用户和特定于会话的数据。例如，它使用该映像来存储唯一用户的已安装应用数据、设置、数据库和文件。每个用户都有一个不同的 ANDROID_SDK_HOME 目录，用于存储该用户创建的 AVD 的数据目录。每个 AVD 都有一个 userdata-qemu.img 文件。

(可选) SD 卡分区映像，允许您在虚拟设备上模拟 SD 卡。您可以在 AVD 管理器 中或使用 mksdcard 工具创建 SD 卡映像文件。该文件存储在您的开发计算机上，必须在启动时加载。

在 AVD 管理器中定义 AVD 时，您可以选择使用自动管理的 SD 卡文件或使用 mksdcard 工具创建的文件。您可以在 AVD 管理器中查看与 AVD 关联的 sdcard.img 文件。-sdcard 选项会覆盖 AVD 中指定的 SD 卡文件。请注意，此 SD 卡选项在使用 Apple Silicon 的 Mac 上不起作用。

在虚拟设备运行时，您可以使用模拟器 UI 或 adb 实用程序浏览、向模拟 SD 卡发送文件以及从模拟 SD 卡复制和删除文件。您无法从正在运行的虚拟设备中删除模拟 SD 卡。

要加载之前将文件复制到 SD 卡文件，请将映像文件安装为循环设备，然后复制文件。或者，使用实用程序（例如 mtools 包）将文件直接复制到映像。

模拟器将文件视为字节池，因此 SD 卡格式无关紧要。

`-wipe-data` 选项不影响此文件。如果要清除文件，请删除该文件，然后使用 AVD 管理器或 `mksdcard` 工具重新创建它。更改文件大小也会删除文件并创建一个新文件。

`mode` 可以是以下任何值

• `emulated` - 模拟器在软件中模拟摄像头。
• `webcamn` - 模拟器使用连接到开发计算机的网络摄像头，由数字指定。要获取网络摄像头的列表，请使用 `-webcam-list` 选项。例如，`webcam0`。
• `none` - 禁用虚拟设备中的摄像头。

例如

emulator @Pixel8_API_34 -camera-back webcam0

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'

在此示例中，第一个 `webcam0` 是您在命令行中使用的名称。第二个 `webcam0` 是开发计算机操作系统使用的名称。第二个名称因操作系统而异。

从 SDK 工具 25.2.4 开始，需要 AVD 名称。

指定物理 RAM 大小，范围为 1536 到 8192 MB。例如

emulator @Pixel8_API_34 -memory 2048

此值将覆盖 AVD 设置。

emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img

如果找不到该文件，模拟器仍会启动，但没有 SD 卡。命令将返回 **无 SD 卡映像** 警告。

如果不指定此选项，除非 AVD 指定其他内容，否则默认值为数据目录中的 `sdcard.img`。有关模拟 SD 卡的详细信息，请参阅AVD 数据目录。

emulator @Pixel8_API_34 -wipe-data

默认情况下，用户数据文件为 `userdata-qemu.img`，初始数据文件为 `userdata.img`。这两个文件都位于数据目录中。`-wipe-data` 选项不影响 `sdcard.img` 文件。有关用户数据的更多信息，请参阅名为了解默认目录和文件的部分。

$ emulator @Pixel8_API_34 -debug init,metrics

要禁用标签，请在其前面放置一个短横线 (-)。例如，以下选项显示所有调试消息，但与网络套接字和指标相关的消息除外

-debug all,-socket,-metrics

要获取标签和说明的列表，请使用 `-help-debug-tags` 选项。例如

emulator -help-debug-tags

您可以在ANDROID_VERBOSE环境变量中定义默认调试标签。在逗号分隔的列表中定义要使用的标签。以下示例显示如何指定 `socket` 和 `gles` 标签

ANDROID_VERBOSE=socket,gles

它等效于使用

-debug-socket -debug-gles

或

-debug socket,gles

emulator @Pixel8_API_34 -debug-all -debug-no-metrics

要获取标签列表，请使用 `emulator -help-debug-tags` 命令。

emulator @Pixel8_API_34 -logcat *:e

`logtags` 使用与 `adb logcat logtags` 命令相同的格式。输入 `adb logcat -help` 以获取更多信息。它是一个空格或逗号分隔的日志筛选器列表，格式为 `componentName:logLevel`。`componentName` 可以是通配符星号 (*) 或组件名称，例如 `ActivityManager`、`SystemServer`、`InputManager` 或 `WindowManager`。

`logLevel` 是以下值之一

• `v` - 详细
• `d` - 调试
• `i` - 信息
• `w` - 警告日志级别
• `e` - 错误
• `s` - 静默

以下示例以信息日志级别显示 GSM 组件消息

emulator @Pixel8_API_34 -logcat '*:s GSM:i'

如果在命令行上不提供 `-logcat` 选项，则模拟器会查找ANDROID_LOG_TAGS环境变量。如果 `ANDROID_LOG_TAGS` 使用有效的 `logtags` 值定义并且不为空，则模拟器会默认使用其值将 Logcat 输出启用到终端。您也可以通过 `adb` 将相同或其他日志消息重定向到终端。

有关 Logcat 和 `adb` 的更多信息，请参阅Logcat 命令行工具、使用 Logcat 查看和写入日志、Log 类和发出 adb 命令。

emulator @Pixel8_API_34 -show-kernel

此选项的一种用途是检查引导过程是否正常运行。

emulator @Pixel8_API_34 -verbose

它显示在启动 AVD 中定义的虚拟设备时实际选择的哪些文件和设置。此选项与指定 `-debug-init` 相同。

emulator @Pixel8_API_34 -dns-server 192.0.2.0,
192.0.2.255

默认情况下，模拟器会尝试检测您正在使用的 DNS 服务器，并在模拟防火墙网络中设置特殊别名，以允许 Android 系统直接连接到服务器。使用 `-dns-server` 选项指定不同的 DNS 服务器列表。

emulator @Pixel8_API_34 -http-proxy myserver:1981

`proxy` 可以是以下之一

http://server:port
http://username:password@server:port

可以省略 `http://` 前缀。

如果不提供此选项，模拟器会查找 `http_proxy` 环境变量，并自动使用任何与 `proxy` 格式匹配的值。有关更多信息，请参阅在使用代理的情况下使用模拟器。

将网络延迟模拟设置为以下 `delay` 值之一（以毫秒为单位）

• `gsm` - GSM/CSD（最小 150，最大 550）。
• `hscsd` - HSCSD（最小 80，最大 400）。
• `gprs` - GPRS（最小 35，最大 200）。
• `edge` - EDGE/EGPRS（最小 80，最大 400）。
• `umts` - UMTS/3G（最小 35，最大 200）。
• `hsdpa` - HSDPA（最小 0，最大 0）。
• `lte` - LTE（最小 0，最大 0）。
• `evdo` - EVDO（最小 0，最大 0）。
• `none` - 无延迟，默认值（最小 0，最大 0）。
• `num` - 指定确切的延迟。
• `min:max` - 指定各个最小和最大延迟。

例如

emulator @Pixel8_API_34 -netdelay gsm

模拟器支持网络限速以及更高的连接延迟。您可以通过皮肤配置或使用 `‑netspeed` 和 `-netdelay` 选项来定义它。

emulator @Pixel8_API_34 -netfast

此选项与指定 `-netspeed full -netdelay none` 相同。这些是这些选项的默认值。

设置网络速度模拟。使用以下 `speed` 值之一（以 kbps 为单位）指定最大网络上传和下载速度

• `gsm` - GSM/CSD（上行：14.4，下行：14.4）。
• hscsd - HSCSD (上行: 14.4，下行: 57.6)。
• gprs - GPRS (上行: 28.8，下行: 57.6)。
• edge - EDGE/EGPRS (上行: 473.6，下行: 473.6)。
• umts - UMTS/3G (上行: 384.0，下行: 384.0)。
• hsdpa - HSDPA (上行: 5760.0，下行: 13,980.0)。
• lte - LTE (上行: 58,000，下行: 173,000)。
• evdo - EVDO (上行: 75,000，下行: 280,000)。
• full - 无限制，默认值 (上行: 0.0，下行: 0.0)。
• num - 指定上行和下行速度。
• up:down - 分别指定上行和下行速度。

例如

emulator @Pixel8_API_34 -netspeed edge

模拟器支持网络限速以及更高的连接延迟。您可以通过皮肤配置或使用 `‑netspeed` 和 `-netdelay` 选项来定义它。

emulator @Pixel8_API_34 -port 5556

对于在您的机器上运行的第一个虚拟设备实例，默认值为5554。虚拟设备通常占用一对相邻的端口：一个控制台端口和一个adb端口。在特定机器上运行的第一个虚拟设备的控制台使用控制台端口5554和adb端口5555。后续实例使用的端口号递增二。例如，5556/5557、5558/5559，依此类推。范围是5554到5682，允许64个并发虚拟设备。

端口分配通常与指定-ports port,{port + 1}相同。{port + 1}必须可用，并为adb保留。如果任何控制台或adb端口已被使用，则模拟器将无法启动。

‑port选项报告虚拟设备正在使用的端口和序列号，并在您提供的数值存在问题时发出警告。在模拟器UI中，您可以在窗口标题中看到控制台端口号，并通过选择**帮助** > **关于**查看adb端口号。

请注意，如果port值不是偶数，并且在5554到5584范围内，则如果adb server在模拟器之后启动，则虚拟设备将启动，但在使用adb devices命令时不可见。因此，我们建议使用偶数控制台端口号。

emulator @Pixel8_API_34 -ports 5556,5559

有效的端口范围是5554到5682，允许64个并发虚拟设备。-ports选项报告模拟器实例正在使用的端口和序列号，并在您提供的数值存在问题时发出警告。

我们建议尽可能使用-port选项。-ports选项适用于需要特殊设置的网络配置。

有关设置控制台和adb端口的更多信息，请参阅-port选项。

emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap

使用此选项开始捕获通过模拟器的虚拟以太网LAN发送的所有网络数据包。之后，您可以使用Wireshark之类的工具分析流量。

请注意，此选项捕获所有以太网数据包，而不限于TCP连接。

emulator @Pixel8_API_34 -accel auto

加速模拟仅适用于x86和x86_64系统映像。在Linux上，它依赖于KVM。在Windows和Mac上，它依赖于英特尔CPU和英特尔HAXM驱动程序。如果您没有模拟x86或x86_64设备，则会忽略此选项。

mode的有效值为

• auto - 自动确定是否支持加速，并在可能的情况下使用它（默认值）。
• off - 完全禁用加速，这主要用于调试。
• on - 强制加速。如果未安装或无法使用KVM或HAXM，则模拟器将无法启动并打印错误消息。

有关更多信息，请参阅为Android模拟器配置硬件加速。

emulator -accel-check

有关更多信息，请参阅检查是否安装了虚拟机管理程序。

指定模拟器引擎

• auto - 自动选择引擎（默认值）。
• classic - 使用旧的QEMU 1引擎（已弃用）。
• qemu2 - 使用较新的QEMU 2引擎。

例如

emulator @Pixel8_API_34 -engine auto

自动检测应选择在模拟特定AVD时提供最佳性能的值。仅出于调试和比较目的使用-engine选项。

emulator @Pixel8_API_34 -gpu swiftshader_indirect

有关更多信息，请参阅配置图形加速。

emulator @Pixel8_API_34 -no-accel

有关更多信息，请参阅为Android模拟器配置硬件加速。

emulator @Pixel8_API_34 -nojni

启动虚拟设备时，默认情况下会启用扩展JNI检查。有关更多信息，请参阅JNI提示。

me-linux$ emulator @Pixel8_API_34 -selinux permissive

默认情况下，SELinux处于enforcing模式，这意味着安全策略正在强制执行。permissive模式加载SELinux策略但不强制执行它。此选项仅记录策略冲突。disabled模式禁用内核对SELinux的支持。

将虚拟设备的时区设置为timezone，而不是主机时区。例如

emulator @Pixel8_API_34 -timezone Europe/Paris

默认情况下，模拟器使用您的开发计算机的时区。使用此选项指定不同的时区，或者如果自动检测不起作用。 timezone值必须采用zoneinfo格式，即area/location或area/subarea/location。例如

• America/Los_Angeles
• Europe/Paris
• America/Argentina/Buenos_Aires

指定的时区必须位于zoneinfo数据库中。

emulator @Pixel8_API_34 -version

或者

emulator -version

emulator @Pixel8_API_34 -no-boot-anim

在较慢的计算机上，此选项可以显著加快启动速度。

emulator @Pixel8_API_34 -screen no-touch

`mode` 可以是以下任何值

• touch - 模拟触摸屏（默认值）。
• multi-touch - 模拟多点触摸屏。
• no-touch - 禁用触摸和多点触摸屏模拟。

启用引导图表，超时时间以秒为单位。一些Android系统映像具有修改后的init系统，该系统集成了引导图表功能。您可以使用此选项将引导图表超时周期传递给系统。如果您的init系统未激活引导图表，则此选项无效。此选项主要对平台开发人员有用，而不是外部应用程序开发人员。

例如

emulator @Pixel8_API_34 -bootchart 120

指定缓存分区映像文件。提供文件名和绝对路径或相对于数据目录的路径来设置持久性缓存文件。如果文件不存在，模拟器会将其创建为空文件。

例如

emulator @Pixel8_API_34 -cache
   ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img

如果您不使用此选项，则默认为名为cache.img的临时文件。有关更多信息，请参阅AVD数据目录。

以MB为单位设置缓存分区大小。

例如

emulator @Pixel8_API_34 -cache-size 1000

如果您不指定此选项，则默认为66 MB。通常，大多数应用程序开发人员不需要此选项，除非他们需要下载大于默认缓存的非常大的文件。有关缓存文件的更多信息，请参阅AVD数据目录。

设置用户数据分区映像文件。提供文件名和绝对路径或相对于工作目录的路径来设置持久性用户数据文件。如果文件不存在，模拟器将从默认的userdata.img文件创建映像，将其存储在您指定的文件名中，并在关机时将用户数据持久保存到其中。

例如

emulator @Pixel8_API_34 -data
   ~/.android/avd/Pixel8_API_34.avd/userdata-test.img

如果您不使用此选项，则默认为名为userdata-qemu.img的文件。有关用户数据文件的更多信息，请参阅AVD数据目录。

使用绝对路径指定数据目录。有关更多信息，请参阅AVD数据目录。

例如

emulator @Pixel8_API_34 -datadir
   ~/.android/avd/Pixel8_API_34.avd/mytest

在64位平台上使用32位模拟器。有时，此选项对于测试或调试很有用。例如，存在模拟器有时无法在64位Windows上运行，但32位可以运行的问题。此选项有助于执行比较以调试问题。这是一个示例

emulator @Pixel8_API_34 -force-32bit

获取有关磁盘映像的帮助。此选项提供与应用程序和平台开发人员相关的相关信息。例如

emulator -help-disk-images

获取有关字符device规范的帮助。一些模拟器选项需要device参数。例如

emulator -help-char-devices

获取与应用程序开发人员相关的磁盘映像的帮助。此选项获取有关使用SDK工具创建的AVD的映像文件位置的信息。例如

emulator -help-sdk-images

获取与平台开发者相关的磁盘镜像帮助信息。例如

emulator -help-build-images

指定数据分区的初始版本。擦除用户数据后，模拟器会将指定文件的内容复制到用户数据（默认情况下为userdata-qemu.img文件），而不是使用默认的userdata.img文件作为初始版本。指定文件名和绝对路径或相对于工作目录的路径。

例如

emulator @Pixel8_API_34 -initdata
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/userdata-test.img

如果未指定路径，则将文件放置在系统目录中。更多信息，请参阅AVD系统目录。

使用特定的模拟内核。如果未指定路径，模拟器将在系统目录中查找。

例如

emulator @Pixel8_API_34 -kernel
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/kernel-test.img -show-kernel

如果未指定此选项，则默认为kernel-ranchu。更多信息，请参阅AVD系统目录。

禁用此虚拟设备的音频支持。某些Linux和Windows计算机的音频驱动程序存在故障，会导致不同的症状，例如阻止模拟器启动。在这种情况下，可以使用此选项来解决问题。或者，您可以使用QEMU_AUDIO_DRV环境变量来更改音频后端。

例如

emulator @Pixel8_API_34 -noaudio

启动模拟器时不使用缓存分区。如果不使用此选项，则默认为名为cache.img的临时文件。此选项仅供平台开发者使用。更多信息，请参阅AVD数据目录。

例如

emulator @Pixel8_API_34 -nocache

禁止自动加载和保存操作，导致模拟器执行完整的启动序列，并在关闭时丢失其状态。它会覆盖-snapshot选项。

例如

emulator @Pixel8_API_34 -no-snapshot

阻止模拟器从快照存储加载AVD状态。执行完整启动。

例如

emulator @Pixel8_API_34 -no-snapshot-load

阻止模拟器在退出时将AVD状态保存到快照存储，这意味着所有更改都将丢失。

例如

emulator @Pixel8_API_34 -no-snapshot-save

在恢复快照时不会立即尝试校正AVD时钟时间。此选项在测试期间非常有用，因为它避免了突然的时间跳跃。时间更新大约每15秒发送一次到AVD。

例如

emulator @Pixel8_API_34 -no-snapshot-update-time

启动模拟器时不挂载文件来存储或加载状态快照，强制执行完整启动并禁用状态快照功能。此选项会覆盖-snapstorage和-snapshot选项。

例如

emulator @Pixel8_API_34 -no-snapstorage

禁用模拟器上的图形窗口显示。此选项在运行没有显示器的服务器上的模拟器时非常有用。您可以通过adb或控制台访问模拟器。例如

emulator @Pixel8_API_34 -no-window

指定系统数据分区大小（以MB为单位）。例如

emulator @Pixel8_API_34 -partition-size 1024

在模拟器启动时设置Android系统属性。name必须是标记为qemu_prop的属性名称，最多32个字符，不包含任何空格，而value必须是最多92个字符的字符串。有关示例，请参阅property_contexts文件。您可以在一条命令行上指定多个‑prop选项。此选项对于调试非常有用。例如

emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz

显示-qemu帮助信息。例如

emulator -qemu -h

指定ramdisk引导镜像。指定文件名和绝对路径或相对于工作目录的路径。

例如

emulator @Pixel8_API_34 -ramdisk
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/ramdisk-test.img

如果不使用此选项，则默认为系统目录中的ramdisk.img文件。更多信息，请参阅AVD系统目录。

在启动模拟之前向远程第三方报告控制台端口。这对于自动化测试脚本很有用。socket必须使用以下格式之一

• tcp:port[,server][,max=seconds][,ipv6]
• unix:port[,server][,max=seconds][,ipv6]

更多信息，请使用-help-report-console选项，如特定选项的帮助信息部分所述。

在当前终端上创建一个root shell控制台。此选项与adb shell命令的不同之处在于

• 它创建一个*root* shell，允许您修改系统的许多部分。
• 即使模拟系统中的adb守护程序已损坏，它也能正常工作。
• 按Control+C（或macOS上的Command-C）停止模拟器而不是shell。

例如

emulator @Pixel8_API_34 -shell

指定快照存储文件内用于自动启动和保存操作的快照名称。

模拟器可以从较早的状态快照恢复执行，而不是执行完整的引导序列，这通常要快得多。提供此选项时，模拟器将从快照镜像加载该名称的快照，并在退出时将其保存回同一名称。

如果不使用此选项，则默认为完整的引导序列。如果指定的快照不存在，则模拟器将改为执行完整的引导序列并执行保存操作。

有关指定快照存储文件和默认文件的详细信息，请参阅-snapstorage选项。

emulator @Pixel8_API_34 -snapshot snapshot2

请记住，在加载快照的过程中，系统、用户数据和SD卡镜像的所有内容都将被其在创建快照时保存的内容覆盖。除非您将此信息保存在不同的快照中，否则自那时以来的任何更改都将丢失。

您还可以使用avd snapshot save name命令从模拟器控制台创建快照。更多信息，请参阅发送模拟器控制台命令。

显示可用快照的列表。此命令打印存储在启动模拟器时使用的快照存储文件中的快照表，然后退出。如果还指定了-snapstorage file，则此命令将打印存储在文件中的快照表。

例如

emulator @Pixel8_API_34 -snapshot-list -snapstorage
   ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img

您可以使用输出中的ID和TAG列值作为-snapshot选项的参数。

指定包含所有状态快照的存储库文件。执行期间进行的所有快照都将保存在此文件中。仅此文件中的快照可在模拟器运行期间恢复。

例如

emulator @Pixel8_API_34 -snapstorage
   ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img

如果不指定此选项，则默认为数据目录中的snapshots.img。如果指定的文件不存在，则模拟器将启动，但不会支持保存或加载状态快照。

使用绝对路径指定系统目录。更多信息，请参阅AVD系统目录。例如

emulator @Pixel8_API_34 -sysdir
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/test

指定初始系统文件。提供文件名和绝对路径或相对于工作目录的路径。

例如

emulator @Pixel8_API_34 -system
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/system-test.img

如果不使用此选项，则默认为系统目录中的system.img文件。更多信息，请参阅AVD系统目录。

在Linux上，使用系统libstdc++而不是模拟器系统捆绑的版本。仅当模拟器无法正常启动时才使用此选项，并注意它并不总是有效。或者，将 ANDROID_EMULATOR_USE_SYSTEM_LIBS环境变量设置为1。

例如

me-linux$ emulator @Pixel8_API_34 -use-system-libs

使用此选项可在模拟会话期间获得可写的系统镜像。为此

1. 使用-writable-system选项启动虚拟设备。
2. 从命令终端输入adb remount命令，告诉模拟器将system/重新挂载为读/写。默认情况下，它被挂载为只读。

使用此标志会创建系统镜像的临时副本，该副本可能非常大，最多几百MB，但会在模拟器退出时被销毁。