jd565/android-fastlane

Android构建环境Docker镜像

概述

该Docker镜像集成了Android构建工具、fastlane和Gradle，旨在提供一个一致、便捷的Android应用构建环境。通过容器化方式消除本地环境配置差异，简化Android应用从代码到发布的全流程，适用于开发、测试和CI/CD场景。

核心功能与特性

• 完整工具链：包含Android SDK构建工具（build-tools）、平台工具（platform-tools）、fastlane自动化工具和Gradle构建系统
• 环境一致性：统一工具版本，避免因本地环境差异导致的构建问题
• 零本地依赖：无需在主机安装Android SDK、fastlane或Gradle，直接通过容器运行
• CI/CD兼容：支持集成到主流CI/CD平台（如Jenkins、GitHub Actions），实现自动化构建流程

使用场景

• Android应用的持续集成/持续部署流程
• 多团队协作时的统一构建标准
• 快速搭建临时构建环境进行测试验证
• 教学或演示环境中的Android构建示例

使用方法

基本构建命令

bash
docker run -v /本地项目路径:/app -w /app 镜像名称 gradle assembleDebug

• -v /本地项目路径:/app：将本地Android项目目录挂载到容器内/app目录
• -w /app：设置工作目录为项目根目录
• gradle assembleDebug：执行Gradle命令构建Debug版本APK

使用fastlane自动化发布

bash
docker run -v /本地项目路径:/app -w /app 镜像名称 fastlane [lane名称]

前提：项目中已配置fastlane/Fastfile，例如执行fastlane beta可自动构建并上传测试版本

环境变量配置

可通过环境变量自定义工具行为：

• ANDROID_HOME：Android SDK路径（默认：/opt/android-sdk）
• GRADLE_USER_HOME：Gradle缓存目录（默认：/root/.gradle，建议挂载本地目录以加速构建）
• FASTLANE_OPTIONS：fastlane额外参数（如--verbose开启详细日志）

挂载缓存示例（提升构建速度）

bash
docker run \
  -v /本地项目路径:/app \
  -v /本地缓存目录/gradle:/root/.gradle \
  -v /本地缓存目录/android:/opt/android-sdk/cache \
  -w /app \
  镜像名称 \
  gradle assembleRelease

docker-compose配置示例

yaml
version: '3'
services:
  android-builder:
    image: 镜像名称
    volumes:
      - ./android-project:/app
      - ./gradle-cache:/root/.gradle
      - ./android-sdk-cache:/opt/android-sdk/cache
    working_dir: /app
    command: gradle bundleRelease