从0到1打造Anbox专属镜像：AOSP源码编译实战指南
项目地址: https://gitcode.com/gh_mirrors/an/anbox 你是否还在为Anbox官方镜像版本滞后而烦恼？是否想定制包含特定Android应用的系统镜像？本文将带你完整走过从AOSP源码同步到Anbox专用镜像生成的全过程，无需深厚Linux内核知识，只需跟随步骤操作，即可在2小时内完成属于自己的Android容器镜像。
准备工作：环境搭建与源码获取
在开始镜像制作前，请确保你的系统满足以下要求：
- 至少200GB磁盘空间（AOSP源码约100GB，编译产物约50GB）
- 16GB内存（推荐32GB以加速编译）
- Ubuntu 20.04+或兼容Linux发行版
首先克隆Anbox项目源码：
git clone https://gitcode.com/gh_mirrors/an/anbox
cd anbox
同步AOSP源码需要使用项目提供的专用脚本，该脚本会自动拉取匹配Anbox架构的Android源码：
./scripts/android-sync.sh
官方同步脚本：scripts/android-sync.sh
该脚本会检查环境变量ANDROID_PRODUCT_OUT，确保编译产物输出到正确路径
配置编译参数：定制你的Android系统
Anbox需要特定的硬件抽象层（HAL）模块才能在容器环境中运行。项目提供了预定义的产品配置文件，位于products/anbox.mk，其中包含关键组件如：
PRODUCT_PACKAGES += \
camera.goldfish \
lights.goldfish \
gps.goldfish \
audio.primary.goldfish \
vibrator.goldfish
这些以goldfish为后缀的模块是Anbox运行必需的虚拟硬件驱动。通过修改此文件，你可以：
- 添加自定义系统应用（在
PRODUCT_PACKAGES中追加） - 配置系统属性（通过
PRODUCT_PROPERTY_OVERRIDES） - 复制额外文件到镜像（使用
PRODUCT_COPY_FILES）
执行编译：生成Android系统镜像
编译过程分为两步：首先构建AOSP基础镜像，然后通过Anbox工具打包成专用格式。
编译AOSP基础镜像
source build/envsetup.sh
lunch anbox_x86_64-userdebug
make -j$(nproc)
编译配置文件：products/x86_64/BoardConfig.mk
该文件定义了x86_64架构的编译参数，如内核版本、GPU支持等
编译完成后，会在out/target/product/generic_x86_64目录生成以下关键文件：
system.img：Android系统分区镜像ramdisk.img：启动内存盘镜像vendor.img：厂商分区镜像（可选）
打包Anbox专用镜像
使用项目提供的打包脚本将AOSP输出转换为Anbox可识别的squashfs格式：
./scripts/create-package.sh \
out/target/product/generic_x86_64/ramdisk.img \
out/target/product/generic_x86_64/system.img \
android-x86_64.img
打包工具脚本：scripts/create-package.sh
该脚本使用squashfs压缩系统文件，通过uidmapshift工具处理权限映射，确保容器内用户正确访问文件
镜像测试与导入
生成的镜像文件需要放置在Anbox的镜像目录：
mkdir -p data/android-images
cp android-x86_64.img data/android-images/
镜像存放目录：data/android-images/
官方说明文档：data/android-images/README.md
文档指出镜像需命名为android-$(arch).img格式，支持x86_64和aarch64架构
启动Anbox服务测试自定义镜像：
sudo systemctl start anbox-container-manager
anbox launch --package=org.anbox.appmgr --component=org.anbox.appmgr.AppViewActivity
高级技巧：镜像优化与定制
减小镜像体积
通过移除不必要的系统应用和资源，可以显著减小镜像体积。编辑products/anbox.mk，注释掉不需要的预装应用：
-PRODUCT_PACKAGES += \
- Calendar \
- Browser
添加预安装应用
将APK文件放入vendor/anbox/prebuilt-apps目录，并在anbox.mk中添加：
PRODUCT_COPY_FILES += \
vendor/anbox/prebuilt-apps/myapp.apk:system/app/MyApp/MyApp.apk
配置GPU加速
确保products/anbox.mk中启用GPU加速相关属性：
PRODUCT_PROPERTY_OVERRIDES += \
ro.kernel.qemu.gles=1 \
ro.opengles.version=196609
常见问题解决
编译时内存不足
如果编译过程中出现out of memory错误，可减少并行任务数：
make -j4 # 使用4个核心编译
镜像无法启动
检查镜像文件权限是否正确：
sudo chmod 644 data/android-images/android-x86_64.img
应用闪退
可能是缺少必要的系统库，检查android/目录下的硬件适配模块是否正确编译。
总结与后续拓展
通过本文方法，你已掌握：
- 使用scripts/android-sync.sh同步定制化AOSP源码
- 基于products/anbox.mk配置编译参数
- 通过scripts/create-package.sh生成Anbox镜像
- 测试和优化自定义镜像
后续你可以尝试：
- 构建多架构镜像（x86_64/arm64）
- 集成Google移动服务（GMS）
- 自动化镜像构建流程（CI/CD）
Anbox项目架构图： 
该架构展示了Anbox如何通过容器化技术在Linux系统上运行Android应用，核心在于左侧的容器管理服务和右侧的Android硬件抽象层适配。
希望本文能帮助你打造更适合自己需求的Anbox系统镜像。如有问题，可查阅项目官方文档docs/或提交issue到项目仓库。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
