< 上一個課程 | 下一個課程 >

第 6 課:來源控制

來源控制元件用來處理您專案中原始碼和其他構件的儲存、擷取和共用。Rational Team Concert™ 來源控制 (SCM) 支援很容易便能用在各種不同的開發實務上,只是它和一般以 SCM 系統為基礎的檔案仍有些許的差異。因此,一開始,我們將提供使用模型的快速概觀。
Rational Team Concert 中,不論您是否已準備好讓您的團隊共用您的變更,我們都希望使用者能藉由 SCM 的功能來追蹤這些變更並將其版本化。作為使用者的您擁有自己的專用儲存庫工作區,其中儲存您所做的變更(不論您何時決定要提供它們給團隊使用)。有時,只過了數小時,您便決定要讓這些變更共用;有時需要一天或者更久。關鍵在於您的變更是放在儲存庫中,而您將決定何時要提供它們給團隊使用。當您載入儲存庫工作區時,其中的檔案與資料夾會傳送至您電腦上的 Eclipse 工作區。如果要將變更從 Eclipse 工作區推送至儲存庫工作區,您需要移入變更。

串流用來儲存團隊的工作。當您想提供所做的變更給團隊時,您可從儲存庫工作區將它們交付串流。當您想納入其他團隊成員的變更時,您將從串流來接受這些變更。請注意,您也可以直接從另一個儲存庫工作區來接受變更,讓團隊成員之間能夠精細地共用變更。舉例來說,兩個團隊成員協同完成小錯誤的修正;或者,某人在開始某項變更後因必須休假,而交由另一個團隊成員繼續該項工作,並在之後交付。

「來源控制」工作流程

您在儲存庫工作區中所做的所有變更,都會放到變更集中進行追蹤。每一個變更集各集合了一些對一或多個檔案或資料夾所做的明確初始變更。變更集也可以附帶註解和變更原因,其做法通常是參照相關的工作項目。原始檔庫是從無到穩定增加變更集建置而成的,且每一個都是以其前一個作為建置基礎。每一個儲存庫工作區或串流是以一連串的變更集為基礎。

讓我們開始進行變更,並學習如何將這些概念運用在每日的工作中。

建立儲存庫工作區

首要步驟是尋找您團隊區域的串流。串流是您提供程式碼供團隊共用之處。
  1. 團隊構件視圖中,展開 Prelude 專案區域, 再展開來源控制,然後展開團隊 1 串流,以檢視元件。 如果來源控制下未出現任何項目,請查看畫面上顯示的「自訂我的過濾器」下拉清單。 開啟下拉清單,並確定已選取所有團隊區域
    註: 當您成為多個團隊的成員時,您會發現自訂的過濾器非常好用。

    串流和儲存庫工作區可分割成個別的元件。由於每一個元件都有自己的歷程,將產品切割成數個元件,對於要建置分層軟體(其中各段採半獨立發展並個別部署)的團體來說頗有助益。簡式儲存庫工作區和串流由單一元件組成。 以本例來說,「團隊 1 串流」只有一個元件(稱為「預設元件」), 其中將包含我們的檔案與資料夾。

    「團隊 1 串流」的預設元件串流

  2. 為標籤名稱為團隊 1 串流(團隊 1)的團隊區域,選取串流。
  3. 按一下滑鼠右鍵,然後按一下新建 > 儲存庫工作區
  4. 新建儲存庫工作區精靈中,在新建儲存庫工作區頁面的儲存庫工作區名稱欄位中,輸入 Prelude 中的 Chris,然後按一下完成 這個動作會建立新的儲存庫工作區,並將新的儲存庫工作區載入至您的 Eclipse 工作區中。 應能迅速載入完成,因為串流尚無任何程式碼。
  5. 載入的儲存庫工作區會出現在「擱置的變更」視圖中。 如果沒有看見「擱置的變更」視圖,請按一下視窗 > 顯示視圖 > 擱置的變更
  6. 選擇性的: 如果您能夠完成團隊邀請指導教學,表示您已完成您在起始設定專案區域時所建立的其中一項工作項目。再次執行已開啟的工作項目查詢,並記下 [加入團隊] 建立儲存庫工作區工作項目。現在,您可以開啟並解決該工作項目,就如同您稍早解決定義團隊成員工作項目一樣。
載入的儲存庫工作區頗為特殊, 因為只要您在 Eclipse 工作區中變更載入的檔案或資料夾, 就會追蹤這些變更,並顯示在擱置的變更視圖中。在這裡,您可以管理變更, 並執行諸如以下的一般作業:
  • 將變更移入至儲存庫工作區。
  • 將變更組織成變更集。
  • 復原您原先所做的變更。
  • 讓變更集和工作項目產生關聯。

在後續的區段中,您還會看到「擱置的變更」視圖的進一步說明,因為實際上它已是開發人員每日的工作中心。

編寫程式碼

當您加入串流之後,您就可以撰寫程式碼並產生構成專案的構件。
如果您想使用 Rational Team Concert 來嘗試執行小型專案中的某些 Java™ 套件,現在可將這些專案從套件瀏覽器視圖匯入至 Eclipse 工作區 (選取快速功能表中的匯入選項)。不過,如果找不到您屬意的程式碼來著手進行,可建立一個簡式 Java 應用程式,或建立一個內含單一文字檔的簡式專案。
  1. 如需在 Jazz 用戶端中建立簡式 Java 應用程式的相關說明,請按一下說明 > 提要
  2. 選擇提要對話框中,展開 Java 開發種類,然後按一下建立 Hello World 應用程式。按一下確定 提要會出現在您的 Jazz 用戶端視窗中,並引導您建立簡式 Java 應用程式。如需進階說明,請參閱 Eclipse Java Development User Guide
    註: 本指導教學的作者已建立一個名為 Hello Prelude 的簡式 Java 專案。

將程式碼放在 Jazz Source Control 下

當您在 Eclipse 工作區中匯入或手動編寫一些程式碼之後,您可以將程式碼移入至伺服器上的儲存庫工作區,並與團隊共用您的專案。
移入是一種將程式碼從 Eclipse 工作區移動至儲存庫工作區的程序。而如果是將程式碼從儲存庫工作區移動至串流,以供您的團隊共用,其術語就是交付。您可以變更 Jazz Source Control 喜好設定來指定自動移入。 您也可以在斷線模式下工作,等到後來重新連線時再移入。

如果要將專案移入至 Jazz Source Control,請執行下列動作:

  1. 開啟 Java 視景。如果這不是現行視景,請按一下視窗 > 開啟視景 > Java
  2. 套件瀏覽器視圖,選取 Hello Prelude 專案。
  3. 按一下滑鼠右鍵,然後按一下團隊 > 共用專案
  4. 共用專案精靈的共用專案頁面上,選取 Jazz Source Control,然後按下一步
  5. 選取元件頁面上,確定已從頁面頂端的下拉清單中選取 chris@localhost 儲存庫連線。 此外,請確定已選取選取現有儲存庫工作區中的元件。展開 Prelude 中的 Chris,並選取預設元件。 按下一步
  6. 雖然您有可能不需進行任何變更,請在檢閱忽略的資源頁面上,驗證或完成共用時要忽略的資源。按一下完成 現在,您的程式碼已移入至儲存庫工作區,但尚未交付至串流。
  7. 選擇性的: 切換至擱置的變更視圖。 從 Java 視景中,按一下視窗 > 顯示視圖 > 擱置的變更 當您載入和共用專案時,應該已開啟此視圖。如果您展開預設元件,您會看到剛才所共用的專案變更集。我們已追蹤共用作業,且對應的變更已自動移入至儲存庫工作區。
  8. 選擇性的: 變更集已有相關的註解:共用專案。 如果要變更註解,或將註解新增至以後不會自動取得註解的變更集,請用滑鼠右鍵按一下變更集,然後按一下編輯註解。 在編輯窗格中,輸入註解,然後按一下 Enter 鍵。
  9. 選擇性的: 如果要導覽元件目錄結構,請在擱置的變更視圖中,用滑鼠右鍵按一下預設元件,然後按一下顯示 > 儲存庫檔案。 在儲存庫檔案視圖中,您會看到您剛才共用的專案。
  10. 選擇性的: 如果要檢查儲存庫工作區的歷程,請在擱置的變更視圖中,用滑鼠右鍵按一下預設元件,然後按一下顯示 > 歷程歷程視圖會同時列出自建立元件以來的起始變更集,以及您剛建立的第二個變更集。 如果要探索變更集的內容,請按兩下變更集。 這時會開啟變更瀏覽器視圖,可讓您瀏覽變更集裡的檔案。

將變更交付給團隊

在這個區段中,您會看到代表您所編寫之程式碼的變更集。接著,您將讓變更集和現有的工作項目產生關聯。最後,您將交付程式碼至串流。
您所做的一切變更都會儲存在儲存庫的儲存庫工作區中。

如果要交付變更,供團隊的其餘成員使用,請執行下列動作:

  1. 擱置的變更視圖中,用滑鼠右鍵按一下變更集,然後按一下建立工作項目關聯
  2. 在「選取工作項目」對話框中,清除只有我的指派勾選框。
  3. 包含的 ID 或文字欄位中,輸入共用 將會顯示在摘要中含有共用兩字的工作項目。
  4. 選取標籤名稱為讓 Jazz Source Control 共用程式碼的工作項目,並按一下確定 這個動作會在您編寫的程式碼和您要付諸執行的工作項目之間建立連線。
  5. 如果要交付並解決工作項目,請在擱置的變更視圖中完成下列步驟:
    1. 用滑鼠右鍵按一下變更集,然後按一下交付並解決工作項目
    2. 交付和解決對話框中,請確定已選取解決工作項目勾選框。
    3. 在工作項目中加入註解窗格中,輸入要新增至工作項目的註解。
    4. 按一下完成
    工作項目已解決,且您的程式碼現在已從伺服器上的儲存庫工作區交付至團隊區域的串流,立即可供團隊的其餘成員存取。
  6. 選擇性的: 重新整理歷程視圖。這個視圖指出變更集已和工作項目產生關聯。
  7. 選擇性的: 團隊構件視圖的團隊 1 串流中, 用滑鼠右鍵按一下預設元件,然後按一下顯示 > 歷程歷程視圖會顯示您在串流中的變更集。
  8. 選擇性的: 歷程視圖中,如果要開啟變更集的相關工作項目,請用滑鼠右鍵按一下變更集,然後按一下開啟工作項目 工作項目已解決,且包含您為這項工作所建立的變更集的鏈結。

課程檢查點

在本課程中,您已學習 Jazz 來源控制的基本觀念。
< 上一個課程 | 下一個課程 >

意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤