Creating new MTJ projects

There are two wizards for creating MTJ projects: MTJ Midlet Project and MTJ Project wizards.

The MTJ Midlet Project creates resources that are required to define a MIDlet. The MTJ Project must be used for any other Java ME profile choice.

The MTJ 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. That file must not be edited.

The MTJ Midlet Project also includes a xxx.jad file (xxx is the project name). This file is the Java Application Descriptor file defined in the MIDP specification.

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 MTJ and:

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

OR

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

3. In the Project name field, enter a name for the project.

4. In the Project contents field, if you do no want to create the project in the default directory, uncheck the Use default box and browse for a new location.

5. Click Next.
   The MTJ JavaME Library Addition window opens.### OPEN ISSUE <15>###
   
   
    

6. To select the Java runtime for the platform, in the Select Runtime Platform field:

• 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 ticked box next to the name of the SDK.
  
  

OR

• If you want to select an existing runtime platform, choose the platform from the drop-down menu in the Add Runtime Platform window
  
  Note: When creating a project, you can select smaller set of APIs that the targeted devices are supporting. By selecting smallest possible set of needed APIs, the number of suitable devices is bigger. Although the project has the default device, the project's definitions can match to several devices.

7. Click Next.
   The Java Settings window opens.
   
   
    

8. To define the Java settings:

1. To define the source folders on build path, select the Source tab, and click Add Folder. In the New Source Folder window, add a source new folder and click OK.
2. To add required projects on the build path, select the Projects tab, and click Add. In the Required Project Selection window, select the projects to be added and click OK.

Note: Only the projects from your current workspace are listed.

3. If you want to add JAR files, libraries or class folders, select the Libraries tab and add the desired components.
4. If you want to define the order and export settings for the Java libraries, select the Order and Export tab and check the boxes of those libraries you want to define the settings for. Exported entries are contributed to dependent projects.
5. If you are creating a MIDlet, click Next.
   The Configure Midlet Suite window opens.
   If you are not creating a MIDlet, continue from Step 9.

9. 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 MIDlet.
• MIDlet suite name
  This is the name of the MIDlet suite that identifies the MIDlets to the user.
• Vendor name
  This is the name of the organization that provides the MIDlet.
• 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 required by this MIDlet suite. As with the Microedition Configuration, the contents of this drop-down menu depend on the profile versions supported by the Wireless Toolkit that you are using for this project.
• Configuration
  This is the Java ME Configuration (CLDC version) required by this MIDlet suite. The contents of this drop-down menu depend on the CLDC versions supported by the Wireless Toolkit that you are using for this project.

Note:You can edit the JAD file at a later point in more detail, using the Application Descriptor Editor.

8. Click Finish.
   You have now created a MTJ project. The project folder is displayed in the Package Explorer view.

9. 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 and the JAD file.

Tip: You can import existing Java ME projects into the MTJ workspace, and convert them into MTJ projects by right-clicking the desired project in the Package Explorer and selecting Convert to MTJ Project.### OPEN ISSUE <15>###

Mobile Tools for Java Platform
Mobile SDKs
Mobile runtimes

Managing mobile SDKs
Creating your first MIDlet
Editing the JAD file

Wizards
JAD file