Android 源代碼樹位於 Google 託管的 Git 存儲庫中。 Git 存儲庫包含 Android 源的元數據,包括對源的更改以及更改的時間。本頁介紹如何下載特定 Android 代碼行的源代碼樹。
要從特定設備的出廠映像開始而不是下載源,請參閱選擇設備版本。
初始化 Repo 客戶端
安裝 Repo Launcher後,設置您的客戶端以訪問 Android 源代碼庫:
創建一個空目錄來保存您的工作文件。給它起任何你喜歡的名字:
mkdir WORKING_DIRECTORY
cd WORKING_DIRECTORY
使用您的真實姓名和電子郵件地址配置 Git。要使用 Gerrit 代碼審查工具,您需要一個與註冊的 Google 帳戶相關聯的電子郵件地址。確保這是您可以接收消息的實時地址。您在此處提供的名稱會顯示在您的代碼提交的屬性中。
git config --global user.name Your Name
git config --global user.email you@example.com
運行
repo init
以獲取最新版本的 Repo 及其最新的錯誤修復。您必須為清單指定一個 URL,該 URL 指定 Android 源代碼中包含的各種存儲庫在您的工作目錄中的位置。repo init -u https://android.googlesource.com/platform/manifest
查看主分支:
repo init -u https://android.googlesource.com/platform/manifest -b master
要簽出除 master 以外的分支,請使用
-b
指定它。有關分支列表,請參閱源代碼標記和構建。對於 Python 2
對於 Python 3
如果您收到“
/usr/bin/env 'python' no such file or directory
”錯誤消息,請使用以下解決方案之一:如果您的 Ubuntu 20.04.2 LTS 是新安裝的(相對於升級的)Linux 版本:
sudo ln -s /usr/bin/python3 /usr/bin/python
如果使用 Git 2.19 或更高版本,您可以在執行
repo init
時指定--partial-clone
。這利用了 Git 的部分克隆功能,僅在需要時下載 Git 對象,而不是下載所有內容。因為使用部分克隆意味著許多操作必須與服務器通信,所以如果您是開發人員並且您使用的是低延遲網絡,請使用以下內容:repo init -u https://android.googlesource.com/platform/manifest -b master --partial-clone --clone-filter=blob:limit=10M
僅適用於 Windows 操作系統:如果您收到一條錯誤消息,指出無法創建符號鏈接,導致
repo init
失敗,請參考 GitHub符號鏈接文檔來創建這些鏈接或啟用它們的支持。對於非管理員,請參閱允許非管理員創建符號鏈接部分。
成功的初始化以一條消息結束,說明 Repo 已在您的工作目錄中初始化。您的客戶端目錄現在包含一個.repo
目錄,其中保存了清單等文件。
下載 Android 源代碼樹
要將 Android 源代碼樹從默認清單中指定的存儲庫下載到您的工作目錄,請運行:
repo sync
要加速同步,請傳遞-c
(當前分支)和-j threadcount
標誌:
repo sync -c -j8
Android 源文件以項目名稱下載到您的工作目錄中。
要抑制輸出,請傳遞-q
(安靜)標誌。有關所有選項,請參閱Repo 命令參考。
使用身份驗證
默認情況下,對 Android 源代碼的訪問是匿名的。為了防止服務器過度使用,每個 IP 地址都與一個配額相關聯。
與其他用戶共享 IP 地址時(例如,從 NAT 防火牆外訪問源存儲庫時),即使是常規使用模式(例如,如果許多用戶從同一 IP 地址同步新客戶端),配額也會觸發。短期內)。
在這種情況下,您可以使用經過身份驗證的訪問,然後為每個用戶使用單獨的配額,而不考慮 IP 地址。
首先,使用密碼生成器創建一個密碼,然後按照密碼生成器頁面上的說明進行操作。
接下來,使用清單 URI https://android.googlesource.com/a/platform/manifest
強制進行身份驗證訪問。請注意/a/
目錄前綴如何觸發強制身份驗證。您可以使用以下命令將現有客戶端轉換為使用強制身份驗證:
repo init -u https://android.googlesource.com/a/platform/manifest
網絡問題疑難解答
從代理後面下載時(這在某些公司環境中很常見),您可能需要明確指定要使用的代理:
export HTTP_PROXY=http://<proxy_user_id>:<proxy_password>@<proxy_server>:<proxy_port>
export HTTPS_PROXY=http://<proxy_user_id>:<proxy_password>@<proxy_server>:<proxy_port>
更罕見的是,Linux 客戶端會遇到連接問題,在下載過程中卡住(通常在接收對象期間)。調整 TCP/IP 堆棧的設置並使用非並行命令可以改善這種情況。您必須具有 root 訪問權限才能修改 TCP 設置:
sudo sysctl -w net.ipv4.tcp_window_scaling=0
repo sync -j1
使用本地鏡像
當使用多個客戶端時,尤其是在帶寬不足的情況下,最好創建整個服務器內容的本地鏡像,並從該鏡像同步客戶端(不需要網絡訪問)。完整鏡像的下載量小於兩個客戶端的下載量,並且包含更多信息。
這些說明假定鏡像是在/usr/local/aosp/mirror
中創建的。首先,創建並同步鏡像本身。請注意--mirror
標誌,您只能在創建新客戶端時指定該標誌:
mkdir -p /usr/local/aosp/mirror
cd /usr/local/aosp/mirror
repo init -u https://android.googlesource.com/mirror/manifest --mirror
repo sync
鏡像同步後,您可以從中創建新客戶端。請注意,您必須指定絕對路徑:
mkdir -p /usr/local/aosp/master
cd /usr/local/aosp/master
repo init -u /usr/local/aosp/mirror/platform/manifest.git
repo sync
最後,要將客戶端與服務器同步,將鏡像與服務器同步,然後將客戶端與鏡像同步:
cd /usr/local/aosp/mirror
repo sync
cd /usr/local/aosp/master
repo sync
可以將鏡像存儲在 LAN 服務器上並通過 NFS、SSH 或 Git 訪問它。也可以將其存儲在可移動驅動器上,並在用戶或機器之間傳遞該驅動器。
驗證 Git 標籤
將以下公鑰加載到您的 GnuPG 密鑰數據庫中。密鑰用於簽署表示版本的註釋標籤。
gpg --import
複製並粘貼下面的鍵,然後鍵入EOF
( Ctrl-D ) 以結束輸入並處理鍵。
-----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v1.4.2.2 (GNU/Linux) mQGiBEnnWD4RBACt9/h4v9xnnGDou13y3dvOx6/t43LPPIxeJ8eX9WB+8LLuROSV lFhpHawsVAcFlmi7f7jdSRF+OvtZL9ShPKdLfwBJMNkU66/TZmPewS4m782ndtw7 8tR1cXb197Ob8kOfQB3A9yk2XZ4ei4ZC3i6wVdqHLRxABdncwu5hOF9KXwCgkxMD u4PVgChaAJzTYJ1EG+UYBIUEAJmfearb0qRAN7dEoff0FeXsEaUA6U90sEoVks0Z wNj96SA8BL+a1OoEUUfpMhiHyLuQSftxisJxTh+2QclzDviDyaTrkANjdYY7p2cq /HMdOY7LJlHaqtXmZxXjjtw5Uc2QG8UY8aziU3IE9nTjSwCXeJnuyvoizl9/I1S5 jU5SA/9WwIps4SC84ielIXiGWEqq6i6/sk4I9q1YemZF2XVVKnmI1F4iCMtNKsR4 MGSa1gA8s4iQbsKNWPgp7M3a51JCVCu6l/8zTpA+uUGapw4tWCp4o0dpIvDPBEa9 b/aF/ygcR8mh5hgUfpF9IpXdknOsbKCvM9lSSfRciETykZc4wrRCVGhlIEFuZHJv aWQgT3BlbiBTb3VyY2UgUHJvamVjdCA8aW5pdGlhbC1jb250cmlidXRpb25AYW5k cm9pZC5jb20+iGAEExECACAFAknnWD4CGwMGCwkIBwMCBBUCCAMEFgIDAQIeAQIX gAAKCRDorT+BmrEOeNr+AJ42Xy6tEW7r3KzrJxnRX8mij9z8tgCdFfQYiHpYngkI 2t09Ed+9Bm4gmEO5Ag0ESedYRBAIAKVW1JcMBWvV/0Bo9WiByJ9WJ5swMN36/vAl QN4mWRhfzDOk/Rosdb0csAO/l8Kz0gKQPOfObtyYjvI8JMC3rmi+LIvSUT9806Up hisyEmmHv6U8gUb/xHLIanXGxwhYzjgeuAXVCsv+EvoPIHbY4L/KvP5x+oCJIDbk C2b1TvVk9PryzmE4BPIQL/NtgR1oLWm/uWR9zRUFtBnE411aMAN3qnAHBBMZzKMX LWBGWE0znfRrnczI5p49i2YZJAjyX1P2WzmScK49CV82dzLo71MnrF6fj+Udtb5+ OgTg7Cow+8PRaTkJEW5Y2JIZpnRUq0CYxAmHYX79EMKHDSThf/8AAwUIAJPWsB/M pK+KMs/s3r6nJrnYLTfdZhtmQXimpoDMJg1zxmL8UfNUKiQZ6esoAWtDgpqt7Y7s KZ8laHRARonte394hidZzM5nb6hQvpPjt2OlPRsyqVxw4c/KsjADtAuKW9/d8phb N8bTyOJo856qg4oOEzKG9eeF7oaZTYBy33BTL0408sEBxiMior6b8LrZrAhkqDjA vUXRwm/fFKgpsOysxC6xi553CxBUCH2omNV6Ka1LNMwzSp9ILz8jEGqmUtkBszwo G1S8fXgE0Lq3cdDM/GJ4QXP/p6LiwNF99faDMTV3+2SAOGvytOX6KjKVzKOSsfJQ hN0DlsIw8hqJc0WISQQYEQIACQUCSedYRAIbDAAKCRDorT+BmrEOeCUOAJ9qmR0l EXzeoxcdoafxqf6gZlJZlACgkWF7wi2YLW3Oa+jv2QSTlrx4KLM= =Wi5D -----END PGP PUBLIC KEY BLOCK-----
導入密鑰後,您可以使用以下命令驗證任何標籤:
git tag -v TAG_NAME
獲取專有二進製文件
AOSP 不能僅從純源代碼中使用,並且需要額外的與硬件相關的專有庫才能運行,例如用於硬件圖形加速。有關其他資源,請參閱以下部分以獲取下載鏈接和設備二進製文件。
下載專有二進製文件
您可以從Google 的驅動程序下載運行標記為 AOSP 發布分支的受支持設備的官方二進製文件。這些二進製文件通過非開源代碼增加了對其他硬件功能的訪問。要構建 AOSP 主分支,請改用Binaries Preview 。在為設備構建主分支時,請使用最新編號版本或最新日期的二進製文件。
提取專有二進製文件
每組二進製文件都作為壓縮存檔中的自解壓腳本提供。解壓縮每個存檔,從源代碼樹的根目錄運行包含的自解壓腳本,然後確認您同意隨附許可協議的條款。二進製文件及其匹配的 makefile 安裝在源代碼樹的vendor/
層次結構中。
清理
為確保在提取後正確考慮新安裝的二進製文件,請使用以下命令刪除任何先前構建的現有輸出:
make clobber