安装和设置需求

每个独立的产品安装都包括公共组件和产品的 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 的当前版本不支持动态或快照视图。必须将相应的 JAR 文件从 CM 服务器复制到客户机,根据使用 Rational CM API 的方式,可以复制到客户机安装位置或插件目录。


反馈