iteratorsmobile/gitlab-ci-android-fastlane

gitlab-ci-android-fastlane 镜像文档

镜像概述

gitlab-ci-android-fastlane是一个集成了Android SDK和fastlane工具的Docker镜像，专为GitLab CI/CD环境设计，旨在简化Android项目的自动化构建、测试和部署流程。通过该镜像，开发团队可直接在GitLab CI/CD管道中执行Android应用的构建和发布操作，无需在CI服务器上手动配置Android开发环境。

核心功能与特性

• 内置Android SDK：包含Android开发所需的基础工具和环境，支持Android应用编译构建
• 集成fastlane：预装fastlane自动化工具，支持Android应用的打包、测试和发布流程自动化
• GitLab CI/CD兼容：针对GitLab CI/CD流程优化，可直接在.gitlab-ci.yml中配置使用
• 缓存支持：可通过GitLab CI缓存机制加速构建过程，减少重复依赖下载

使用场景

• 基于GitLab CI/CD的Android项目持续集成构建
• Android应用的自动化测试与打包
• 通过fastlane实现Android应用的手动/自动部署（如部署到测试环境、应用商店等）
• 需要在CI/CD流程中统一Android开发环境的团队

使用方法与配置说明

基本配置

在GitLab项目的.gitlab-ci.yml文件中指定该镜像，即可在CI/CD流程中使用：

yaml
image: iteratorsmobile/gitlab-ci-android-fastlane

完整CI/CD配置示例

以下是一个包含构建和部署阶段的完整.gitlab-ci.yml配置示例：

yaml
image: iteratorsmobile/gitlab-ci-android-fastlane

stages:
  - build
  - deploy

# 缓存Gradle依赖，加速构建
cache:
  key: ${CI_PROJECT_ID}
  paths:
    - .gradle/

# 构建前准备：赋予gradlew执行权限
before_script:
  - chmod +x ./gradlew

# 构建作业：执行Release版本构建
build_job:
  stage: build
  script:
    - ./gradlew assembleRelease
  artifacts:
    paths:
      - app/build/outputs  # 保存构建输出产物

# 部署作业：手动触发fastlane部署到测试环境
deploy_internal:
  stage: deploy
  when: manual  # 需要手动触发
  script:
    - fastlane android staging  # 执行fastlane的staging环境部署任务

关键配置说明

• stages：定义CI/CD流程的阶段，示例中包含build（构建）和deploy（部署）两个阶段
• cache：配置缓存路径（.gradle/），避免每次构建重复下载依赖，提高构建效率
• before_script：构建前执行的命令，通过chmod +x ./gradlew确保Gradle包装器可执行
• build_job：构建阶段任务，执行./gradlew assembleRelease生成Release版本APK，并通过artifacts保存构建产物
• deploy_internal：部署阶段任务，设置为when: manual需手动触发，通过fastlane android staging执行fastlane定义的部署流程

依赖要求

• 项目需包含gradlew（Gradle包装器）文件
• 需在项目中配置fastlane（包含Fastfile等配置文件），定义staging等部署环境的任务