Home    Documentation   Download ZIP file

Compilation Instructions

The NXT BTControl project was developed with the NetBeans IDE, and you should use this environment as well, if you have it available or can install it on your computer. Alternatively, you can install Apache ANT to compile the source from a command line window.

NetBeans

Use/install version 6.7.1 or later of NetBeans. The standard version without any additional plugins should suffice, but you may contemplate adding the SVN plugin if you intend to directly access the source control mechanism of this project. Otherwise, using the source file distribution is all you need.

  1. Download the latest source ZIP file and extract it to a convenient place, or get the source from the SVN repository;
  2. Startup NetBeans;
  3. Open the "Tools" - "Java Platforms" window;
  4. Locate the "J2SE" platform your IDE is using, select it and find the base directory of the J2SE SDK installation on the right side of the window. For example C:\Program Files\Java\jdk1.6.0;
  5. Copy the JAR files mentioned in the dependencies page: bluecove-2.1.0.jar and Joystick.jar from the libs directory to the directory C:\Program Files\Java\jdk1.6.0\jre\lib\ext. This will make the classes in these files visible to the Java compiler. You will have to do this only once;
  6. After this step you should stop and restart the IDE so it can refresh its JAR library cache;
  7. Use the "Open Project" dialog to choose the top-level directory of the extracted ZIP file;
  8. Select the "Build Project" action to compile all code and create a ZIP distribution file;

Apache ANT

Make sure you install ANT version 1.7.1 or later, in order to parse the build XML file, correctly. You will also need a J2SE SDK installation for version 5 or higher, preferrably SDK 6.

  1. Download the latest source ZIP file and extract it to a convenient place;
  2. Locate the installation directory for the J2SE JDK, for example C:\Program Files\Java\jdk1.6.0;
  3. Copy the JAR files mentioned in the dependencies page: bluecove-2.1.0.jar and Joystick.jar from the libs directory to the SDK directory C:\Program Files\Java\jdk1.6.0\jre\lib\ext. This will make the classes in these files visible to the Java compiler. You will have to do this only once;
  4. Open a command window and set the directory to the base of the extracted ZIP file;
  5. Run the "ant jar" command to compile all code, create the JAR file and the distribution ZIP file;


Last modified: Thu Dec 17 20:40:34 Eastern Standard Time 2009