AOSP 之 emulator 常用参数

在 AOSP 编译好 emulator（即 Android 模拟器）后，你就可以使用它来启动你编译的系统镜像了。emulator 工具有很多常用的命令行参数，以下是一些常用参数分类和说明：

---

📦 基本参数

参数	说明
-avd <name>	启动指定的 AVD 名称（模拟器配置）
-sysdir <path>	指定 system 镜像的目录（system.img 所在目录）
-system <file>	指定 system 镜像路径
-kernel <file>	指定 kernel 映像
-ramdisk <file>	指定 ramdisk 文件
-data <file>	指定 userdata 映像
-sdcard <file>	指定 sdcard 映像路径
-wipe-data	清除用户数据分区，恢复初始状态

---

🖥️ 显示与性能

参数	说明
-no-window	不启动 GUI（适用于服务器等无窗口环境）
-gpu on/off/host	控制 GPU 加速方式（推荐使用 host）
-no-accel	禁用硬件加速
-cores <n>	指定 CPU 核心数
-memory <n>	分配模拟器内存（单位 MB）

---

📡 网络相关

参数	说明
-netdelay <delay>	设置网络延迟，如 none, gsm, edge, umts, lte
-netspeed <speed>	设置网络速度，如 gsm, edge, umts, full
-port <port>	设置控制台端口（默认是 5554）
-http-proxy <proxy>	设置 HTTP 代理

---

🔧 调试与开发

参数	说明
-verbose	输出详细的调试信息
-logcat '*:I'	启动时指定 logcat 的过滤条件
-shell	启动并进入模拟器 shell
-no-snapshot	启动时不使用快照（避免状态恢复）

---

🧪 启动自定义镜像（无 avd）

如果你没有使用 AVD 配置，而是手动编译的 AOSP 镜像（比如 out/target/product/generic_x86/），可以用类似以下命令：

emulator \
    -verbose \
    -show-kernel \
    -no-snapshot \
    -qemu \
    -kernel kernel-ranchu \
    -system system.img \
    -ramdisk ramdisk.img \
    -data userdata.img \
    -skindir . \
    -skin 480x800

-qemu 后可以加 QEMU 的原生命令行参数。

---

✅ 查看全部参数

emulator -help

或者单独查看某个分类的帮助：

emulator -help-all
emulator -help-disk-images
emulator -help-virtual-device