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

設定及安裝 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,請執行下列步驟:

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

課程檢查點

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

意見反應