使用 Application Discovery Assistant 创建应用程序和项目

AppScan® Source 包含功能强大的 Application Discovery Assistant，它使您能够为 Java™ 源代码和 Microsoft™ Visual Studio 解决方案快速创建并配置应用程序和项目。Application Discovery Assistant 还使您能够找到包含了 Java™ 项目的 Eclipse 工作空间。Application Discovery Assistant 使您能够指向源、解决方案或工作空间目录，然后 AppScan® Source 将处理余下的工作。

关于此任务

您可以使用 Application Discovery Assistant 来搜索包含 Java™ 源代码、Microsoft™ Visual Studio 解决方案和/或 Eclipse 工作空间的组合的位置。通过 Application Discovery Assistant 的最后一个面板，您可以指定仅针对 Java™ 的应用程序/项目结构首选项。此面板与 Microsoft™ Visual Studio 解决方案或Eclipse 工作空间的应用程序和项目文件的放置没有任何关系：应用程序文件自动放置在解决方案或工作空间的根目录中，而项目文件自动放置在各个解决方案或工作空间项目的根目录中。

过程

  1. 完成以下操作之一以启动 Application Discovery Assistant：
    • 从主菜单栏中选择文件 > 添加应用程序 > 发现应用程序。
    • 在“资源管理器”视图的快速启动部分中，选择现应用程序。
    • 在“资源管理器”视图工具栏中，单击添加应用程序菜单向下箭头按钮，然后从菜单中选择发现应用程序。
    • 在“资源管理器”视图中，右键单击所有应用程序，然后从菜单中选择添加应用程序 > 发现应用程序。
  2. 在“搜索位置”面板中，指定包含要扫描的源代码、解决方案或工作空间的位置。此外，还可将扫描设置为在完成应用程序发现后立即开始。

    在此处，可以单击下一步以设置其他 Application Discovery Assistant 选项（如外部依赖关系指定、排除规则和 Java™ 应用程序/项目结构首选项），或者也可以单击启动以开始应用程序发现。如果单击启动：

    • 将不设置任何外部依赖关系位置。如果应用程序具有外部依赖关系，但未指定这些依赖关系，那么扫描结果将受到不利影响。
    • 将使用预设排除规则（请参阅缺省 Application Discovery Assistant 排除规则以查看缺省规则的列表）。
    • 如果要查找 Java™ 源代码，那么将创建一个项目和一个应用程序（此单个项目将包含找到的所有源代码根目录）。

    如果单击下一步，那么继续执行下一步。

  3. 在“外部依赖关系”面板中，为应用程序具有的每个外部依赖关系都设置一条路径（例如，JDK 或 Web 服务器的路径）。要完成此面板，请按照以下指示信息操作：
    1. 要添加外部依赖关系，请在表内单击或单击添加，然后输入或通过浏览来找到外部依赖关系路径。要接受您通过键盘输入的路径，请按键盘 Enter 键。
      提示： 在编辑依赖关系路径字段时在其中进行输入，将列出可选择的目录。必须至少输入盘符。对于指定的路径，将列出其包含的所有文件夹。
    2. 要除去外部依赖关系路径，请选择该路径并单击删除。
    3. 要修改外部依赖关系路径，请在该路径内单击，然后输入或通过浏览来找到外部依赖关系路径。

    在此处，可以单击下一步以设置其他 Application Discovery Assistant 选项，或者也可以单击启动以开始应用程序发现。如果单击启动：

    • 将使用预设排除规则（请参阅缺省 Application Discovery Assistant 排除规则以查看缺省规则的列表）。
    • 如果要查找 Java™ 源代码，那么将创建一个项目和一个应用程序（此单个项目将包含找到的所有源代码根目录）。

    如果单击下一步，那么继续执行下一步。

  4. 在“排除规则”面板中，指定用于滤除文件和目录的规则。规则通过 PERL、Grep、EGrep 或完全匹配正则表达式来设置。例如，如果要从 Application Discovery 搜索中排除名为 temp 的目录，那么可以添加 PERL .*[\\/]temp 排除规则。

    缺省情况下，提供了一组 PERL 正则表达式来排除一些常用目录（请参阅缺省 Application Discovery Assistant 排除规则以查看完整列表）。要修改此列表或创建新规则，请按照以下指示信息操作：

    1. 要修改现有排除规则，请在该规则内单击以激活规则编辑器。完成了对规则的编辑之后，请单击它以外的区域，或按键盘 Enter 键。

      要修改现有规则的正则表达式类型，请在该规则的正则表达式类型单元格内单击，然后从菜单中选择正则表达式类型。

    2. 要添加一项排除规则，请单击添加。这会向表中添加新规则，您可以按照以上关于修改规则的指示信息来修改该规则。
    3. 要除去排除规则，请选择该规则并单击删除（或者单击全部删除以除去面板中当前列出的所有排除规则）。
    重要： 在表中，有效排除规则通过复选标记来表示，而无效规则通过红色 X 来表示。您在所有规则都有效之前将无法启动 Application Discovery 或在 Application Discovery Assistant 中继续操作。

    在此处：

    • 如果仅要搜索 Java™ 源代码，那么可以单击下一步以设置 Application Discovery Assistant 应用程序/项目结构首选项，或者也可以单击启动以运行此助手程序。
    • 如果仅要搜索 Microsoft™ Visual Studio 解决方案或 Eclipse 工作空间，请单击启动以运行此助手程序。单击下一步将致使此助手程序进入仅适用于 Java™ 源代码发现的面板。

    如果单击下一步，那么继续执行下一步。

  5. “应用程序和项目创建”面板仅适用于 Java™ 源代码发现。在该面板中，指定将创建的应用程序和项目的结构：
    1. 要为找到的所有源代码根目录创建单个项目，请在项目菜单中选择创建单个项目。通过此选择，您将只能选择创建单个应用程序。
    2. 要为找到的每个源代码根目录都创建一个单独的项目，请在项目菜单中选择为找到的每个源代码根目录创建项目。通过此选择，您可以选择创建一个或多个应用程序。要创建包含已创建的所有项目的单个应用程序，请在应用程序菜单中选择创建单个应用程序。要为已创建的每个项目都创建应用程序，请在应用程序菜单中选择为每个项目创建应用程序。

    此外，选择用于存储应用程序和项目定义文件的位置。

    如果选择为我组织文件：

    • 如果要创建单个项目，那么将在搜索位置创建项目和应用程序文件。
    • 如果要在单个应用程序中为每个源代码根目录都创建项目，那么每个源代码根目录的项目文件都将创建在该源代码根目录的上一级目录中，而应用程序文件将创建在搜索位置。
    • 如果要为每个源代码根目录都创建项目并为每个项目都创建应用程序，那么每个源代码根目录的项目和应用程序文件都将创建在该源代码根目录的上一级目录中。

    如果指定目录，那么将在该目录中创建所有应用程序和项目文件。

  6. 如果要更改已在先前面板中作出的任何设置，请单击上一步。当您对 Application Discovery 设置满意时，请单击开始对搜索位置进行扫描以查找源代码根目录。

结果

当 Application Discovery 操作完成时，因 Application Discovery 操作而创建的新应用程序和项目会显示在“资源管理器”视图中，并且已准备好进行扫描（如果已将扫描设置为在完成应用程序发现后立即开始，那么扫描将开始）。

如果在发现期间遇到了问题，那么 Application Discovery Assistant 在完成操作时会提供一个发现报告。例如，如果应用程序具有未在“外部依赖关系”面板中指定的外部依赖关系，那么该报告将包含指示无法解析外部依赖关系的警告。在该发现报告中：

  • 单击完成以创建应用程序和项目。如果选择了忽略警告并仍进行扫描，那么将立即扫描应用程序和项目。
  • 单击上一步以修改 Application Discovery Assistant 设置或再次运行 Application Discovery。
  • 单击取消以关闭此发现报告而不创建应用程序或项目。