jerbob92/gitlab-ci-android

Android构建Docker镜像

用于GitLab CI的Android应用构建与测试镜像

该镜像的代码会在Docker Hub自动构建：
https://hub.docker.com/r/jerbob92/gitlab-ci-android/

镜像概述

本镜像为GitLab CI流水线提供Android应用的完整构建与测试环境，支持Gradle构建、缓存优化、单元测试及模拟器可视化测试记录，帮助开发者实现Android项目的自动化CI流程。

核心功能

• 支持Android应用的Gradle编译（assemble）与检查（check）
• 缓存Gradle wrapper和依赖，提升构建效率
• 集成Android模拟器，支持可视化测试及屏幕录制
• 提供测试失败时的 artifact 上传（录制视频、测试日志）

使用场景

适用于GitLab CI流水线中的Android项目，包括：

• 日常开发中的自动化构建与单元测试
• 模拟器上的UI自动化测试（如Espresso框架）
• 测试失败时的问题定位（通过录制视频和日志）

配置说明

基础构建与测试示例

yml
image: jerbob92/gitlab-ci-android:latest

before_script:
    - export GRADLE_USER_HOME=`pwd`/.gradle
    - mkdir -p $GRADLE_USER_HOME
    - chmod +x ./gradlew

cache:
  paths:
     - .gradle/wrapper
     - .gradle/caches

build:
  stage: build
  script:
     - ./gradlew assemble

test:
  stage: test
  script:
     - ./gradlew check

带模拟器可视化测试与屏幕录制的示例

image: jerbob92/gitlab-ci-android:latest

stages:
  - build
  - test

before_script:
    - export GRADLE_USER_HOME=`pwd`/.gradle
    - mkdir -p $GRADLE_USER_HOME
    - chmod +x ./gradlew

cache:
  paths:
     - .gradle/wrapper
     - .gradle/caches

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

test:
  stage: test
  script:
      - echo "no" | /sdk/tools/android create avd -f -n test -t android-23 --abi "google_apis/x86" -s WXGA720
      - echo "no" | /sdk/tools/emulator64-x86 -avd test -wipe-data -noaudio -no-window -gpu off -verbose -qemu -usbdevice tablet -vnc :2 &
      - /helpers/wait-for-avd-boot.sh
      - /sdk/platform-tools/adb install -r app/build/outputs/apk/app-debug.apk
      - /sdk/platform-tools/adb install -r app/build/outputs/apk/app-debug-androidTest-unaligned.apk
      - /sdk/platform-tools/adb shell pm grant [package-name] android.permission.SET_ANIMATION_SCALE
      - flvrec.py -o test.flv localhost 5902 &
      - /sdk/platform-tools/adb shell am instrument -w -r -e debug false [package-name]/[test-class] | tee test.log
      - pkill -f flvrec
      - yamdi -i test.flv -o test_recording.flv
      - rm test.flv
      - if grep -q "FAILURES!!!" test.log; then exit 1; fi
  artifacts:
    paths:
      - test_recording.flv
      - test.log
    when: on_failure
    expire_in: 1 week

请将 [package-name] 替换为你的应用包名，[test-class] 替换为测试类名。该示例会录制测试过程，若测试失败则上传视频和日志。建议结合Espresso测试框架使用。