kylemanna/aosp

Android Open Source Project Docker构建环境

镜像概述和主要用途

这是一个最小化的Android AOSP（Android开放源代码项目）构建环境，配备便捷的自动化包装脚本。开发者可在任意Linux发行版上直接使用该Docker镜像进行构建，无需担心因系统包更新（尤其是在Arch Linux等滚动发行版上）导致的AOSP构建中断问题。生产构建服务器和集成测试服务器也应使用相同镜像，确保开发者与生产环境使用完全一致的构建环境，从而尽早发现并解决构建问题。

注意：该镜像仅在Linux上能良好工作。通过boot2docker运行时，由于VirtualBox的vboxsf共享文件夹服务在AOSP等大型构建中性能极差，会导致严重性能问题。Mac OS X和Windows用户建议使用https://github.com/kylemanna/vagrant-aosp%E8%99%9A%E6%8B%9F%E6%9C%BA%E8%BF%9B%E8%A1%8C%E5%BC%80%E5%8F%91%E3%80%82

核心功能和特性

• 最小化构建环境：基于Ubuntu基础镜像，仅包含构建Android所需的最小化软件包
• 自动化包装脚本：提供aosp包装脚本，简化Docker镜像调用流程
• 环境一致性：确保开发者、生产构建和测试环境完全一致，减少构建差异导致的问题
• 权限处理：自动处理卷挂载权限，确保容器内aosp用户可访问宿主机目录
• SSH代理转发：支持将宿主机的ssh-agent转发到容器内，方便访问私有Git仓库

使用场景和适用范围

• 开发者日常构建AOSP源代码
• 生产环境中的AOSP构建服务器
• 集成测试服务器，确保构建一致性
• 需要在不同Linux发行版上保持一致构建环境的团队

使用方法和配置说明

快速开始

适用于希望快速体验的用户：

1. 创建工作目录并进入：

   bash
   mkdir kitkat ; cd kitkat
   

2. 设置环境变量，指定持久化文件存储目录：

   bash
   export AOSP_VOL=$PWD
   

3. 下载并运行构建脚本：

   bash
   curl -O https://raw.githubusercontent.com/kylemanna/docker-aosp/master/tests/build-kitkat.sh
   bash ./build-kitkat.sh
   

   脚本会自动完成以下操作：

   • 检查并获取aosp包装脚本（如本地不存在）
   • 运行aosp包装脚本，处理Docker镜像拉取和容器运行参数
   • 在容器内初始化repo、拉取源代码并执行构建

工作原理

Dockerfile基础

Dockerfile基于Ubuntu基础镜像，包含构建Android所需的最小化软件包，确保环境精简且高效。

aosp包装脚本

aosp是简化Docker镜像调用的包装脚本，主要功能包括：

• 确保卷挂载可访问，并为容器内aosp用户设置正确权限（可能需要sudo）
• 转发ssh-agent到容器内，支持访问私有Git仓库
• 无缝处理Docker镜像拉取和容器运行参数

基本使用方式

使用aosp前缀执行容器内命令，例如在容器中运行repo sync：

bash
aosp repo sync -j2

对于环境配置类操作，可通过编写简短脚本实现，例如tests/build-kitkat.sh展示了完整的AOSP拉取和构建流程。

测试版本

已测试通过的AOSP版本：

• Android Kitkat android-4.4.4_r2.0.1