jangrewe/gitlab-ci-android

gitlab-ci-android

镜像概述

该Docker镜像包含Android SDK及构建Android应用所需的大多数常用包，专为在GitLab CI等CI工具中构建Android应用设计。通过合理配置CI环境的缓存机制，可显著提升构建效率，尤其在多构建任务场景下效果明显。

核心功能和特性

• 内置Android SDK及常用构建依赖包，满足Android应用构建基本需求
• 针对GitLab CI环境优化，可直接集成到CI流水线中
• 支持通过缓存Gradle依赖等方式减少重复下载，缩短构建时间

使用场景

适用于需要在CI/CD流程中自动化构建Android应用的场景，包括但不限于：

• GitLab CI流水线中的Android应用构建任务
• 其他支持Docker容器的CI/CD平台（如Jenkins、GitHub Actions等）
• 多阶段构建流程中的Android应用编译环节

使用方法和配置说明

基本配置

在GitLab CI配置文件（.gitlab-ci.yml）中指定该镜像，并配置缓存以优化构建效率。

环境变量

• GRADLE_USER_HOME：指定Gradle的用户主目录，用于缓存Gradle依赖，建议设置为项目内目录（如$(pwd)/.gradle）以便CI缓存

缓存配置

为提升构建速度，建议缓存Gradle依赖目录。缓存键可使用项目ID（${CI_PROJECT_ID}）确保唯一性，缓存路径设置为.gradle/。

构建步骤

1. 配置before_script：设置Gradle用户目录并赋予构建脚本执行权限
2. 定义构建阶段和任务
3. 执行Gradle构建命令（如assembleDebug）
4. 保存构建产物（如APK文件）

示例配置

以下是一个包含依赖缓存的.gitlab-ci.yml示例：

yaml
image: docker.xuanyuan.run/jangrewe/gitlab-ci-android

stages:
  - build

before_script:
  - export GRADLE_USER_HOME=$(pwd)/.gradle
  - chmod +x ./gradlew

cache:
  key: ${CI_PROJECT_ID}
  paths:
    - .gradle/

build:
  stage: build
  script:
    - ./gradlew assembleDebug
  artifacts:
    paths:
      - app/build/outputs/apk/app-debug.apk

示例说明

• image: jangrewe/gitlab-ci-android：指定使用该镜像
• before_script：设置Gradle缓存目录并确保gradlew可执行
• cache：缓存Gradle依赖，避免重复下载
• build阶段：执行assembleDebug命令构建调试版APK，并将产物保存为artifacts