无论所有子提供程序是否都存在,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 文件。
常见实现 JAR 文件。
ClearQuest 产品的扩展。 还需要 <install-dir>\ClearQuest\cqjni.jar
要使用 Rational CM API JAR 文件,必须将其所有的位置都添加到类路径。
可以使用在 <install-dir>\common\com.ibm.rational.stp.cmapi.zip 文件中打包的文件和其他已安装文件(在上一部分中列出)创建 Eclipse 插件,从而支持从 Eclipse 运行时环境中的其他插件访问 Rational CM API。此 zip 文件包括代码样本,其中含有 CM API 教程描述的示例。
要将 Rational CM API 插件添加到运行时配置,您可以将该插件复制到 Eclipse 实例或创建新的扩展安装站点。这样会创建 Rational CM API 的新目录(例如,C:\eclipse\plug-ins\com.ibm.rational.stp.cmapi)。 该新插件是简单的独立 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.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 视图并通过 Rational ClearCase CM 服务器支持远程访问。Rational CM API 的当前版本不支持动态或快照视图。必须将相应的 JAR 文件从 CM 服务器复制到客户机机器的客户机安装位置或插件目录,具体位置取决于安装 Rational CM API 的方式。