摘要：本文介绍一套用于编译 AOSP 源码的 Docker 环境安装脚本工程。工程以
aosp_docker_env_install.sh为入口，自动完成 apt 源替换、基础工具安装、Docker 安装与基础镜像构建，并调用set_swap.sh扩充 swap 以避免编译时被 OOM 杀掉。镜像构建由Dockerfile.base_ubuntu_1804-v0.5配合install/sources.list（阿里源）与install/ubuntu_install_core.sh（安装编译依赖、OpenJDK 8、Python 及 repo 工具）完成。此外还提供run_docker.py脚本，用于在宿主机上便捷地创建、启动并进入带目录映射与端口映射的编译容器，README.md则给出完整的安装与使用说明。
本篇文章主要介绍用于编译 AOSP 代码的 Docker 环境安装脚本工程，工程文件树如下所示：
├── aosp_docker_env_install.sh // env install script ├── Dockerfile.base_ubuntu_1804-v0.5 // docker build dockerfile ├── install // docker build file │ ├── sources.list // modify docker sources list file │ └── ubuntu_install_core.sh // docker install file ├── README.md // readme file ├── run_docker.py // host docker script └── set_swap.sh // host swap modify for android build fail整体架构与流程
整个工程围绕「宿主机准备 → 构建基础镜像 → 运行编译容器」三个阶段展开，各脚本之间的调用关系如下：
从职责划分看，各文件的分工如下：
aosp_docker_env_install.sh: env install script
#!/bin/bash # @content: this shell script install the docker tools # modify apt src mv /etc/apt/sources.list /etc/apt/sources.list-$(date "+%Y%m%d-%H%M%S") && \ cp ./install/sources.list /etc/apt/sources.list # install basic software tool apt-get update && apt install -y --no-install-recommends build-essential \ vim \ curl # config no certificate, this can be remove if the company network 1 # do not have the certificate issue echo insecure >> ~/.curlrc echo "check_certificate = off" >> ~/.wgetrc git config --global http.sslVerify false export CURL_CA_BUNDLE="" # install docker curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun # build docker image sudo docker build -t ubuntu:1804.base -f Dockerfile.base_ubuntu_1804-v0.5 . # add host swap for android build fail error ./set_swap.shDockerfile.base_ubuntu_1804-v0.5: Docker build dockerfile
# Pull base image From ubuntu:18.04 LABEL maintainer="" ARG DEBIAN_FRONTEND=noninteractive COPY install/sources.list /install/sources.list COPY install/ubuntu_install_core.sh /install/ubuntu_install_core.sh RUN bash /install/ubuntu_install_core.sh # Set environment variables. ENV HOME /root # Define working directory. WORKDIR /root # Define default command. CMD ["bash"]sources.list：modify docker sources list file
#添加阿里源 deb http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse deb http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse deb http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse deb http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse deb http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse deb-src http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse deb-src http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse deb-src http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse deb-src http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse deb-src http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverseubuntu_install_core.sh：Docker install file
#!/bin/bash # @content: this shell script install the unbuntu base tools of android # modify apt src mv /etc/apt/sources.list /etc/apt/sources.list-$(date "+%Y%m%d-%H%M%S") && \ cp /install/sources.list /etc/apt/sources.list # install basic software tool apt-get update && apt install -y --no-install-recommends build-essential \ software-properties-common \ vim \ curl \ ssh \ exuberant-ctags \ subversion \ cmake \ wget \ unzip \ zip \ git \ make \ g++ \ apt-utils \ tzdata \ net-tools \ inetutils-ping \ rsync # install openjdk apt-get install -y --no-install-recommends openjdk-8-jdk #python ln -s /usr/bin/python3 /usr/bin/python # config no certificate, this can be remove if the company network 1 # do not have the certificate issue echo insecure >> ~/.curlrc echo "check_certificate = off" >> ~/.wgetrc git config --global http.sslVerify false export CURL_CA_BUNDLE="" export PYTHONHTTPSVERIFY=0 # repo mkdir ~/bin PATH=~/bin:$PATH curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo chmod a+x ~/bin/repoREADME.md ：readme file
AOSP Env Setup
This folder contains the scripts for AOSP Docker environment setup and a Python script for Docker usage.### File list
. ├── aosp_docker_env_install.sh // env install script ├── Dockerfile.base_ubuntu_1804-v0.5 // docker build dockerfile ├── install // docker build file │ ├── sources.list // modify docker sources list file │ └── ubuntu_install_core.sh // docker install file ├── README.md // readme file ├── run_docker.py // host docker script └── set_swap.sh // host swap modify for android build fail ```### AOSP Docker Build Env Installsudo ./aosp_docker_env_install.sh
### Base Docker Image * [ubuntu:18.04](https://registry.hub.docker.com/u/library/ubuntu/) ### Installation Install [Docker](https://www.docker.com/) from the official website, or follow the [Docker installation guide](https://www.runoob.com/docker/ubuntu-docker-install.html) on runoob.com. ### Build sudo docker build -t [docker image tag ] -f [dockerfile] . eg: sudo docker build -t ubuntu:1804.base -f Dockerfile.base_ubuntu_1804 . ### Usagesudo docker run -it ubuntu:1804.base /bin/bash
### Python Script: run_docker.pypython3 run_docker.py -h
usage: run_docker.py [-h] [–cname CNAME] [–iname INAME] [–sdir SDIR] [–ddir DDIR] [–list] [–port PORT]
optional arguments:
-h, --help show this help message and exit
–cname CNAME, -c CNAME
Container name
–iname INAME, -i INAME
Docker images
–sdir SDIR, -s SDIR shared dir
–ddir DDIR, -d DDIR Docker mount dir about share dir
–list, -l list images and containers now
–port PORT, -p PORT map host port to docker port
eg:
python3 run_docker.py -c android-v0.1 -i ubuntu:1804.base
## run_docker.py：host Docker scriptimport argparse
import os
import sys
import subprocess
def main():
print(ARGS)
if ARGS.list:
listcontainer_cmd_str = “echo ‘Images:’ && sudo docker images && echo ‘containers:’ && sudo docker ps -a”
os.system(listcontainer_cmd_str)
elif ARGS.cname and ARGS.cname and ARGS.sdir and ARGS.ddir:
container_num_cmd_str = “sudo docker ps -a | grep “{}”|wc -l”.format(FLAGS.cname)
print("container_num_cmd_str : ", container_num_cmd_str)
num = subprocess.check_output(container_num_cmd_str, shell=True).decode(‘utf-8’).strip()
print("containers num: ", num)
if num == ‘0’:
run_cmd_str = “sudo docker run -it -p {} --name {} -v {}:{} {} /bin/bash”.format(
FLAGS.port, FLAGS.cname, FLAGS.sdir, FLAGS.ddir, FLAGS.iname)
print("run_cmd_str : ", run_cmd_str)
os.system(run_cmd_str)
else:
start_exec_cmd_str = “sudo docker start {} && sudo docker exec -ti {} /bin/bash”.format(
FLAGS.cname, FLAGS.cname)
print("start_exec_cmd_str : ", start_exec_cmd_str)
os.system(start_exec_cmd_str)
else:
print(“Bad command !!!”)
ifname== ‘main’:
parser = argparse.ArgumentParser()
parser.add_argument(‘–cname’, ‘-c’, type=str, help=‘Container name ‘)
parser.add_argument(’–iname’, ‘-i’, type=str, help=‘Docker images ‘)
parser.add_argument(’–sdir’, ‘-s’, type=str, default=‘/mnt/dev/’, help=‘shared dir ‘)
parser.add_argument(’–ddir’, ‘-d’, type=str, default=‘/home/’, help=‘Docker mount dir about share dir ‘)
parser.add_argument(’–list’, ‘-l’, action=“store_true”, default=False, help=" list images and containers now")
parser.add_argument(‘–port’, ‘-p’, help=‘map host port to docker port’)
FLAGS, unparsed = parser.parse_known_args() ARGS = parser.parse_args() main()`run_docker.py` 的核心逻辑是一个「先查后建」的分支判断：容器已存在则启动并进入，不存在则新建容器。 ```mermaid flowchart TD A["解析命令行参数"] --> B{"是否指定 --list"} B -->|是| C["打印镜像与容器列表"] B -->|否| D{"cname / sdir / ddir 是否齐全"} D -->|否| E["输出 Bad command"] D -->|是| F["统计同名容器数量"] F --> G{"数量是否为 0"} G -->|是| H["docker run 新建容器<br/>挂载目录 + 端口映射"] G -->|否| I["docker start + docker exec<br/>进入已有容器"] H --> J["进入容器 bash"] I --> Jset_swap.sh: host swap modify for Android build fail
#!/bin/bash # 建立swap文件 # ``` # android源码编译错误：ninja failed with: signal: killed # ``` # 查看目前swap free -m # 建立swap文件,大小4G dd if=/dev/zero of=/var/swapfile bs=1024 count=4000000 # 启用虚拟内存,将swap文件设置为swap分区文件 mkswap /var/swapfile #注意：insecure permissions 0644, 0600 suggested. chmod 600 /var/swapfile # 激活swap,启用分区交换文件 swapon /var/swapfile # 停用虚拟内存 #swapoff /var/swapfile # 查看内存和虚拟内存 free -m # 开机启用swap echo '/var/swapfile swap swap defaults 0 0' >> /etc/fstab # 查看目前swap free -mset_swap.sh的执行顺序如下，核心目的是在物理内存不足时用 swap 兜底，避免编译进程被内核 OOM 杀掉。