inovex/gitlab-ci-android

Android CI构建Docker镜像

镜像概述

本Docker镜像专为Android CI（持续集成）构建设计，基于GitHub仓库https://github.com/inovex/gitlab-ci-android%E3%80%82%E9%95%9C%E5%83%8F%E5%86%85%E7%BD%AEAndroid%E5%BC%80%E5%8F%91%E5%92%8C%E6%9E%84%E5%BB%BA%E6%89%80%E9%9C%80%E7%9A%84%E5%AE%8C%E6%95%B4%E5%B7%A5%E5%85%B7%E9%93%BE%EF%BC%8C%E5%8F%AF%E5%BF%AB%E9%80%9F%E9%9B%86%E6%88%90%E5%88%B0CI/CD%E6%B5%81%E7%A8%8B%E4%B8%AD%EF%BC%8C%E5%AE%9E%E7%8E%B0Android%E5%BA%94%E7%94%A8%E7%9A%84%E8%87%AA%E5%8A%A8%E5%8C%96%E6%9E%84%E5%BB%BA%E3%80%81%E6%B5%8B%E8%AF%95%E5%92%8C%E6%89%93%E5%8C%85%EF%BC%8C%E5%87%8F%E5%B0%91%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE%E6%97%B6%E9%97%B4%EF%BC%8C%E6%8F%90%E5%8D%87%E5%BC%80%E5%8F%91%E6%95%88%E7%8E%87%E3%80%82

核心功能与特性

• 完整工具链：包含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插件