3. 安装Repo工具
任务目标
在Ubuntu主机上安装并配置Google的Repo工具,验证repo命令可正常执行,为后续AOSP源码多仓库管理做准备。
环境要求
- Ubuntu 18.04+(本文以Ubuntu 20.04为例)
- 已安装curl与git
- 可访问Google源码仓库(若网络受限,需配置代理或使用镜像)
安装Repo
Repo是Google基于Git构建的多仓库管理工具,本质是一个Python脚本。官方推荐安装到用户目录下,避免污染系统路径。
# 1. 创建bin目录并加入PATH
mkdir -p ~/bin
export PATH=~/bin:$PATH
echo 'export PATH=~/bin:$PATH' >> ~/.bashrc
# 2. 下载repo脚本(官方源)
curl -sS https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
# 3. 赋予执行权限
chmod a+x ~/bin/repo
# 4. 验证安装
repo --version
若无法访问Google存储,可使用AOSP镜像提供的repo脚本(如清华源):
curl -sS https://mirrors.tuna.tsinghua.edu.cn/git/git-repo > ~/bin/repo
初始化Repo客户端(可选验证)
仅安装repo脚本不足以验证其完整功能,建议通过一次真实的repo init操作确认工具可用。以下命令在空目录中初始化AOSP的master分支(仅下载manifest,不下载源码):
mkdir -p ~/aosp-test && cd ~/aosp-test
repo init -u https://android.googlesource.com/platform/manifest
若使用镜像,将URL替换为:https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/platform/manifest
验证方法与判定标准
- 版本输出:执行
repo --version,输出包含repo版本号(如repo v2.29)及Python版本信息,即安装成功。 - 初始化成功:
repo init执行后,当前目录下生成.repo/manifests目录,且命令无报错退出,说明repo工具可正常访问manifest仓库。 - 环境持久化:重新打开终端后执行
which repo,应返回/home/<用户名>/bin/repo,确认PATH配置已写入.bashrc。
常见问题
- curl: (7) Failed to connect:网络无法访问Google,改用清华镜像源下载repo脚本。
- repo: command not found:当前shell未加载新PATH,执行
source ~/.bashrc或重新登录终端。 - Python版本过低:Repo要求Python 3.6+,检查
python3 --version,必要时通过apt install python3升级。