halimqarroum/docker-android

docker-android

一个最小化且可定制的Docker镜像，将Android模拟器作为服务运行。

镜像概述

docker-android是一个大小优化的Docker镜像，旨在提供运行功能齐全的Android模拟器所需的最少软件，支持通过网络远程控制。该镜像仅包含Android模拟器、用于从容器外部远程连接的ADB服务器，以及带有libvirt支持的QEMU。适用于CI环境、自动化测试等需要远程控制Android模拟器的场景。

核心功能和特性

• 基于Alpine的最小化镜像，捆绑Android模拟器和KVM支持
• 内置Java Runtime Environment 11
• 可定制Android版本、设备类型和镜像类型
• 内置容器网络接口上的模拟器和ADB端口转发
• 模拟器重启时自动清除镜像数据
• 无头运行模式，适合CI环境，兼容scrcpy实现远程屏幕控制

镜像大小对比

不同构建变体的大小如下：

使用方法

构建镜像

默认情况下，构建会将Android SDK、平台工具和模拟器捆绑到镜像中：

bash
docker build -t android-emulator .

运行容器

构建完成后，可挂载KVM驱动并暴露ADB端口运行容器：

注意：API 33至少需要4GB内存和8GB磁盘空间

bash
docker run -it --rm --device /dev/kvm -p 5555:5555 android-emulator

连接ADB到容器

容器内的ADB服务器会自动启动并监听所有接口。内核启动后（约几秒），可通过以下命令连接ADB：

bash
adb connect 127.0.0.1:5555

使用scrcpy远程控制屏幕

可使用https://github.com/Genymobile/scrcpy%E8%BF%9C%E7%A8%8B%E6%8E%A7%E5%88%B6%E6%A8%A1%E6%8B%9F%E5%99%A8%E5%B1%8F%E5%B9%95%EF%BC%8C%E8%BF%9E%E6%8E%A5ADB%E5%90%8E%E6%9C%AC%E5%9C%B0%E8%BF%90%E8%A1%8C%EF%BC%9A

默认模拟器使用Pixel预设（1080x1920）

bash
scrcpy

自定义镜像

构建时可通过参数自定义API级别（Android版本）、镜像类型和架构：

• API_LEVEL：指定Android API级别（参考API级别列表）
• IMG_TYPE：指定镜像类型（如google_apis、google_apis_playstore）
• ARCHITECTURE：指定CPU架构（支持x86_64和x86）

示例：构建Android Pie（API 28）带Google Play Store的镜像

bash
docker build \
  --build-arg API_LEVEL=28 \
  --build-arg IMG_TYPE=google_apis_playstore \
  --build-arg ARCHITECTURE=x86 \
  --tag android-emulator .

挂载外部SDK

可通过构建参数禁用镜像内SDK安装，将SDK存储在外部（如NFS共享文件系统）以减小镜像大小和构建时间：

bash
docker build -t android-emulator --build-arg INSTALL_ANDROID_SDK=0 .

运行时需将外部SDK挂载到/opt/android：

bash
docker run -it --rm --device /dev/kvm -p 5555:5555 -v /shared/android/sdk:/opt/android/ android-emulator

从Docker Hub拉取

Docker Hub提供预构建镜像，标签格式为api-<API级别>，例如拉取API 33镜像：

bash
docker pull halimqarroum/docker-android:api-33

参见

• https://github.com/alvr/alpine-android%EF%BC%9A%E5%9F%BA%E4%BA%8E%E4%B8%8D%E5%90%8CAlpine%E9%95%9C%E5%83%8F%E7%9A%84Android%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83
• https://github.com/budtmo/docker-android%EF%BC%9A%E6%8F%90%E4%BE%9BWebRTC%E7%95%8C%E9%9D%A2%E7%9A%84Android%E6%A8%A1%E6%8B%9F%E5%99%A8%E9%95%9C%E5%83%8F