...
Tip |
| title |
Setup For *NIX Users |
|
|
Thanks to the hints from this page. |
...
Before you can build the NMS API and the various provider libraries you need to initialize your local NAnt repository so that you have all the required dependencies available for the provider's NAnt build scripts to pull in during their builds. We maintain a tree in the NMS SVN repo with all the required dependencies which allow you to easily populate you NAnt repo. You can check out this tree by executing the following:
No Format |
svn co https://svn.apache.org/repos/asf/activemq/activemq-dotnet/vendor/
|
Now that you have the vendor tree checkout out you can install the various libaries into you NAnt repo by running each one's build script and with the 'install' target. You will need nant-0.91 or higher. The version 0.90 won't work. Let's take the NUnit testing framework libraries as an example, you install them like so:
No Format |
cd ./activemq-dotnet/vendor/NUnit/2.5.8
nant install
|
...
To build the code with Nant you will need to build the individual modules, starting with the main NMS module first. Following are the steps needed to build all of the modules, but depending on which provider you are using, you may only need to build the main Apache.NMS module and then your specific provider module. For example, if you are only working with ActiveMQ, then you would need to build the Apache.NMS module and the Apache.NMS.ActiveMQ provider module. Here are the steps to build all of the modules for the trunk version. Modify the paths to build a particular tag release (e.g., change the trunk folder to tags\1.0.0):
No Format |
cd activemq-dotnetcd Apache.NMS\trunk
nant
cd ..\..\Apache.NMS.ActiveMQ\trunk
nant
cd ..\..\Apache.NMS.MSMQAMQP\trunk
nant
cd ..\..\Apache.NMS.EMS\trunk
nant
cd ..\..\Apache.NMS.MQTT\trunk
nant
cd ..\..\Apache.NMS.MSMQ\trunk
nant
cd ..\..\Apache.NMS.Stomp\trunk
nant
cd ..\..\Apache.NMS.WCF\trunk
nant
cd ..\..\Apache.NMS.ZMQ\trunk
nant
|
This will build all of the providers. The only module that needs to be built first is the Apache.NMS module, as all of the other provider modules depend upon that module. IMPORTANT: In order to build the Apache.NMS.EMS module, you must have a licensed copy of the TIBCO.EMS.dll. This module is not available from The Apache Software Foundation.
...
If you want to run a build with the unit tests (assuming you have a broker running) then type the following from the trunk folder of the provider module:
No Format |
nant test
|
Alternatively, you can use the NUnit graphical interface to load the appropriate module's nunit project file. Each project includes a file named Apache.NMS.modulename.Test.nunit, where modulename matches the provider module's name (e.g., ActiveMQ, AMQP, EMS, MQTT, MSMQ, Stomp, WCF, or WCFZMQ). This file can be loaded into the NUnit's graphical application to run all of the unit tests and see their output.
...