| This file describes how to create local additions to JMeter. |
| |
| Create a new directory for the sources: |
| |
| cd JMETER_HOME |
| |
| mkdir addons |
| |
| Copy addons.xml into JMETER_HOME |
| |
| To build the addons, run ant as follows: |
| |
| ant -buildfile=addons.xml |
| |
| This will compile the sources to build/addons/... |
| |
| If successful, it will also create the jar file: |
| |
| JMETER_HOME/lib/ext/ApacheJmeter_addons.jar |
| |
| As the filename of this jar is alphabetically earlier, |
| any classes in it will be used in preference to existing JMeter classes. |
| |
| This allows the addons to be used to supply new functionality as well |
| as overriding existing functionality, without needing to rebuild JMeter. |
| |
| Such addons are intended mainly to be used locally - for example if you |
| have developed any new code that is only relevant to your organisation. |
| |
| It can also be useful for developing general purpose add-ons that are |
| intended for general release. Once tested, these can be moved into one of |
| the normal JMeter source directories. |
| |
| N.B. The build file assumes that JMeter has been built separately, as |
| JMeter classes are resolved from jars in the lib and lib/ext directories. |