4. AOSP源码获取与目录结构
AOSP（Android Open Source Project）源码体量庞大，单靠 git clone 无法高效管理数百个独立仓库。Google 提供的 Repo 工具本质上是一个 Python 脚本，它封装了 Git 的多仓库操作，通过 manifest.xml 清单文件描述“哪个仓库、放在哪个路径、检出哪个分支或标签”，从而实现一次同步、统一管理。理解 Repo 的工作模型，是获取 AOSP 源码的第一步。
一、核心原理：Repo 与 Manifest 的关系
Repo 并不替代 Git，而是站在 Git 之上做编排。执行 repo init 时，Repo 会先克隆 manifest 仓库到 .repo/manifests，再根据 -b 指定的分支或标签解析出 manifest.xml；执行 repo sync 时，Repo 读取清单中的 <project> 节点，逐个克隆或更新对应仓库。因此，分支与标签的选择，本质上就是选择一份 manifest。
二、方法流程：初始化、同步与分支选择
标准获取流程分为四步：安装 Repo、初始化仓库、同步源码、切换分支或标签。以下命令以 Android 14 为例：
# 1. 安装 repo 工具
mkdir -p ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
export PATH=~/bin:$PATH
# 2. 初始化：-b 指定分支或标签
mkdir aosp && cd aosp
repo init -u https://android.googlesource.com/platform/manifest -b android-14.0.0_r1
# 3. 同步源码（-j 并发，-c 仅当前分支，--no-tags 减少标签）
repo sync -j8 -c --no-tags
# 4. 查看当前分支与清单
repo branch
repo manifest -o manifest_snapshot.xml分支与标签的选择直接影响后续构建的稳定性。标签（如 android-14.0.0_r1）对应一次正式发布，仓库版本固定，适合产品化构建；分支（如 main）会持续更新，适合跟踪最新特性，但可能引入未验证的变更。若需长期维护，建议在标签基础上创建本地分支：
repo forall -c 'git checkout -b my_product_branch'三、目录功能说明与代码检索
AOSP 根目录下各文件夹职责分明，下表列出最常用的目录及其作用，便于快速定位代码：
| 目录 | 功能说明 | 典型检索场景 |
|---|---|---|
build/ | 编译系统、Makefile、Soong 配置 | 修改编译选项、添加模块 |
frameworks/base/ | Android 框架核心（AMS、PMS、WMS） | 系统服务行为分析 |
frameworks/native/ | Native 层服务与库 | SurfaceFlinger、Input |
system/core/ | init、logd、adb 等基础组件 | 启动流程、日志系统 |
packages/apps/ | 系统内置应用（Settings、Launcher） | 预置应用定制 |
device/<vendor>/<board>/ | 设备树、BoardConfig、HAL 配置 | 产品配置与镜像构建 |
vendor/ | 厂商私有代码与二进制 | 驱动、闭源库集成 |
out/ | 编译产物（system.img、boot.img） | 镜像输出与烧录 |
代码检索是日常开发的高频操作。AOSP 提供了多种工具：grep -rn 适合小范围精确查找；cgrep 只搜索 C/C++ 文件；jgrep 只搜索 Java 文件；mgrep 搜索 Android.mk；cs 结合 ctags 与 cscope，支持跳转定义。例如查找 ActivityManagerService 的定义：
cd frameworks/base
cs ActivityManagerService
# 或
jgrep "class ActivityManagerService"repo manifest -o manifest_snapshot.xml 保存清单快照。当需要复现某次构建时，用 repo init -m manifest_snapshot.xml 即可还原完全一致的仓库版本组合。
四、常见误区与复盘
- 误区一：直接 clone manifest 仓库就以为拿到了源码。manifest 仓库只包含清单文件，真正的代码分散在数百个仓库中，必须通过
repo sync拉取。 - 误区二：忽略
-c参数导致同步缓慢。不加-c时 Repo 会拉取所有分支的引用，磁盘和网络开销成倍增加。日常开发使用repo sync -c -j8即可。 - 误区三：在
main分支上直接做产品构建。main 分支变动频繁，可能导致编译失败或行为不一致。产品构建应锁定标签或创建本地稳定分支。 - 误区四：检索时全目录 grep 导致耗时过长。应先用
cs或cgrep缩小范围，再结合--include过滤文件类型。
error: Exited sync due to fetch errors，通常是网络问题或某个仓库地址不可达。可先执行 repo sync -f --force-sync 强制重试，再检查 .repo/manifests 中的远程地址是否可访问。
掌握 Repo 的清单驱动模型、分支与标签的选择策略、目录职责划分以及高效检索方法，就能在庞大的 AOSP 代码库中快速定位目标，为后续的产品配置与镜像构建打下坚实基础。