源代码控制工具

使用 Android 代码需要同时使用Git (一种开源版本控制系统)和Repo (一种运行在 Git 之上的 Google 构建的存储库管理工具)。请参阅源代码管理工作流程页面,了解您可以采取的常规操作的摘要,例如上传更改以供审核。

混帐

Git 处理分布在多个存储库中的大型项目。 Android 使用 Git 进行本地操作,例如本地分支、提交、差异和编辑。建立 Android 项目的挑战之一是确定如何最好地支持外部社区——从爱好者社区到构建大众市场消费设备的大型 OEM。谷歌希望组件是可替换的,并且希望有趣的组件在 Android 之外有自己的生命。 Google 首先选择了分布式版本控制系统,然后将范围缩小到 Git。

有关 Git 的更多详细信息,请参阅此Git 文档

回购

Repo在必要时统一 Git 存储库,执行上传到Gerrit 版本控制系统,并自动化部分 Android 开发工作流程。

Repo Launcher 提供了一个 Python 脚本,用于初始化结帐并下载第二部分,即完整的 Repo 工具。完整的 Repo 工具包含在 Android 源代码检出中。默认情况下,它位于$SRCDIR/.repo/repo/...并从下载的 Repo Launcher 接收转发的命令。

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

在大多数情况下,您可以使用 Git 代替 Repo,或者将 Repo 和 Git 命令混合使用以形成复杂的命令。但是,使用 Repo 进行基本的跨网络操作可以让您的工作变得更加简单。有关 Repo 的更多详细信息,请参阅Repo 命令参考Repo README 、可以在 Repo 中启用的Preupload Hooks (测试)和AOSP 中的一般文档

要从git-repo-downloads下载并安装Repo Launcher ,请参阅安装 Repo

格里特

Gerrit是一个基于 Web 的代码审查系统,适用于使用 Git 的项目。 Gerrit 通过允许所有授权用户提交更改来鼓励更集中地使用 Git,如果他们通过代码审查,这些更改将自动合并。此外,Gerrit 使审查变得容易,在浏览器中并排显示更改并启用内联评论。

android-review.googlesource.com找到 Android Gerrit 审查界面,在android.googlesource.com找到代码导航界面。

Android Code Search允许您在不下载任何内容的情况下搜索 AOSP。您可以使用代码搜索来查看 AOSP 源代码、在开源分支之间切换以及导航交叉引用。有关详细信息,请参阅 Google Developers 站点的代码搜索文档

其他工具

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

Android 调试桥 (ADB)可让您将开发工作站直接连接到您的 Android 设备,以便您可以安装包并评估您的更改。

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

安装回购

按照以下步骤安装 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在常规目录中运行时报告类似于以下内容。 (常规目录不是回购客户端的一部分;例如,它是您的主目录。)

  3. 运行此命令:
  4. repo version
  5. 期待与此类似的报告:
  6. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • 报告为 2.15 或更高版本的repo launcher version号表示正确的版本号和正确的安装。
    • (from /usr/bin/repo)表示从包安装。
    • (from /home/<>/bin/repo)表示手动安装。

完成安装

下一步:要完成完整的回购工具安装,请参阅下载源页面上的初始化回购客户端