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

設定及安裝 CM API

在使用 CM API 之前,您必須新增檔案至類別路徑,並已安裝Rational® 產品的授權版本。
CM API 是對Rational 產品執行作業的一般元件。 若要對 Rational 產品使用這個 API,您必須將該產品安裝在系統上。 您還必須把在安裝 Rational 產品時已安裝在系統上的 CM API 檔案複製到類別路徑。
使用 Rational ClearQuest® 資源時所需的 CM API 檔案包括:所有 CM API 資源類型的必要檔案及 Rational ClearQuest 資源的必要檔案。 這些 Java™ 套件是使用 Rational CM API 執行 Rational ClearQuest 作業所需要的。
  • javax.wvcm:工作區版本化及配置管理套件 (WVCM)。
  • com.ibm.rational.wvcm.stp:Rational 軟體小組套件是 WVCM 套件的延伸規格。 此套件包含Rational CM API 的介面,並為 Rational 產品資源提供一般物件模型。 此套件與產品專用儲存庫或實作界限無關。
  • com.ibm.rational.wvcm.stp.cq:產品專用延伸規格,提供Rational ClearQuest 資料庫的存取權。此套件包含的功能,對 ClearQuest 資料庫及其基礎資源的功能提供更完整的(產品專用)存取權。

雖然您可以將此文件中的程式碼剪下及貼到可編譯的Java 中,但它沒有編譯過,有可能因為包含印刷錯誤而無法編譯。這些範例的完整可編譯版本,可在補充保存檔中的 samples Eclipse 專案中找到,該保存檔是隨Rational CM API 的文件而分送的。

依預設,Rational CM API JAR 檔和其他必要的 JAR 檔會安裝在下列位置。 install-dir 代表已安裝 Rational 產品檔案的目錄。 依預設,這個目錄在 UNIX®系統和 Linux® 上會是 /opt/rational,在 Windows® 系統上則是 C:\Program Files\IBM Rational
  • 在 Windows 系統上:
    • <install-dir>/Common/stpwvcm.jar:Rational CM API 介面 JAR 檔。
    • <install-dir>/Common/stpcmmn.jar:一般實作 JAR 檔。
    • <install-dir>/ClearQuest/stpcq.jar: ClearQuest 產品的延伸規格。
    • <install-dir>/ClearQuest/cqjni.jar:Rational ClearQuest JAR 檔。
  • 在 UNIX 及 Linux 系統上:
    • <install-dir>/common/stpwvcm.jar
    • <install-dir>/common/stpcmmn.jar
    • <install-dir>/clearquest/cqweb/lib/stpcq.jar
    • <install-dir>/clearquest/cqweb/lib/cqjni.jar

若要使用 Rational CM API JAR 檔,您必須將所有其位置新增至類別路徑中。

若要從 Eclipse 外掛程式存取Rational CM API,您可以將 com.ibm.rational.stp.teamapi.zip 檔案及專案範例匯入 Eclipse 中,或遵循下列步驟:

  1. 使用 com.ibm.rational.stp.teamapi.zip 檔案包裝的檔案來建立 Eclipse 外掛程式。
  2. 若要將Rational CM API 外掛程式新增至執行時期配置中,請將外掛程式複製到 Eclipse 實例中,或建立新的延伸規格安裝站台。 這樣會為Rational CM API 建立一個新目錄(例如,C:\eclipse\plugins\com.ibm.rational.stp.teamapi)。 這個新外掛程式是一個簡易自行包含的 Eclipse 外掛程式,由 Rational CM API JAR 檔及產品專用 JAR 檔組成。請注意,.zip 檔不包含實際產品 JAR 檔。
  3. 建立外掛程式目錄之後,每一個已安裝的 JAR 檔必須從它已安裝的位置複製到新的外掛程式目錄。 每一個 JAR 檔都需要Rational CM API JAR 檔。 下次您啟動 Eclipse 時,此外掛程式即可供使用。
  4. 若要從外掛程式使用 Rational CM API,請確認 com.ibm.rational.stp.teamapi 的相依關係。
現在您準備好使用 Rational CM API 撰寫 Java 程式。
您必須有已安裝的 Rational ClearQuest 授權版本,才能對 ClearQuest 資源使用 Rational CM API。如果您安裝及配置 JAR 檔,但沒有安裝對應的產品,則對該Java 套件的呼叫會失敗。

課程檢查點

既然您已設定系統來使用 CM API 進行程式設計,您就可以開始學習 CM API 物件模型及程式設計模型。
在這一課,您學到下列各項:
  • CM API 與Rational ClearQuest 之間的關係
  • 如何設定系統使用 CM API 進行程式設計
  • 您系統需要 CM API 中的哪些檔案

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