This page describes how to use the Ant build.xml file to build the Magic Lantern IDE for the J2SE platform.

Table of Contents

• Linux Build Environment
  • Generate Ant build.xml Configurations
  • Top-level Build Instructions
  • Detailed Jar Build Instructions
• Windows Build Environment

Linux Build Environment

On Linux, make sure to install the ant libraries:

sudo apt update
sudo apt install ant ant-contrib

Generate Ant build.xml Configurations

These instructions use the Eclipse environment to build the Jars. Because Eclipse may be installed in different locations for individual, local development platforms, the build.xml file must first be created for the project. Use the Ant build.xml File Generation instructions to generate an Ant build configuration.

:information_source: Note: This must be done for each of the Java projects.

Top-level Build Instructions

A top-level build file can be found at $MLE_HOME/build/linux/build.xml.

Available targets include:

Main targets:

 build            Build all Java libraries
 build-actors     Buld actors.jar
 build-actorsdoc  Build actorsdoc.jar
 build-codegen    Buld codegen.jar
 build-doc        Build all Java library documentation
 build-math       Buid mlmath.jar
 build-mathdoc    Build mlmathdoc.jar
 build-mlert      Buld mlert.jar
 build-mlertdoc   Build mlertdoc.jar
 build-mrefs      Buld mrefs.jar
 build-mrefsdoc   Build mrefsdoc.jar
 build-parts      Buld parts.jar
 build-partsdoc   Build partsdoc.jar
 build-props      Buld props.jar
 build-propsdoc   Build propsdoc.jar
 build-roles      Buld roles.jar
 build-rolesdoc   Build rolesdoc.jar
 build-sets       Buld sets.jar
 build-setsdoc    Build setsdoc.jar
 build-stages     Buld stages.jar
 build-stagesdoc  Build stagesdoc.jar
 clean            Clean all Java libraries
 clean-actors     Delete actors.jar and actorsdoc.jar
 clean-codegen    Delete codegen.jar
 clean-math       Delete mlmath.jar and mlmathdoc.jar
 clean-mlert      Delete mlert.jar and mlertdoc.jar
 clean-mrefs      Delete mrefs.jar and mrefsdoc.jar
 clean-parts      Delete parts.jar and partsdoc.jar
 clean-props      Delete props.jar and propsdoc.jar
 clean-roles      Delete roles.jar and rolesdoc.jar
 clean-sets       Delete sets.jar and setsdoc.jar
 clean-stages     Delete stages.jar and stagesdoc.jar
 install          Build and install all Java libraries
 install-doc      Install all Java library documentation
 install-sdk      Build and install Java SDK libraries
 printenv         Display build environment
 uninstall        Delete all Java libraries
Default target: install

Detailed Jar Build Instructions.

Build com.wizzer.mle.math Jar

The following instructions will build the project, if necessary, and then create the mlmath.jar file in $MLE_HOME/lib/java/runtime.

cd $MLE_HOME/Core/math/java/com.wizzer.mle.math
ant create-jar

Build com.wizzer.mle.runtime Jar

The following instructions will build the project, if necessary, and then create the mlert.jar file in $MLE_HOME/lib/java/runtime.

cd $MLE_HOME/Core/mlert/java/com.wizzer.mle.runtime
ant create-jar

Build com.wizzer.mle.parts Jar

The following instructions will build the project, if necessary, and then create the parts.jar file in $MLE_HOME/lib/java/runtime.

cd $MLE_HOME/Parts/base/java/com.wizzer.mle.parts
ant create-jar

Build com.wizzer.mle.parts.actors Jar

The following instructions will build the project, if necessary, and then create the actors.jar file in $MLE_HOME/lib/java/runtime.

cd $MLE_HOME/Parts/actors/java/com.wizzer.mle.parts.actors
ant create-jar

Build com.wizzer.mle.parts.mrefs Jar

The following instructions will build the project, if necessary, and then create the mrefs.jar file in $MLE_HOME/lib/java/runtime.

cd $MLE_HOME/Parts/mediaref/java/com.wizzer.mle.parts.mrefs
ant create-jar

Build com.wizzer.mle.parts.props Jar

The following instructions will build the project, if necessary, and then create the props.jar file in $MLE_HOME/lib/java/runtime.

cd $MLE_HOME/Parts/props/java/com.wizzer.mle.parts.props
ant create-jar

Build com.wizzer.mle.parts.roles Jar

The following instructions will build the project, if necessary, and then create the roles.jar file in $MLE_HOME/lib/java/runtime.

cd $MLE_HOME/Parts/roles/java/com.wizzer.mle.parts.roles
ant create-jar

Build com.wizzer.mle.parts.sets Jar

The following instructions will build the project, if necessary, and then create the sets.jar file in $MLE_HOME/lib/java/runtime.

cd $MLE_HOME/Parts/sets/java/com.wizzer.mle.parts.sets
ant create-jar

Build com.wizzer.mle.parts.stages Jar

The following instructions will build the project, if necessary, and then create the stages.jar file in $MLE_HOME/lib/java/runtime.

cd $MLE_HOME/Parts/stages/java/com.wizzer.mle.parts.stages
ant create-jar

Windows Build Environment

TBD