构建样本 API 应用程序

Rational® Publishing Engine 附带一个样本应用程序,该应用程序演示如何使用 API 在本地或远程执行预先配置的文档规范。

关于此任务

可在 %RPE_HOME%/lib/api/example 中找到该应用程序。如果未对 -home 选项提供值,那么会在构建时使用项目的主文件夹。部署应用程序时,必须主文件夹置于 .jar 文件所在的文件夹中,应用程序才能找到主文件夹。

过程

  1. 打开 %RPE_HOME%/lib/api/example
  2. 解压缩 com.ibm.rational.rpe.examples.zip 归档。
  3. 为您提供对 Rational Publishing Engine 库中必需的 .dll.so 文件的应用程序访问权。
    要点: 在示例归档的根目录中提供的 .dll.so 可能不适用于您的环境。
    • 32 位应用程序:
      1. %RPE_HOME%/lib/rcl_telelogic.dll
      2. %RPE_HOME%/lib/librcl_telelogic.so
    • 64 位应用程序:
      1. %RPE_HOME%/lib/64/rcl_telelogic.dll
      2. %RPE_HOME%/lib/64/librcl_telelogic.so

    要提供对这些文件的应用程序访问权,您可以:

    • 将文件路径添加至应用程序启动脚本。此操作确保无论您的应用程序在哪儿运行都是独立的。
    • 将文件路径添加至 PATH 系统变量。 如果您选择此选项,那么您必须在使用该应用程序的每台计算机上都要完成此步骤。
  4. 复制 Rational Publishing Engine 安装文件内的 lib 目录中的插件。
    • 要构建 32 位应用程序,请复制 %RPE_HOME%/lib 目录中的插件。
    • 要构建 64 位应用程序,请复制 %RPE_HOME%/lib/64 目录中的插件。
  5. 在已解压示例归档的 lib 目录中粘贴插件。不要复制 .dll.so 文件。 示例:project/lib
  6. 打开 %RPE_HOME%/config 目录。
  7. 复制 rpeconfig.xmlRPEElementsDefinitions.xml 文件。
  8. rpeconfig.xmlRPEElementsDefinitions.xml 文件粘贴到示例的 home/config 文件夹中。 该示例设计为在 src 文件夹的根目录中使用 log4j.properties 文件,并且不能在 home/config 文件夹中使用该文件,即使提供了此文件也是如此。
  9. 可选: 要通过 Rational DOORS® 生成文档,请复制 %RPE_HOME%/source/DOORS%RPE_HOME%/source/DB Structure 文件夹
  10. 可选: 在项目的 home/source 文件夹中粘贴 DOORSDB Structure 文件夹。
  11. 复制 %RPE_HOME%/utils/Word%RPE_HOME%/utils/HTML 文件夹。
  12. WordHTML 文件夹粘贴到项目的 home/utils 中。
  13. 使用项目中的插件路径来更新类路径。

反馈