可以把 AOSP 编译理解为:从源码、构建配置和工具链出发,经过 Soong 模块分析、Ninja/Siso 任务调度、源码编译与资源打包,最终生成 Android 系统镜像。
整个过程不只是执行一次 make,而是由多个构建阶段组成。
一、AOSP 编译全流程图
1. 获取 AOSP 源码
repo sync · frameworks · system · packages · vendor · device
2. 初始化构建环境
source build/envsetup.sh · lunch
确定产品、架构、构建变体和环境变量
3. 解析构建配置
Android.bp · Android.mk · 产品配置 · BoardConfig.mk
Soong / Kati 分析模块及依赖
4. 生成构建任务图
Soong → soong_build → build.ninja
将模块依赖转换为可执行的构建规则
5. 执行编译任务
Ninja / Siso → Clang / LLD / javac / Kotlin 等
C/C++、Java、Kotlin、资源、APK、共享库
6. 汇总与打包
模块安装 → system/product/vendor 等目录 → 镜像生成
可能包括 AVB、稀疏镜像及刷机包
7. 得到最终构建产物
out/target/product/fde_arm64/
注意:这是逻辑上的流程。实际构建时,许多步骤会交错执行;修改少量源码时,也不一定需要重新执行所有步骤。
二、第一阶段:源码与产品配置
1. 初始化环境
在你的项目根目录下执行:
cd /aosp17
source build/envsetup.sh
lunch fde_arm64-cp2a-userdebug
主要作用:
-
envsetup.sh:加载 AOSP 构建环境,定义lunch、m等命令。 -
lunch:选择目标产品、CPU 架构和构建类型。 -
userdebug:面向调试和开发的构建变体。
你的目标大致是:
| 配置项 | 当前目标 |
|---|---|
| 产品 |
|
| 构建变体 |
|
| CPU 架构 | ARM64 |
| Android 版本 | 17 |
| 构建编号 |
|
| 源码目录 |
|
可以先检查环境:
echo "$TARGET_PRODUCT"
echo "$TARGET_BUILD_VARIANT"
echo "$OUT_DIR"
2. 产品配置如何决定最终系统?
重点查看以下文件:
-
device/.../AndroidProducts.mk -
产品对应的
.mk文件 -
BoardConfig.mk -
device.mk -
vendor/...下的产品配置 -
各模块的
Android.bp
产品配置决定要编译哪些应用、系统服务、HAL、共享库,以及系统镜像的分区布局和设备参数。
lunch 只是选择配置,不会直接编译全部源码。
三、第二阶段:Soong、Kati、Ninja、Siso 分别做什么?
这是理解 AOSP 编译最重要的部分。AOSP 主要使用 Soong 和传统 Make 兼容构建链生成构建规则,再由执行器完成任务。官方构建文档对此有详细说明。
Android Open Source Project+1
Soong + Blueprint
输入:Android.bp
解析模块声明、依赖关系、编译变体和属性,生成 Ninja 构建规则。主要实现语言是 Go。
Kati
输入:Android.mk 和 Make 配置
兼容旧式 Make 构建描述,处理产品配置和相关规则,并生成 Ninja 文件。它不是用来代替 Soong 的。
Ninja
输入:生成的 .ninja 文件
根据依赖图安排任务、判断哪些任务需要重做,并发执行 Clang、Java 编译器、链接器、打包工具等命令。
Siso
构建执行器的另一种选择
负责执行构建任务,支持适合其集成环境的调度和缓存能力。它不是编译器,也不是 Soong 的替代品;是否实际使用取决于当前分支和构建配置。
它们的关系
Android.bp ──→ Blueprint / Soong ──┐
├──→ Ninja 构建规则 ──→ Ninja 或 Siso
Android.mk ──→ Kati ───────────────┘ │
▼
Clang / javac / 工具链
│
▼
.o / .so / APK / 镜像
这张图是概念简图。实际 AOSP 中,soong_ui 会协调多个阶段,Soong 与 Kati 也会交换生成的配置和模块信息;并不是简单地把两个输入文件直接拼起来。
Android Git+1
特别注意:Ninja 和 Siso 不一定同时参与同一次构建。 不能仅凭源码目录里存在 Siso,就认定当前 m 命令已经通过 Siso 执行。
四、第三阶段:Soong 如何把源码变成构建任务?
以你正在开发的 FDE Gallery 为例:
packages/apps/fdegallery/
├── Android.bp
├── AndroidManifest.xml
└── src/
└── ...
假设 Android.bp 中定义了一个 android_app 模块。Soong 会处理以下内容:
-
解析模块声明:读取源码列表、资源、Manifest、依赖库等。
-
模块变体生成:根据架构、产品、host/device、编译条件等生成相应变体。
-
依赖关系解析:确定依赖的 Java 库、Native 库、资源模块等。
-
规则生成:为资源处理、Java 编译、DEX、APK 打包等操作生成构建规则。
-
执行依赖分析:在任务图中建立先后关系,保证依赖先完成。
例如:
GalleryApp
├── AndroidManifest.xml
├── res/
├── src/*.java
├── 静态 Java 库
└── Native 库(如果有)
│
▼
资源处理 / Java 编译 / DEX
│
▼
APK 打包
│
▼
签名或后续安装处理
实际执行时,不同步骤可以并行;并非所有 APK 都需要单独签名,具体取决于模块配置和构建目标。
Soong 生成什么?
重点观察这些目录:
out/soong/
├── build.ninja
├── soong.variables
└── .intermediates/
-
build.ninja:Soong 生成的主要构建规则文件。 -
soong.variables:产品和构建配置传给 Soong 的数据。 -
.intermediates/:模块编译过程中的中间产物。
这些文件能帮助你判断构建是卡在配置解析阶段,还是已经进入实际编译阶段。
五、第四阶段:真正执行编译
当规则生成完成后,构建系统开始执行任务。
1. C/C++ Native 编译
以 Android 系统服务或 Native 库为例:
.cpp / .c
↓
Clang 编译器
↓
.o 目标文件
↓
LLD 链接器
↓
.so 共享库或可执行文件
常见产物:
-
.o:目标文件。 -
.a:静态库。 -
.so:共享库。 -
ELF 可执行文件:Native 程序或服务。
例如,你在 AOSP17 集成 sherpa-onnx 时,可能会经历 C/C++ 编译、JNI 桥接、共享库链接、ABI 检查以及 APK 或系统分区安装等步骤。
2. Java / Kotlin 编译
.java / .kt
↓
javac / Kotlin 编译器
↓
.class / 中间字节码
↓
D8 / R8 等相关处理
↓
DEX
↓
APK 打包
具体路径取决于模块类型。AOSP 平台应用通常使用 Soong 的 android_app、java_library 等模块,而不是直接把 Android Studio 的 Gradle 工程当成整个系统的构建入口。
3. Android 资源编译
AndroidManifest.xml
res/
assets/
↓
资源处理、Manifest 处理
↓
资源表 / 编译资源
↓
APK 打包
例如你之前遇到的:
FDECuratedApps-unsigned.apk
duplicate assets/app_functions.xml
这属于 APK 组装阶段的重复文件问题,不是 C++ 编译错误,也不是 Ninja 调度本身的错误。需要检查生成的 JAR、资源目录及 APK 合并规则,确认 assets/app_functions.xml 为什么被放入两次。
4. 并发执行与增量编译
假设任务图里有:
libA ──→ libB ──→ appC
libD ───────────→ appC
libA 和 libD 可以并行编译;libB 必须等待 libA。appC 需要等它依赖的相关任务完成。
Ninja 或 Siso 根据任务依赖和输入输出状态调度工作。修改一个 Java 文件,并不意味着整个 Android 系统都要从头编译;构建系统会尽可能重用有效的中间产物。
六、第五阶段:安装模块并生成系统镜像
单个模块编译成功,并不等于完整的 AOSP 系统镜像已经成功生成。
通常还要经过以下步骤:
模块安装
把 APK、共享库、可执行文件、配置和资源放入对应的 staging/install 目录。
分区内容整理
根据产品配置组织 system、system_ext、product、vendor 等分区内容;实际分区集合因产品而异。
镜像生成
根据设备配置生成对应的分区镜像,例如 system.img、vendor.img、product.img、userdata.img。不是每个产品都会生成全部这些文件。
完整性与发布处理
可能包括 AVB、镜像稀疏化、打包和构建归档等操作,具体取决于产品配置和所选目标。
你的最终输出目录一般是:
out/target/product/fde_arm64/
可以用下面的命令检查实际生成了什么:
ls -lh out/target/product/fde_arm64/
重点区分:
-
APK 生成成功:应用模块构建完成。
-
installed-files等安装清单生成:模块已进入安装阶段的相关产物。 -
system.img等镜像生成:相应镜像目标已完成。 -
整个
m命令退出码为0:本次所请求的构建目标成功完成。
七、第六阶段:从命令行执行完整构建
在你的 ARM64 AOSP17 环境中,可以按下面的顺序操作。
1. 完整系统构建
cd /aosp17
source build/envsetup.sh
lunch fde_arm64-cp2a-userdebug
m -j8
这里使用 -j8 是为了与你此前提到的 8 个逻辑 CPU 对应,作为一个保守的起始值。它不是性能最优值;实际还需要考虑 RAM、磁盘 I/O、编译器进程内存和是否使用远程执行。
2. 只编译一个模块
例如,想先验证 FDE Gallery:
m FDEGallery
注意,FDEGallery 只是示例模块名。应使用你项目 Android.bp 中实际声明的模块名。
如果想确认模块是否存在,可以尝试:
m nothing
它主要用于解析、验证构建结构,并不等于完整编译系统。具体目标名也可以通过当前分支支持的帮助信息确认。
3. 编译后检查镜像
ls -lh out/target/product/fde_arm64/
如果只构建了某个 APK,不能据此认为整个系统镜像已经更新。需要根据目标选择是否执行完整系统构建或对应的镜像目标。
Android 官方的构建入口、lunch、m 和模块级构建方式可参考 Build Android 官方指南。
Android Open Source Project
八、编译过程中如何定位问题?
建议按构建阶段定位,不要看到 FAILED 就直接清理整个 out 目录。
| 现象 | 优先检查 |
|---|---|
|
|
|
|
| 属性拼写、模块类型、Soong 配置 |
|
| 模块名、依赖声明、产品是否包含该模块 |
| C/C++ 编译失败 | 编译器报错、头文件、ABI、编译参数 |
| Java/Kotlin 编译失败 | 类型错误、依赖库、平台 API |
| APK 重复文件 |
|
| 链接失败 |
|
| 镜像生成失败 | 分区容量、安装清单、镜像和签名配置 |
| 机器内存不足 | 并发数、单任务内存、交换空间、系统日志 |
查看实际构建日志
# 当前目标
echo "$TARGET_PRODUCT-$TARGET_BUILD_VARIANT"
# Soong 中间产物
ls out/soong/
# 构建输出目录
ls out/target/product/fde_arm64/
# 查看系统资源
free -h
nproc
df -h
如需深入定位 Ninja 的实际执行情况,可以检查当前分支生成的 build.ninja、组合构建文件和构建日志。不要直接假设所有 Android 17 分支都采用相同的文件名或执行器。
九、针对你的 ARM64 编译服务器,重点理解什么?
你此前的服务器配置为 ARM64、8 个逻辑 CPU、64 GB 内存,目标是完整构建 Android 17 FDE 系统。
建议重点关注这三个方向:
-
宿主机与目标架构分离。 宿主机负责运行 Go、Python、Soong、Ninja 等构建工具;目标工具链负责生成 ARM64 Android 产物。宿主机是 ARM64,并不意味着所有宿主工具和目标程序都使用相同的 ABI。
-
工具链版本与构建环境。 优先使用当前源码树提供或指定的预构建工具链,特别是 Clang、JDK、Go、Python 和 Rust。不要只因为宿主机已安装较新版本,就直接替换 AOSP 指定的工具。
-
构建执行器与缓存。 Siso 正在进入 Android 构建生态,但不能假定你当前的 FDE17 分支已经完成集成。先检查源码和构建日志,再判断是否使用 Siso、Ninja 或其他执行路径。
Git at Google+1
十、如何真正跟踪一次 m 的内部调用?
如果你想从源码层面研究完整流程,建议沿以下顺序阅读:
第一步:入口
build/make/envsetup.sh
研究 m 命令如何定位源码根目录并进入构建入口。
第二步:构建协调器
build/soong/soong_ui.bash
追踪 soong_ui 如何组织配置解析、构建规则生成和任务执行。
第三步:构建规则生成
build/soong/、build/blueprint/、build/make/core/
分别研究 Soong、Blueprint、Kati 及它们的交互。
第四步:任务执行
查看生成的 .ninja 文件及执行器命令,追踪具体的编译器、链接器和打包工具。
以上路径是典型的源码阅读入口,实际文件细节应以你检出的 Android 17 / FDE 分支为准。
建议下一步: 先搞清楚 m → soong_ui → Soong/Kati → Ninja 或 Siso 这条调用链,再深入研究模块编译和镜像打包。这样你之后排查 sherpa-onnx 集成、AppFunctions、Native 库链接和系统镜像生成问题时,就能快速判断错误属于哪个阶段。
本文系统梳理AOSP 17的完整编译流程,涵盖源码同步、环境初始化、产品配置解析、Soong/Kati构建规则生成、Ninja/Siso任务调度、C/C++与Java/Kotlin编译、资源处理、增量构建、模块安装及系统镜像生成等核心阶段。重点剖析Soong如何将Android.bp和Android.mk转换为构建图,以及ARM64环境下工具链、执行器选择与问题定位方法。
2456

被折叠的 条评论
为什么被折叠?



