Creating new MTJ projects

###OPEN ISSUE <15>###

There are two wizards for creating MTJ projects:

• Java ME Project
  The Java ME Project must be used for all Java ME profiles other than MIDP profile. The Java ME Projects are extensions of an Eclipse Java project. Additional resources include the mtj.project file, which is a control file that points to the SDK libraries. This file must not be edited.

• Midlet Project
  The MTJ Midlet Project creates resources that are required to define a MIDlet. The project includes a xxx.jad file (xxx is the project name). This file is the Java Application Descriptor file defined in the MIDP specification.

Note: When creating an MTJ project, you also define the mobile runtime for the project. To do this, you need to have the desired mobile SDK installed on your computer.

To create a new  MTJ project

1. In the menu bar, select File -> New -> Project.
   New Project wizard opens with the Select a wizard window.
   
   
    

2. Expand Mobile Tools for the Java Platform and choose one of the following:

• If you want to create a Java ME project using a profile other than the MIDP, select Java ME Project and click Next.
  The MTJ Project window opens.

• f you want to create a MIDlet Project, select Midlet Project and click Next.
  The MTJ Midlet Project Creation window opens.
  
   

3. Define project details:
1. In the Project name field, enter a name for the project.
2. In the Project contents field, if you do no want to create the project in the default directory, clear the Use default box and browse for a new location.
3. Click Next.
   The MTJ Java ME Library Addition window opens.
   
   
4. To select the mobile runtime for the platform, in the Select Runtime Platform field select one of the following:
• If you want to create a new runtime platform, select New Runtime Platform.
  The Add Runtime Platform window opens.
  Note: In the Add Runtime Platform window, you can import and activate mobile SDKs to MTJ as the device platforms. The active device platform is represented by the checked box next to the name of the SDK.

• If you want to select an existing runtime platform, choose the platform from the drop-down menu in the MTJ JavaME Library Addition window.

5. Click Next.
   The Java Settings window opens.
   
   
    

6. To define the Java settings:
1. In the Source tab, the system displays the default source folder and output folder. You can edit these by selecting Add Folder, Remove or Browse.
2. If you want to add your own JAR files, libraries or class folders, select the Libraries tab and add the desired components.
3. If you are creating a MIDlet, click Next.
   The Configure Midlet Suite window opens.
   If you are not creating a MIDlet, click Next, select the template if necessary and continue from Step 10 in this step list.

7. In the Configure Midlet Suite window, define the following properties for the JAD file:
• MIDlet JAR name
  This is the JAR file name of this application.
• MIDlet suite name
  This is the name that identifies the MIDlet suite to the user.
• Vendor name
  This is the name of the organization that provides the MIDlet suite.
• Version
  This is the version number of the MIDlet suite. The format is <major>.<minor>.<micro> as described in the Java Product Versioning Specification. The Java ME container can use this for install and upgrade purposes, as well as for communication with the user.
• Profile
  This is the Java ME profile used by this MIDlet suite.
• Configuration
  This is the Java ME Configuration (CLDC version) used by this MIDlet suite.

8. Click Next.
   The Templates window opens.
   

9. MTJ provides one example template, the Hello_World_MIDP.
   If you want to create a functioning Java ME project from template, check the box next to Use template to create Java ME project and select the template from the list.
   The system creates a functioning Java ME project into your workspace, with the chosen template's MIDP code in the source folder.

10. Click Finish.
    You have now created an MTJ project. The project folder is displayed in the Eclipse's Package Explorer view.
     

11. In Package Explorer view, expand the project folder.
    
    The project folder displays the contents of the project. These include the chosen runtime library, the optional separate source folder, the project folder, the optional MIDP package and the JAD file.

Mobile Tools for the Java Platform
Mobile SDKs
Mobile runtimes

Managing mobile SDKs
Creating your first MIDlet
Editing the JAD file

Wizards
JAD file