Linux® 和 Windows 的代码复审应用程序命令的参数

代码复审应用程序命令需要参数来指定工作空间、要处理的项目或目录、规则文件和输出文件。

代码复审应用程序的应用程序参数显示在 表 1中。

表 1. 代码复审应用程序参数
参数 类型 描述
-application 必需 com.ibm.rsaz.analysis.commandline.AnalyzeApplication

使用此参数指定代码复审应用程序的 Eclipse 应用程序标识符。 完全按如下所示指定标识: com.ibm.rsaz.analysis.commandline.AnalyzeApplication。
-data 必需 此参数指定代码复审应用程序使用的 Eclipse 工作空间的路径。 它必须是标准路径。 如果指定的工作空间不存在，那么会创建该工作空间。

如果还使用 -projects 参数，那么代码复审应用程序会在此工作空间中搜索所指定项目。

如果未指定 -projects 参数或 -directory 参数，那么代码复审应用程序会分析所指定工作空间中的所有项目。
-rulefile 必需 此参数指定一个规则文件的标准路径，该规则文件包含一组代码复审规则及其指定严重性。 代码复审应用程序对您启动该应用程序时指定的项目或文件应用这些规则。

对于 COBOL，这些规则包括定制类别和规则及用户编写规则。

Rules for COBOL， PL/I ， 和 Java™ 可以包含在同一规则文件中。 在处理期间，代码复审应用程序确定它发现的每个源代码文件的编程语言。 然后，它对该文件应用适用于该语言的规则。

规则文件的扩展名必须为 .dat。 它必须在安装所启动 eclipse.exe 文件的工作站和文件系统中。 不能通过网络、内部网或互联网对其进行访问。

通过单击 导出 以从 软件分析配置窗口导出所选规则来创建规则文件。
-projects
-directory
 可选 每个这样的参数都指定要分析的源代码文件的位置。 您还可以使用参数 -includefile 和 -excludefile 来包含或排除特定文件。

当源代码文件位于 您在 -data 参数中指定的工作空间内的项目中时，请使用 -projects 。

当源代码文件位于 您在 -data 参数中指定的工作空间外部的目录中时，请使用 -directory 。

如果同时省略 -projects 和 -directory，那么代码复审应用程序会分析所指定工作空间中的所有项目内的源代码文件。

如果 -projects P1[， P2， P3 ...] 指定，应用程序将处理项目 P1， P2， P3.....的逗号分隔列表中的所有源代码文件。

如果 -directory D1[， D2， D3， ...] 指定，应用程序将处理 目录 D1， D2， D3和 ....的逗号分隔列表中的所有源代码文件。

如果同时指定了 -projects 和 -directory ，那么应用程序将处理 -projects 参数并忽略 -directory 参数。

使用 -directory 参数创建的临时项目：以下信息适用于位于 -data 参数中指定的工作空间外部的目录。

使用 -directory 参数有两个影响：
  • 对于 -directory 参数中指定的每个目录，系统会创建具有相同名称并带有 genericProject_ 或 analyzedAsJava_ 之类的前缀的临时项目。 这些临时项目是在 -data 参数中指定的工作空间中创建的。 例如，如果在 -directory 参数中指定了目录 c:\SourceFiles\CobolDirectory_0001 ，那么将在工作空间中创建临时项目，例如 genericProject_CobolDirectory_0001 。 每个临时项目都是一个 Eclipse 的带链接资源，它链接至本地文件系统中的对应原始目录。
    可从工作空间中删除这些临时项目。
    重要信息: 遵循删除资源链接的过程，以便不删除文件系统中相应目录的内容。 有关删除临时项目的更多信息，请参阅 删除由 -directory 参数创建的临时项目。
  • CSV 分析结果文件、XML 分析结果文件和 JUnit XML 分析结果文件中的目录路径包括这些临时项目的名称。
    注: 在将结果文件用作其他应用程序的输入之前，您可能需要修改这些路径。
警告:
不要使用 -directory 选项来指定位于您在 -data 参数中指定的工作空间内的目录。 这样做会在工作空间中创建临时项目，这些项目是 Eclipse 的带链接资源（它们链接至指定的目录）。 以错误方式删除临时项目可能导致删除原始项目、文件夹或源代码文件。 有关删除临时目录的信息，请参阅 删除由 -directory 参数创建的临时项目。
-includefile 可选 仅当存在 -directory 参数时，才应使用此参数。 它指定一个文本文件的标准路径，该文本文件包含要分析的源代码文件列表（每行一个文件）。

-directory 参数和 -includefile 参数同时存在时，代码复审应用程序仅分析包含文件中指定的源代码文件和 -directory 参数中指定的某个目录中出现的源代码文件。

包含文件中的每个条目必须是文件名或相对路径加文件名。 代码复审应用程序会搜索每个指定目录中的每个条目。
-excludefile 可选 仅当存在 -directory 参数时，才应使用此参数。 它指定一个文本文件的标准路径，该文本文件包含分析时要排除的源代码文件列表（每行一个文件）。

-directory 参数和 -excludefile 参数同时存在时，代码复审应用程序在分析时会排除该排除文件中指定的源代码文件和 -directory 参数中指定的某个目录中出现的源代码文件。 未排除的所有文件会得到分析。

排除文件中的每个条目必须是文件名或相对路径加文件名。 代码复审应用程序会搜索每个指定目录中的每个条目并排除它发现的文件。
-exportdirectory 必需 此参数指定代码复审应用程序将其输出数据文件写至的目录的标准路径。 这些数据文件可用作其他应用程序的输入。

将生成所有受支持类型的输出数据文件。

如果省略此参数，那么不会生成任何输出数据文件。 但是，该应用程序仍会将输出信息写至标准输出（如果指定了该选项）。
-nosplash 可选 此参数阻止显示 Eclipse 启动屏幕。
-verbose 可选 此参数导致代码复审应用程序将输出信息写至标准输出。
在 Windows 操作系统上，要捕获输出信息，您不仅必须指定 -verbose 参数，还必须将标准输出重定向到命令行上的文件:
-verbose >output_file
>output_file 可选 在命令行上使用此重定向捕获文件中的应用程序输出信息。

在 Windows 上，还必须指定 -verbose 参数以获取输出信息。