Google 致力于为黑人社区推动种族平等。查看具体举措

源代码控制工具

如需使用 Android 代码,您需要使用 Git(一种开源版本控制系统)和 Repo(一种对 Git 构成补充的 Google 代码库管理工具)。如需查看您可以执行的常规操作(例如上传更改以供审核)的摘要,请参阅源代码控制工作流程页面。

Git

Git 可以处理分布在多个代码库上的大型项目。Android 使用 Git 执行本地操作,例如建立本地分支、提交、对比差异、修改。打造 Android 项目所面临的挑战之一就是确定如何最好地支持外部社区 - 从业余爱好者社区到生产大众消费类设备的大型 OEM。Google 希望组件可以替换,并希望有趣的组件能够在 Android 之外自行发展。Google 最初决定使用一种分布式修订版本控制系统,经过筛选,最后选中了 Git。

如需详细了解 Git,请参阅 Git 文档

Repo

Repo 可以在必要时整合多个 Git 代码库,将相关内容上传到 Gerrit 修订版本控制系统,并自动执行 Android 开发工作流程的部分环节。

Repo 启动器会提供一个 Python 脚本,该脚本可以初始化检出,并可以下载第二部分,即完整的 Repo 工具。完整的 Repo 工具包含在 Android 源代码检出中。该工具默认位于 $SRCDIR/.repo/repo/... 中,它可以从下载的 Repo 启动器接收转发的命令。

Repo 不会取代 Git,只是为了让您在 Android 环境中更轻松地使用 Git。Repo 使用清单文件将 Git 项目汇总到 Android 超级项目中。您可以将 repo 命令(这是一个可执行的 Python 脚本)放在路径中的任何位置。使用 Android 源代码文件时,您可以使用 Repo 执行跨网络操作,例如使用一个 Repo 工作目录。

在大多数情况下,您可以仅使用 Git(不必使用 Repo),或结合使用 Repo 和 Git 命令以组成复杂的命令。不过,使用 Repo 执行基本的跨网络操作可大大简化您的工作。如需详细了解 Repo,请参阅 Repo 命令参考资料Repo README、可在 Repo 中启用的预上传钩子(测试)以及 AOSP 中的通用文档

如需从 git-repo-downloads 下载并安装 Repo 启动器,请参阅安装 Repo

Gerrit

Gerrit 是一个基于网页的代码审核系统,适用于使用 Git 的项目。Gerrit 允许所有授权用户提交更改(如果这些更改通过代码审核,便会自动纳入到项目中),以此鼓励他们更集中地使用 Git。此外,Gerrit 会在浏览器中并排显示更改,并支持代码内注释,从而使审核工作变得非常轻松。

如需查看 Android Gerrit 审核界面,请转到 android-review.googlesource.com;如需查看代码导航界面,请转到 android.googlesource.com

Android 代码搜索支持在 AOSP 中进行搜索,您无需下载任何内容。您可以使用“代码搜索”来查看 AOSP 源代码,在开放源代码分支之间切换,以及浏览交叉引用。如需了解详情,请参阅 Google Developers 网站上的代码搜索文档

其他工具

Android Studio 是用于开发 Android 应用的官方集成开发环境 (IDE)。

Android 调试桥 (adb) 可让您将开发工作站直接与相应 Android 设备关联,以便安装软件包和评估更改。

对于 Android 10 及更高版本,请使用 IntelliJ with AIDEgen IDE 进行 Android 平台开发。

安装 Repo

请按以下步骤安装 Repo:

  1. 确保您的主目录中有一个 bin/ 目录,并且它包含在您的路径中:
  2. mkdir ~/bin
    PATH=~/bin:$PATH
    
  3. 下载 Repo 启动器,并确保它可执行:
    curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
    chmod a+x ~/bin/repo
    
    如果完成此步骤后您的终端中未显示该命令,请按 Enter 键。
  4. (可选)验证启动器与 Google 签名是否匹配:
    gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ~/bin/repo

适用于旧版 Python 2 系统的旧版 Repo

如需下载旧版 Repo 启动器,请使用以下命令:

curl https://storage.googleapis.com/git-repo-downloads/repo-1 > ~/bin/repo
chmod a+x ~/bin/repo

完成安装

下一步:如需完整安装 Repo 工具,请参阅下载源代码页面中的初始化 Repo 客户端