amsitoperations/ams-android-gradle

adesso-mobile/ams-android-gradle-docker 镜像文档

镜像概述

adesso-mobile/ams-android-gradle-docker是adesso mobile solutions提供的官方Docker镜像，旨在简化Android应用的构建流程。该镜像集成了Java、Kotlin开发环境及Gradle构建工具，提供了一致、可复现的Android应用构建环境，适用于开发团队本地开发及CI/CD流水线集成。

核心功能与特性

• 预装开发环境：集成Java和Kotlin运行时环境，无需额外配置开发语言环境
• Gradle集成：内置Gradle构建工具，支持Android项目的编译、打包等构建流程
• Android构建支持：兼容Android应用开发的标准构建流程，支持Java和Kotlin混合开发项目
• 环境一致性：统一开发和构建环境，避免因本地环境差异导致的构建问题
• 轻量易用：简化配置，可直接集成到现有开发或CI/CD流程中

使用场景

• 本地开发环境：开发团队快速搭建一致的Android构建环境，无需手动配置Java、Kotlin和Gradle
• CI/CD流水线：集成到Jenkins、GitLab CI、GitHub Actions等CI/CD工具中，作为Android应用构建的标准化步骤
• 自动化构建：用于自动化脚本或工具中，执行Android项目的构建、测试等任务

使用方法与配置说明

基本使用

通过docker run命令启动容器，挂载本地Android项目目录并执行Gradle构建命令：

bash
docker run --rm -v $(pwd):/app -w /app adesso-mobile/ams-android-gradle-docker gradle build

参数说明：

• --rm：容器退出后自动删除，避免残留容器实例
• -v $(pwd):/app：将当前目录（Android项目根目录）挂载到容器内的/app目录
• -w /app：设置容器的工作目录为/app（即挂载的项目目录）
• gradle build：执行Gradle构建命令，可替换为其他Gradle任务（如gradle assembleDebug、gradle test等）

高级配置

自定义Gradle版本

如需使用特定版本的Gradle，可通过项目内的gradle/wrapper/gradle-wrapper.properties文件指定，容器会自动使用项目配置的Gradle版本。

持久化Gradle缓存

为提高构建效率，可将Gradle缓存目录挂载到本地：

bash
docker run --rm \
  -v $(pwd):/app \
  -v ~/.gradle/caches:/root/.gradle/caches \
  -w /app \
  adesso-mobile/ams-android-gradle-docker \
  gradle build

CI/CD集成示例（GitLab CI）

在.gitlab-ci.yml中集成该镜像作为构建步骤：

yaml
build_android:
  image: adesso-mobile/ams-android-gradle-docker
  stage: build
  script:
    - gradle clean assembleRelease
  artifacts:
    paths:
      - app/build/outputs/apk/release/*.apk

注意事项

• 确保本地Docker环境已正确安装并运行
• 挂载项目目录时，路径需正确指向Android项目的根目录（包含build.gradle文件的目录）
• 首次运行时，Gradle会下载依赖包，可能需要较长时间，后续构建可利用缓存加速