Upsource 一個新的代碼審查工具-安裝使用指南

Upsource 一個新的代碼審查工具(Polyglot code review tool)，Upsource安裝、配置及使用介紹……

<!--more-->

寫在前面的話

最近因項目組須要，在尋找一款比較好用的代碼審查工具，由於是Intellj IDEA深度粉絲，因此優先找的仍是能支持Intellij IDEA的工具，正好在JetBrains官網上看到這款Upsource工具，因而打算花了一週時間研究下，因而各類baidu，Google找資料，發現這款工具的中文介紹少之又少，全部就有了這篇文章，此文僅供須要的同仁，若有問題歡迎指正。

• 另外在網上也找到17款最佳的代碼審查工具，供你們參考。

安裝與配置

下載解壓

下載合適版本的Upsource安裝程序點擊下載，我用的版本爲Upsource-3.5.3550，將其解壓到任意磁盤，進入Upsource根目錄(下面統稱upsource_home)，準備進行安裝，

Win下啓動安裝配置

• Upsource對比較耗內存，建議機器內存在4G以上
• 在Windows環境，爲了不碰到各類奇奇怪怪的問題，最好關閉全部殺毒軟件
  啓動安裝過程很是簡單，

1. 運行Upsource做爲後臺進程進行安裝 以管理員身份運行打開cmd，切換到<upsource_home>目錄，執行命令

upsource_home\bin\upsource.bat start

如圖： 2. 運行Upsource做爲Windows Service

upsource_home\bin\upsource.bat service install /runAsSystem

啓動完成後會打開默認瀏覽器網址http://機器名:80/welcome 頁面，注意在3.5版本中windows默認端口爲80，在之前的版本端口默認是8080。這是你會看到以下頁面： 點擊Set up進行安裝，這時咱們能夠修改訪問域名和端口 點擊Next進入用戶管理，設置管理員用戶名密碼 點擊Next，這裏會提示免費版支持10個免費用戶，若是你有License Key的話，在這裏能夠輸入。 點擊Finish，靜候安裝 啓動完成後，會默認打開歡迎頁面，到這步安裝大功告成。

建立/管理項目

使用admin帳戶登陸，點擊Create Project建立項目 點擊Create project完成項目建立，接下來就等待代碼clone完成。

設置用戶/組/角色權限

代碼下載完成以後，就開始設置用戶權限 點擊Users進行用戶/組/角色權限設置，Upsource安裝完成以後默認添加了admin和guest用戶。 設置用戶時能夠指定用戶組，每一個項目有三個用戶組，分別爲Code Viewers、Developers、Project Admin。同一個用戶能夠擁有多個用戶組。 角色權限能夠設置全局角色和對應某個項目的角色，總共有五種，分別是：Code Viewer、Developer、Observer、Project Admin、System Admin，每一個角色所擁有的權限均可以根據本身需求靈活進行配置 這裏咱們爲cms項目添加兩個用戶：Lucy爲Project Admin角色，tom爲Developer角色

代碼審查（Code Review）

Upsource能爲代碼審查提供哪些便利

• 對多種類型的代碼庫與軟件開發語言進行代碼瀏覽
• 對同一個代碼庫的多個修訂版本進行瀏覽，而且經過一個圖形化工具顯示多個修訂版本之間的關係
• 對代碼變動進行跟蹤，包括提交歷史、變動差別比較，以及分支與合併的操做
• 對團隊的代碼進行審查，包括代碼的討論、跟蹤代碼評論以及最終的結論

如何進行代碼審查

當開發者tom提交完代碼以後，項目管理員Lucy登陸到Upsource，能夠看到全部項目的索引，每一個項目都有對應一個特定的VCS倉庫。

單擊項目名稱列出每一次提交的版本，每一次提交的代碼羅列，這裏你能夠瀏覽代碼，建立代碼審覈，分支列表，分支與分支代碼比較，代碼提交代碼審覈分析（可視化圖表）……等等你想要的功能。 拖動滾動條，將光標移動到須要進行審覈的修訂版本上，點擊Create review建立一次新的代碼審查

代碼對比

點擊左邊修訂版中提交的文件名顯示嵌入差別： 點擊Side-by-side diff能夠查看整個文件在提交先後的變化

關於代碼評論

不管你是做爲一個author、reviewer或watcher，你均可以發表評論，發表的評論全部參與的人均可以看得見 有三種類型的評論：

• 審查意見：這種類型的評論是否是捆綁到任何代碼特定文件或部分。
• 行級評論：這種類型的註釋與特定的代碼行相關聯。
• 代碼塊評論：這種類型的評論是爲了找出一個特定的代碼片斷中的一個文件進行審查。

行級評論

代碼塊評論

參與評論

Lucy進行評論後，開發者tom會收到郵件通知，登陸tom帳戶，能夠清晰的看到Lucy的評論的代碼，能夠進行回覆。 當點擊Accept時，表示接受這次修訂，這次審查被視爲完成。

Upsource分析功能

Upsource提供了例如代碼提交分析、代碼審查分析等功能。

其餘

JetBrains提供的Upsource受權計劃是根據用戶的數量所決定的，不超過10人（去掉admin、guest其實就只有8個用戶）的團隊能夠無償使用。一樣，教育機構及非盈利的開源項目也能夠無償使用。

版本

• 版本1.0 2016年11月
• 來源 FuYung：http://dreamfy.cn/