kdbhalala/avdslim

一、一句话定位


AVD-SLIM 是一款零依赖的 CLI 工具,能将 Android 模拟器的宿主机内存消耗从约 8GB 降至约 1.5GB,CPU 空闲开销降至接近零,特别适配 Apple Silicon 与 Linux。

二、核心技术/架构亮点


1. QEMU 低内存模式:自动传递 `-lowram` 参数,绕过模拟器内部 4GB 下限,使 Android 内核以低内存模式运行(RAM 1~1.5GB)。
2. 强制 GPU 硬件加速:自动选择 Metal(macOS)、DRI/Vulkan(Linux)或 SwiftShader(无头环境),避免 CPU 软件渲染的 4GB 额外开销。
3. 自动禁用 24+ 非必要后台服务(如 Google 助理、Maps、Telemetry),保留 FCM、Firebase Auth、WebView 等核心功能,支持 `restore` 一键回滚。
4. 即时快照技术:通过 `bake` 命令冷启动一次后保存优化状态,后续启动仅需 1.5 秒。
5. 零风险集成:提供 `install-shim` 可无损嵌入 Android Studio 启动流程,不影响现有开发习惯。

三、适用场景与目标用户


- 本地开发:Android 开发者(Flutter/React Native/原生)在 macOS 或 Linux 上运行模拟器,减轻内存压力,提升多任务体验。
- CI/CD 流水线:在 GitHub Actions 等无头环境中以最小资源运行 Android 模拟器进行自动化测试。
- 资源受限环境:开发机内存不足 16GB 或需要在同一台机器上运行多个模拟器。

四、可动手动作


1. 快速安装:`curl -fsSL https://raw.githubusercontent.com/kdbhalala/avdslim/main/install.sh | bash`
2. 启动并优化模拟器:先创建 Google APIs 镜像的 AVD,然后运行 `avdslim launch`(或使用 `avdslim start` 自启动)。
3. 集成到 Android Studio:执行 `avdslim install-shim`,之后点击 Run 按钮即自动享受优化。
4. 回滚与检查:`avdslim restore` 恢复所有服务;`avdslim doctor` 检测模拟器状态。
5. 制作黄金快照:`avdslim bake` 将优化后状态保存为不可变快照,秒级启动。

五、学习优先级与理由


P0(本周动手)
理由:操作极简、见效立竿见影,仅需一条命令即可释放 6GB+ 内存,同时保留全部核心开发功能,且无风险回滚。适合立即集成到日常开发流程中,大幅提升体验。
赣ICP备2026023170号-1
⌂