企业官网建设流程全解析

Docker Android 镜像选择与构建完整指南：快速构建你想要的 Android 模拟器镜像

【免费下载链接】docker-android🤖 A minimal and customizable Docker image running the Android emulator as a service.项目地址: https://gitcode.com/GitHub_Trending/dockera/docker-android

Android 模拟器镜像选择有那么复杂吗？Docker Android 镜像是一个把 Android 模拟器跑成服务的精简容器：只装了模拟器本体、ADB 服务器和支持 libvirt 的 QEMU。你只需要定好 API 级别（即 Android 版本）、镜像类型（google_apis 或 playstore），再决定要不要带上 Android SDK，一条命令就能构建出镜像。本文带你走一遍选型和构建流程。

一、30 秒看懂：把 Android 模拟器跑进 Docker 能省什么力气

一句话定位：Docker Android 把可直接远程连接（带 ADB）的 Android 模拟器塞进容器，你不必在自己机器上装 SDK、模拟器和整套虚拟化环境。

举个具体例子：CI 流水线需要一个 Android 13 的测试环境，但构建机上只装了 Docker。构建一个 Docker Android 镜像，起容器，用 ADB 连上就能跑测试，全程不碰本机系统。

二、三个维度选对 Android 模拟器镜像 🎯

结论：选镜像就是回答三个问题——构建形态、API 级别、镜像类型。

注意：API 级别不等于 Android 版本号。拿不准时，先查级别与版本的对应关系，再定版本。

三、构建一条命令：API 级别与镜像类型的三个参数

结论：三个参数定下来，一条构建命令就能得到你自己的镜像。

• API_LEVEL：指定镜像对应的 Android 版本，例如API_LEVEL=33表示 Android 13.0。
• IMAGE_TYPE：指定镜像类型，google_apis或playstore。
• ARCHITECTURE：指定 CPU 架构，目前只支持x86_64和x86。

先克隆仓库：

git clone https://gitcode.com/GitHub_Trending/dockera/docker-android

进入项目目录执行构建命令（示例：Android 13 + Play 商店镜像）：

docker build --build-arg API_LEVEL=33 --build-arg IMAGE_TYPE=playstore -t docker-android:api33-playstore .

构建逻辑在 Dockerfile，SDK 下载脚本见 scripts/install-sdk.sh，容器启动配置在 docker-compose.yml。

四、Docker Android 镜像大小对比：完整和精简差多少

结论：完整镜像是 GB 级，精简镜像小一个量级，差距是数量级的。

带 Android SDK 和模拟器的完整镜像体积大，但功能齐全；不需要 SDK 时，构建不含 SDK 与模拟器的精简镜像，镜像大小和构建时间都会明显下降。

可执行建议：构建机磁盘紧张、或只需要模拟器跑起来，选精简版；需要在容器里装新包、做调试，就上完整版。

五、镜像选型避坑：两个新手常犯的错误 ⚠️

结论：新手最容易栽在两处——把版本号当 API 级别、镜像类型选错。

坑 1：API 28 是 Android 9.0，API 33 才是 Android 13.0。直接把版本号写进API_LEVEL，装出来的就是错误的 Android 版本，只能重新构建。

坑 2：应用依赖 Play 商店或 Play 服务时，google_apis满足不了，得换成playstore镜像重建。

下一步：先确认应用要测的 Android 版本，照第三节的命令跑一次构建，几分钟后你就有一个可直接使用的 Android 模拟器镜像。

【免费下载链接】docker-android🤖 A minimal and customizable Docker image running the Android emulator as a service.项目地址: https://gitcode.com/GitHub_Trending/dockera/docker-android