告别几 GB 镜像拖垮 CIDocker Android 镜像选型与构建完整指南【免费下载链接】docker-android A minimal and customizable Docker image running the Android emulator as a service.项目地址: https://gitcode.com/GitHub_Trending/dockera/docker-android凌晨两点你的 CI 流水线又被Android 测试卡住了拉镜像、等启动、超时、重跑……动辄几个 GB 的体积把一次提交变成一场漫长的等待。Docker Android 镜像开源项目 docker-android正是为此而生——它把 Android 模拟器打包成一台可以随启随停的服务镜像里只装了模拟器、ADB 服务器连接和操作模拟器的桥接工具和带 libvirt 支持的 QEMU硬件级模拟器轻量、可定制、上手快。本文不打算罗列参数而是带你按想清楚 → 选镜像 → 构建 → 避坑四步走把一台 Android 模拟器真正跑起来。全程约十分钟跟着做就好。第一步动手之前先回答三个问题很多新手一上来就急着docker build结果要么镜像大到离谱要么装出来根本跑不动。选型之前先想清楚三件事跑在哪CI 机器还是本地开发机CI 环境通常追求能跑、占地小本地则更看重功能完整。测什么只是单元测试还是需要 Google API、甚至 Play 商店的集成测试这直接决定镜像类型。资源够吗宿主机支持 KVM 吗能分出多少内存和磁盘把答案记下来再看这份选型决策清单你的需求建议选型CI 里只跑 UI 冒烟测试追求最小体积精简镜像INSTALL_ANDROID_SDK0SDK 挂载到外部目录需要完整开发环境本地调试为主含 SDK 的完整镜像要调 Google 地图、推送等 GMS 服务google_apis镜像要测应用内购买、Play 商店集成google_apis_playstore镜像机器是老 CPU 或特殊架构改用 x86 镜像并确认 KVM 可用需求定了体积差距有多大不同构建变体的体积差异非常悬殊构建变体未压缩体积压缩后API 33 模拟器5.84 GB1.97 GBAPI 28 模拟器4.29 GB1.46 GB不含 SDK 和模拟器414 MB138 MB同样一套功能精简与否能差出好几个 GB。想清楚需求这一步就把浪费的空间省回来了。第二步快速锁定合适镜像的三个要点选型靠的是三个构建参数API_LEVEL、IMG_TYPE、ARCHITECTURE。理解它们你就能像点菜一样定制属于自己的 Android 模拟器 Docker 镜像。1. API_LEVEL要哪个 Android 版本API_LEVEL决定 Android 版本号。选太新兼容性问题多选太老又测不出真机上的最新行为。建议主测版本取 12 个最低支持版本取 1 个。API_LEVELAndroid 版本适用场景28Android 9.0兼容老机型、覆盖低版本用户30Android 11.0通用测试的稳妥之选新手首选33Android 13.0当前主流版本功能覆盖最全34Android 14.0最新系统验证新特性2. IMG_TYPEGoogle APIs 还是 PlayStoregoogle_apis自带 Google 服务框架能调地图、推送等能力是大多数测试的标准选择。google_apis_playstore在 Google APIs 基础上多一个 Play 商店适合测应用内购买、商店分发流程。用 PlayStore 镜像有个小前提模拟器和客户端要保持一致的 adbkey连接密钥。用adb keygen adbkey生成后放到项目的./keys目录覆盖即可。3. ARCHITECTUREx86_64 还是 x86镜像只主动支持x86_64和x86两种架构。绝大多数服务器选x86_64老设备或特定模拟场景才用x86。架构和宿主机不匹配模拟器会直接拒绝启动这一步务必先确认。第三步从克隆到跑通一条命令完成 Docker Android 镜像构建 ️光说不练假把式。下面我们用最典型的组合——API 33 PlayStore x86_64——完整走一遍克隆 → 构建 → 运行 → 连接。先克隆项目git clone https://gitcode.com/GitHub_Trending/dockera/docker-android cd docker-android再构建镜像docker build \ --build-arg API_LEVEL33 \ --build-arg IMG_TYPEgoogle_apis_playstore \ --build-arg ARCHITECTUREx86_64 \ --tag docker-android:api33-playstore .逐行拆解这条命令--build-arg API_LEVEL33指定 Android 13镜像会下载对应的系统镜像--build-arg IMG_TYPEgoogle_apis_playstore选用带 Play 商店的镜像类型--build-arg ARCHITECTUREx86_64指定 CPU 架构与构建机器保持一致--tag docker-android:api33-playstore给镜像起个容易认的名字末尾的.告诉 Docker 在当前目录找 Dockerfile。构建完成后挂载 KVM 驱动硬件虚拟化加速并暴露端口启动docker run -it --rm --device /dev/kvm -p 5555:5555 docker-android:api33-playstoreAPI 33 建议至少分配 4 GB 内存和 8 GB 磁盘空间否则模拟器可能起不来。等模拟器内核完成启动就能通过 ADB 连接容器了adb connect 127.0.0.1:5555连上之后桌面端还能用 scrcpy 把模拟器屏幕镜像到本地像操作真机一样操作它。下面这几张就是镜像里跑起来的模拟器实拍如果你只是想快速完成 Docker Android 镜像下载不想从源码构建也可以直接从 Docker Hub 拉取官方预构建版本docker pull halimqarroum/docker-android:api-33第四步构建前必看的四个避坑点新手最容易在下面四个地方翻车提前避开能省下大把时间。坑 1架构不匹配模拟器拒绝启动ARCHITECTURE必须和宿主机 CPU 一致。不确定的话先执行uname -m确认再填对应的参数。坑 2KVM 不可用启动慢到怀疑人生模拟器依赖硬件虚拟化。运行前检查/dev/kvm是否存在在云服务器或虚拟机里还要先在宿主机开启嵌套虚拟化。没有 KVM模拟器不是不能跑而是慢得没法用。坑 3想要最小体积SDK 却偷偷塞进来默认构建会安装完整 SDK。追求极致精简可以加这个参数关闭 SDK 安装docker build -t android-emulator --build-arg INSTALL_ANDROID_SDK0 .注意SDK 需要你自己挂载进容器位置固定在/opt/android别挂错目录。坑 4构建太慢卡在下载阶段首次构建要下载系统镜像和命令行工具网络不好时特别煎熬。两个办法一是换一个更稳定的CMD_LINE_VERSION版本号减少重试二是直接用预构建镜像见上一步的docker pull让下载速度和构建时间都回归正常。下一步行动从 API 30 精简镜像开始别一上来就追求最新最全。我给你的建议是先用API 30Android 11 google_apis的组合起步体积适中、兼容性好按上面的流程克隆、构建、启动、连接先把整条链路跑通再根据真实测试需求逐步切换 Android 版本和镜像类型。等你对这套流程有了感觉再回头调整参数、优化体积也不迟。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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
