android-environment

![Pipeline status]([***]

镜像概述和主要用途

android-environment是一个用于在CI/CD流水线中构建Android应用的Docker容器镜像。该镜像基于OpenJDK 8或OpenJDK 11构建，内置Android tools SDK和Platform tools组件，提供了构建Android应用所需的基础环境。默认情况下需要用户自行安装应用所需的Android API版本，同时也提供预安装特定Android API的镜像版本以减少构建时间。

核心功能和特性

• 基于OpenJDK 8或OpenJDK 11两种版本，满足不同Java环境需求
• 内置Android tools SDK和Platform tools，无需额外配置基础工具链
• 支持灵活选择：默认镜像仅包含核心组件，需手动安装Android API；预安装API版本的镜像可直接使用，大幅缩短构建时间
• 提供明确的标签命名规则，清晰标识JDK版本和预安装的Android API版本

使用场景和适用范围

适用于各类CI/CD流水线环境中自动化构建Android应用的场景，特别适合需要统一构建环境、减少环境配置差异的开发团队。无论是需要自定义安装Android组件的灵活构建需求，还是追求快速构建流程（使用预安装API版本）的场景均适用。

详细使用方法和配置说明

镜像获取

该镜像已发布至Docker Hub，镜像名称为raatiniemi/android-environment，可通过Docker Hub获取。具体标签信息可查看可用标签。

标签命名约定

镜像标签包含明确的版本信息，主要标识JDK版本；对于预安装Android API的镜像，还会包含API版本。各标签说明如下：

• jdk-11-latest —— 仅包含核心组件，基于OpenJDK 11
• jdk-11-android-28-latest —— 包含Android API 28，基于OpenJDK 11
• jdk-11-android-29-latest —— 包含Android API 29，基于OpenJDK 11
• jdk-11-android-30-latest —— 包含Android API 30，基于OpenJDK 11
• jdk-8-latest —— 仅包含核心组件，基于OpenJDK 8
• jdk-8-android-28-latest —— 包含Android API 28，基于OpenJDK 8
• jdk-8-android-29-latest —— 包含Android API 29，基于OpenJDK 8
• jdk-8-android-30-latest —— 包含Android API 30，基于OpenJDK 8

注意：不推荐使用latest标签，因为该标签未指定JDK版本。目前latest标签基于OpenJDK 8，但未来将迁移至OpenJDK 11。

安装额外Android工具

如需安装额外的Android工具，推荐使用sdkmanager命令，使用前需接受相关许可协议。以下是一个接受许可并安装指定构建工具和Android API的示例脚本：

bash
function accept_license_and_install {
  yes | sdkmanager $1 1>/dev/null;
  if [ $? -ne 0 ]; then
    echo "Failed to accept license and install ${1}";
    exit 1;
  fi
}

accept_license_and_install "build-tools;27.0.3";
accept_license_and_install "platforms;android-27";

说明：构建工具（build-tools）默认未安装，通常在执行gradlew命令时会自动安装。