回購命令參考

Repo 通過簡化跨多個存儲庫的工作來補充 Git。有關 Repo 和 Git 之間關係的說明,請參閱源代碼控制工具。有關 Repo 的更多詳細信息,請參閱Repo README

回購使用採用以下形式:

repo command options

可選元素顯示在方括號 [ ] 中。例如,許多命令將project-list作為參數。您可以將project-list指定為名稱列表或項目本地源目錄的路徑列表:

repo sync [project0 project1 ... projectn]
repo sync [/path/to/project0 ... /path/to/projectn]

幫助

此頁面僅突出顯示關鍵選項。有關完整詳細信息,請參閱命令行幫助。安裝 Repo 後,您可以通過運行以下命令找到以所有命令摘要開頭的最新文檔:

repo help

您可以通過在 Repo 樹中運行此命令來查看有關任何命令的詳細信息:

repo help command

例如,以下命令為 Repo 的init參數生成描述和選項列表,該參數在當前目錄中初始化 Repo。 (有關詳細信息,請參閱init 。)

repo help init

或者只查看可用選項的列表,運行:

repo command --help
例如:
repo init --help

在裡面

repo init -u url [options]

在當前目錄中安裝 Repo。這將創建一個.repo/目錄,其中包含用於 Repo 源代碼和標準 Android 清單文件的 Git 存儲庫。

選項:

  • -u :指定從中檢索清單存儲庫的 URL。通用清單位於https://android.googlesource.com/platform/manifest
  • -m :選擇存儲庫中的清單文件。如果未選擇清單名稱,則默認值為default.xml
  • -b :指定修訂版,即特定的manifest-branch

注意:對於所有剩餘的 Repo 命令,當前工作目錄必須是.repo/的父目錄或父目錄的子目錄。

同步

repo sync [project-list]

下載新更改並更新本地環境中的工作文件,實質上是在所有 Git 存儲庫中完成git fetch 。如果不帶參數運行repo sync ,它會同步所有項目的文件。

當您運行repo sync ,會發生以下情況:

  • 如果項目從未同步過,那麼repo sync就相當於git clone 。遠程存儲庫中的所有分支都複製到本地項目目錄。

  • 如果項目之前已經同步過,那麼repo sync就相當於:

    git remote update
    git rebase origin/branch
    

    其中branch是本地項目目錄中當前簽出的分支。如果本地分支沒有跟踪遠程存儲庫中的分支,則項目不會發生同步。

  • 如果 Git rebase 操作導致合併衝突,請使用正常的 Git 命令(例如, git rebase --continue )解決衝突。

成功運行repo sync ,指定項目中的代碼是最新的並與遠程存儲庫中的代碼同步。

以下是關鍵選項。有關更多信息,請參閱repo help sync

  • -c :僅從服務器獲取當前清單分支。

  • -d :將指定的項目切換回清單修訂版。如果項目當前位於主題分支上,但暫時需要清單修訂,這將很有幫助。

  • -f :即使項目無法同步,也繼續同步其他項目。

  • -j threadcount :跨線程拆分同步以加快完成速度。確保您的機器不會不堪重負 - 為其他任務保留一些 CPU。要查看可用 CPU 的數量,請先運行: nproc --all

  • -q :通過抑制狀態消息安靜地運行。

  • -s :同步到由當前清單中的manifest-server元素指定的已知良好構建。

上傳

repo upload [project-list]

對於指定的項目,Repo 將本地分支與上次 Repo 同步期間更新的遠程分支進行比較。 Repo 會提示您選擇一個或多個尚未上傳審核的分支。

然後,所選分支上的所有提交都通過 HTTPS 連接傳輸到 Gerrit。開啟上傳授權需要配置HTTPS密碼。訪問密碼生成器以生成新的用戶名/密碼對以通過 HTTPS 使用。

當 Gerrit 通過其服務器接收到對像數據時,它會將每個提交轉換為更改,以便審閱者可以對特定提交發表評論。要將多個檢查點提交合併為一個提交,請在運行上傳之前使用git rebase -i

如果您不帶參數運行repo upload ,它會搜索所有項目以查找要上傳的更改。

要在上傳後編輯更改,請使用git rebase -igit commit --amend類的工具來更新本地提交。修改完成後:

  • 驗證更新的分支是當前簽出的分支。
  • 對於系列中的每個提交,在括號內輸入 Gerrit 更改 ID:
    # Replacing from branch foo
    [ 3021 ] 35f2596c Refactor part of GetUploadableBranches to lookup one specific...
    [ 2829 ] ec18b4ba Update proto client to support patch set replacments
    # Insert change numbers in the brackets to add a new patch set.
    # To create a new change record, leave the brackets empty.
    

上傳完成後,更改有一個額外的補丁集。

如果您只想上傳當前檢出的 Git 分支,請使用標誌--current-branch (或--cbr )。

差異

repo diff [project-list]

使用git diff顯示提交和工作樹之間的顯著變化。

下載

repo download target change

從審查系統下載指定的更改,並使其在項目的本地工作目錄中可用。

例如,要將更改 23823下載到您的平台/構建目錄中:

repo download platform/build 23823

運行repo sync會刪除使用repo download檢索到的任何提交。或者您可以使用git checkout m/master遠程分支。

注意:全球所有服務器都存在復制延遲,因此在Gerrit的 Web 上可見更改和repo download可以找到所有用戶的更改之間存在輕微的鏡像延遲。

對所有人

repo forall [project-list] -c command

在每個項目中執行給定的 shell 命令。 repo forall提供了以下附加環境變量:

  • REPO_PROJECT設置為項目的唯一名稱。

  • REPO_PATH是相對於客戶端根目錄的路徑。

  • REPO_REMOTE是清單中遠程系統的名稱。

  • REPO_LREV是清單中修訂的名稱,轉換為本地跟踪分支。如果您需要將清單修訂傳遞給本地執行的 Git 命令,請使用此選項。

  • REPO_RREV是清單中修訂的名稱,與清單中所寫的完全相同。

選項:

  • -c :要執行的命令和參數。該命令通過/bin/sh以及作為 shell 位置參數傳遞後的任何參數進行評估。

  • -p :在輸出指定命令之前顯示項目標題。這是通過將管道綁定到命令的 stdin、stdout 和 sterr 流,並將所有輸出管道傳輸到在單個尋呼會話中顯示的連續流中來實現的。

  • -v :顯示命令寫入 stderr 的消息。

修剪

repo prune [project-list]

修剪(刪除)已經合併的主題。

開始

repo start
branch-name [project-list]

從清單中指定的修訂開始,開始一個新的開發分支。

BRANCH_NAME參數提供了您嘗試對項目進行的更改的簡短描述。如果您不知道,請考慮使用名稱default

project-list參數指定哪些項目參與此主題分支。

注意:句點 ( . ) 是當前工作目錄中項目的簡寫。

地位

repo status [project-list]

將工作樹與指定的每個項目中的暫存區(索引)和此分支 (HEAD) 上的最新提交進行比較。顯示這三種狀態之間存在差異的每個文件的摘要行。

要查看當前分支的repo status . ,請運行repo status . .狀態信息按項目列出。對於項目中的每個文件,使用兩個字母的代碼。

在第一列中,大寫字母表示暫存區與最後提交的狀態有何不同。

信件意義描述
——沒有變化HEAD 和索引相同
一種添加不在 HEAD 中,在索引中
修改的在 HEAD 中,在索引中修改
D已刪除在 HEAD 中,不在索引中
電阻重命名不在 HEAD 中,索引中的路徑已更改
C已復制不在 HEAD 中,從索引中的另一個複制
模式改變HEAD 和 index 內容相同,模式改變
未合併HEAD 和索引之間的衝突;需要分辨率

在第二列中,小寫字母表示工作目錄與索引的不同之處。

信件意義描述
——新的/未知的不在索引中,在工作樹中
修改的在索引中,在工作樹中,已修改
d已刪除在索引中,不在工作樹中