kmindi/android-ci

Android CI

本镜像专为Android项目的持续集成（CI）场景设计，提供完整的SDK环境支持。

核心功能

镜像包含以下关键组件：

• Android构建工具（build tools）
• 平台工具（platform tools）
• Android 28 SDK及x86_64系统镜像
• extra-android-m2repository
• extra-google-m2repository
• extra-google-google_play_services

使用场景

适用于GitLab CI环境下的Android应用自动化流程，包括：

• 应用构建（assemble）
• 单元测试（test）
• 仪器化测试（connectedAndroidTest）
• 代码覆盖率报告生成

配置说明

以下是GitLab CI配置示例（.gitlab-ci.yml）：

YAML
image: kmindi/android-ci:platforms-28

variables:
  GRADLE_OPTS: "-Dorg.gradle.daemon=false"

before_script:
  # 定义缓存文件夹以支持GitLab CI缓存
  - export ANDROID_SDK_HOME=$CI_PROJECT_DIR
  - export GRADLE_USER_HOME=$(pwd)/.gradle
  - chmod +x ./gradlew

stages:
  - build
  - test

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

build:tagged:
  stage: build
  tags:
    - docker
  script:
    - ./gradlew assembleDebug
  artifacts:
    name: "AppName_{$CI_BUILD_TAG}"
    paths:
    - app/build/outputs/apk/
  only:
    - tags
    
build:
  stage: build
  tags:
    - docker
  script:
    - ./gradlew assembleDebug
  artifacts:
    name: "AppName_{$CI_BUILD_ID}"
    expire_in: 1 week
    paths:
    - app/build/outputs/apk/
  except:
    - tags

test:unit:
  stage: test
  tags:
    - docker
  script:
    - ./gradlew test jacocoTestReport
    - cat "app/build/reports/jacoco/jacocoTestReport/html/index.html"
  coverage: '/Total.+?([0-9]{1,3})\%/'
  cache:
    key: ${CI_PROJECT_ID}
    paths:
    - .gradle/
    - .android/build-cache/
    policy: pull
  artifacts:
    name: "tests-unit-${CI_BUILD_NAME}_${CI_BUILD_REF_NAME}_${CI_BUILD_REF}"
    expire_in: 1 week
    paths:
      - "**/build/reports/**"
    
test:instrumentation:28:
  stage: test
  tags: 
    - docker
    - kvm
  script:
    - echo no | avdmanager -v create avd --force --name test --abi google_apis/x86_64 --package "system-images;android-28;google_apis;x86_64"
    - export SHELL=/bin/bash && echo "no" | emulator -avd test -no-audio -no-window -gpu off -verbose -qemu &
    - adb wait-for-device
    - android-wait-for-emulator
    - export TERM=${TERM:-dumb}
    - export ADB_INSTALL_TIMEOUT=4 # 分钟（默认2分钟）
    - assure_emulator_awake.sh "./gradlew connectedAndroidTest"
    - ./gradlew createDebugCoverageReport
    - cat "app/build/reports/coverage/debug/index.html"
  coverage: '/Total.+?([0-9]{1,3})\%/'
  artifacts:
    name: "tests-instrumentation-28-${CI_BUILD_NAME}"
    expire_in: 1 week
    paths:
      - "**/build/reports/**"