构建 JMeter

在编译 JMeter 之前,您需要做一些事情:
  • 兼容 Java 8 的 JDK(Java 开发工具包)
  • 可选:Gradle安装
  • JMeter 源,如下一节所示

获取源

Apache JMeter 的官方源代码版本可以从下载页面下载

使用 Gradle 编译和打包 JMeter

JMeter 可以完全使用 Gradle 构建。基本命令是:

./gradlew build

通过./gradlew tasks(或./gradlew tasks --all ) 查看可用任务列表,了解可以使用的其他任务。有关可用任务的更多详细信息可以在gradle.md中找到。

通过 IntelliJ IDEA 打开项目

您需要 IntelliJ 2018.3.1 或更高版本。

  • 使用 IntelliJ IDEA 打开 build.gradle.kts 文件并选择“Open as Project”
  • 确保选中“为每个源集创建单独的模块”
  • 确保选中“使用默认 gradle 包装器”
  • 在“文件已存在”对话框中,选择“是”覆盖
  • 在“打开项目”对话框中,选择“删除现有项目并导入”

使用 Eclipse 编译和打包 JMeter

选项 1:通过 Eclipse 的“导入 Gradle 项目”向导导入 Eclipse 项目

最近的 Eclipse 版本可以自动导入 Gradle 项目,所以使用 File  →  Import... 然后选择Existing Gradle Project并继续导入。

选项 2:使用 Gradle 任务设置 Eclipse 项目

下载源代码后,您可以通过运行以下命令来设置 Eclipse 项目:
./gradlew eclipse
然后,您可以使用 File  →  Import  →  Existing projects 将项目导入 Workspace并选择包含 JMeter 源的文件夹。

为 JMeter 做贡献

我们热爱贡献

如果您花一些时间为该项目做出贡献,我们将非常感谢您。如果您有时间花在项目上,您可以从问题页面中选择现有的增强或错误。
您还可以为翻译做出贡献,请参阅JMeter Localization (Translator's Guide)

提交补丁

如果您想为 JMeter 提供错误修复或增强功能,请遵循以下过程:

检查你的补丁

在提交补丁之前,请确保执行以下操作:
检查补丁是否编译并遵循 Tab 空间策略,方法是运行:

./gradlew check

通过运行检查补丁是否不会破坏 JUnit 测试:

./gradlew test

使用 GIT 创建 PR

  • 打开一个 bugzilla 问题,请参阅问题页面
  • Fork Apache JMeter 镜像
  • 在本地克隆您的分叉存储库:
    git clone https://github.com/yourid/jmeter/
  • 使用例如 bugzilla id 创建一个分支:
    git branch BUGID
  • 签出新分支:
    git checkout BUGID
  • 在那里提交你的修复:
    git commit -m 'Fix to BUGID' list of files
  • 请避免在 PR 中创建合并提交。我们接受小的更改,合并提交更难审查
  • 将 JMeter 存储库添加为上游:
    git remote add upstream http://www.github.com/apache/jmeter
  • 推它 :
    git push origin BUGID
  • 创建一个 PR 并将其链接到 bugzilla 问题中
  • 或者创建一个差异并作为附件添加到 bugzilla 问题
    git diff > BUGID.patch
不同的操作系统对行尾标记有不同的默认值。典型的配置是用于 Windows 的 CRLF 和用于 macOS 和 GNU/Linux 的 LF。建议通过core.autocrlf
的适当设置来遵循该配置。对于 Windows
git config --global core.autocrlf true
, 并且适用于 macOS 和 GNU/Linux 集
git config --global core.autocrlf input
由于.gitattributes,Git 将自动识别存储库中的文本文件,并且 Git 会将文本文件的行尾转换为适当的平台原生格式(根据core.autocrlf
某些文件(例如*.sh*.bat)具有无论开发人员工作站的配置如何,都预定义了生产线结束策略。

使用补丁创建 PR

  • 打开一个 bugzilla 问题,请参阅问题页面
  • 签出 Apache JMeter 源
  • 编写修复代码
  • 通过右键单击 Eclipse 项目并选择 Team  →  Create Patch ... 创建补丁
  • 将您的补丁附加到 bugzilla 问题

自动化构建

自动化(每晚)构建

作为开发过程的一部分,JMeter 项目可以访问各种持续集成 (CI) 服务器构建。构建输出可用于测试代码库的最新更改。

请注意,构建没有经过任何 QA,只能用于开发测试。有关详细信息,请参阅面向开发人员的 Nightly 构建页面。

构建附加组件

构建附加组件

如果您只想构建一个附加组件,则无需构建 JMeter。只需下载二进制存档并将 jars 添加到类路径或使用 Maven 工件来构建您的附加组件。您可能还需要下载源代码,以便 IDE 使用它。

有关一些建议,请参阅源代码树中的extras/addons*文件

Go to top