构建 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 项目,所以使用 然后选择 并继续导入。选项 2:使用 Gradle 任务设置 Eclipse 项目
下载源代码后,您可以通过运行以下命令来设置 Eclipse 项目:./gradlew eclipse然后,您可以使用 并选择包含 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
某些文件(例如*.sh或*.bat)具有无论开发人员工作站的配置如何,都预定义了生产线结束策略。
的适当设置来遵循该配置。对于 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 项目并选择
- 将您的补丁附加到 bugzilla 问题
自动化构建
自动化(每晚)构建
作为开发过程的一部分,JMeter 项目可以访问各种持续集成 (CI) 服务器构建。构建输出可用于测试代码库的最新更改。
请注意,构建没有经过任何 QA,只能用于开发测试。有关详细信息,请参阅面向开发人员的 Nightly 构建页面。
构建附加组件
构建附加组件
如果您只想构建一个附加组件,则无需构建 JMeter。只需下载二进制存档并将 jars 添加到类路径或使用 Maven 工件来构建您的附加组件。您可能还需要下载源代码,以便 IDE 使用它。
有关一些建议,请参阅源代码树中的extras/addons*文件