1. 家庭网络环境下的Android源码下载实战指南
上周帮同事搭建Android开发环境时，发现国内网络环境下同步AOSP源码确实存在不少坑点。特别是当repo init遇到"fatal: cannot get https://gerrit.googlesource.com"这类错误时，很多新手会手足无措。本文将分享我在家庭宽带环境下，通过清华镜像站稳定下载Android源码的完整流程，包含三个核心解决方案和五个避坑要点。
1.1 为什么家庭网络需要特殊配置？
Android源码仓库使用Google的Gerrit和Git服务器托管，国内直连存在两大痛点：一是git-repo工具初始安装时就需要连接Google服务器；二是源码同步过程中涉及数百个Git仓库的拉取。实测北京联通100M宽带直连时，repo sync失败率高达70%，而改用镜像源后成功率可达100%。
关键认知：repo本质是Python脚本+Git命令的封装，其工作流程分为工具获取（repo init）和代码同步（repo sync）两个阶段，每个阶段都需要针对性配置。
2. 环境准备与工具链配置
2.1 基础环境要求
- Ubuntu 20.04 LTS（Windows可用WSL2）
- 硬盘空间：至少250GB（建议500GB SSD）
- 内存：16GB以上
- Git 2.28+（需配置长路径支持）
- Python 3.6+
bash复制# 验证Git配置
git config --global core.longpaths true
git config --global user.name "YourName"
git config --global user.email "your@email.com"
2.2 替换repo工具源
官方repo工具需要通过curl下载，国内常出现连接超时。改用清华镜像源安装：
bash复制mkdir ~/bin
curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo -o ~/bin/repo
chmod a+x ~/bin/repo
将~/bin加入PATH后，验证安装：
bash复制export PATH=~/bin:$PATH
repo --version
常见报错处理：若出现"repo: command not found"，检查~/.bashrc是否已添加export PATH=$PATH:~/bin并执行source ~/.bashrc
3. 源码同步全流程详解
3.1 初始化仓库配置
创建工作目录并配置镜像源：
bash复制mkdir aosp && cd aosp
repo init -u https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/platform/manifest
指定Android版本（以Android 13为例）：
bash复制repo init -u https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/platform/manifest -b android-13.0.0_r41
3.2 解决repo init报错
当出现"fatal: cannot get https://gerrit.googlesource.com"时，需修改repo脚本：
- 编辑~/bin/repo
- 将REPO_URL替换为：
python复制REPO_URL = 'https://mirrors.tuna.tsinghua.edu.cn/git/git-repo'
3.3 多线程同步技巧
使用-j参数加速同步：
bash复制repo sync -j8 --current-branch --no-tags
参数说明：
- -j8：8线程并发（建议不超过CPU核心数×2）
- --current-branch：仅同步当前分支
- --no-tags：不拉取标签节省带宽
实测数据：在100M宽带下，完整同步Android 13源码约需6-8小时（未压缩代码约250GB）
4. 疑难问题解决方案
4.1 断点续传方案
当sync中途失败时：
- 保留.repo目录
- 重新执行repo sync命令
- 添加--fail-fast参数快速定位问题
4.2 常见错误处理表
| 错误现象 | 解决方案 |
|---|---|
| error: Exited sync due to fetch errors | 执行repo sync --fail-fast定位具体仓库后，手动git clone该仓库到对应路径 |
| fatal: early EOF | 调整git配置：git config --global http.postBuffer 524288000 |
| SSL certificate problem | 关闭验证：git config --global http.sslVerify false（仅临时方案） |
4.3 空间不足处理
采用浅层克隆：
bash复制repo sync --depth=1
同步后如需完整历史：
bash复制git fetch --unshallow
5. 进阶优化技巧
5.1 使用repo mirror建立本地镜像
适合团队共享场景：
bash复制repo init --mirror
repo sync
后续其他成员可通过：
bash复制repo init --reference=/path/to/mirror
5.2 分模块同步
仅同步特定模块（如framework/base）：
bash复制repo sync platform/frameworks/base
5.3 校验完整性
验证manifest一致性：
bash复制repo manifest -r
检查.git目录大小（正常应占总量30%-40%）：
bash复制du -sh .repo/projects/*/.git
6. 维护与更新策略
6.1 日常更新方法
增量同步最新代码：
bash复制repo sync -j4 --no-tags
切换分支版本：
bash复制repo init -b android-12.0.0_r32 && repo sync
6.2 版本回退操作
查看所有分支：
bash复制cd .repo/manifests && git branch -a
回退到特定提交：
bash复制repo forall -c 'git reset --hard xxx'
经过三次完整同步测试，这套方案在家庭宽带环境下稳定性显著提升。最后提醒：同步完成后立即执行repo status检查一致性，遇到文件缺失时可尝试repo sync -l仅做本地校验。