Creating new MTJ projects

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.
  
  Note: If you are creating this type of a project and you select to use the template that is provided (see step 9 below), confirm that the SDK you are using supports Java ME Personal Profile.

• 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.
   

• If 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. 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 Java ME Runtime Platform 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, in the Configure Runtime Platforms field, select Window -> Preferences> Mobile Tools for the Java Platform > Runtime Platform.
  The Preferences (filtered) window opens with the Runtime Platform pane.
  Note: In the Runtime Platform pane, you can import and activate mobile SDKs to MTJ as the runtime platforms. The active runtime platforms are listed in the Runtime Platforms field..

• If you want to select an existing runtime platform, choose the platform from the drop-down menu.

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, for MIDP projects and one example template, the Hello_World_PPRO, which is for Personal Profile projects.
   Note: Hello_World_PPRO template is for Personal Profile and requires that the SDK with Personal Profile support is defined for the project.
   If you want to create a functioning 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 project into your workspace, with the chosen template's 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. the res folder for resources 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