下载源代码

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

要从特定设备的出厂映像开始而不是下载源,请参阅选择设备版本

初始化 Repo 客户端

安装 Repo Launcher后,设置您的客户端以访问 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 及其最新的错误修复。您必须为清单指定一个 URL,该 URL 指定 Android 源代码中包含的各种存储库在您的工作目录中的位置。

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

    查看主分支:

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

    要签出除 master 以外的分支,请使用-b指定它。有关分支列表,请参阅源代码标记和构建

    对于 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 (当前分支)和-j threadcount标志:

repo sync -c -j8

Android 源文件以项目名称下载到您的工作目录中。

要抑制输出,请传递-q (安静)标志。有关所有选项,请参阅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

网络问题疑难解答

从代理后面下载时(这在某些公司环境中很常见),您可能需要明确指定要使用的代理:

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 不能仅从纯源代码中使用,并且需要额外的与硬件相关的专有库才能运行,例如用于硬件图形加速。有关其他资源,请参阅以下部分以获取下载链接和设备二进制文件

下载专有二进制文件

您可以从Google 的驱动程序下载运行标记为 AOSP 发布分支的受支持设备的官方二进制文件。这些二进制文件通过非开源代码增加了对其他硬件功能的访问。要构建 AOSP 主分支,请改用Binaries Preview 。在为设备构建主分支时,请使用最新编号版本或最新日期的二进制文件。

提取专有二进制文件

每组二进制文件都作为压缩存档中的自解压脚本提供。解压缩每个存档,从源代码树的根目录运行包含的自解压脚本,然后确认您同意随附许可协议的条款。二进制文件及其匹配的 makefile 安装在源代码树的vendor/层次结构中。

清理

为确保在提取后正确考虑新安装的二进制文件,请使用以下命令删除任何先前构建的现有输出:

make clobber