源代碼控制工具

使用 Android 程式碼需要同時使用Git (開源版本控制系統)和Repo (Google 建置的儲存庫管理工具,在 Git 上運行)。請參閱原始程式碼管理工作流程頁面,以了解您可以採取的常規操作的摘要,例如上傳變更以供審核。

git

Git 處理分佈在多個儲存庫上的大型專案。 Android 使用 Git 進行本機操作,例如本機分支、提交、差異和編輯。建立 Android 專案的挑戰之一是確定如何最好地支持外部社群——從愛好者社群到建立大眾市場消費設備的大型 OEM。 Google 希望元件是可替換的,並且希望有趣的元件在 Android 之外擁有自己的生命週期。 Google 首先選擇了分散式版本控制系統,然後將範圍縮小到 Git。

有關 Git 的更多詳細信息,請參閱此Git 文件

回購協議

Repo在必要時統一 Git 儲存庫,執行上傳至Gerrit 修訂控制系統的操作,並自動化部分 Android 開發工作流程。

Repo Launcher 提供了一個 Python 腳本,用於初始化結帳並下載第二部分,即完整的 Repo 工具。完整的 Repo 工具包含在 Android 原始碼檢查中。預設情況下,它位於$SRCDIR/.repo/repo/...中,並從下載的 Repo Launcher 接收轉送的命令。

Repo 並不會取代 Git,它只是讓在 Android 環境中使用 Git 變得更容易。 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 程式碼搜尋可讓您搜尋 AOSP,而無需下載任何內容。您可以使用程式碼搜尋來查看 AOSP 原始碼、在開源分支之間切換以及導航交叉引用。有關詳細信息,請參閱 Google Developers 網站的程式碼搜尋文件

其他工具

Android Studio是用於 Android 應用程式開發的官方整合開發環境 (IDE)。

Android 調試橋 (ADB)可讓您將開發工作站直接連接到 Android 設備,以便您可以安裝軟體套件並評估您的變更。

對於 AOSP 開發,請使用Android Studio for Platform (ASfP)

安裝倉庫

請依照以下步驟安裝 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-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
    
  2. 這些命令設定一個臨時文件,將儲存庫下載到其中,並驗證提供的密鑰是否與所需的密鑰相符。如果成功,安裝將繼續。

    安裝後,驗證repo version在常規目錄中運行時是否會報告類似以下內容的內容。 (常規目錄不是儲存庫客戶端的一部分;例如,它是您的主目錄。)

  3. 運行這個命令:
  4. repo version
  5. 期待與此類似的報告:
  6. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • 報告的repo launcher version號為 2.15 或更高版本表示版本號正確且安裝正確。
    • (from /usr/bin/repo)表示從套件安裝。
    • (from /home/<>/bin/repo)表示手動安裝。

完成安裝

下一步:要完成完整的 Repo Tool 安裝,請參閱下載來源頁面上的初始化 Repo 用戶端