【原文】Eclipse下jmeter2.6源代码编译指导

一、预备所需文件

1. 下载二进制包和源码包并解压到目标文件夹(e.g.jmeter2.6下，apache-jmeter-2.6_release和apache-jmeter-2.6_src)

2. 下载2个jar包（很重要要不会有n多的错误）：
    bcmail-XXX.jar
    bcprov-XXX.jar
    地址：http://www.bouncycastle.org/latest_releases.html

二、安装Eclipse

1. 下载Eclipse：eclipse3.3.2
2. 安装jdk：jdk-6u25-windows-i586.exe
3. Java环境变量设置
    Windows下JAVA用到的环境变量主要有3个，JAVA_HOME、CLASSPATH、PATH。
    JAVA_HOME指向的是JDK的安装路径，如D:/Program Files/IBM/Java50，在这路径下你应该能够找到bin、lib等目录。
    设置方法：
    JAVA_HOME = D:/Program Files/IBM/JAVA50
    PATH环境变量原来Windows里面就有，只要保留原来的PATH的内容，并在其中加上%JAVA_HOME%/bin (%JAVA_HOME%就是是引用上一步设定好的环境变量JAVA_HOME) 。
    设置方法：
    PATH = %JAVA_HOME%/bin;%PATH%
    同样，%PATH%是引用以前你设置的PATH环境变量，你照抄以前的值就行了。
    注意的是最前面的"./;"，这个是告诉JDK，搜索CLASS时先查找当前目录的CLASS文件，至于CLASSPATH后面指定tools.jar这个具体文件，是由java语言的import机制和jar机制决定的。
    设置方法：
    CLASSPATH = ./;%JAVA_HOME%/lib/tools.jar

三、安装ANT

如果已经安装ANT，跳过该步骤。
1. 下载ANT：apache-ant-1.8.3-bin.zip
    地址：http://ant.apache.org/bindownload.cgi
2. 安装ANT
3. ANT环境变量设置
    Windows下ANT用到的环境变量主要有2个，ANT_HOME 、PATH。
    设置ANT_HOME指向ant的安装目录。
    设置方法：
    ANT_HOME = D:/apache_ant_1.7.0
    将%ANT_HOME%/bin; %ANT_HOME%/lib添加到环境变量的path中。
    设置方法：
    PATH = %ANT_HOME%/bin; %ANT_HOME%/lib

4. 查看是否安装成功。
    转自：http://www.cnblogs.com/ghj1976/archive/2010/04/14/1711914.html
    在dos窗口中输入命令ant，若出现结果:
       Buildfile：build.xml does not exist!
       Build failed
    说明ant安装成功！因为ant默认运行build.xml文件，这个文件需要我们建立。

    一个简单的使用ANT的例子:
    在 D 盘根目录下新建一个 build.xml 文件，文件的内容如下：
    <?xml version="1.0" encoding="GBK"?>
    <project name="测试脚本" default="copyfile" basedir="." >
       <target name="copyfile">
          <copy file="d:/a.txt" todir="e:/Temp" overwrite="true" />
       </target>
    </project>

    在 D 盘根目录下新建一个 a.txt 文件，内容随便。

    进入DOS，依次执行：
      d:
      ant
    如同下面的截图：
   
执行完毕后，我们会在 e:/Temp 目录下看到 a.txt 文件，跟D盘根目录下的完全一样，即Copy成功。

如果中间提示类似如下错误：
Unable to locate tools.jar. Expected to find it in C:\Program Files\Java\jre6\lib\tools.jar
这是因为JDK 的安装有问题或者是 JAVA_HOME 环境变量没有设置或者设置有问题， jre下肯定没tools.jar。

四、创建工程

1. 将apache-jmeter-2.6_release下的lib中的文件（ext、junit文件夹及各jar包）拷到apache-jmeter-2.6_src下的lib目录
2. 创建apache-jmeter-2.6_src下的lib\api目录，并将下载的bcmail-XXX.jar和bcprov-XXX.jar拷贝到该目录
3. 修改commons-logging1.1.1.jar为commons-logging.jar
4. 打开eclipse，新建java工程，命名(jmeter2.6下jmeter文件)，删除默认生产的scr目录
5. 选择import，选择General\File System方式导入，选择除bin目录以外的所有目录
6. 关闭eclipse

五、编译工程

1. 将apache-jmeter-2.6_release下的eclipse.classpath中的内容复制一份替换jmeter下的.classpath的内容
2. 将apache-jmeter-2.6_release\bin下，全部.properties文件拷贝到jmeter\bin
3. 重新开启eclipse
4. 打开jmeter项目属性对话框，选择Java Build Path，选择Libraries页，导入jmeter\lib下全部jia包，包括子文件夹下jia包
5. 编译工程，此时编译不通过，大都为编译路径问题。打开jmeter项目属性对话框，选择Java Build Path，选择Source页，根据编译错误提示，添加编辑路径。直至编译成功。
6. 使用ANT正常编译
7. 选择org.apache.jmeter.NewDriver设置运行配置，可以参考可以参考http://people.apache.org/~mkostrze/jmeter-eclipse/index.html

设置成功后，就可以运行或者debug jmeter。