安裝與設定需求

每一套個別的產品安裝都包含一般元件及該產品的 Rational® CM API 子提供者。 例如,Rational ClearQuest® 產品安裝就包含 Rational ClearQuest CM API 子提供者。 子提供者層可確保已安裝 CM API 元件基礎架構。因此,根據已安裝產品的組合,系統可以有下列全部或部分 JAR 檔:

Rational CM API 基礎架構的設計並不會考慮所有子提供者是否存在,一概都能夠運作。提供者介面允許子提供者 JAR 檔屬於不同的版本層次。

Rational CM API 元件有其相關聯的多組件版本號碼。只有在基礎架構元件的版本比已安裝的版本還新的情況下,安裝一個子提供者會改寫由舊版的子提供者所安裝的基礎架構元件。

依預設,Rational CM API JAR 檔和其他必要的 JAR 檔會安裝在下列位置。 變數 <install-dir> 代表已安裝 Rational 產品檔的目錄。 依預設,這個目錄在 UNIX® 系統和 Linux® 上是 /opt/rational, 而在 Windows® 系統上是 C:\Program Files\IBM Rational

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

從 Eclipse 外掛程式存取 Rational CM API

您可以利用封裝在 <install-dir>\common\com.ibm.rational.stp.teamapi.zip 檔中的檔案和其他已安裝的檔案(列在上一節)來建立 Eclipse 外掛程式, 以支援在 Eclipse 執行時期環境中從其他外掛程式存取 Rational CM API。 這個 zip 檔中有程式碼範例,包括 CM API 指導教學所說明的範例。

若要將 Rational CM API 外掛程式新增至執行時期配置中,您可以將外掛程式複製到 Eclipse 實例中,或是建立新的延伸規格安裝網站。 這樣會為 Rational CM API 建立一個新目錄(例如:C:\eclipse\plug-ins\com.ibm.rational.stp.teamapi)。 這個新的外掛程式是一個簡單又獨立的 Eclipse 外掛程式, 由 Rational CM API JAR 檔加上產品專屬的(ClearCase 及 ClearQuest)JAR 檔組成。 請注意,.zip 檔也包含實際的產品 JAR 檔。在建立外掛程式目錄之後,您必須將每一個已安裝的 JAR 檔從其安裝位置複製到這個新的外掛程式目錄。每一個子提供者 JAR 檔都需要 Rational CM API JAR 檔。 下次啟動 Eclipse 時,即可使用此外掛程式。請注意,如果您安裝較新的產品版本或修補程式, 則必須確認外掛程式中的 JAR 檔符合已安裝的 JAR 檔且使用較新的 JAR 檔。

若要從外掛程式中使用 Rational CM API, 您必須確認 com.ibm.rational.stp.teamapi 有相依關係。 如需建立外掛程式的相關資訊,請造訪 http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm

您也可以將 CM API 外掛程式當作專案來匯入 Eclipse 中。

您必須有已授權且已安裝的 Rational 產品版本,才能使用該產品的 Rational CM API 子提供者。 如果您已安裝子提供者 JAR 檔,但未安裝對應的產品,則呼叫 Java™ 套件會失敗。

從 Java 用戶端應用程式存取 Rational CM API

若要讓用戶端應用程式對 Rational ClearQuest 子提供者發出要求, Rational ClearQuest 產品與呼叫 Rational CM API 的用戶端程式必須安裝在同一部機器上。

ClearCase 子提供者支援 Web 視圖,以及透過 Rational ClearCase CM 伺服器進行遠端存取。 目前的 Rational CM API 版本不支援動態或 Snapshot 視圖。 必須將適當的 JAR 檔從 CM 伺服器複製到用戶端機器的用戶端安裝位置或外掛程式目錄,視要如何使用 Rational CM API 而定。


意見