下载源代码

Android 源代码树位于由 Google 托管的 Git 代码库中。Git 代码库中包含 Android 源代码的元数据,其中包括对源代码进行的更改以及更改时间。本页介绍了如何下载特定 Android 代码流水线的源代码树。

如需从特定设备的出厂映像开始,而非从下载源代码开始,请参阅选择设备 build

初始化 Repo 客户端

安装 Repo 启动器后,设置您的客户端以访问 Android 源代码库:

  1. 创建一个空目录来存放您的工作文件。为其指定一个您喜欢的任意名称:

    mkdir WORKING_DIRECTORY
    cd WORKING_DIRECTORY
    
  2. 使用您的真实姓名和电子邮件地址配置 Git。如需使用 Gerrit 代码审核工具,您需要一个与已注册的 Google 帐号相关联的电子邮件地址。 确保这是您可以用来接收邮件的有效地址。您在此处提供的姓名将显示在您提交的代码的提供方信息中。

    git config --global user.name Your Name
    git config --global user.email you@example.com
    
  3. 运行 repo init 获取最新版本的 Repo 及其最新的 bug 修复。Android 源代码中包含的各个仓库在工作目录中的放置位置是通过清单文件来指定的,您必须为该清单指定一个网址。

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

    如需签出 master 分支,请运行以下命令:

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

    如需签出 master 之外的其他分支,请使用 -b 指定此分支。 如需查看分支列表,请参阅源代码标记和 build

    适用于 Python 2

    适用于 Python 3

    如果您收到“/usr/bin/env 'python' no such file or directory”错误消息,请使用以下解决方案之一:

    如果您的 Ubuntu 20.04.2 LTS 是全新安装(相对于升级)的 Linux 版本:

    sudo ln -s /usr/bin/python3 /usr/bin/python

    如果使用的是 Git 2.19 或更高版本,您可以在执行 repo init 时指定 --partial-clone,这样可以利用 Git 的部分克隆功能,从而仅在需要时下载 Git 对象而非下载所有内容。由于使用部分克隆意味着许多操作必须与服务器通信,因此,如果您是一名开发者并且使用的是低延迟网络,请使用以下命令:

    repo init -u https://android.googlesource.com/platform/manifest -b master --partial-clone --clone-filter=blob:limit=10M
    

    仅针对 Windows 操作系统:如果您收到一条错误消息,告诉您无法创建符号链接(这会导致 repo init 运行失败),请参阅 GitHub 符号链接文档来创建符号链接,或启用符号链接支持功能。如果您不是管理员,请参阅允许非管理员创建符号链接部分。

初始化成功后,系统将显示一条消息,告诉您 Repo 已在工作目录中完成初始化。您的客户端目录现在包含一个 .repo 目录,这是清单等文件的存放位置。

下载 Android 源代码树

如需将 Android 源代码树从默认清单中指定的代码库下载到工作目录,请运行以下命令:

repo sync

如需加快同步速度,请传递 -c(当前分支)和 -jthreadcount 标志:

repo sync -c -j8

Android 源代码文件会下载到工作目录中对应的项目名称下。

如需禁止输出,请传递 -q (quiet) 标志。如需了解所有选项,请参阅 Repo 命令参考文档

使用身份验证

默认情况下,访问 Android 源代码为匿名操作。为了防止服务器被过度使用,每个 IP 地址都有一个相关联的配额。

当与其他用户共用一个 IP 地址时(例如,在越过 NAT 防火墙访问源代码库时),即使在常规使用模式下也可能触发配额,例如,当许多用户在短时间内从同一个 IP 地址同步新客户端时便可能触发配额。

在这样的情况下,您可以使用需要进行身份验证的访问方式。不论 IP 地址是什么,这种访问方式都会对每位用户使用单独的配额。

首先,使用密码生成器生成密码,然后按照密码生成器页面中的说明进行操作。

接下来,使用清单 URI https://android.googlesource.com/a/platform/manifest 强制采用需验证身份的访问方式。 请注意 /a/ 目录前缀如何触发强制性身份验证。您可以通过以下命令将现有客户端转换为使用强制性身份验证:

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

排查网络问题

如果在使用代理的情况下下载内容(在一些企业环境中很常见),您可能需要明确指定 Repo 要使用的代理:

export HTTP_PROXY=http://<proxy_user_id>:<proxy_password>@<proxy_server>:<proxy_port>
export HTTPS_PROXY=http://<proxy_user_id>:<proxy_password>@<proxy_server>:<proxy_port>

一种比较少见的情况是,Linux 客户端遇到连接问题,在下载期间(通常是在“正在接收对象”期间)卡住。建议您调整 TCP/IP 堆栈的设置并使用非并行命令,这样可以改善这种情况。您必须拥有 root 权限才能修改 TCP 设置:

sudo sysctl -w net.ipv4.tcp_window_scaling=0
repo sync -j1

使用本地镜像

使用多个客户端时,您可以为整个服务器内容创建本地镜像,并从该镜像同步客户端(不需要访问网络)。

以下说明假定镜像创建在 /usr/local/aosp/mirror 中。首先,创建并同步镜像本身。请注意 --mirror 标记,该标记只能在创建新客户端时指定:

mkdir -p /usr/local/aosp/mirror
cd /usr/local/aosp/mirror
repo init -u https://android.googlesource.com/mirror/manifest --mirror
repo sync

同步镜像后,您就可以从镜像创建新客户端了。请注意,您必须指定一个绝对路径:

mkdir -p /usr/local/aosp/master
cd /usr/local/aosp/master
repo init -u /usr/local/aosp/mirror/platform/manifest.git
repo sync

最后,要将客户端与服务器同步,请将镜像与服务器同步,然后再将客户端与镜像同步:

cd /usr/local/aosp/mirror
repo sync
cd /usr/local/aosp/master
repo sync

您可以将镜像存储在 LAN 服务器上,然后通过 NFS、SSH 或 Git 访问它。您还可以将其存储在移动存储盘上,并在用户之间或计算机之间传递该存储盘。

验证 Git 标记

将以下公钥加载到您的 GnuPG 密钥数据库中。该密钥用于签署代表各版本的带注释标记。

gpg --import

复制并粘贴以下密钥,然后键入 EOF (Ctrl-D) 结束输入并处理密钥。

-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.4.2.2 (GNU/Linux)

mQGiBEnnWD4RBACt9/h4v9xnnGDou13y3dvOx6/t43LPPIxeJ8eX9WB+8LLuROSV
lFhpHawsVAcFlmi7f7jdSRF+OvtZL9ShPKdLfwBJMNkU66/TZmPewS4m782ndtw7
8tR1cXb197Ob8kOfQB3A9yk2XZ4ei4ZC3i6wVdqHLRxABdncwu5hOF9KXwCgkxMD
u4PVgChaAJzTYJ1EG+UYBIUEAJmfearb0qRAN7dEoff0FeXsEaUA6U90sEoVks0Z
wNj96SA8BL+a1OoEUUfpMhiHyLuQSftxisJxTh+2QclzDviDyaTrkANjdYY7p2cq
/HMdOY7LJlHaqtXmZxXjjtw5Uc2QG8UY8aziU3IE9nTjSwCXeJnuyvoizl9/I1S5
jU5SA/9WwIps4SC84ielIXiGWEqq6i6/sk4I9q1YemZF2XVVKnmI1F4iCMtNKsR4
MGSa1gA8s4iQbsKNWPgp7M3a51JCVCu6l/8zTpA+uUGapw4tWCp4o0dpIvDPBEa9
b/aF/ygcR8mh5hgUfpF9IpXdknOsbKCvM9lSSfRciETykZc4wrRCVGhlIEFuZHJv
aWQgT3BlbiBTb3VyY2UgUHJvamVjdCA8aW5pdGlhbC1jb250cmlidXRpb25AYW5k
cm9pZC5jb20+iGAEExECACAFAknnWD4CGwMGCwkIBwMCBBUCCAMEFgIDAQIeAQIX
gAAKCRDorT+BmrEOeNr+AJ42Xy6tEW7r3KzrJxnRX8mij9z8tgCdFfQYiHpYngkI
2t09Ed+9Bm4gmEO5Ag0ESedYRBAIAKVW1JcMBWvV/0Bo9WiByJ9WJ5swMN36/vAl
QN4mWRhfzDOk/Rosdb0csAO/l8Kz0gKQPOfObtyYjvI8JMC3rmi+LIvSUT9806Up
hisyEmmHv6U8gUb/xHLIanXGxwhYzjgeuAXVCsv+EvoPIHbY4L/KvP5x+oCJIDbk
C2b1TvVk9PryzmE4BPIQL/NtgR1oLWm/uWR9zRUFtBnE411aMAN3qnAHBBMZzKMX
LWBGWE0znfRrnczI5p49i2YZJAjyX1P2WzmScK49CV82dzLo71MnrF6fj+Udtb5+
OgTg7Cow+8PRaTkJEW5Y2JIZpnRUq0CYxAmHYX79EMKHDSThf/8AAwUIAJPWsB/M
pK+KMs/s3r6nJrnYLTfdZhtmQXimpoDMJg1zxmL8UfNUKiQZ6esoAWtDgpqt7Y7s
KZ8laHRARonte394hidZzM5nb6hQvpPjt2OlPRsyqVxw4c/KsjADtAuKW9/d8phb
N8bTyOJo856qg4oOEzKG9eeF7oaZTYBy33BTL0408sEBxiMior6b8LrZrAhkqDjA
vUXRwm/fFKgpsOysxC6xi553CxBUCH2omNV6Ka1LNMwzSp9ILz8jEGqmUtkBszwo
G1S8fXgE0Lq3cdDM/GJ4QXP/p6LiwNF99faDMTV3+2SAOGvytOX6KjKVzKOSsfJQ
hN0DlsIw8hqJc0WISQQYEQIACQUCSedYRAIbDAAKCRDorT+BmrEOeCUOAJ9qmR0l
EXzeoxcdoafxqf6gZlJZlACgkWF7wi2YLW3Oa+jv2QSTlrx4KLM=
=Wi5D
-----END PGP PUBLIC KEY BLOCK-----

导入密钥后,您可以通过以下命令验证任何标记:

git tag -v TAG_NAME

获取专有二进制文件

您不能只通过纯源代码来使用 AOSP,还需要运行与硬件相关的其他专有库(例如用于硬件图形加速的专有库)。如需更多资源的下载链接和设备二进制文件,请参阅以下各部分。

下载专有二进制文件

对于运行带标志的 AOSP 版本分支的受支持设备,您可以从 Google 的驱动程序页面下载相关的官方二进制文件。有了这些二进制文件,您将能使用更多采用闭源代码的硬件功能。如需构建 AOSP 的 master 分支,请使用二进制文件预览。在针对某种设备构建 master 分支时,请使用适用于最新编号版本的二进制文件或具有最新日期的二进制文件。

解压专有二进制文件

每组二进制文件都是压缩包中的一个自解压脚本。解压每个压缩包,从源代码树的根目录运行附带的自解压脚本,然后确认您同意附带的许可协议的条款。二进制文件及其对应的 makefile 将会安装在源代码树的 vendor/ 层次结构中。

清理

为了确保新安装的二进制文件在解压后能被有效采用,请使用以下命令删除所有之前 build 的已有输出:

make clobber