缺省情况下,Rational CM API JAR 文件和其他必需的 JAR 文件都安装在以下位置中, 其中变量 RATIONAL_INSTALL 表示 Rational 产品文件的安装目录。
%RATIONAL_INSTALL%\Common\stpwvcm.jar
%RATIONAL_INSTALL%\Common\stpcmn.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 实例中或创建一个新的扩展安装点。这会为 ClearQuest CM API 创建一个新目录,例如,C:\eclipse\plug-ins\com.ibm.rational.stp.cmapi。 这个新插件包含 Rational CM API JAR 文件和 ClearQuest JAR 文件。 创建好插件目录后,必须将各个已安装的 JAR 文件从其安装位置复制到该新插件目录中。 每个子提供程序 JAR 文件都需要 ClearQuest CM API JAR 文件。下次启动 Eclipse 时,该插件就已可供使用。请注意,如果要安装较新的产品版本或补丁,那么必须验证插件中的 JAR 文件是否与已安装的 JAR 文件匹配并使用较新的 JAR 文件。
要通过插件使用 ClearQuest CM API,必须将 com.ibm.rational.stp.cmapi 标识为依赖关系。请访问 http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm,以获取有关创建插件的信息。
您也可以将 ClearQuest CM API 插件作为项目导入到 Eclipse 中。
必须具有 Rational 产品的许可和已安装版本才能使用该产品的 Rational CM API 子提供程序。如果安装了子提供程序 JAR 文件,但未安装相应的产品,那么对该 Java 包的调用将失败。
为了让客户机应用程序对 Rational ClearQuest 子提供程序发出请求,必须将 Rational ClearQuest 产品与调用 Rational ClearQuest CM API 的客户机程序安装在同一台计算机上。