EvoMaster 开源项目使用教程

1. 项目介绍

EvoMaster 是一个开源的 AI 驱动的工具，专门用于自动生成系统级测试用例（也称为模糊测试），主要针对 Web 和企业应用程序。目前，EvoMaster 主要支持白盒和黑盒测试 Web API，如 REST、GraphQL 和 RPC（例如 gRPC 和 Thrift）。

EvoMaster 的核心功能包括：

• Web API 测试：支持 REST、GraphQL 和 RPC API 的测试。
• 黑盒测试模式：可以在任何 API 上运行（无论其编程语言），但结果可能不如白盒测试。
• 白盒测试模式：适用于编译到 JVM 的 API（如 Java 和 Kotlin），通过分析字节码生成更有效的测试用例。
• 多种输出格式：支持生成 Python、JavaScript、Java 和 Kotlin 等多种格式的测试用例。

2. 项目快速启动

2.1 安装 EvoMaster

EvoMaster 提供了多种安装方式，包括 Windows、OSX 和 Linux 的安装包，以及一个 uber-fat JAR 文件。以下是使用 uber-fat JAR 文件的安装步骤：

1. 下载 uber-fat JAR 文件：

   wget https://github.com/WebFuzzing/EvoMaster/releases/download/v1.0.0/evomaster.jar
   

2. 确保已安装 JDK 8 或更高版本：

   java -version
   

3. 运行 EvoMaster：

   java -jar evomaster.jar
   

2.2 生成测试用例

以下是一个简单的示例，展示如何使用 EvoMaster 生成测试用例：

java -jar evomaster.jar --outputFormat PYTHON_UNITTEST --targetUrl http://example.com/api

此命令将生成 Python 格式的测试用例，目标 API 为 http://example.com/api。

3. 应用案例和最佳实践

3.1 应用案例

EvoMaster 已被广泛应用于各种 Web 和企业应用程序的测试中。例如，某大型金融机构使用 EvoMaster 对其 REST API 进行自动化测试，显著提高了测试覆盖率和缺陷检测率。

3.2 最佳实践

• 初始测试：建议先使用黑盒模式进行测试，以快速了解 EvoMaster 的功能和效果。
• 长时间运行：为了获得更好的测试结果，建议将 EvoMaster 运行数小时，而不是几分钟。
• 代码覆盖率：在白盒测试模式下，EvoMaster 可以通过分析字节码来提高代码覆盖率，建议在 JVM 项目中使用。

4. 典型生态项目

EvoMaster 作为一个开源项目，与其他开源工具和项目有着紧密的联系。以下是一些典型的生态项目：

• OpenAPI/Swagger：EvoMaster 支持使用 OpenAPI/Swagger 格式的 API 文档进行测试。
• JUnit：EvoMaster 可以生成 JUnit 格式的测试用例，与 JUnit 生态系统无缝集成。
• Postman：EvoMaster 生成的测试用例可以导入到 Postman 中进行进一步的测试和调试。

通过这些生态项目的支持，EvoMaster 能够更好地满足不同场景下的测试需求。