下載及建構 Android 來源的 main
分支版本之前,請確認硬體符合必要需求,且已正確安裝所需軟體。您也應該熟悉下列字詞:
- Git
- Git 是免費的開放原始碼發布版本管控系統。Android 使用 Git 執行本機作業,例如分支版本、修訂版本、差異比較和編輯。如需 Git 的相關說明,請參閱 Git 說明文件。
- 存放區
- Repo 是 Git 圍繞的 Python 包裝函式,可簡化跨多個 Git 存放區執行複雜作業的情形。存放區不會取代所有版本管控作業的 Git,只能讓複雜的 Git 作業更容易完成。存放區使用資訊清單檔案,將 Git 專案匯總至 Android 超級專案。
- 資訊清單檔案
- 資訊清單檔案是一種 XML 檔案,用於指定 Android 原始碼中各個 Git 專案在 Android 開放原始碼計畫來源樹狀結構中的位置。
Meet 設備需求
您的開發工作站應符合或超過以下硬體需求:
64 位元 x86 系統。
至少 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 的預建版本,因此您不需要執行額外的安裝步驟。下一節說明如何安裝存放區。
安裝存放區
請按照下列步驟安裝存放區:
下載目前的套件資訊:
sudo apt-get update
執行下列指令,安裝 Repo 啟動器:
sudo apt-get install repo
存放區啟動器提供 Python 指令碼,可用於初始化結帳並下載完整的存放區工具。
如果成功,請跳到步驟 4。
(選用) 使用下列一系列指令手動安裝 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 下載至檔案,然後驗證提供的金鑰是否符合必要金鑰。如果這些指令執行成功,最後一個指令會安裝存放區啟動器。
驗證存放區啟動器版本:
repo version
輸出內容應指出 2.5 以上版本,例如:
repo launcher version 2.40
設定替代輸出目錄
根據預設,每個版本的輸出內容會儲存在相符來源樹狀結構的 out/
子目錄中。您可以匯出 OUT_DIR
環境變數來覆寫這個目錄。舉例來說,如果您想將輸出內容儲存在其他磁碟中,可以將 OUT_DIR
指向該磁碟:
export OUT_DIR=my_other_drive
後續步驟
- 如要下載原始碼,請繼續下載 Android 原始碼。
- 如需學習 Git 的相關說明,請參閱 Git 說明文件。
- 如需其他存放區說明文件,請參閱 Repo README。
- 如需所有 Repo 指令的清單,請參閱 Repo 指令參考資料。