docker-android-sdk

镜像概述

docker-android-sdk是包含Android SDK的Docker镜像，提供不同Linux基础和使用模式以适应多样化构建需求。支持Ubuntu（官方推荐）和Alpine（轻量级）两种Linux发行版，以及standalone（SDK集成于镜像）和lazydl（通过卷共享SDK数据）两种使用模式，适用于各类Docker-enabled CI环境中的Android项目构建。

核心功能与特性

Linux基础版本

• Ubuntu：官方支持的Android SDK构建系统，兼容性更好，适合不确定选择时使用。
• Alpine：轻量级Linux发行版，针对Docker容器优化，镜像体积更小。

使用模式

• standalone：标准模式，Android SDK直接集成在镜像中，开箱即用，适用于CircleCI、Bitbucket Pipelines等CI环境的Android构建。
• lazydl：通过命名卷共享SDK数据，支持两个容器协作（构建容器执行构建，sdk-data容器管理SDK下载与共享），可自定义下载SDK组件，也可作为自定义镜像基础。

标签说明

使用场景

• standalone模式：适用于CircleCI、Bitbucket Pipelines等Docker支持的CI环境，直接执行Android构建命令，无需额外配置卷共享。
• lazydl模式：适用于需要共享SDK数据（减少重复下载）、自定义SDK组件（仅下载所需部分）或构建自定义Android SDK镜像的场景。

使用方法

拉取镜像

根据需求拉取对应标签的镜像：

# Ubuntu standalone模式
docker pull runmymind/docker-android-sdk:ubuntu-standalone

# Ubuntu lazydl模式
docker pull runmymind/docker-android-sdk:ubuntu-lazydl

# Alpine standalone模式
docker pull runmymind/docker-android-sdk:alpine-standalone

# Alpine lazydl模式
docker pull runmymind/docker-android-sdk:alpine-lazydl

# 最新版（Ubuntu lazydl）
docker pull runmymind/docker-android-sdk:latest

standalone模式使用示例

直接运行容器执行Android构建命令（如构建APK）：

docker run --rm -v $(pwd):/app runmymind/docker-android-sdk:ubuntu-standalone \
  sh -c "cd /app && ./gradlew assembleDebug"

• -v $(pwd):/app：挂载当前目录到容器内/app，用于访问项目代码。
• ./gradlew assembleDebug：执行Android构建命令（根据项目实际情况调整）。

lazydl模式使用示例

1. 通过卷共享SDK数据（推荐使用docker-compose）

创建docker-compose.yml：

version: '3'
services:
  sdk-data:
    image: runmymind/docker-android-sdk:ubuntu-lazydl
    volumes:
      - sdk-volume:/opt/android-sdk
    command: echo "SDK data volume initialized"

  builder:
    image: runmymind/docker-android-sdk:ubuntu-lazydl
    volumes:
      - sdk-volume:/opt/android-sdk
      - ./:/app
    depends_on:
      - sdk-data
    command: sh -c "cd /app && ./gradlew assembleDebug"

volumes:
  sdk-volume:

• sdk-data容器：初始化SDK数据卷，下载SDK到共享卷sd-volume。
• builder容器：使用共享卷中的SDK执行构建，避免重复下载。

启动构建：

docker-compose up

2. 自定义SDK组件下载

1. 创建package-list-minimal.txt，指定所需SDK组件（如platforms;android-30、build-tools;30.0.3等）。
2. 挂载文件并运行初始化命令：

docker run --rm -v $(pwd)/package-list-minimal.txt:/opt/tools/package-list-minimal.txt \
  -v sdk-volume:/opt/android-sdk \
  runmymind/docker-android-sdk:ubuntu-lazydl \
  /opt/tools/entrypoint.sh built-in

• 容器会根据package-list-minimal.txt下载指定组件到sd-volume卷，供后续构建使用。

3. 作为自定义镜像基础

在Dockerfile中以lazydl镜像为基础，添加项目特定依赖：

FROM runmymind/docker-android-sdk:ubuntu-lazydl

# 添加自定义依赖或配置
RUN apt-get update && apt-get install -y some-package

构建自定义镜像：

docker build -t my-custom-android-sdk .