Android CI构建Docker镜像

镜像概述

本Docker镜像专为Android CI（持续集成）构建设计，基于GitHub仓库inovex/gitlab-ci-android。镜像内置Android开发和构建所需的完整工具链，可快速集成到CI/CD流程中，实现Android应用的自动化构建、测试和打包，减少环境配置时间，提升开发效率。

核心功能与特性

• 完整工具链：包含Android SDK、各版本Build Tools、Platform Tools及必要依赖库
• 预配置环境：内置Java运行环境（JRE/JDK）、Gradle构建工具，无需额外安装
• 多版本支持：支持不同Android API级别和Build Tools版本的应用构建
• CI/CD适配：优化用于GitLab CI等主流CI平台，兼容自动化构建流程
• 轻量高效：基于***基础镜像优化，平衡功能完整性与镜像体积

使用场景与适用范围

• 自动化构建：集成到GitLab CI、Jenkins、GitHub Actions等CI/CD系统，实现Android应用的持续构建
• 团队协作：统一开发和构建环境，避免"本地可运行，CI构建失败"的环境差异问题
• 多版本管理：支持同一项目不同Android版本分支的并行构建
• 快速迭代：缩短构建配置周期，适用于敏捷开发团队的高频次构建需求

使用方法与配置说明

基本使用（Docker Run）

通过docker run命令直接运行镜像，挂载本地Android项目目录并执行构建命令：

bash
docker run -v /path/to/your/android/project:/app \
  -w /app \
  inovex/gitlab-ci-android:latest \
  ./gradlew assembleDebug

• -v /path/to/your/android/project:/app：挂载本地Android项目目录到容器内/app路径
• -w /app：设置工作目录为项目路径
• ./gradlew assembleDebug：执行Gradle构建命令（生成Debug版本APK）

Docker Compose配置示例

创建docker-compose.yml文件，定义构建服务：

yaml
version: '3'
services:
  android-build:
    image: inovex/gitlab-ci-android:latest
    volumes:
      - ./android-project:/app
    working_dir: /app
    command: ./gradlew assembleRelease

运行构建：

bash
docker-compose up

CI/CD集成示例（GitLab CI）

在项目根目录创建.gitlab-ci.yml，配置CI构建任务：

yaml
stages:
  - build

android-build:
  stage: build
  image: inovex/gitlab-ci-android:latest
  script:
    - ./gradlew clean assembleRelease
  artifacts:
    paths:
      - app/build/outputs/apk/release/*.apk

提交配置后，GitLab CI将自动拉取镜像并执行构建，构建产物（APK）将作为artifacts保存。

环境变量说明

镜像预配置以下关键环境变量，可根据需求调整：

注意事项

• 首次运行可能因下载依赖（如Gradle、Android SDK组件）耗时较长，建议在CI配置中启用依赖缓存（如GitLab CI的cache配置）
• 根据项目需求选择合适的镜像标签（如指定Android SDK版本的标签），可在GitHub仓库查看可用标签
• 构建过程中需确保网络通畅，以便下载项目依赖和Gradle插件