majlant/android-ci

Android应用构建Docker镜像

概述

本Docker镜像专为Android应用构建设计，提供完整的Android开发环境，集成Android SDK、构建工具及依赖组件，旨在简化Android应用的编译、打包流程，实现开发环境标准化，适用于本地开发和CI/CD自动化构建场景。

核心功能与特性

• 完整开发环境：预装Android SDK、Build Tools、Platform Tools及常用Android平台版本
• 工具集成：内置JDK（Java开发环境）和Gradle构建工具，无需额外配置
• 多版本支持：可通过环境变量灵活指定目标Android API级别
• 环境隔离：容器化设计避免开发环境冲突，确保构建一致性
• 轻量优化：精简镜像体积，优先集成核心构建组件，提升构建效率

使用场景

• CI/CD自动化构建：集成到Jenkins、GitLab CI、GitHub Actions等流程，实现Android应用自动编译、测试、打包
• 多版本开发环境统一：团队协作中确保所有成员使用相同的Android SDK和构建工具版本
• 临时开发环境：快速搭建隔离的Android构建环境，避免本地环境污染
• 教学与演示：快速部署可复现的Android构建环境，用于技术分享或培训

使用方法

基本使用流程

1. 拉取镜像（若需指定版本，替换latest为具体版本号）：

   bash
   docker pull [镜像仓库地址]/android-build-image:latest
   

2. 运行容器构建Android项目：

   bash
   docker run -it --rm \
     -v /本地/android项目路径:/app \  # 挂载项目目录
     -v ~/.gradle:/root/.gradle \      # 挂载Gradle缓存（加速构建）
     -w /app \                         # 设置工作目录为项目根目录
     [镜像仓库地址]/android-build-image:latest \
     ./gradlew assembleRelease         # 执行构建命令（生成Release包）
   

环境变量配置

通过-e参数可自定义构建环境，常用环境变量：

• ANDROID_SDK_ROOT：Android SDK路径（默认已配置，无需修改）
• ANDROID_BUILD_TOOLS_VERSION：指定Build Tools版本（如34.0.0）
• ANDROID_PLATFORM_VERSION：指定目标Android平台版本（如android-33）
• GRADLE_OPTS：Gradle运行参数（如-Xmx2048m设置内存限制）

示例（指定Android 13构建）：

bash
docker run -it --rm \
  -v /本地/android项目路径:/app \
  -e ANDROID_PLATFORM_VERSION=android-33 \
  -e ANDROID_BUILD_TOOLS_VERSION=33.0.1 \
  -w /app \
  [镜像仓库地址]/android-build-image:latest \
  ./gradlew assembleDebug

卷挂载说明

• 项目目录：必须挂载本地Android项目根目录到容器内/app，确保构建命令可访问项目文件
• Gradle缓存：挂载~/.gradle到容器/root/.gradle，避免重复下载依赖，显著提升构建速度
• SDK缓存：如需持久化SDK组件，可额外挂载/opt/android-sdk到本地目录（可选）

示例：CI/CD集成（GitLab CI配置）

在.gitlab-ci.yml中使用该镜像执行自动化构建：

yaml
stages:
  - build

android-build:
  stage: build
  image: [镜像仓库地址]/android-build-image:latest
  script:
    - ./gradlew clean assembleRelease
  artifacts:
    paths:
      - app/build/outputs/apk/release/*.apk  # 保存构建产物
  cache:
    paths:
      - ~/.gradle/caches/                   # 缓存Gradle依赖

注意事项

• 首次运行可能因下载额外SDK组件（如指定版本的Build Tools）耗时较长，建议预先配置常用Android版本环境变量
• 构建过程需网络连接以下载依赖（如Maven仓库包），确保容器网络通畅
• 对于大型项目，建议通过GRADLE_OPTS增加内存分配（如-Xmx4096m）以避免构建超时