mirror of https://github.com/apache/jmeter.git
105 lines
4.1 KiB
Plaintext
105 lines
4.1 KiB
Plaintext
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
|
|
|
|
|
|
Eclipse settings
|
|
----------------
|
|
The following files should be excluded from build output:
|
|
*.metaprops
|
|
See Preferences/Java/Building/Output Folder/Filtered Resources
|
|
|
|
|
|
Eclipse.classpath
|
|
-----------------
|
|
[This has been tested with Eclipse 3.2 up to 4.3.2. It may not work with other versions.]
|
|
|
|
The file eclipse.classpath is intended as a starter .classpath file
|
|
for building JMeter using Eclipse version 3 to 4.3. Make sure to execute
|
|
the "ant download_jars" task to download and install the jars referred
|
|
to in the classpath before creating the Eclipse project.
|
|
If you do after creating project, then don't forget to refresh Eclipse project.
|
|
|
|
Note that Eclipse is not easy to use for creating jar files.
|
|
However, it is easy to use Eclipse to run Ant.
|
|
|
|
The following targets may prove useful:
|
|
|
|
clean - Clean up to force a build from source
|
|
package-only - creates the jars
|
|
package - compiles everything and then packages it
|
|
run_gui - compiles, packages, and then start the JMeter GUI from the jars
|
|
|
|
Invoking Ant targets inside Eclipse
|
|
----------------------------------
|
|
You can use the "Run As --> Ant Build" and select target, or you can use
|
|
the "Windows->Show View->Ant View". Then select the "build.xml" file and
|
|
drag and drop to the "Ant View".
|
|
Now you can invoke targets by clicking on them.
|
|
Note that if you invoke for example the "compile" target, and get error
|
|
messages about
|
|
"
|
|
Unable to find a javac compiler;
|
|
com.sun.tools.javac.Main is not on the classpath.
|
|
Perhaps JAVA_HOME does not point to the JDK
|
|
"
|
|
it just means that your Eclipse project is set up with JRE libraries instead of JDK libraries.
|
|
The suggested fix is to add a JDK in "Window->Preferences->Java->Installed JREs".
|
|
Then do a "Project->Properties" and select "Java Build Path" in the left pane, and then
|
|
select the "Libraries" tab in the right pane. Scroll to the bottom, select the "JRE System Library",
|
|
and click "Remove". Then click "Add library..." , select "JRE System Library", and then select
|
|
the JDK. Now it should work when you invoke the "compile" target.
|
|
|
|
|
|
Finishing the build using Ant
|
|
-----------------------------
|
|
|
|
Find the build.xml file in the project,
|
|
right click on it, and click "Run As --> Ant Build".
|
|
|
|
Make sure you select the "package" target.
|
|
|
|
This will compile any remaining classes,
|
|
and then create all the jars.
|
|
|
|
Now refresh the project (you should add this to the Ant build properties)
|
|
|
|
Launching from Eclipse
|
|
----------------------
|
|
|
|
You can use the Ant target run_gui to run the JMeter GUI, or you can follow the instructions
|
|
below to add a Java Application launch, which will for example, allow you to use the debugger to
|
|
run JMeter.
|
|
|
|
These instructions assume you have configured Eclipse to use the classpath
|
|
as suggested in eclipse.classpath, and have run "ant package" to compile
|
|
the RMI classes and build the jars.
|
|
|
|
Create a new Java Application launch configuration.
|
|
|
|
On the Main tab, enter the following as the main class:
|
|
|
|
org.apache.jmeter.NewDriver
|
|
|
|
On the Arguments tab, in the Working Directory area, pick the radio
|
|
button next to "Other" and enter the following in the text box:
|
|
|
|
${workspace_loc}/jmeterproject/bin
|
|
|
|
where "jmeterproject" is the name of the JMeter project.
|
|
|
|
[It would be nicer to use ${project_loc}/bin
|
|
but unfortunately the Eclipse Debug view does not seem to preserve any of the project variables]
|