注意:該文檔中的假定使用分支為dev。
1.Gerrit配置
其中提到的下列步驟,請確認在你即將進行的專案中,是否已經配置完成。
自動添加 Change-Id
將 commit-msg 放到工程目錄中的 .git/hooks/ 裡面,之後的 commit 就會自動添加 Change_Id 到 commit message 中
可根據需求調整 commit-msg 的內容
2.新Subject的Push及Review
2.1 Push
1.若當前需push的版本在Gerrit中不存在時,在Git中使當前分支與origin/dev在同一主線上,並且保證當前分支與origin/dev之間沒有其他分支:
(注:若該主線中存在其他分支,所有分支將被push進入Gerrit Server)
2.點擊“Push”,Remote分支為“Origin”, push至“refs/for/dev”:
2.2 Verify/Review
2.2.1 打開Subject
1.push成功后,所有項目相關人員均會收到郵件提醒
2.網頁打開Gerrit並登陸
3.進入All->Open,可瀏覽當前還未Merge的Subject(Subject的名稱同Commit Message相同):
右側顯示Code Review及Verify均未執行。
4.點擊進入Subject,進行Verify
2.2.2 Verify
1.復制Download下的地址:
2.Git Extension中打開Git Bash(若由於配置不正確無法打開Git Bash,可進入工程目錄通過點擊鼠標右鍵,選擇Git Bash進入)
3.Git Bash中點擊鼠標右鍵粘貼已復制的地址,點擊”Enter“:
4.Git Extension進行刷新,此時已進入待Verify的分支,進行build和運行,以驗證改版本為可使用版本
5.若驗證成功,Gerrit中點擊”Review“進入Review頁面,”Verified“下選擇”+1 Verified“;否則選擇”-1 Fails“:
2.2.3 Review
Verify成功后可進行Review動作:
1.在該Subject頁面下的FilePath選擇希望查看的文件:
2.此時可進行文件對比(左:原文件,右:當前版本文件):
3.雙擊一行可進行備注添加,點擊”save“將保存備注,”discard“放棄備注:
4.Review完畢后,點擊”Review“按鈕可進行評分,需一次得到兩分才可獲取提交資格:
2.2.4 Submit
當Verify通過,且Review一次獲取2分后,可進行Submit,將版本並入Server:
點擊”Submint Path Set *“:
此時版本成功合並入Server。
3.已存在Subject的push
1.當Code Review沒有通過(Verfiy未通過,或Review沒有一次獲的2分)時,需要在當前Subject下push修改后的分支時,注意可在Commit時進行Amend,是當前分支保持原地:
2.點擊“Amend last commit”,使分支保持原先的Commit Message和Change Id
3.再次點擊“Amend last commit”,確認修改當前分支
4.繼續的向“refs/for/dev”路徑的push
5.此時在該Subject下將會有兩個版本:
6.繼續上一節的Verify和Review動作,直至通過Review