网上关于这块大部分教程都是无效的，因为墙的缘故，无法使用官方提供的下载链接，我这里使用了清华大学的镜像，是能够顺利将 AOSP 下载下来。如果你还没有安装 Ubuntu，请看《VirtualBox 安装 Ubuntu》。

下载 repo

Repo 是一款工具，可让您在 Android 环境中更轻松地使用 Git，首先需要安装 Git：

sudo apt-get install git

创建 bin，并加入 path：

mkdir ~/bin
PATH=~/bin:$PATH

下载 repo：

curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo > ~/bin/repo

错误：

Command 'curl' not found, but can be installed with:

sudo apt install curl

需要安装 curl，执行命令sudo apt-get install curl进行安装。

注意：命令 apt 在低版本 Ubuntu 不行，本教程统一使用命令 apt-get。

权限设置：

chmod a+x ~/bin/repo

如何验证 repo 安装成功

输入命令repo，提示：

/usr/bin/env: "python": 没有那个文件或目录

需要安装 python，执行命令sudo apt-get install python安装，再次输入命令repo，提示如下即 repo 安装成功：

error: repo is not installed.  Use "repo init" to install it here.

下载源码

初始化仓库

建立工作目录 AOSP，命令：

mkdir AOSP
cd AOSP

初始化仓库:

repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest

错误

错误1

error.GitError: manifests var: 
*** 请告诉我你是谁。

运行

  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

来设置您账号的缺省身份标识。
如果仅在本仓库设置身份标识，则省略 --global 参数。

没有设置身份，要使用 Gerrit 代码审核工具，您需要一个与已注册的 Google 帐号关联的电子邮件地址：

git config --global user.email "wuxiaolong.me@gmail.com"
git config --global user.name "WuXiaolong"

其他邮箱应该也是可以的。

错误2

fatal: Cannot get https://gerrit.googlesource.com/git-repo/clone.bundle
fatal: error [Errno 101] Network is unreachable

因为 repo 运行过程中会尝试访问官方的 git 源更新自己，如果想使用 tuna 的镜像源进行更新，将如下内容复制到你的~/.bashrc里，然后重启终端模拟器。

export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/'

错误3：

curl: (22) The requested URL returned error: 404 Not Found
Server does not provide clone.bundle; ignoring.

为什么会出现此种 log ？

在通过 Git 的 HTTP 协议下载最新数据之前，Repo 尝试下载预先打包的捆绑文件以引导每个 git。

原文：Repo attempts to download a prepackaged bundle file to bootstrap each git prior to downloading the most recent data via Git's HTTP protocol.

如果捆绑文件不可用（如本例所示），Repo 将忽略它并继续进行，换句话说，不要注意这一点。

原文：If a bundle file isn't available (like in this case), Repo will ignore it and proceed anyway. In other words, don't pay any attention to this.

最后，如何取消 download clone.bundle ？

只需要在repo 添加一个参数 --no-clone-bundle，如下：

可通过 repo -h 获得参数 --no-clone-bundle 的说明

repo init --no-clone-bundle
repo sync --no-clone-bundle

指定某个 Android 版本

如果需要某个特定的 Android 版本(列表)：

repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-8.0.0_r1

提示以下，即 init 成功：

Your identity is: WuXiaolong <wuxiaolong.me@gmail.com>
If you want to change this, please re-run 'repo init' with --config-name

repo has been initialized in /media/disk/Project/AOSP

疑问

如果没有指定版本，如何知道下载好的 AOSP 是什么版本？

找到build/make/core/version_defaults.mk文件打开，搜索PLATFORM_SDK_VERSION，找到了 PLATFORM_SDK_VERSION := 28，从 SDK 版本可以知道 AOSP 版本是 9.0，我下载的就是最新的。

同步代码

同步源码树（以后只需执行这条命令来同步）：

repo sync

然后等待下载完毕：

正在检出文件: 100% (1709/1709), 完成.
正在检出文件: 100% (9492/9492), 完成.在检出文件:   2% (251/9492)   
正在检出文件: 100% (617/617), 完成.正在检出文件:  17% (106/617)   
正在检出文件: 100% (15779/15779), 完成.检出文件:   7% (1251/15779)   
正在检出文件: 100% (29/29), 完成.  正在检出文件:  27% (8/29)   
Syncing work tree: 100% (568/568), done.

最后整个源码大小 27.2 G。

参考

https://source.android.google.cn/setup/

公众号

我的公众号：吴小龙同学，欢迎交流～