27、开源项目与社区：AAOS 开源项目，AOSP 贡献指南，社区资源
做 AAOS 开发这些年，我最大的感受就是：闭门造车行不通。AAOS 不是 Google 关起门来搞的，它扎根在 AOSP 这个大生态里。说白了，你遇到的坑，八成有人在社区里踩过，甚至已经填平了。
这一章，我就带你看看 AAOS 的开源全貌。从代码仓库到贡献流程，再到怎么跟社区打交道。嗯，都是实战中一定会用到的。
AAOS 在 AOSP 中的位置
先搞清楚一件事：AAOS 不是独立项目。它是 AOSP 的一个分支，或者说是一个“产品配置”。
你拉下 AOSP 代码后，会发现 packages/services/Car/ 这个目录。这就是 AAOS 的核心。里面包含了车载特有的服务，比如 CarService、CarPropertyManager、Vehicle HAL 的封装层。
我个人习惯把 AAOS 的代码结构分成三层：
- 底层：Vehicle HAL 定义，在
hardware/interfaces/automotive/下 - 中间层：CarService 和 Car API，在
packages/services/Car/下 - 上层：车载应用和 UI 库，在
packages/apps/Car/下
这三层通过 AIDL 接口通信。你想想看，如果你要新增一个车辆信号，就得从 HAL 层一路改到应用层。我在项目中遇到过好几次，因为接口定义没对齐，导致编译通过但运行时崩溃。所以，接口设计一定要先在社区讨论。
核心开源仓库一览
AOSP 的仓库太多了，我帮你梳理几个跟 AAOS 强相关的：
| 仓库路径 | 说明 | 重要程度 |
|---|---|---|
platform/packages/services/Car |
CarService 核心实现 | ★★★★★ |
platform/hardware/interfaces/automotive |
Vehicle HAL 接口定义 | ★★★★★ |
platform/packages/apps/Car |
车载系统应用（Launcher、Settings 等） | ★★★★ |
platform/frameworks/native/services/automotive |
车载 native 服务 | ★★★ |
platform/external/autofill |
车载自动填充服务 | ★★ |
这些仓库都在 android.googlesource.com 上。你可以用 repo 工具一次性拉下来。不过要注意，AOSP 的代码量很大，我建议你只拉 automotive 相关的 manifest，别全拉，不然硬盘受不了。
如何向 AOSP 贡献代码
很多人觉得给 Google 提交代码很难。其实流程很清晰，就是步骤多。我拆解一下：
- 签署 CLA：去
cla.developers.google.com签署贡献者许可协议。这是必须的，不签的话你的提交会被自动拒绝。 - 下载代码并创建分支：用
repo init和repo sync拉代码，然后repo start <branch-name>创建本地分支。 - 修改代码：记得遵循 AOSP 的代码风格。Java 用 Google Style，C++ 用 AOSP 的
.clang-format。 - 提交并生成 Patch：
git commit后，用repo upload提交到 Gerrit 审核系统。 - 等待 Review：会有 Google 的工程师或者社区维护者 review。他们会给 comments，你需要在 Gerrit 上回复并修改。
- 合并：通过 review 后，代码会被合并到主干。
我曾经犯过一个低级错误：提交前忘了运行 repo start，结果所有修改都堆在默认分支上，导致 repo upload 失败。后来我养成了习惯，每次改代码前先 repo start 一个新分支。这个习惯救了我很多次。
社区资源与沟通渠道
做 AAOS 开发，你不可能不看社区。我常用的资源有这些：
- android-automotive 邮件列表：这是最核心的讨论区。技术问题、设计提案都在这里。我建议你订阅并每天扫一眼。
- Google Issue Tracker：报告 bug 和 feature request 的地方。注意，AAOS 的组件名是
Android Automotive。 - Stack Overflow：搜
android-automotive标签。很多常见问题都有答案。 - AOSP Gerrit：看别人提交的 patch，能学到很多最佳实践。我经常去翻
packages/services/Car下的最新提交。
一个小技巧：在 Gerrit 上搜索 status:open project:platform/packages/services/Car，就能看到所有待 review 的 patch。看看别人怎么改的，比自己瞎琢磨快多了。
AAOS 开源生态的 SVG 结构图
下面这张图，是我梳理的 AAOS 开源生态的核心结构。从代码仓库到社区渠道，一目了然。
避坑指南：贡献代码时常见的坑
我踩过的坑，列出来给你参考：
- CLA 没签就提交：Gerrit 会直接拒绝。先签好，省得白忙活。
- Commit Message 格式不对：AOSP 要求第一行是标题，空一行后写正文。正文要说明“为什么改”而不是“改了什么”。
- 忘记跑测试：AAOS 有专门的
atest命令。提交前至少跑一下atest CarServiceTest。我见过有人提交的代码连编译都过不了，直接被 maintainer 打回。 - 一次提交改太多：尽量保持每个 commit 只做一件事。reviewer 喜欢小改动，大 patch 容易被搁置。
核心要点：AAOS 的开源社区不是摆设。遇到问题先去搜邮件列表和 Gerrit，八成能找到答案。贡献代码时，耐心比技术更重要。review 过程可能会来回好几轮，别急，这是正常的。
好了，关于 AAOS 开源项目与社区，我就讲这些。记住：代码在 AOSP 里，问题在社区里，答案在 Gerrit 里。多逛、多问、多提交，你很快就能成为 AAOS 社区的熟面孔。