容器化革命：用Docker打造高可复用的Android CTS测试环境

在Android系统开发与测试领域，兼容性测试套件(CTS)是确保设备符合Google兼容性标准的基石。然而传统CTS测试环境的搭建过程堪称"依赖地狱"——从Ubuntu系统配置、JDK版本适配到SDK工具链部署，每一步都可能遇到难以排查的环境问题。更令人头疼的是，当需要跨团队协作或多设备并行测试时，环境不一致导致的测试结果偏差屡见不鲜。

1. 为什么需要容器化CTS环境

1.1 传统方式的痛点分析

手工搭建CTS测试环境通常需要处理以下复杂依赖：

• 操作系统层：特定版本的Ubuntu（如22.04 LTS）
• Java环境：精确匹配的JDK（如OpenJDK 11）
• Android工具链：SDK Platform Tools、build-tools等
• 测试资源：CTS测试包、媒体文件等大型二进制资源

这些依赖项不仅安装步骤繁琐，还存在以下典型问题：

1. 环境配置文档过时导致依赖版本冲突
2. 不同测试人员环境差异造成测试结果不一致
3. 无法快速复制环境到新机器或CI/CD流水线
4. 本地环境污染导致难以隔离多版本测试

1.2 容器化解决方案的优势

通过Docker容器技术，我们可以实现：

• 环境即代码：用Dockerfile定义所有依赖和配置
• 一次构建，随处运行：构建的镜像可在任何支持Docker的主机上运行
• 资源隔离：每个测试会话在独立容器中执行，互不干扰
• 版本控制：镜像版本与CTS测试套件版本严格对应

# 示例：基础环境Dockerfile片段
FROM ubuntu:22.04
ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get install -y \
    openjdk-11-jdk \
    unzip \
    wget \
    adb

2. 构建CTS测试容器镜像

2.1 基础镜像准备

我们选择官方Ubuntu 22.04镜像作为基础，逐步添加CTS所需组件：

# 构建基础镜像
docker build -t android-cts-base:1.0 -f Dockerfile.base .

# 验证Java环境
docker run --rm android-cts-base:1.0 java -version

2.2 分层构建策略

为提高构建效率，采用分层构建方案：

镜像层级	包含内容	构建频率
base	OS+JDK	低频更新
sdk	Android SDK工具链	中频更新
cts	特定版本CTS套件	高频更新

# 多阶段构建示例
FROM android-cts-base:1.0 AS sdk
ARG SDK_VERSION=33
RUN wget https://dl.google.com/android/repository/commandlinetools-linux-${SDK_VERSION}_latest.zip && \
    unzip commandlinetools-linux-${SDK_VERSION}_latest.zip && \
    ./cmdline-tools/bin/sdkmanager --install "platform-tools" "build-tools;33.0.0"

2.3 完整镜像构建流程

1. 下载CTS测试包和媒体文件
2. 编写Dockerfile整合所有组件
3. 使用多阶段构建优化镜像体积

FROM sdk AS final
COPY android-cts-12_r5-linux_x86-arm.zip /tmp
COPY android-cts-media-1.5.zip /tmp
RUN unzip /tmp/android-cts-12_r5-linux_x86-arm.zip -d /opt && \
    unzip /tmp/android-cts-media-1.5.zip -d /opt/media
ENV PATH="/opt/android-cts/tools:${PATH}"
WORKDIR /opt/android-cts

3. 容器化CTS测试运行时配置

3.1 设备连接方案

测试设备通过USB连接到宿主机，容器通过挂载设备节点访问：

docker run -it --rm \
    --privileged \
    -v /dev/bus/usb:/dev/bus/usb \
    -v $PWD/results:/opt/android-cts/results \
    android-cts:12_r5

3.2 数据持久化策略

关键目录挂载方案：

容器路径	宿主机路径	用途
/opt/android-cts/results	./results	测试报告
/opt/media	./media	媒体文件缓存
/root/.android	./android_config	ADB配置

3.3 常用测试命令封装

创建便捷的测试脚本：

#!/bin/bash
# run_cts.sh
docker run -it --rm \
    --privileged \
    -v /dev/bus/usb:/dev/bus/usb \
    -v $PWD/results:/opt/android-cts/results \
    android-cts:12_r5 \
    ./tools/cts-tradefed run cts --plan CTS

4. 高级应用场景与实践技巧

4.1 CI/CD集成方案

在Jenkins或GitLab CI中集成CTS测试：

# .gitlab-ci.yml示例
stages:
  - test

cts-test:
  stage: test
  image: docker:20.10
  services:
    - docker:dind
  script:
    - docker run --privileged -v /dev/bus/usb:/dev/bus/usb $CTS_IMAGE
  artifacts:
    paths:
      - results/

4.2 多设备并行测试

利用Docker Compose管理多设备测试：

version: '3'
services:
  cts-device1:
    image: android-cts:12_r5
    privileged: true
    volumes:
      - /dev/bus/usb/001/001:/dev/bus/usb/001/001
      - ./results/device1:/results

  cts-device2:
    image: android-cts:12_r5
    privileged: true
    volumes:
      - /dev/bus/usb/001/002:/dev/bus/usb/001/002
      - ./results/device2:/results

4.3 常见问题排查指南

问题现象：ADB设备未识别

• 检查USB设备权限
• 确认内核模块加载正确
• 验证容器内lsusb命令输出

问题现象：媒体文件缺失

• 检查媒体文件挂载路径
• 验证容器内文件权限
• 确认媒体文件版本匹配

# 调试命令示例
docker exec -it cts-container adb devices
docker exec -it cts-container ls -l /opt/media

5. 性能优化与最佳实践

5.1 镜像构建优化

• 使用.dockerignore排除无关文件
• 合理安排Dockerfile指令顺序
• 利用构建缓存加速重复构建

# 优化后的Dockerfile片段
COPY .dockerignore .
COPY android-cts-media-1.5.zip /tmp
RUN unzip /tmp/android-cts-media-1.5.zip -d /opt/media && \
    rm /tmp/android-cts-media-1.5.zip

5.2 运行时资源限制

合理配置容器资源：

docker run -it --rm \
    --cpus 2 \
    --memory 4g \
    --device-read-bps /dev/sda:1mb \
    android-cts:12_r5

5.3 安全实践

• 避免在镜像中存储敏感信息
• 使用非root用户运行容器
• 定期更新基础镜像安全补丁

# 安全增强示例
RUN groupadd -r cts && useradd -r -g cts cts
USER cts