源代码控制工具

若想使用 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. 运行以下命令以使用您的 Linux 发行版中的官方软件包:
      sudo apt-get update
      sudo apt-get install repo
    
    如果这些命令不适用于您的系统(例如,您发现软件包版本已过时,或者您的 Linux 发行版中没有可用的官方软件包),请使用以下命令手动安装 Repo:
    export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
    curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
    gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
    
  2. 这些命令会设置一个临时文件,将 Repo 下载到该文件中,并验证提供的密钥是否与所需的密钥匹配。如果这些步骤成功完成,就会继续进行安装。

    安装后,请验证 repo version 在常规目录中运行时是否会报告与下方相似的内容。(常规目录不是 Repo 客户端的一部分;举个例子,它是您的主目录。)

  3. 运行以下命令:
  4. repo version
  5. 您会看到一个与下方内容相似的报告:
  6. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • 如果报告的 repo launcher version 编号为 2.15 或更高,则表明版本号正确,安装无误。
    • (from /usr/bin/repo) 表明是通过软件包进行安装的。
    • (from /home/<>/bin/repo) 表明是手动安装的。

完成安装

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