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

验证方法与判定标准

  1. 版本输出:执行repo --version,输出包含repo版本号(如repo v2.29)及Python版本信息,即安装成功。
  2. 初始化成功:repo init执行后,当前目录下生成.repo/manifests目录,且命令无报错退出,说明repo工具可正常访问manifest仓库。
  3. 环境持久化:重新打开终端后执行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升级。