Main   Download   News   Features   Documentation   Authors

Build Instructions

About

This page contains information about building JMSME classes. For information about building MIDlets which use JMSME, see using JMSME page (coming soon) . Build instructions are split in two parts:

  • building client (MIDlet) classes
  • building proxy

Steps introduced in this instructions should work on any system since ant is portable, but I have tested them only on linux. You may have to adjust some steps in other enviroments. In case of any doubt try reading build.xml file (Peter has commented it quite well).


Required tools:

Below is the list of tools and classes you will need to build JMSME. If you have developed MIDP applications you propably are already familiar with most of them. I will assume you have them installed and configured.

  • Jakarta ant.
  • Antenna tasks for ant. Theese tasks deal with all MIDlet specific build operations.
  • JavaMake installed as ant task.
  • MIDP reference implementation or any other MIDP implementation to link with client side of JMSME . The reference implementation can be found at Sun.
  • JMS classes to link with (we have been using JMS api from JORAM), but you may use any JMS 1.1 (or later) classes.

Building Client
  • Unpack the source. Depending on the archive name and type it will be propably something like this:
    tar -xzf jmsme.tar.gz
  • Set environmental variable MIDP_PATH to point the location of your MIDP classes. On my box it is:
    export MIDP_PATH=/usr/java/midp/classes
  • Change directory to jmsme/source
  • You may issue: ant -projecthelp to see all possible build targets. In short words:
    • ant dist.client builds client library, output jar is jmsme/client/lib/jmsme-client.jar.
    • ant document.client builds javadoc api documentation.

Building Proxy

I assume you have unpacked the source, just like in building client above.

  • Set environmental variable JMS_PATH to point the location of your JMS interfaces definitions. On my box it is:
    export JMS_PATH=/usr/java/joram/lib/jms.jar
  • Change directory to jmsme/source
  • Build commands for proxy:
    • ant dist.proxy builds proxy, output jar is jmsme/proxy/lib/jmsme-proxy.jar.
    • ant document.proxy builds javadoc api documentation for proxy.

SourceForge.net Logo Powered by PHP Powered by Emacs Valid HTML 4.01! Valid CSS!
Last modified: Sun Jun 22 16:48:50 CEST 2003