Jupiter 使用說明

Jupiter 是什麼

Jupiter 是一個開源的、整合在Eclipse下執行程式碼審查工作的一個很棒的工具。
Jupiter工作分三個階段：

• Individual Phase 個人階段，表示個人審查階段。
• Team Phase 團隊階段，表示團隊審查階段。
• Rework Phase 修復階段，表示修改Bug 階段。

安裝Jupiter

• 線上安裝 http://jupiter-eclipse-plugin.googlecode.com/svn/trunk/site/
• 離線安裝: http://code.google.com/p/jupiter-eclipse-plugin/downloads/list
  把下載到的jar檔案拷貝到eclipse的plugins目錄下，重啟eclipse即可。
  如果出現如下圖示，則表示安裝成功:
  
  

  image.png

建立Review ID

1. 什麼是Review ID
   Review ID 程式碼一個審查任務，包涵了很多元素，比如審查任務名稱、描述，審查那些程式碼檔案，審查人，審查型別，級別設定等等。
2. 建立Review ID流程

• 在eclipse中選擇要審查的專案，右鍵選擇"屬性"選項，進入Review，如下圖：

  
  
  

  image.png

• 右擊右邊的"New" 按鈕出現填寫框，可以填寫ReviewID的名稱，描述。如下圖：

  
  
  

  image.png

• 點選"Next>" 按鈕進入下一步，選擇對哪些程式碼檔案進行審查，如下圖：

  
  
  

  image.png

• 點選"Next>" 按鈕進入下一步，選擇或者新輸入審查人員，如下圖：

  
  
  

  image.png

• 點選"Next>"按鈕進入下一步，指定Session的作者，但是一般選擇所審查程式的程式設計人員。

  
  
  

  image.png

• 點選"Next>"按鈕進入下一步，選擇"Type，Severity，Resolution，Status"的選項。

  
  
  

  image.png

• 點選"Next>"按鈕進入一下步，這裡確定"Type，Severity，Resolution，Status"的預設選項，如下圖：

  
  
  

  image.png

• 點選"Next>"按鈕進入下一步，輸入最後生成的審查檔案放置目錄，建議使用日期加任務標記作為目錄。

  
  
  

  image.png

• 點選"Next>"按鈕進入下一步，最後設定每個階段的過濾器，每個專案可以根據專案的需要設定，這裡預設不變。

  
  
  

  image.png

• 點選"Finish"按鈕完成ReviewID的設定，進入工程目錄檔案，可心發現目錄中多出一個.jupiter檔案，這個檔案裡面包含了上面配置所有資訊。

  
  
  

  image.png

釋出 Review ID

釋出Review ID的過程其實就是配合SVN或都CVS或者其他版本控制系統，釋出.jupiter檔案。讓其他專案組人員把該檔案拷貝到相同目錄。

獲取Review ID

過通svn等版本控制，得到.jupiter檔案

Individual Phase

Individual Phase的目標

個人階段的目標：就是針對在ReviewID定義指定的審查人員對程式碼進行評審，並把評審結果上傳到版本控制中。

Individual Phase的過程

• 點選Jupiter的eclipse圖示的下拉箭頭，出現4個選項，選擇1 Individual Phase,即可進入擇ReviewID介面。如下圖：

  
  
  

  image.png

• 選擇Review ID介面，如下圖:

  
  
  

  image.png

• 點選"Finish"按鈕，進入Individual Phase檢視，在左邊"ReviewTable"檢視中，選擇待審查的程式碼檔案。

  
  
  

  image.png

• 通過點選 + 按鈕新增評審記錄。通過 - 按鈕刪除評審記錄。

  
  
  

  image.png

• 在開啟的待評審程式碼檔案中，右鍵問題程式碼行。在右鍵選單中選擇Add Review Issue.....，在右邊Review Editor檢視中選擇"Type，Severity"，描述程式碼問題。並儲存

  
  
  

  image.png

• 這時候可以看到程式碼中，問題行將出現紫色標記，滑鼠放上去會出現問題說明。如圖:

  
  
  

  image.png

結束 Individual Phase

個人審查階段就是這樣一個一個問題的疊加，直到你完成所有程式碼檔案的審查工作，之後重新整理工程目錄，在目錄下面會增加一個子目錄，其中"-"的前一部分是ReviewID名稱，後一部分XXX是執行Individual的審查者.提交.review檔案到版本控制。

image.png

Team Phase 階段

Team Phase的目標

Team phase的目標就是把很多審查人的審查檔案集合起來，然後開個評審會議，把問題討論清楚，確認是否需要調整，或者給誰調整解決。

Team Phase過程

• 進入Team Phase