Upsource功能介紹

簡(jiǎn)介

Upsource作為Jetbrains公司出品的一款Code Review工具，通過(guò)與版本管理軟件（ Git、 Mercurial、 Subversion 和 Perforce）結(jié)合，以社交化的形式，將代碼予以團(tuán)隊(duì)成員或其他人分享、討論。

主要功能

便捷的查看自己的項(xiàng)目

Upsource主要基于版本管理軟件，因此，只要項(xiàng)目已經(jīng)交給Upsource管理，你就可以方便的看到你所參與的項(xiàng)目,以及最近相關(guān)的Feeds。

你所貢獻(xiàn)的項(xiàng)目

相關(guān)Feeds

不同的Review角色

在Upsource之中，針對(duì)一次review分為了3個(gè)不同的角色，Author、Reviewer、Watcher
其中Author在創(chuàng)建本次Review時(shí)，Upsource會(huì)自動(dòng)根據(jù)代碼的提交來(lái)判斷，因此不可修改.

Reviewer：主要負(fù)責(zé)審核代碼作者對(duì)該份代碼的修改并留下反饋，他可以隨時(shí)在該次review中討論并留下意見(jiàn)，也可以關(guān)閉這次review。

Watcher：watcher不太需要去關(guān)心代碼的細(xì)節(jié)修改，關(guān)注重點(diǎn)是項(xiàng)目的狀態(tài)以及團(tuán)隊(duì)成員的討論。

review角色

如上圖所示，作為review的發(fā)起者，你可以點(diǎn)擊+邀請(qǐng)團(tuán)隊(duì)成員或者其他人作為reviewer或者watcher，同時(shí)，你可以將鼠標(biāo)放在頭像之上，看到該成員本次review的進(jìn)度,如下所示

image.png

簡(jiǎn)單方便的Review視圖

以Idea、Webstorm、Pycharm聞名的Jetbrains公司，對(duì)于代碼的展現(xiàn)方示方式自然得心應(yīng)手，無(wú)論是python、c++、c#、Java、Javascript都可以很好的在瀏覽器中展現(xiàn)，甚至React、Vue這樣的DSL，也能正常的展示出來(lái)

在線展示React代碼

社交化的Review形式

在review中，如果您發(fā)現(xiàn)某一行代碼實(shí)現(xiàn)有問(wèn)題，你可以隨時(shí)在該行加上注解，并@相關(guān)開(kāi)發(fā)同學(xué)，當(dāng)他做出合理的解釋或者修改后，您就可以標(biāo)記這行已經(jīng)解決過(guò)了，已方便減少不必要的重復(fù)review

image.png

Jetbrains插件集成

如果你不喜歡在瀏覽器上做Review，同時(shí)正巧你又使用的是Jetbrains旗下的軟件進(jìn)行開(kāi)發(fā)任務(wù)，那么你可以天然的將Upsource通過(guò)插件的形式集成在你的IDE上
詳細(xì)說(shuō)明可以在官方文檔上查到，這里就不在展開(kāi)：https://www.jetbrains.com/help/upsource/installing-plugin.html

基于Upsource的CR實(shí)踐

通過(guò)這段時(shí)間對(duì)Upsource的使用，我們可以通過(guò)創(chuàng)建Branch Review，來(lái)對(duì)一個(gè)迭代的代碼進(jìn)行Review，一個(gè)加上Review的開(kāi)發(fā)流程如下所示。

開(kāi)發(fā)流程.png

創(chuàng)建項(xiàng)目

如果登錄Upsource后，發(fā)現(xiàn)沒(méi)有你自己的項(xiàng)目，那么，你需要自行將項(xiàng)目創(chuàng)建出來(lái)。

• 點(diǎn)擊首頁(yè)右上角的設(shè)置按鈕

  
  
  設(shè)置

• 點(diǎn)擊Create Project
  

  創(chuàng)建項(xiàng)目

• 輸入項(xiàng)目名字、倉(cāng)庫(kù)地址、倉(cāng)庫(kù)校驗(yàn)方式等相關(guān)信息
  

  輸入必備信息

• 點(diǎn)擊 Create Project即可

這時(shí)，便可以看到項(xiàng)目已經(jīng)正在導(dǎo)入之中,待項(xiàng)目導(dǎo)入成功，就可以開(kāi)始創(chuàng)建一Review

image.png

基于Branch創(chuàng)建Review

• 進(jìn)入項(xiàng)目之后，點(diǎn)擊Branch
  

  image.png

• 點(diǎn)擊本次迭代需要Review分支(如Review的基礎(chǔ)分支不是Master,需要自己點(diǎn)擊Change default branch來(lái)替換，已便能正常識(shí)別修改內(nèi)容)
  

  image.png

• 點(diǎn)擊Create Branch Review即可
  

  image.png

• 這時(shí)候便可以在右側(cè)面板上看到本次修改文件的變化，然后自行把Reviewer以及Watcher拉進(jìn)Review中即可

image.png

開(kāi)始Review

• 對(duì)有疑問(wèn)的代碼位置，可以點(diǎn)擊左側(cè)的紅筆,填寫(xiě)你的意見(jiàn)或者疑問(wèn)并@者或者團(tuán)隊(duì)其他成員
  

  提出疑問(wèn)

• 當(dāng)團(tuán)隊(duì)成員作出合理解釋或者修改后，可以點(diǎn)擊Resolve來(lái)標(biāo)明這個(gè)疑問(wèn)已經(jīng)作出回答
  

  解決疑問(wèn)

完成Review

當(dāng)reviewer對(duì)該次review已經(jīng)沒(méi)有疑問(wèn)了，可以通過(guò) Accept或者raise concern來(lái)告知review發(fā)起人，你對(duì)這次review的結(jié)果，review發(fā)起人，也可以通過(guò)看Reviewer頭像的方式，快速了解到Reviewer對(duì)該次review的觀點(diǎn)

完成review

查看review觀點(diǎn)

關(guān)閉Review

• 當(dāng)?shù)磳⑸暇€，所有的文件以及提出疑問(wèn)都得到了Review或者解答,那么，我們需要將這次Review關(guān)閉,點(diǎn)擊Close review即可 【該操作一般為review發(fā)起人發(fā)起，如果該修改已上線，請(qǐng)記得關(guān)閉，以免對(duì)reviewer造成影響】
  
  結(jié)束review

其他

如果說(shuō)，普通的Branch Review可能并不能很好的滿足本次迭代的需求，我們也可以將某次提交，綁定到已經(jīng)創(chuàng)建好的Review。

• 點(diǎn)擊想要Review的提交，進(jìn)入頁(yè)面后右上角點(diǎn)擊Review change后點(diǎn)擊Attach to review，隨后選中已經(jīng)創(chuàng)建好的Review,這樣，就可以將某一些提交附著于你創(chuàng)建好的Review上了

image.png

總結(jié)

Upsource是一個(gè)比較偏向社交化的CR工具，可以充分利用開(kāi)發(fā)的碎片時(shí)間進(jìn)行，如果您的團(tuán)隊(duì)既想保證CR覆蓋率，又不希望阻塞項(xiàng)目，那么可以考慮使用該工具來(lái)完成CR。

如果該文能夠幫您解決問(wèn)題，歡迎點(diǎn)贊,您的贊是我更新的最大動(dòng)力，謝謝