Setting up the Environment

 

Ant

For programming, the JMap 6.5 SDK uses Ant to perform various tasks using scripts. Ant can be downloaded from http://ant.apache.org.

When used from Eclipse, Ant may be unable to find the Java compiler in order to compile classes. In such a case, you must add a reference to the tools.jar library provided with the Java JDK in the Ant configuration. For more information, refer to this article: http://wiki.eclipse.org/FAQ_Why_can't_my_Ant_build_find_javac%3F.

Eclipse

Eclipse is the preferred Java development environment for JMap. It can be downloaded from this address: http://www.eclipse.org. However, it is quite possible to develop JMap applications using the environment and tools of your choice. The following information applies to the Eclipse Luna (version 4.4) environment.

Integrate JMap 6.5 SDK as an Eclipse project

To simplify development, it is recommended to integrate the JMap 6.5 SDK as an Eclipse project. Your development should be in projects that are separate from the SDK to keep it intact as a source of reference.

 

Step 1

In an Eclipse worskpace (existing or new), create a Java project for the JMap 6.5 SDK.

File -> New -> Java Project

 

Step 2

Select the path of the JMap 6.5 SDK that was specified when it was installed. To do this, you must disable the Use default location option to let Eclipse browse a folder outside of the current workspace. The project name is set automatically when the folder is selected. Press Finish.

 

 

Create a new project

To start new development work using the JMap 6.5 SDK (such as creating a new JMap extension), it is recommended to create separate projects. Each new project should point to the libraries distributed with the SDK to allow for compilation. The example below shows how to create a new JMap project.

 

Step 1

In the same Eclipse workspace containing the project for the JMap 6.5 SDK, create a new Java project.

File -> New -> Java Project

 

Step 2

Give your project a name then press Next.

 

Step 3

Select the Projects tab and press Add....

 

Step 4

Select the JMap SDK project. All of the SDK's libraries will become available for your project. Press OK.

Step 5

Press Finish.