Creating new MTJ projects

There are two wizards for creating MTJ projects:

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

• MTJ Project wizards.
  The MTJ Project must be used for all other Java ME profiles. 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.

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 stored 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 MTJ and choose one of the following:

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

• 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. 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 JavaME Library Addition window opens.### OPEN ISSUE <15>###
   
   

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.
  
  Note: When creating a project, you can select a smaller set of APIs than the targeted devices are supporting. By selecting the smallest possible set of needed APIs, you maximize the number of suitable devices. Although the project has a default device, the project's definitions can match several devices.

5. Click Next.
   The Java Settings window opens.
   
   
    

6. 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 new source 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 10

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 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. 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 Next.
   The Templates window opens.
   

9. 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 package in the source folder as a functional MIDP application.

10. Click Finish.
    You have now created an MTJ project. The project folder is displayed in the 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.

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 the Java Platform
Mobile SDKs
Mobile runtimes

Managing mobile SDKs
Creating your first MIDlet
Editing the JAD file

Wizards
JAD file