設定 Android 開放原始碼計畫開發作業 (9.0 以上版本)

下載及建構 Android 來源的 main 分支版本之前，請確認硬體符合必要需求，且已正確安裝所需軟體。您也應該熟悉下列字詞：

Git
Git 是免費的開放原始碼發布版本管控系統。Android 使用 Git 執行本機作業，例如分支版本、修訂版本、差異比較和編輯。如需 Git 的相關說明，請參閱 Git 說明文件。
存放區
Repo 是 Git 圍繞的 Python 包裝函式，可簡化跨多個 Git 存放區執行複雜作業的情形。存放區不會取代所有版本管控作業的 Git，只能讓複雜的 Git 作業更容易完成。存放區使用資訊清單檔案，將 Git 專案匯總至 Android 超級專案。
資訊清單檔案
資訊清單檔案是一種 XML 檔案，用於指定 Android 原始碼中各個 Git 專案在 Android 開放原始碼計畫來源樹狀結構中的位置。

Meet 設備需求

您的開發工作站應符合或超過以下硬體需求：

  • 64 位元系統。

  • 至少 400 GB 的可用磁碟空間，供您查看及建構程式碼 (輸入 250 GB 以及需要建構 150 GB 的可用空間)。

  • 至少有 64 GB RAM。Google 會使用搭載 64 GB RAM 的 72 核心機器來建構 Android。採用這項硬體設定後，整個 Android 版本約需 40 分鐘的時間，而漸進式 Android 建構需要幾分鐘的時間。相較於配備 64 GB RAM 的 6 核心機器，完整建構約需 6 小時的時間。

符合作業系統需求

您的開發工作站必須使用 GNU C 程式庫 (glibc) 2.17 以上版本執行任何 64 位元 Linux 發行版。

安裝必要套件

如要建構 Android 11 以上版本，必須使用 Ubuntu 18.04 以上版本。如要安裝 Ubuntu 18.04 以上版本所需的套件，請執行下列指令：

sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig

在安裝的套件中，這個指令會安裝 Git，用以下載 Android 開放原始碼計畫來源。

安裝所需的軟體

使用 Android 開放原始碼計畫之前，您必須先安裝 OpenJDK、Make、Python 3 和 Repo。Android 開放原始碼計畫主要分支版本隨附 OpenJDK、Make 和 Python 3 的預建版本，因此您不需要執行額外的安裝步驟。下一節說明如何安裝存放區。

安裝存放區

請按照下列步驟安裝存放區：

  1. 下載目前的套件資訊：

    sudo apt-get update

  2. 執行下列指令，安裝 Repo 啟動器：

    sudo apt-get install repo

    存放區啟動器提供 Python 指令碼，可用於初始化結帳並下載完整的存放區工具。

    如果成功，請跳到步驟 4。

  3. (選用) 使用下列一系列指令手動安裝 Repo：

    export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo

    前三個指令會設定暫存檔案、將 Repo 下載至檔案，然後驗證提供的金鑰是否符合必要金鑰。如果這些指令執行成功，最後一個指令會安裝存放區啟動器。

  4. 驗證存放區啟動器版本：

    repo version

    輸出內容應指出 2.5 以上版本，例如：

    repo launcher version 2.40

設定替代輸出目錄

根據預設，每個版本的輸出內容會儲存在相符來源樹狀結構的 out/ 子目錄中。您可以匯出 OUT_DIR 環境變數來覆寫這個目錄。舉例來說，如果您想將輸出內容儲存在其他磁碟中，可以將 OUT_DIR 指向該磁碟：

export OUT_DIR=my_other_drive

後續步驟