无论是否已具有所有这些子提供程序,Rational CM API 基础结构都能正常运行。提供程序接口允许子提供程序 JAR 文件处于不同的发行版级别。
Rational CM API 组件具有多重部件版本号。安装一个子提供程序将覆盖由子提供程序的先前版本安装的基础结构组件,但是仅当基础结构组件的版本比已安装的版本更新的时候才会出现此情况。
缺省情况下,Rational CM API JAR 文件以及其他必需的 JAR 文件都安装在以下位置中,其中变量 RATIONAL_INSTALL 表示 Rational 产品文件的安装目录。
%RATIONAL_INSTALL%\Common\stpwvcm.jar
%RATIONAL_INSTALL%\clearcase\web\cmapi\stpcc.jar
%RATIONAL_INSTALL%\ClearQuest\stpcq.jar
还需要以下文件:%RATIONAL_INSTALL%\ClearQuest\cqjni.jar
要使用 Rational CM API JAR 文件,必须将其所有的位置都添加到类路径。
您可以通过使用上一部分中列出的文件和位于归档文件 %RATIONAL_INSTALL%\common\cm\teamapi.zip 中的 \plugins\com.ibm.rational.stp.cmapi 目录下的文件来创建 Eclipse 插件。
要将 Rational CM API 插件添加到运行时配置中, 请将这些文件复制到 Eclipse 实例中或创建一个新的扩展安装点。这样会为 Rational CM API 创建一个新目录,例如:C:\eclipse\plug-ins\com.ibm.rational.stp.cmapi。 该新插件包含 Rational CM API JAR 文件和特定于产品(ClearCase 和 ClearQuest)的 JAR 文件。创建好插件目录后,必须将各个已安装的 JAR 文件从其安装位置复制到该新插件目录中。 每个子提供程序 JAR 文件都需要 Rational CM API JAR 文件。下次启动 Eclipse 时,该插件就已可供使用。请注意,如果要安装较新的产品版本或补丁,那么必须验证插件中的 JAR 文件是否与已安装的 JAR 文件匹配并使用较新的 JAR 文件。
要通过插件使用 Rational CM API,必须将 com.ibm.rational.stp.cmapi 标识为依赖关系。请访问 http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm,以获取有关创建插件的信息。
您也可以将 CM API 插件作为项目导入到 Eclipse 中。
必须具有 Rational 产品的许可和已安装版本才能使用该产品的 Rational CM API 子提供程序。如果安装了子提供程序 JAR 文件,但未安装相应的产品,那么对该 Java™ 包的调用将失败。
为了能让客户机应用程序对 Rational ClearQuest 子提供程序发出请求,必须将 Rational ClearQuest 产品与调用 Rational CM API 的客户机程序安装在同一台计算机上。
ClearCase 子提供程序支持 Web 视图以及通过变更管理服务器 (CM Server) 进行的远程访问。Rational CM API 的当前版本不支持动态或快照视图。必须将相应的 JAR 文件从 CM 服务器复制到客户机计算机的客户机安装位置或 plug-in 目录中,具体位置取决于使用 Rational CM API 的方式。