Antenna

Setup

Making the tasks available to Ant

<taskdef name="wtkjad" classname="de.pleumann.antenna.WtkJad"/>
<taskdef name="wtkbuild" classname="de.pleumann.antenna.WtkBuild"/>
<taskdef name="wtkpackage" classname="de.pleumann.antenna.WtkPackage"/>
<taskdef name="wtkmakeprc" classname="de.pleumann.antenna.WtkMakePrc"/>
<taskdef name="wtkrun" classname="de.pleumann.antenna.WtkRun"/>
<taskdef name="wtkpreverify" classname="de.pleumann.antenna.WtkPreverify"/>
<taskdef name="wtkobfuscate" classname="de.pleumann.antenna.WtkObfuscate"/>
<taskdef name="wtksmartlink" classname="de.pleumann.antenna.WtkSmartLink"/>
<taskdef name="wtkpreprocess" classname="de.pleumann.antenna.WtkPreprocess"/>
<taskdef name="wtkdeploy" classname="de.pleumann.antenna.WtkDeploy"/>
<taskdef name="wtkrapc" classname="de.pleumann.antenna.WtkRapc"/>
		

<taskdef resource="antenna.properties"/>
		

<taskdef resource="antenna.properties " classpath="full name of Antenna jar file"/>
		

Selecting a WTK and APIs for a project

<property name="wtk.home" value="c:\Java\wtk-1.0.4"/>
		

Property	Default	Purpose	WTK
wtk.cldc.version	1.0	Specifies the version of CLDC to use.	2.1+
wtk.midp.version	2.0 for WTK 2.x, 1.0 otherwise.	Specifies the version of MIDP to use.	2.0+
wtk.mmapi.enabled	false	Enables or disables the Multimedia API (MMAPI).	2.0+
wtk.wma.enabled	false	Enables or disables the Wireless Messaging API (WMA).	2.0+
wtk.wma.version	1.0	Selects the supported version of the Wireless Messaging API (WMA). Currently either 1.0 (JSR-120) or 2.0 (JSR-205) is allowed.	2.3+
wtk.j2mews.enabled	false	Enables or disables the J2ME Web Services API (J2MEWS).	2.1+
wtk.bluetooth.enabled	false	Enables or disables the J2ME Bluetooth API (JSR-82).	2.2+
wtk.java3d.enabled	false	Enables or disables the J2ME 3D API (JSR-184).	2.2+
wtk.optionalpda.enabled	false	Enables or disables the J2ME optional PDA packages (JSR-75).	2.2+
wtk.locationservices.enabled	false	Enables or disables the J2ME location services API (JSR-179).	2.3+
wtk.contenthandler.enabled	false	Enables or disables the J2ME content handler API (JSR-211).	2.3+
wtk.satsa.enabled	false	Enables or disables the J2ME Security and Trust Services API (JSR-177).	2.3+
wtk.miapi.enabled	false	Enables or disables the J2ME Mobile Internationalization API (JSR-238).	2.5+
wtk.ams.enabled	false	Enables or disables the J2ME Advanced Multimedia Supplements API (JSR-234).	2.5+
wtk.papi.enabled	false	Enables or disables the J2ME Payment API (JSR-229).	2.5+
wtk.s2dvgapi.enabled	false	Enables or disables the J2ME Scalable 2D Vector Graphics API (JSR-226).	2.5+
wtk.sipapi.enabled	false	Enables or disables the J2ME Session Initiation Protocol API (JSR-180).	2.5+
wtk.midpapi	Varies	Sets a totally custom BOOTCLASSPATH. Use this property if the set of APIs you need is not covered by the above properties (for example because you are using the system libraries provided another vendor or you have some important additional libraries).	1.0+

Please note that the properties for selecting a CLDC and MIDP version also set the default values for the "config" and "profile" properties used in the WtkJad and WtkPackage tasks. So, if you set the versions properly at the beginning of your build.xml file, you normally don't have to deal with these values again.

Using an obfuscator

retroguard.jar
proguard.jar
		

<property name="wtk.retrogard.home" value="your path goes here"/>
<property name="wtk.proguard.home" value="your path goes here"/>
		

If both obfuscators are available, ProGuard is preferred because it usually provides better results.

Note that if using RetroGuard and setting a BOOTCLASSPATH through the wtk.midpapi property, it might also become necessary to set the following property:

<property name="wtk.emptyapi" value="your path goes here"/>
		

Using the Websphere Micro Environment Toolkit for PalmOS

Using Over-the-Air provisioning

The task provides the following parameters:

Parameter	Type	Required	Purpose
jadfile	file	yes	The name of the JAD file to create or update.
jarfile	file	no	The name of the JAR file that accompanies the JAD file. If present, the task tries to update the MIDlet-Jar-URL and MIDlet-Jar-Size attributes. Note that the "deploy" parameter also has an effect on the MIDlet-Jar-URL attribute.
manifest	file	no	If this parameter is present, a MANIFEST file is generated, too. The contents of the manifest are taken from the JAD file, with only the following exceptions: The MIDlet-Jar-Url and MIDlet-Jar-Size keys are obmitted. The MicroEdition-Configuration and MicroEdition-Profile keys are added as specified in the corresponding parameters of the task, or they default to "CLDC-1.0" and "MIDP-1.0", or to what has been set using the wtk.cldc.version and wtk.midp.version properties. Note that the MANIFEST file is always created from scratch, independent of the "update" parameter.
update	boolean	no	If set to true, an existing JAD file is updated instead of creating a new one from scratch. In update mode, the behaviour is as follows: If a JAR file is specified, the MIDlet-Jar-URL and MIDlet-Jar-Size attributes are modified. Note that the "deploy" parameter also has an effect on the MIDlet-Jar-URL attribute. If one of the name, vendor or version attributes is specified, it overrides the one already present in the JAD file. If at least one MIDlet is specified using the sub-element described below, the whole list of MIDlets in the existing JAD file is cleared. If an attribute is specified using the sub-element described below, it overrides an existing attribute in the JAD file.
target	URL	no	A URL to which the MIDlet suite shall be deployed at a later point. If specified, this URL will prefix the JAR file name in the MIDlet-Jar-URL. The URL must not end with a slash, because one is added automatically.
name	string	no	The name of the MIDlet suite, that is, the value of the MIDlet-Name attribute.
vendor	string	no	The vendor of the MIDlet suite, that is, the value of the MIDlet-Vendor attribute.
version	string	no	The version of the MIDlet suite, that is, the value of the MIDlet-Version attribute.
autoversion	boolean	no	If true, the task attempts to create a new version number for the MIDlet suite. If no MIDlet-Version key exists, version "1.0.0" is assigned. Otherwise, the last of the three numbers is increased by one (assuming some major.minor.micro scheme).
encoding	string	no	Specifies the encoding to use when reading or writing the JAD and MANIFEST files. Defaults to the platform default encoding, when no specified (this might change to UTF-8 in the future).
if	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is defined.
unless	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is not defined.

Midlet

Parameter	Type	Required	Purpose
name	string	yes	The MIDlet's name.
icon	String	no	An icon for the MIDlet, specified as a path relative to the root of the JAR file.
class	string	yes	The name of the main MIDlet class.
if	String	no	Provides fine-grained control over the MIDlets based on properties. The MIDlet will only make it to the JAD file if the given property is defined.
unless	String	no	Provides fine-grained control over the MIDlets based on properties. The MIDlet will only make it to the JAD file if the given property is not defined.

Attribute

Parameter	Type	Required	Purpose
name	string	yes	The attribute name.
value	String	no	The attribute value. If you don't specify this parameter, the given attribute is removed from the JAD file instead.
if	String	no	Provides fine-grained control over the attributes based on properties. The attribute will only be copied to the JAD file if the given property is defined.
unless	String	no	Provides fine-grained control over the attributes based on properties. The attribute will only be copied to the JAD file if the given property is not defined.

Build

Package

MakePRC

• With the Wireless Toolkit up to version 1.0.4. From version 2.0 (which is also the first version to support MIDP 2.0), the PalmOS converter is no longer included in the Wireless Toolkit, because MIDP for PalmOS doesn't support MIDP 2.0.
• With the IBM Websphere Micro Environment for PalmOS 5.x upwards. In this case, the "wme.home" property needs to point to the WME home directory.

The task provides the following parameters:

Parameter	Type	Required	Purpose
jarfile	file	at least one of these	The JAR file from which to read classes.
jadfile	file		The JAD file that contains MIDlet definitions.
prcfile	file	no	The Palm OS PRC file to create. Defaults to the JAR file, but with the ".prc" extension.
converter	string	no	The converter to use for generating the PRC file. Possible values are "wtk", which results in Sun's WTK converter being used, or "wme", which calls the converter from the IBM WME. Unless the property "wtk.wme.home" is defined, the WTK converter is the default option, so there's normally no need to change this property.
icon	file	no	An icon to use for the application.
smallicon	file	no	A small icon to use for the application.
name	string	no	The name of the application to display on the Palm.
longname	string	no	A longer name for the application to display on the Palm.
creator	string	only if type other than "Data"	A 4-byte creator ID to use for the application. For non-experimental products, you need to register with PalmSource first.
type	string	no	A type to use for the application. Defaults to "Data".
highres	boolean	no	(WME only) Set to "true" to support High-Resolution mode (320*320, 320*480).
if	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is defined.
unless	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is not defined.

Run

The task provides the following parameters:

Parameter	Type	Required	Purpose
jadfile	file	yes	The JAD file that describes the MIDlet suite. The JAR file is taken from the MIDlet-Jar-URL key.
classpath	string	no	Additional classes that are needed for execution.
classpathref	string	no	A reference to a classpath defined elsewhere.
heapsize	string	no	The heap space available to the MIDlet suite. May be something like "65536", "128K" or "1M". Defaults to the latter.
device	string	no	The device (skin) to use during emulation. The Wireless Toolkit comes with the following devices pre-installed: DefaultColorPhone (also default if parameter is not specified at all) DefaultGreyPhone MinimumPhone Motorola_i85s RIMJavaHandheld PalmOS_Device (requires Palm OS emulator)
wait	boolean	no	Specifies whether Ant should wait for the emulator to exit. Defaults to true. Note that this parameter also determines whether you can see the emulator's stdout/stderr streams. If Ant doesn't wait for the emulator to finish, this info goes to /dev/nul.
trace	string	no	Specifies whether the emulator should display verbose information on the MIDlet in execution. This is basically a comma-separated list of items whose possible values seem to depend on the WTK version. Common options are: class - Displays class loading information. gc - Display garbage collection information. all - Displays all trancing information Please see your WTK documentation for a complete list of options. Of course this parameter only makes sense when used together with "wait=true".
debug	address	no	Enables remote debugging support. The address of the remote debugger needs to be specified in the form <host>:<port>. Note that you need a special kind of debugger for this to work. The one in Forte/Netbeans seems to work, while the one in Eclipse, unfortunately, doesn't. :(
if	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is defined.
unless	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is not defined.

Preverify

WtkPreverify can operate either on directories or on JAR files, not both. If the input is read from a directory, the output will be written to a directory (that is, we are dealing with single class files). If the input is read from a JAR file, the output will be written to a JAR file. If, in the latter case, no output JAR is specified, the input JAR is overwritten. In addition, if a JAD file is specified, its "MIDlet-Jar-Size" key is updated.

Note: In the past, a number of users reported preverification failures. These should be fixed with Antenna 0.9.11. If you still have problems during preverification, please make sure that jar[.exe] (from the JDK) is in your path. Depending on the order and versions of JDKs and WTKs you installed, this might not be the case, making the preverify[.exe] utility from the WTK fail.

The task provides the following parameters:

Parameter	Type	Required	Purpose
srcdir	file	Either of these two.	The source directory, containing non-preverified classes.
jarfile	file		The source JAR file, containing non-preverified classes.
destdir	file	yes, if "srcdir" is being used	The target directory to write the preverified classes to.
tojarfile	file	no, but can be combined with "jarfile"	The target JAR file to write the preverified classes to. If not specified, the source JAR is overwritten.
jadfile	file	no	The name of the JAD file that accompanies the JAR file. If the source JAR file is overwritten (no "tojarfile" being specified), the "MIDlet-Jar-Size" key in the JAD is updated when the task is finished.
bootclasspath	path	no	Specifies the basic system classes that are needed by the application. Defaults to the MIDP API contained in ${wtk.home}/lib/midpapi.zip, or ${wtk.midpapi}, if specified.
classpath	path	no	Specifies additional libraries that are needed by the application, but not part of the JAR file (for example libraries that are already available on a certain phone).
classpathref	string	no	A reference to a classpath defined elsewhere.
bootclasspathref	string	no	A reference to a bootclasspath defined elsewhere.
cldc	boolean	no	If set to "false" then "-cldc" is not passed as a parameter to the preverifier. Defaults to "true".
nonative	boolean	no	Can be used to allow/forbid certain langage features during preverification. If set to "true", then "-nonative" is passed to the preverifier. Please turn "cldc" off before. Otherwise this setting might have no effect.
nofloat	boolean	no	Can be used to allow/forbid certain langage features during preverification. If set to "true", then "-nofloat" is passed to the preverifier. Please turn "cldc" off before. Otherwise this setting might have no effect.
nofinalize	boolean	no	Can be used to allow/forbid certain langage features during preverification. If set to "true", then "-nofinalize" is passed to the preverifier. Please turn "cldc" off before. Otherwise this setting might have no effect.
if	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is defined.
unless	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is not defined.

Obfuscate

The task provides the following parameters:

Parameter	Type	Required	Purpose
jarfile	file	yes	The unobfuscated source JAR file to read classes from.
jadfile	file	no	A JAD file that accompanies the JAR file. The task uses this file to determine the list of classes to exclude from obfuscation as follows: The main MIDlet classes, denoted by the MIDlet-# keys in the JAD file are preserved. Classes to be loaded by name (on a Motorola phone), denoted by an iDEN-Install-Class-# keys are preserved, too. Additional classes to spare from obfuscation can be specified using the "preserve" nested element. If the source JAR file is overwritten (no "tojarfile" being specified), the "MIDlet-Jar-Size" key in the JAD is updated when the task is finished.
tojarfile	file	no	The obfuscated target JAR file to create. Defaults to the source JAR file, if not specified.
bootclasspath	path	no	The bootclasspath is needed by the obfuscator. It defaults to the MIDP API contained in ${wtk.home}/lib/midpapi.zip, or ${wtk.midpapi}, if specified. Only for RetroGuard, the emptied-out MIDP API is used.
classpath	path	no	The classpath is needed by the obfuscator. If you use any external libraries other than the MIDP API itself, specify them here.
classpathref	string	no	A reference to a classpath defined elsewhere.
bootclasspathref	string	no	A reference to a bootclasspath defined elsewhere.
obfuscator	String	no	Allows to choose between ProGuard and RetroGuard, in case both obfuscators are present. Valid arguments are "proguard" and "retroguard". If this attribute is not specified, ProGuard is always preferred over RetroGuard.
if	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is defined.
unless	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is not defined.
verbose	boolean	no	Allows to set the verbosity of the task's output.

Preserve

Parameter	Type	Required	Purpose
class	string	yes	The fully qualified name of a class that should be neither obfuscated nor removed (if ProGuard is used and the class is not necessary).
if	String	no	Provides fine-grained control over the classes being preserved. The class will only be preserved if the given property is defined.
unless	String	no	Provides fine-grained control over the classes being preserved. The class will only be preserved if the given property is not defined.

Argument

Parameter	Type	Required	Purpose
value	string	yes	Specifies the argument to pass to the obfuscator.
if	String	no	Provides fine-grained control over the arguments. The argument will only be applied if the given property is defined.
unless	String	no	Provides fine-grained control over the arguments. The argument will only be applied if the given property is not defined.

SmartLink

1. It is one the main MIDlet classes, denoted by a MIDlet-# key in the JAD file.
2. It is a class to be loaded by name (on a Motorola phone), denoted by an iDEN-Install-Class-# key.
3. It is explicitly excluded from smartlinking using the <preserve> nested element.
4. It is needed (imported) by another class that is necessary.

The task provides the following parameters:

Parameter	Type	Required	Purpose
jarfile	file	yes	The name of the JAR file to optimize.
jadfile	file	yes	The name of the JAD file that accompanies the JAR file. If the source JAR file is overwritten (no "tojarfile" being specified), the "MIDlet-Jar-Size" key in the JAD is updated when the task is finished.
tojarfile	file	no	The name of the resulting, optimized JAR file. Defaults to the original JAR file, if not specified.
bootclasspath	path	no	Specifies the basic system classes that are needed by the application. Defaults to the MIDP API contained in ${wtk.home}/lib/midpapi.zip, or ${wtk.midpapi}, if specified.
classpath	path	no	Specifies additional libraries that are needed by the application, but not part of the JAR file (for example libraries that are already available on a certain phone).
classpathref	string	no	A reference to a classpath defined elsewhere.
bootclasspathref	string	no	A reference to a bootclasspath defined elsewhere.
if	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is defined.
unless	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is not defined.

Preserve

Parameter	Type	Required	Purpose
class	string	yes	The fully qualified name of a class that needs to be in the JAR file even if the smartlinking task thinks that it doesn't.
if	String	no	Provides fine-grained control over the classes being preserved. The class will only be preserved if the given property is defined.
unless	String	no	Provides fine-grained control over the classes being preserved. The class will only be preserved if the given property is not defined.

Preprocess

Preprocessing source files to manage implementation differences is quite unusual in Java programming. Actually it might be considered "evil technology" by OO purists. While the latter is somewhat true - interfaces, abstract classes and loading classes by name are definitely the cleaner approach - pure OO is something you often cannot afford when developing for devices that accept only JAR files up to 30 KB. A simple interface easily costs a kilobyte or more in the JAR. Loading implementation-specific classes by name usually gets in the way of obfuscation. A conditionally compiled block, on the other hand, costs absolutely nothing (apart, maybe, from a bit of pride, in case you consider yourself an OO purist, but isn't that a small price to pay for a MIDlet that works merrily on dozens of different mobile phones?).

Please note that the task only preprocesses the source files, but doesn't compile them. So you still have to run the Java compiler on the preprocessed files afterwards. Since the preprocessor doesn't filter "inactive" conditional parts by removing them, but by commenting them out instead, line numbers for compiler errors are usually the same as for the original code (unless you are using #include).

In addition to conditional compilation the preprocessor replaces Ant-style properties in the source-code.

The task provides the following parameters:

Parameter	Type	Required	Purpose
srcdir	file	yes	The source directory from which Java source files are being preprocessed.
destdir	file	yes	The destination directory to which preprocessed files are written.
newext	string	no	Specifies a new file extension for all files that have gone through the preprocessor. Useful when you save the files to preprocess with a special extension to distinguish them from normal Java files. The new extension replaces everything from (and including) the first dot in the filename up to the end, so when you specify newext=".java", a file "MyFile.j2me.pp" becomes "MyFile.java" once it goes through the peprocessor. If you don't specify this parameter, file extensions are not changed.
indent	boolean	no	Controls indentation of comments that the preprocessor writes into the target files. Defaults to true, which results in comments having the same indentation as the the original line. Setting it to false results in comments starting at the beginning of a line.
symbols	string	no	A comma-separated list of identifiers that are initially defined for each file the preprocessor is invoked on.
encoding	string	no	Specifies the encoding to use when reading or writing source files. Defaults to the platform default encoding, if not specified.
filter	boolean	no	When set to true, the preprocessor filters all directives and "inactive" conditional parts. The resulting file contains only the actual Java source code that goes into the compiler. Defaults to false.
verbose	boolean	no	Turn verbose output on or off.
if	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is defined.
unless	String	no	Provides fine-grained control over task execution based on a property definition. The task will only be executed if the given property is not defined.

The task forms an implicit FileSet, thus the usual "include", "exclude" etc. nested elements are used to specify the source files for preprocessing. The pattern "**/*.java" is included in this FileSet per default, so it is normally enough to specify the source and destination directories.

Directives

Directive	Decription
#define <identifier>	Defines an identifier, thus making its value "true" when it is referenced in further expressions.
#undefine <identifier>	Undefines an identifier, thus making its value "false" when it is referenced in further expressions.
#ifdef <identifier>	The following lines are compiled only if the given identifier is defined (or undefined, in the case of an "#ifndef" directive). "#else" does exactly what your think it does. Each directive must be ultimately closed by an "#endif" directive. The "#elifdef" and "#elifndef" directives help to specify longer conditional cascades without having to nest each level. The "#if" and "#elif" directives even allow to use complex expressions. These expressions are very much like Java boolean expressions. They may consist of identifiers, parentheses and the usual "&&", "||", "^", and "!" operators. Please note that "#ifdef" and "#ifndef" don't support complex expressions. They only expect a single argument - the symbol to be checked.
#ifndef <identifier>
#else
#endif
#elifdef <identifier>
#elifndef <identifier>
#if <expression>
#elif <expression>
#include <filename>	Includes the given source file at the current position. Must be terminated by "#endinclude" for technical reasons. The filename may also be given as an Ant-style property (${name}). The property needs to be defined in your build.xml file then. Note that relative file names are interpreted as relative to the build.xml file.
#endinclude

Deploy

RAPC

The WtkRapc task invokes the BlackBerry rapc compiler. It takes for input a list of .java files, or a JAR file, and generates a .cod file that can be loaded onto the BlackBerry handset.

This Ant task assumes the BlackBerry build tools are already installed and accessible.

Before using this task, you must define property bb.buildjars.home, which defines where to find the BlackBerry rapc compiler, for example:

    <property name="bb.buildjars.home" location="..."/>

To define the RAPC task, do as follows:

    <taskdef name="wtkrapc" classname="de.pleumann.antenna.WtkRapc" classpath="${buildjars.home}/antenna-bin-0.9.12a.jar"/>

The task provides the following parameters:

Parameter	Type	Required	Purpose
jadfile	file	yes	The name of the JAD file to use
source	file	yes	List of .java files or the name of the JAR file containing the input java classes.
codename	string	yes	The codename to for the generated .cod file.
import	file	yes	List of import libraries, such as the BlackBerry Java APIs.
destdir	file	yes	If specified, indicates the directory where to copy the JAD, ALX, and generated .cod file.
quiet	boolean	no	If specified, indicates to use the -quiet argument indicating rapc to use the quiet console output mode.
midlet	boolean	no	If specified, indicates to use the -midlet argument, indicating rapc to build a MIDlet and corresponding JAR.

Usage:

<target name="rapc" description="RIM COD Compiler" depends="jar">
    <wtkrapc jadfile="${jadfile}" source="${jarfile}" codename="${codename}" import="${bb.api.jar}" destdir="output/tocod/"/ quiet="true" midlet="false">
</target>

It is good practice to build your MIDP application using Antenna's steps WtkBuild and so on, which produces a JAR file, and input this JAR file into the RAPC step. This approach allows you to separate the generation of standard MIDlet and BlackBerry packaging.

*Note that the BlackBerry tools, such as RAPC, are only available on Microsoft Windows platforms.

History

Date	Version	Changes
XX-Jul-06	0.9.14	Okay, it's been a while. :-) But version 0.9.14 is finally out, mostly thanks to the help of Fred Grott. News are WTK support up to version 2.5 as well as support for several other toolkits.
29-Aug-04	0.9.13	Added support for WTK 2.2 beta (patch provided by Fred Grott). Added support for BlackBerry RAPC compiler (courtesy of Enrique Ortiz). IBM PalmOS PRC converter now uses jartoprc.exe instead of jad2prc.exe (fixed by Xiaodan Zhou). Added some new options to preprocessor (as requested by Steve Oldmeadow). Possibly some other fixes by people who are not mentioned here (sorry for that). The next release will feature an improved version of the preprocessor (sorry for still not having it integrated, Andre).
26-Jun-04	-	Number of downloads has passed the mark of 10000 last night.
25-Apr-04	0.9.12	A new release, finally. Don't know why it took so long to get this one out. Biggest news is WTK 2.1 and up-to-date WME compatibility. Fixed bugs in date formatting and file sorting of OTA servlet. Manifest can now go into the JAR in raw, unchanged form. Several fixes and optimizations in the preprocessor. Working directory is not set to $jdk/bin during preverification any longer. Obfuscators don't need to be in $jdk/bin or classpath any longer. Fixed a problem with JAD loading and empty lines. Classpath for preverifier is quoted if necessary. Credits for this version go to: Darryl L. Pierce, Kjell M. Myksvoll, Glenn Engel, Gabriela Chiribau, Tore Storødegård, Csaba Kertesz, Elliot Daniel Sumner, Guy Tomer, and Michael Van Meekeren.
02-Dec-03	-	Antenna has been covered in a J2ME article by (German) JavaSpektrum magazine.
08-Oct-03	0.9.11	Preprocessor correctly handles #include when a "blind part" is encountered (#775880). WtkObfuscate allows to choose between ProGuard and RetroGuard, if both are present (#780182). WtkJad allows to specifiy encoding for JAD file (#781486). All three thanks to Janusz Gregorczyk. Working directory set to "<JAVA_HOME>/bin" when calling preverifier. Might resolve strange preverification errors some users encountered (thanks to Frédéric Dubuisson). Allowed to turn off -cldc parameter during preverification (#789131) and shortened task definition to one line (both courtesy of Jim O'Leary). Fixed small problem with target attribute of WtkJad (#798831, thanks to Thiago Leão Moreira). Fixed two problems with the OTA servlet and the WAP template (both thanks to Werner Baumann). All tasks that support classpaths should also support references to classpaths now (as noted by Gyula Kun-Szabo). Added support for Websphere PRC converter and piped preverifer output to Ant console (as suggested by Michael Kroll). Encoding for preprocessor file access can be specified (patch by Yuri Magrisso). CreateXXX signatures now feature proper class of return value instead of Object (thanks to Edwin van Ouwerkerk Moria). Order of debugging parameters for emulator[.exe] changed. Sorry to those whose additions didn't make it into the new version, but after more than two months I wanted to have this version released. I'll consider your stuff for the next version - promised.
16-Jul-03	0.9.10	I've somewhat recovered from the "lost notebook" problem. The bad news is that I lost some (non-Antenna) code due to not doing backups regularly. The good news is that I now have a new and very cool ThinkPad. :) I tried to work through the collected mails this evening, incorporated fixes and produced a new version. We also have a project logo now, thanks to Steve Oldmeadow. Preserve element in WtkPackage now honors if/unless attributes. ProGuard now called with "-dontusemixedcaseclassnames" by default to avoid Problems under Windows (both thanks to Elmar Sonnenschein). Provided proper support for Ant's ZipFileSet et. al to fix bug #739447 (also mapped libclasspath feature on it, thus saving some code). Fixed stupid exception in preprocessor when including files. Allowed #include directive to interpret Ant-style properties (both thanks to Steve Oldmeadow, too).
15-Jun-03	-	Unfortunately, my Notebook has been stolen from my Office this week. :-( In addition to a number of uncommitted Antenna fixes I lost the e-mail of a whole month. Could all the people who mailed me regarding Antenna between 10-May-03 and 10-Jun-03 please send me these mails again (possibly including responses received from me)?
27-Jun-03	-	I have set up a mailing list for Antenna. The list address is "antenna at pleumann.de". Subscriptions are managed via "antenna-request at pleumann.de". Send a mail with subject "subscribe" to become a member. Due to ever-increasing spam problems and my unwillingness to delete dozens of garbage messages per day, posting requires list membership. External postings will be rejected automatically and without moderation. I will also provide a HTML list archive once I find the time.
18-Apr-03	0.9.9	Added support for "if" and "unless" parameters in all tasks and all nested elements (as suggested by Elmar Sonnenschein). Build script now compiles against current Ant version. JAD task has new parameter for specifying URL for later deployment. Various fixes and extensions to the pre- and postprocessing tasks (credits for all go to Jay Goldman). Replaced modifed MANIFEST.MF created by RetroGuard with original one to get rid of signing information (suggested by Kadocsa Tassonyi). Added deployment task and OTA servlet. BTW: Is anyone who's better at The GIMP than me willing to provide a logo for the project? Something like an ant with mobile phone or a satellite dish on its head...? :-)
31-Mar-03	0.9.8	Fixed typo in WtkRun which hindered remote debugging (thanks to Tyler Pitchford). Changed JAD/MANIFEST handling so that the properties copied from a JAD to a MANIFEST.MF are restricted to those explicitly allowed by the MIDP 2.0 specification (patch courtesy of Richard Kunze). Introduced new Ant properties to specify default BOOTCLASSPATH for all tasks. Fixed bug in WtkJad task where MANIFEST.MF was written to same file as JAD. Added possibilities to control extension and indentation of preprocessed files (suggested by Yuri Magrisso). Dropped "defaultpackage" option in favor of a generic way to pass proprietary arguments to obfuscators (suggestion by Janusz Gregorczyk). I also changed the CLASSPATH the preverifier is called with to cope with problems reported by several people. From now on, the emptied-out API is used only for RetroGuard. If there are still problems with preverification (or new ones, which I don't hope), please tell me!
09-Mar-03	0.9.7	Put quotes around file names passed to external Java and native tools to deal with spaces in paths (thanks to Robert Virkus, Janusz Gregorczyk, and again to Andras Salamon). Fixed naming problem in methods dealing with classpath references. Fixed problem with preverify task not deleting temporary directory. Obfuscator doesn't need to be in "${wtk.home}/bin" any longer - it can also be in CLASSPATH (suggested by Janusz Gregorczyk). Added remote debugging support to emulator task (suggested by Walter Chang), as well as trace options. Made preprocessor resistent to trailing whitespace or tabs.
12-Feb-03	0.9.6	Preverifier is now called with "-cldc" switch. Fixed a bug with copying temporary files that resulted in non-verified JARs (thanks to Doug Johnson and the students from CSE 403). Tasks now check if "wtk.home" points to proper WTK directory. Added "defaultpackage" option for ProGuard preverifier (as suggested by Andras Salamon). Post processing tasks now support "classpathref" and "bootclasspathref" attributes (via patch provided by Mat Trudel) and are able to update a JAD file automatically. Fixed several other bugs reported by users.
29-Dec-02	0.9.5	Removed some differences between documentation and implementation (aka bugs) of WtkPreprocess.
28-Dec-02	0.9.4	Added preprocessing task. Fixed a NPE problem in the SmartLink task (thanks to Chris Hyzer). Added support for showing stdout/stderr of emulated MIDlets (as suggested by Doug Johnson).
21-Dec-02	0.9.3	Added support for ProGuard obfuscator/optimizer. Used platform path separator where appropriate (thanks again to Andras). Improved error detection for external programs. Unified interface for smart linking and obfuscating.
15-Dec-02	0.9.2	Added task for smartlinking/optimizing a JAR file. And, yes, the supposed "source" ZIP file contained the classes only. :-) Thanks go to Andras Salamon for pointing this out.
07-Dec-02	0.9.1	Added tasks for JAD/MANIFEST handling and for calling the emulator. Renamed several elements, most notably WtkCompile to WtkBuild. Fixed lots of bugs and hopefully introduced not as many new ones. :-)
01-Dec-02	0.9.0	Initial public release.

Plan

• Improvements to the preprocessor (other variable types than boolean; complex expressions; properties in expressions).
• A task for signing MIDlets.
• Using Antenna with other SDKs (Nokia etc.) without the need for Sun's WTK.