AOSP17编译整个流程

本文系统梳理AOSP 17的完整编译流程,涵盖源码同步、环境初始化、产品配置解析、Soong/Kati构建规则生成、Ninja/Siso任务调度、C/C++与Java/Kotlin编译、资源处理、增量构建、模块安装及系统镜像生成等核心阶段。重点剖析Soong如何将Android.bp和Android.mk转换为构建图,以及ARM64环境下工具链、执行器选择与问题定位方法。

可以把 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:面向调试和开发的构建变体。

你的目标大致是:

配置项

当前目标

产品

fde_arm64

构建变体

userdebug

CPU 架构

ARM64

Android 版本

17

构建编号

CP2A

源码目录

/aosp17

可以先检查环境:

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 会处理以下内容:

  1. 解析模块声明:读取源码列表、资源、Manifest、依赖库等。

  2. 模块变体生成:根据架构、产品、host/device、编译条件等生成相应变体。

  3. 依赖关系解析:确定依赖的 Java 库、Native 库、资源模块等。

  4. 规则生成:为资源处理、Java 编译、DEX、APK 打包等操作生成构建规则。

  5. 执行依赖分析:在任务图中建立先后关系,保证依赖先完成。

例如:

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 目录。

现象

优先检查

lunch 找不到产品

AndroidProducts.mk、产品配置、环境初始化

Android.bp 解析失败

属性拼写、模块类型、Soong 配置

module ... not found

模块名、依赖声明、产品是否包含该模块

C/C++ 编译失败

编译器报错、头文件、ABI、编译参数

Java/Kotlin 编译失败

类型错误、依赖库、平台 API

APK 重复文件

assets、资源合并、生成 JAR、打包规则

链接失败

.so、符号、链接顺序、目标架构

镜像生成失败

分区容量、安装清单、镜像和签名配置

机器内存不足

并发数、单任务内存、交换空间、系统日志

查看实际构建日志

# 当前目标
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 系统。

建议重点关注这三个方向:

  1. 宿主机与目标架构分离。 宿主机负责运行 Go、Python、Soong、Ninja 等构建工具;目标工具链负责生成 ARM64 Android 产物。宿主机是 ARM64,并不意味着所有宿主工具和目标程序都使用相同的 ABI。

  2. 工具链版本与构建环境。 优先使用当前源码树提供或指定的预构建工具链,特别是 Clang、JDK、Go、Python 和 Rust。不要只因为宿主机已安装较新版本,就直接替换 AOSP 指定的工具。

  3. 构建执行器与缓存。 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 库链接和系统镜像生成问题时,就能快速判断错误属于哪个阶段。

评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值