FAQ

Is the original reversi midlet available?

No, it is not currently available. A midlet based on the strategy game framework may see the light of day at some point though.

How do I build the code?

To build the code you require:

• J2SE 1.5.0 or higher - the Java 2 platform, standard edition.
• Ant 1.6 or higher - the de facto build tool for Java projects.

To run the unit tests you require:

• JUnit 3.8.1 or higher - a popular, simple framework to write repeatable tests.

To optionally shrink/optimise/obfuscate the compiled code (which is particularly useful for applets and midlets) you require:

• ProGuard 3.0 or higher - an excellent Java shrinker/optimiser/obfuscator which operates on the byte code (not the source code).

Unpack the source code into a directory then edit ant.properties in the root directory making sure that the junit-jar and proguard-jar properties point to the correct locations for the JUnit and ProGuard jars.

Each project directory has its own build file and can be built separately, or the root build file can be used to build the lot. To build the complete source, execute:

• ant build

or just simply:

• ant

from the root of the directory where the source was unpacked, which calls the build target for each project in the correct order.

The useful Ant targets defined in the root build file are:

• clean: removes all the directories created by other targets.
• build: compiles the code in each subdirectory in the correct order.
• doc: generates javadocs for the complete source excluding the unit tests.
• alldoc: generates javadocs for the complete source including the unit tests.

The useful Ant targets defined in each of the project build files are:

• clean: removes all the directories created by other targets.
• build: builds the console app and the applet.
• build-console-app: compiles the code for the console application.
• run-console-app: launches the console application from Ant.
• build-applet: compiles the code and builds a distribution jar file for the applet.
• doc: generates javadocs for the project excluding the unit tests.
• alldoc: generates javadocs for the project including the unit tests.
• test: runs the unit tests for the project.

The reversi and connect4 projects include an obfuscate target, which slims down the applet distribution, minimising the size of the binary:

• obfuscate: shrink and obfuscate the distribution