1. AOSP源码同步的痛点与优化思路第一次同步AOSP源码的经历就像在沙漠里找水——明明知道绿洲就在那里但就是走不到。我清楚地记得第一次尝试同步android-13.0.0_r82分支时连续失败了7次每次都是在不同进度条位置报错退出。最崩溃的是第5次已经下载了80GB数据后突然遇到网络中断一切又要重头开始。为什么AOSP同步这么困难根本原因在于代码仓库体积爆炸式增长Android 13单个版本源码已超过200GB含.git元数据跨国网络稳定性问题默认源服务器位于海外连接经常中断Git设计局限性传统clone会下载全部历史记录而AOSP历史提交超过500万次去年Google官方论坛就有开发者抱怨同步android-14.0.0_r29时下载了900GB数据来源AOSP downloads just got much bigger - Google Groups。这促使我研究出一套组合优化方案# 清华大学镜像源 月度打包文件 深度限制 curl -OC - https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar tar -xvf aosp-latest.tar -C aosp/ cd aosp repo init --partial-clone --depth1 -u https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/platform/manifest -b android-13.0.0_r82 repo sync -c -j8这个方案相比传统方式有三个关键改进镜像源选择国内镜像速度提升10-20倍初始数据包月度tar包减少约60%下载量同步参数--partial-clone和--depth1避免下载无用历史2. 镜像源选择的艺术很多开发者不知道AOSP官方其实维护着全球镜像列表。但选择不当的镜像可能导致同步失败。我测试过多个主流镜像这里分享实测数据镜像源平均速度稳定性更新频率谷歌官方(android.googlesource.com)200KB/s★★☆实时清华大学(tuna)8MB/s★★★每日中科大(ustc)6MB/s★★★每日腾讯云(cloud.tencent)5MB/s★★☆每周为什么推荐清华镜像除了速度快它有两个独特优势提供月度打包文件(aosp-latest.tar)节省初始下载时间自动同步谷歌安全补丁延迟不超过24小时配置方法也很简单# 修改repo的默认URL export REPO_URLhttps://mirrors.tuna.tsinghua.edu.cn/git/git-repo # 或者永久修改 git config --global url.https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/.insteadof https://android.googlesource.com/注意部分企业内网可能会拦截非官方源同步前建议先测试curl是否能访问镜像站3. 参数优化的三重境界3.1 基础版-c和-j参数大多数教程只教到这一步repo sync -c -j8-c参数表示只同步当前分支-j8是并行任务数。但实际使用中发现对android-13.0.0_r82这样的大分支仍需下载约80GB数据并行数过高可能导致服务器限流建议根据CPU核心数调整3.2 进阶版--depth1浅克隆这是Git的经典优化手段repo init --depth1 -u [URL]效果立竿见影代码体积减少40%仅保留最新快照同步时间缩短50%但有两个致命缺陷无法查看历史提交记录后续切换分支困难3.3 终极版--partial-clone智能过滤Android 11开始支持的新特性repo init --partial-clone --clone-filterblob:limit10M -u [URL]这个方案的精妙之处在于立即下载小于10MB的文件占日常开发的90%大文件如内核镜像按需下载保留完整提交历史实测数据方案初始体积完整体积适用场景传统clone200GB200GB需要完整历史--depth180GB80GB仅编译--partial-clone60GB按需增长平衡型开发4. 疑难问题解决方案4.1 Python版本冲突AOSP要求Python 3.6但很多系统默认是2.7。遇到过最奇葩的错误File /usr/bin/repo, line 51 def print(self, *args, **kwargs): ^ SyntaxError: invalid syntax完美解决方案# 查看已安装版本 ls -l /usr/bin/python* # 设置多版本共存 sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 2 sudo update-alternatives --config python # 选择3.84.2 同步中断恢复当遇到error: Cannot checkout device/google/raviole-kernel时定位问题项目cd .repo/projects/device/google/raviole-kernel删除异常目录rm -rf .repo/projects/device/google/raviole-kernel继续同步repo sync -c --fail-fast -j14.3 磁盘空间不足Android源码编译需要至少300GB空间。如果同步中途报No space left可以清理.git临时文件find .repo -name *.tmp -exec rm -f {} \;使用稀疏检出只同步必要模块repo sync -c platform/frameworks/base platform/packages/apps/Settings5. 实战从零同步android-13.0.0_r82完整操作流程实测通过# 1. 准备环境Ubuntu 20.04 sudo apt install git python3 curl # 2. 通过镜像下载月度包约60GB mkdir ~/aosp cd ~/aosp curl -OC - https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar tar -xvf aosp-latest.tar -C ./ # 3. 初始化仓库 repo init --partial-clone --no-use-superproject \ -u https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/platform/manifest \ -b android-13.0.0_r82 # 4. 开始同步推荐tmux后台运行 tmux new -s sync repo sync -c -j$(nproc --ignore2)如果一切顺利3-5小时后你会看到Checking out: 100% (1145/1145), done in 4h12m38s repo sync has finished successfully.6. 高级技巧增量同步与本地镜像对于团队开发可以建立本地镜像# 首次创建镜像需要大容量存储 repo init --mirror -u [URL] repo sync -j10 # 开发者从本地同步 repo init --reference/path/to/mirror -u [URL] repo sync这种方案带来两个好处后续同步速度提升10倍以上统一代码版本避免兼容性问题最近在给公司搭建CI系统时我用这个方案将同步时间从6小时压缩到20分钟。关键是定期更新镜像# 每周执行 cd /path/to/mirror repo sync -j107. 避坑指南千万不要做的事直接sudo运行repo会导致权限混乱在Windows WSL1中同步文件系统性能极差使用--depth1后切换分支必现冲突推荐的做法使用ext4文件系统NTFS性能损失30%为repo配置缓存git config --global http.postBuffer 1048576000 git config --global core.compression 9网络不稳定时添加重试参数repo sync -c -j8 --fetch-submodules --no-tags --prune --force-sync记得去年有个同事在同步时强制断电导致.repo目录损坏。修复方法是find .repo -name *.lock -exec rm -f {} \; repo sync --force-sync