Repo 可簡化多個存放區的工作,為 Git 提供補充功能。對於 Repo 和 Git 之間的關係,請參閱 原始碼控管工具。如要進一步瞭解存放區,請參閱 存放區 README
存放區的使用格式如下:
repo command options
選擇性元素會顯示在方括號 [] 中。例如,許多指令 project-list 做為引數。您可以指定 project-list 以名稱或字串清單的形式,列出 專案:
repo sync [project0 project1 ... projectn]
repo sync [/path/to/project0 ... /path/to/projectn]
幫助
repo help
提供 repo
指令的說明。您也可以查看
指定指令做為選項的 Repo 指令:
repo help command
舉例來說,下列指令會產生 init
指令的說明和選項清單:
repo help init
或者,如要只查看指令的可用選項清單,請執行以下指令:
repo command --help
例如:
repo init --help
init
repo init -u url [options]
在目前目錄中安裝 Repo。這個指令會建立 .repo/
目錄中的
標準 Android 資訊清單檔案
選項:
-u
:指定要用來擷取資訊清單存放區的網址。這個 資訊清單位於https://android.googlesource.com/platform/manifest
。-m
:選取存放區中的資訊清單檔案。如果未選取資訊清單名稱,預設值為default.xml
。-b
:指定修訂版本,也就是特定的 manifest-branch。
同步
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 是本機目前的結帳分支版本 專案目錄如果本機分支未追蹤遠端存放區中的分支,則不會為專案進行同步處理。
成功執行 repo sync
後,指定專案中的程式碼會更新並與遠端存放區中的程式碼同步。
主要選項:
-c
:僅從伺服器擷取目前的資訊清單分支版本。-d
:將指定專案切換回資訊清單修訂版本。如果專案位於主題分支,但暫時需要資訊清單修訂版本,這個選項就很實用。-f
:即使專案無法同步處理,也能繼續同步處理其他專案。threadcount
:將同步作業分散到各執行緒,以便更快完成。別讓機器負擔過重,只剩下 CPU 來處理其他任務如要查看可用的 CPU 數量,請先執行nproc --all
。-q
:抑制狀態訊息,安靜執行。-s
:同步至目前資訊清單中manifest-server
元素指定的已知良好版本。
如需更多選項,請執行 repo help sync
。
上傳
repo upload [project-list]
將變更上傳至審查伺服器。針對指定專案,Repo 會將本機分支與上次 Repo 同步時更新的遠端分支進行比較。Repo 會提示您選取一或多個尚未上傳供審查的分支。
所選分支的所有修訂版本都會透過 HTTPS 連線。您必須設定 HTTPS 密碼,才能啟用上傳功能 或授權。如要產生新的使用者名稱/密碼組合,透過 HTTPS 使用, 請前往 密碼產生器。
當 Gerrit 透過伺服器收到物件資料時,
提交變更,方便審查者針對特定修訂版本加註。
如要將多個檢查點提交合併為單一提交,請在執行上傳作業前使用 git rebase -i
。
如果您執行 repo upload
時沒有使用引數,系統會搜尋所有專案:
即可上傳變更內容
如要在上傳後編輯變更內容,請使用 git rebase -i
等工具或
更新本機修訂版本的 git commit --amend
。編輯內容
完成:
- 確認更新的分支是目前已簽出的分支。
- 使用
repo upload --replace PROJECT
開啟變更比對編輯器。 針對系列叢書中的每個提交,請在括號內輸入 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 replacements # 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
從審查系統下載指定的變更,並在專案的本機工作目錄中提供。
例如,如要將 change 23823 下載至 platform/build
目錄:
repo download platform/build 23823
執行 repo sync
會移除透過 repo download
擷取的所有提交。或者,您也可以使用 git checkout m/main
檢查遠端分支。
forall
repo forall [project-list] -c command
這個外掛程式會在每項專案中執行指定的殼層指令。repo forall
提供下列額外的環境變數:
REPO_PROJECT
要設定為專案的唯一名稱。REPO_PATH
是相對於用戶端根目錄的路徑。REPO_REMOTE
是資訊清單中的遠端系統名稱。REPO_LREV
是資訊清單中的修訂版本名稱,經過翻譯為 本地追蹤分支。如果您需要傳送資訊清單,請使用這個變數 新增至本機執行的 Git 指令REPO_RREV
是資訊清單中的修訂版本名稱,與資訊清單中的名稱完全相同。
選項:
-c
:要執行的指令和引數。系統會透過/bin/sh
及其之後的所有引數都會以殼層位置的形式傳遞 參數。-p
:在指定指令的輸出內容前顯示專案標頭。方法是將管道繫結至指令的 stdin、stdout 和 sterr 串流,並將所有輸出內容管道至單一分頁器工作階段中顯示的連續串流。-v
:顯示指令寫入 stderr 的訊息。
修剪
repo prune [project-list]
刪減 (刪除) 已合併的主題。
start
repo start branch-name [project-list]
從資訊清單中指定的修訂版本開始,開始開發新的分支。
BRANCH_NAME
引數會簡短說明所進行的變更
想製作出什麼都沒問題如果不知道
default
。
project-list
引數會指定哪些專案參與這個主題分支。
status
repo status [project-list]
將工作樹狀結構與指定每個專案中的暫存區 (索引) 和這個分支 (HEAD) 的最新提交內容進行比較。針對這三種狀態之間有差異的每個檔案,顯示摘要行。
如要只查看目前分支的狀態,請執行 repo status .
。狀態
會按專案列出資訊專案中的每個檔案都會使用兩個字母代碼。
在第一欄中,大寫字母會指出前台區域與上次提交的狀態有何不同。
Letter | 意義 | 說明 |
---|---|---|
- | 沒有變化 | HEAD 和索引中的內容相同 |
A | 已新增 | 不在索引中,而是在 HEAD 中 |
M | 上次修改日期 | 已在 HEAD 中修改 |
D | 已刪除 | 位於 HEAD 中,不在索引中 |
R | 已重新命名 | 不在 HEAD 中,但索引中路徑已變更 |
C | 已複製 | 不在 HEAD 中,而是從索引中的其他項目複製而來 |
T | 模式已變更 | HEAD 和索引中的內容相同,但模式已變更 |
更新 | 未合併 | HEAD 與索引之間的衝突;需要解決 |
在第二欄中,小寫字母會指出工作目錄與索引的差異。
Letter | 意義 | 說明 |
---|---|---|
- | 新客戶/不明 | 不在索引中,但在工作樹狀結構中 |
分鐘 | 上次修改日期 | 在索引、工作樹狀結構中修改 |
d 鍵 | 已刪除 | 在索引中,不在工作樹狀結構中 |
處理存放區錯誤
git commit -a # Commit local changes first so they aren't lost. repo start branch-name # Start the branch git reset --hard HEAD@{1} # And reset the branch so that it matches the commit before repo start repo upload .
如果在工作階段開始時未執行 repo start
指令,就會顯示錯誤訊息 repo: error: no branches ready for upload
。如要復原,請
修訂版本 ID,啟動新的分支版本,然後合併。