1 Instructions on how to build functional test MIDlets

     2 ====================================================

     3 

     4 This file gives instructions on how to use the build.xml files for MIDlet suite 

     5 compilation and packing.

     6 

     7 

     8 Requirements

     9 ------------

    10 

    11 * Get a local copy of the directory containing the UI FuTe MIDlets from the 

    12 version control system. Get the whole structure, because the xml files in the 

    13 root will be needed.

    14 

    15 * Apache Ant installed. It is used for compiling the MIDlet source files and 

    16 packing the classes and resources into MIDlet packages.

    17 

    18 * Environment variable JAVA_HOME value is set to the path where JDK is 

    19 installed.

    20 

    21 * Sun Java Wireless Toolkit for CLDC (WTK) installed to "C:\WTK". The location 

    22 is defined in the file "properties.xml":

    23 

    24     o <property name="wtk.home" value="C:/WTK"/> 

    25 

    26 * Java public api classes jar file "java_public_api.jar" should be copied to WTK 

    27 lib directory, in sub directory "ext". The file can be found i.e. in the SDK 

    28 package. You can use also some other jar/zip package that contains the needed 

    29 classes, it is used only for compiling the MIDlets. The location of the file is 

    30 defined in the file "properties.xml":

    31 

    32     o <property name="java_public_api" value="${wtk.home}/lib/ext/java_public_api.jar"/> 

    33 

    34 * Antenna library file should be copied to WTK lib directory, in sub directory 

    35 "ext". It can be found from the Internet: http://antenna.sourceforge.net/. The 

    36 location of the file is defined in the file "properties.xml":

    37 

    38     o <taskdef resource="antenna.properties" classpath="${wtk.home}/lib/ext/antenna-bin-1.0.2.jar"/> 

    39 

    40 

    41 Building & packing MIDlets

    42 --------------------------

    43 

    44 Building the MIDlets can be done in the MIDlet project directory itself, or in 

    45 some of the parent directories. If it is done in the MIDlet project directory, 

    46 only that MIDlet will be built. If it is done in the root of the UI FuTe 

    47 MIDlets, then all of them will be built.

    48 

    49 The default action for Ant is "pack". It will compile and create the MIDlet 

    50 packages. Compilation is done by using either one of these commands:

    51 

    52     ant

    53     ant pack

    54 

    55 If you want to clean the build directories, it can be done with command:

    56 

    57     ant clean

    58 

    59 The compiled classes and MIDlets are stored in a directory named "build" to the 

    60 MIDlet suite project directory.