tkmps/tkimg-android

Android Build CircleCI Docker镜像

镜像概述和主要用途

该Docker镜像专为CircleCI持续集成/持续部署(CI/CD)环境设计，提供完整的Android开发和构建环境，旨在简化Android项目在CircleCI上的自动化构建流程。通过预装必要的开发工具和依赖，减少环境配置时间，确保构建过程的一致性和可靠性。主要用于在CircleCI平台上执行Android应用的构建、编译、测试及打包操作，支持从代码检出到APK/AAB生成的全流程自动化。

核心功能和特性

• 预装Android开发环境：集成Android SDK、Build Tools、Platform Tools等核心组件，无需手动安装配置
• 多版本支持：适配多种Android API级别和Build Tools版本，满足不同项目需求
• Gradle集成：预装Gradle构建工具，支持自定义Gradle版本，优化构建性能
• CircleCI优化：针对CircleCI缓存机制（依赖缓存、构建缓存）进行优化，提升构建速度
• 兼容性：兼容CircleCI 2.0+及后续版本，支持Linux x86_64架构
• 安全性：定期更新基础镜像及依赖组件，修复安全漏洞，确保构建环境安全

使用场景和适用范围

• Android项目CI/CD：适用于需要在CircleCI上实现Android应用自动化构建、测试、打包的开发团队
• 多环境构建：支持为开发、测试、生产等不同环境生成对应构建产物
• 开源/商业项目：适配开源Android项目及商业应用，简化构建流程
• 教育/个人项目：个人开发者或学生可通过该镜像快速搭建Android CI/CD流程

使用方法和配置说明

在CircleCI中配置使用

1. 修改CircleCI配置文件
   在项目根目录下的.circleci/config.yml中指定该镜像，示例配置如下：

   yaml
   version: 2.1
   jobs:
     build-android:
       docker:
         - image: [镜像名称]  # 替换为实际镜像名称
       steps:
         - checkout
         - restore_cache:
             keys:
               - v1-dependencies-{{ checksum "build.gradle" }}
               - v1-dependencies-
         - run:
             name: 下载依赖
             command: ./gradlew dependencies
         - save_cache:
             paths:
               - ~/.gradle/caches
               - ~/.gradle/wrapper
             key: v1-dependencies-{{ checksum "build.gradle" }}
         - run:
             name: 构建APK
             command: ./gradlew assembleDebug
         - store_artifacts:
             path: app/build/outputs/apk/debug/app-debug.apk
             destination: apk/
   workflows:
     build:
       jobs:
         - build-android
   

2. 配置环境变量（可选）
   在CircleCI项目设置中添加以下环境变量自定义构建参数：

   • ANDROID_API_LEVEL: 目标Android API级别（默认：最新稳定版）
   • BUILD_TOOLS_VERSION: Android Build Tools版本（默认：最新稳定版）
   • GRADLE_VERSION: Gradle版本（默认：7.5+）

本地测试使用

通过以下命令在本地测试镜像功能：

bash
docker run -it --rm \
  -v /path/to/your/android/project:/app \
  -w /app \
  [镜像名称] \
  ./gradlew assembleDebug

参数说明：

• -v /path/to/your/android/project:/app: 挂载本地Android项目目录到容器内/app
• -w /app: 设置工作目录为/app
• [镜像名称]: 替换为实际镜像名称
• ./gradlew assembleDebug: 执行Android Debug版本构建

配置参数说明