Android Docker镜像文档

镜像概述

本Docker镜像提供了一个完整的Android运行和开发环境，将Android SDK及相关工具封装为容器化应用，旨在简化Android应用的开发、测试流程，避免本地环境配置差异带来的问题，支持快速集成到开发或CI/CD流程中。

核心功能和特性

• 完整Android开发工具链：内置Android SDK、Build Tools、Platform Tools等核心开发工具
• 多API级别支持：可配置不同Android API级别（如API 28、30、33等），满足不同版本应用开发需求
• 轻量级容器化：基于精简基础镜像构建，降低资源占用，启动快速
• 环境一致性：容器化确保开发、测试环境一致，减少"在我机器上能运行"问题
• 灵活配置：支持通过环境变量自定义SDK组件、模拟器设置等

使用场景

• Android应用开发测试：本地开发时快速切换不同Android环境，验证应用兼容性
• 自动化测试：集成到UI自动化测试框架（如Appium、Espresso），执行应用自动化测试用例
• CI/CD流程集成：作为CI/CD流水线中的构建节点，完成应用编译、打包、测试等流程
• 教学与演示：快速搭建临时Android开发环境，用于教学或技术演示

使用方法

基本运行命令

通过以下命令启动Android环境容器：

docker run -it --rm \
  -v $(pwd):/app \
  -e ANDROID_API_LEVEL=33 \
  -e ANDROID_BUILD_TOOLS_VERSION=33.0.2 \
  android:latest \
  /bin/bash

参数说明：

• -v $(pwd):/app：将本地当前目录挂载到容器内/app目录，用于共享项目代码
• -e ANDROID_API_LEVEL：指定Android API级别（如28、30、33）
• -e ANDROID_BUILD_TOOLS_VERSION：指定Android Build Tools版本

常用环境变量配置

集成CI/CD示例（GitLab CI配置）

在.gitlab-ci.yml中集成该镜像执行自动化构建：

stages:
  - build

android-build:
  stage: build
  image: android:latest
  variables:
    ANDROID_API_LEVEL: 33
    ANDROID_BUILD_TOOLS_VERSION: 33.0.2
  script:
    - cd /app
    - ./gradlew clean assembleDebug
  artifacts:
    paths:
      - app/build/outputs/apk/debug/*.apk

启动Android模拟器（可选）

若需在容器中运行Android模拟器，需配置额外参数（需宿主机支持虚拟化）：

docker run -it --rm \
  --privileged \
  -v $(pwd):/app \
  -e ANDROID_API_LEVEL=33 \
  -e ANDROID_EMULATOR=true \
  android:latest \
  sh -c "emulator -avd test-avd -no-window -no-audio &"

注意：运行模拟器需宿主机开启CPU虚拟化支持，并添加--privileged参数赋予容器设备访问权限。