cimg/android 是 CircleCI 官方维护的 Android CI 环境，按 tag 区分 API Level 与 NDK 版本，在 docker run 中挂载 Gradle 工程执行 ./gradlew assembleRelease。与本地 Android Studio 相比可脚本化、可缓存，但镜像体积大、启动慢，不适合 Kubernetes Deployment 长期运行。正确用法是 GitLab/GitHub Actions/CircleCI Job 中 --rm 执行构建，并挂载 workspace 与 Gradle 缓存卷加速重复编译。

快速启动

docker run --rm \
  -v $(pwd):/home/circleci/project \
  docker.io/cimg/android:2024.01 \
  sdkmanager --list | head

推荐实践

docker run --rm \
  -v $(pwd):/home/circleci/project \
  -v gradle-cache:/home/circleci/.gradle \
  -w /home/circleci/project \
  docker.io/cimg/android:2024.01-ndk \
  ./gradlew assembleRelease --no-daemon

核心参数说明

• -v $(pwd):/home/circleci/project — 挂载 Android 工程
• -v gradle-cache:... — Gradle 依赖与构建缓存
• -w /home/circleci/project — 容器内工作目录
• 固定 tag — API/NDK 版本与项目 compileSdk 对齐
• --rm — 构建完成释放资源
• 定位 — CI 构建环境，非生产运行时