Posts 使用 Repo 下载 AOSP 源代码
Post
Cancel

使用 Repo 下载 AOSP 源代码

本指导记录了在 Windows 下(除了安装外,其余章节 Linux 同样适用)使用 Repo 工具的过程,包括安装 Repo、配置代理、同步全部或部分 Android Open Source Project(APPS)工程源代码到本地,可方便 Android 系统研究人员后续使用 Source Insight 等工具本地查阅代码。

安装 Repo(Windows)

安装 Python

repo 是 Python 脚本,依赖于 Python。前往 https://www.python.org/downloads/ 下载安装 Python 3,安装过程注意勾选创建 PATH 环境变量,使 Python 程序目录添加到操作系统环境变量中。

安装 Git

前往 https://git-scm.com/downloads 下载安装 Git,在 Windows 上 Git 还提供了一个 bash 模拟器,称为 Git Bash。

安装 Repo

先在用户目录(%USERPROFILE%)下创建 bin 目录,然后手动下载 https://storage.googleapis.com/git-repo-downloads/repo 到该目录,最后将 bin 目录添加到 Windows PATH 环境变量中。

配置代理(可选)

在公司内网,可能需要额外配置代理才能让 git 和 repo 连接外网。

Git 代理配置

编辑 %USERPROFILE%/.gitconfig(Windows)或 ~/.gitconfig(Linux)

1
2
3
4
[http]
    proxy = http://user:password@example.com:8080
[https]
    proxy = http://user:password@example.com:8080

注意:连接内网地址时需要关闭代理。

Repo 代理配置

编辑 %USERPROFILE%/.bash_profile(Windows)或 ~/.bash_profile(Linux),增加如下代理配置:

1
2
3
export http_proxy= http://user:password@example.com:8080
export https_proxy = $http_proxy
export ftp_proxy = $http_proxy

完成上述代理配置后,bash(或 git bash)中运行的 Git 和 Repo 命令就会以代理的方式连接服务器了。

创建 AOSP 源代码根目录

1
mkdir AOSP

在源代码根目录初始化 Repo 客户端

在源码根目录执行 repo init 获取最新版本的 Repo,并通过指定清单文件来指定 Android 源代码中包含的各个代码库位于工作目录中的什么位置:

1
repo init -u https://android.googlesource.com/platform/manifest

上面命令会在 AOSP 目录创建 .repo 目录,包含最新版本 Repo 以及清单等文件。

如果因不明原因无法下载 Repo,可以用如下命令手动获取:

1
2
3
4
mkdir .repo
cd .repo
git clone https://gerrit.googlesource.com/git-repo
mv git-repo repo

同步源代码

AOSP 由大量项目组成,包含数百个 git 仓库,代码量十分巨大(因此 Google 开发 repo 工具)。同步源代码的方式有两种:

同步整个 AOSP 源代码

1
repo sync

同步 AOSP 子工程源代码

通过指定工程名来来执行 repo sync,可以仅仅同步感兴趣的那部分源代码,并且在本地保持 AOSP 目录结构:

1
repo sync project_name1 projuect_nameN

其中工程名可通过查阅 .repo/manifest/default.xml 得到,例如 platform/frameworks/base

切换不同 AOSP 分支

1. 查看可切换的分支

1
cd .repo/manifests git branch -a | cut -d / -f 3

2. 切换分支 (以android-7.0.0_r1为例)

1
repo init -u https://android.googlesource.com/platform/manifest -b android-7.0.0_r1

3. 同步代码

1
repo sync

如果本地版本库中的源代码有一些改动,执行上述命令后,会出现部分文件的提交无法合并的提示,此时使用下面的操作命令:

1
2
3
repo forall -c git reset --hard
repo init -u https://android.googlesource.com/platform/manifest -b android-7.0.0_r1
repo sync

常见问题

添加了环境变量,但 Git Bash 仍然报找不到 Python 的错误(Windows)

1
/bin/env: python: No such file or directory

这种情况在 Git Bash 中执行 echo $PATH 会发现 Python 不在 PATH 变量中,解决办法是重启电脑以及重装 Git,让 Git 重新读取 Windows 的环境变量。

This post is licensed under CC BY 4.0 by the author.