下載源代碼 ?

Android 源代碼樹位于由 Google 托管的 Git 代碼庫中。Git 代碼庫中包含 Android 源代碼的元數(shù)據(jù)，其中包括對源代碼進行的更改以及更改時間。本頁介紹了如何下載特定 Android 代碼流水線的源代碼樹。

如需從特定設(shè)備的出廠映像開始，而非從下載源代碼開始，請參閱選擇設(shè)備 build。

安裝 Repo 啟動器后，設(shè)置您的客戶端以訪問 Android 源代碼庫：

創(chuàng)建一個空目錄來存放您的工作文件。為其指定一個您喜歡的任意名稱：

使用您的真實姓名和電子郵件地址配置 Git。如需使用 Gerrit 代碼審核工具，您需要一個與已注冊的 Google 帳號相關(guān)聯(lián)的電子郵件地址。 確保這是您可以用來接收郵件的有效地址。您在此處提供的姓名將顯示在您提交的代碼的提供方信息中。

運行 repo init 獲取最新版本的 Repo 及其最新的 bug 修復(fù)。Android 源代碼中包含的各個倉庫在工作目錄中的放置位置是通過清單文件來指定的，您必須為該清單指定一個網(wǎng)址。

如需簽出 master 分支，請運行以下命令：

如需簽出 master 之外的其他分支，請使用 -b 指定此分支。 如需查看分支列表，請參閱源代碼標(biāo)記和 build。

適用于 Python 2

如需了解更多詳情，請參閱將 Python 2 代碼遷移到 Python 3 以及針對廢棄您的 Python 2 代碼的建議。

適用于 Python 3

如果您收到“/usr/bin/env 'python' no such file or directory”錯誤消息，請使用以下解決方案之一：

如果您的 Ubuntu 20.04.2 LTS 是全新安裝（相對于升級）的 Linux 版本：

如果使用的是 Git 2.19 或更高版本，您可以在執(zhí)行 repo init 時指定 --partial-clone，這樣可以利用 Git 的部分克隆功能，從而僅在需要時下載 Git 對象而非下載所有內(nèi)容。由于使用部分克隆意味著許多作必須與服務(wù)器通信，因此，如果您是一名開發(fā)者并且使用的是低延遲網(wǎng)絡(luò)，請使用以下命令：

僅針對 Windows 作系統(tǒng)：如果您收到一條錯誤消息，告訴您無法創(chuàng)建符號鏈接（這會導(dǎo)致 repo init 運行失敗），請參閱 GitHub 符號鏈接文檔來創(chuàng)建符號鏈接，或啟用符號鏈接支持功能。如果您不是管理員，請參閱允許非管理員創(chuàng)建符號鏈接部分。

初始化成功后，系統(tǒng)將顯示一條消息，告訴您 Repo 已在工作目錄中完成初始化。您的客戶端目錄現(xiàn)在包含一個 .repo 目錄，這是清單等文件的存放位置。

如需將 Android 源代碼樹從默認(rèn)清單中指定的代碼庫下載到工作目錄，請運行以下命令：

如需加快同步速度，請傳遞 -c（當(dāng)前分支）和 -jthreadcount 標(biāo)志：

Android 源代碼文件會下載到工作目錄中對應(yīng)的項目名稱下。

如需禁止輸出，請傳遞 -q (quiet) 標(biāo)志。如需了解所有選項，請參閱 Repo 命令參考文檔。

默認(rèn)情況下，訪問 Android 源代碼為匿名作。為了防止服務(wù)器被過度使用，每個 IP 地址都有一個相關(guān)聯(lián)的配額。

當(dāng)與其他用戶共用一個 IP 地址時（例如，在越過 NAT 防火墻訪問源代碼庫時），即使在常規(guī)使用模式下也可能觸發(fā)配額，例如，當(dāng)許多用戶在短時間內(nèi)從同一個 IP 地址同步新客戶端時便可能觸發(fā)配額。

在這樣的情況下，您可以使用需要進行身份驗證的訪問方式。不論 IP 地址是什么，這種訪問方式都會對每位用戶使用單獨的配額。

首先，使用密碼生成器生成密碼，然后按照密碼生成器頁面中的說明進行作。

接下來，使用清單 URI https://android.googlesource.com/a/platform/manifest 強制采用需驗證身份的訪問方式。 請注意 /a/ 目錄前綴如何觸發(fā)強制性身份驗證。您可以通過以下命令將現(xiàn)有客戶端轉(zhuǎn)換為使用強制性身份驗證：

如果在使用代理的情況下下載內(nèi)容（在一些企業(yè)環(huán)境中很常見），您可能需要明確指定 Repo 要使用的代理：

一種比較少見的情況是，Linux 客戶端遇到連接問題，在下載期間（通常是在“正在接收對象”期間）卡住。建議您調(diào)整 TCP/IP 堆棧的設(shè)置并使用非并行命令，這樣可以改善這種情況。您必須擁有 root 權(quán)限才能修改 TCP 設(shè)置：

使用多個客戶端時，您可以為整個服務(wù)器內(nèi)容創(chuàng)建本地鏡像，并從該鏡像同步客戶端（不需要訪問網(wǎng)絡(luò)）。

以下說明假定鏡像創(chuàng)建在 /usr/local/aosp/mirror 中。首先，創(chuàng)建并同步鏡像本身。請注意 --mirror 標(biāo)記，該標(biāo)記只能在創(chuàng)建新客戶端時指定：

同步鏡像后，您就可以從鏡像創(chuàng)建新客戶端了。請注意，您必須指定一個絕對路徑：

最后，要將客戶端與服務(wù)器同步，請將鏡像與服務(wù)器同步，然后再將客戶端與鏡像同步：

您可以將鏡像存儲在 LAN 服務(wù)器上，然后通過 NFS、SSH 或 Git 訪問它。您還可以將其存儲在移動存儲盤上，并在用戶之間或計算機之間傳遞該存儲盤。

將以下公鑰加載到您的 GnuPG 密鑰數(shù)據(jù)庫中。該密鑰用于簽署代表各版本的帶注釋標(biāo)記。

復(fù)制并粘貼以下密鑰，然后鍵入 EOF (Ctrl-D) 結(jié)束輸入并處理密鑰。

導(dǎo)入密鑰后，您可以通過以下命令驗證任何標(biāo)記：

您不能只通過純源代碼來使用 AOSP，還需要運行與硬件相關(guān)的其他專有庫（例如用于硬件圖形加速的專有庫）。如需更多資源的下載鏈接和設(shè)備二進制文件，請參閱以下各部分。

對于運行帶標(biāo)志的 AOSP 版本分支的受支持設(shè)備，您可以從 Google 的驅(qū)動程序頁面下載相關(guān)的官方二進制文件。有了這些二進制文件，您將能使用更多采用閉源代碼的硬件功能。如需構(gòu)建 AOSP 的 master 分支，請使用二進制文件預(yù)覽。在針對某種設(shè)備構(gòu)建 master 分支時，請使用適用于最新編號版本的二進制文件或具有最新日期的二進制文件。

每組二進制文件都是壓縮包中的一個自解壓腳本。解壓每個壓縮包，從源代碼樹的根目錄運行附帶的自解壓腳本，然后確認(rèn)您同意附帶的許可協(xié)議的條款。二進制文件及其對應(yīng)的 makefile 將會安裝在源代碼樹的 vendor/ 層次結(jié)構(gòu)中。

為了確保新安裝的二進制文件在解壓后能被有效采用，請使用以下命令刪除所有之前 build 的已有輸出：