Skip Headers
Oracle® Java ME Embedded Getting Started Guide for the Windows Platform
Release 3.4
  Go To Table Of Contents
Go To Index


1 Before You Begin

The Oracle Java ME SDK 3.4 platform is a sophisticated and useful tool for programmers who want to develop embedded applications. The Oracle Java ME SDK 3.4 platform can be used successfully and easily with the NetBeans 7.3.1 Integrated Development Environment, as well as the Eclipse (Indigo 3.7, Juno 4.2, or Kepler 4.3) IDE.


The Oracle Java ME Embedded 3.4 runtime is fully implemented inside Oracle Java ME SDK 3.4 software. So, there is no need for you to independently install Oracle Java ME Embedded 3.4 software.

This chapter provides information you need to ensure that your Microsoft Windows XP (32-bit) or Windows 7 (32-bit or 64-bit) platform is correctly set up for working with Oracle Java ME SDK. Both Windows XP and Windows 7 must include the most recent Microsoft service packs.

Installing the Java SE Platform

To properly run the Oracle Java ME SDK software and its associated Tools, you must have Java Platform, Standard Edition (Java SE), Version 7, Update 25 (or later) installed on your computer.

This guide assumes you have already installed the Java SE platform. If you have not installed Java 7, Update 25, you can download it from the following location:

The installation of Eclipse Indigo 3.7 requires Java 6, Update 17 as the reference platform. It may work with other Java versions, but it is not recommended by Eclipse. To get Java 6, Update 17:

The Java SE platform must also be in your PATH.

Setting and Verifying Your Java SE PATH

To verify if Java SE platform is set in your PATH:

  1. In the Windows command line, type:

    C:\>echo %PATH%

  2. If Java SE is properly installed, you see a path to the default installation directory:

    C:\>Program Files\Java\jdk1.7.0_x

  3. If not, you need to add Java SE to your PATH.


    Setting the PATH may require using a Windows short name. To see top-level Windows short names, type C:\>dir /x

  4. Set the Java SE variable, JDK_DIR:

    C:\>set JDK_DIR=C:\Program Files\Java\jdk1.7.0_25

  5. Add JDK_DIR to your PATH:

    C:\>set PATH=%PATH%;%JDK_DIR%\bin

  6. To verify the version of your Java SE platform, type:

    C\:>java -version

The version number shown in the output should be version 1.7.0_25 or higher.

Installing the Oracle Java ME SDK Platform

Follow these steps to install the Oracle Java ME SDK 3.4.

  1. If you have previously installed an earlier version of Oracle Java ME SDK, uninstall the previous version as shown below.


    If you are installing Oracle Java ME SDK for the first time, skip to Step 2.

    • If you have Oracle Java ME SDK data to save, copy it to a safe location before continuing.

    • In the Windows system tray, right click the emulator icon and choose Exit.

    • From the Windows Programs menu, select the previous version and choose Uninstall from the submenu. The Installer opens.

    • On the first page check the option to remove the user data directory.

    • Follow the prompts.

  2. Download the SDK from:

  3. Double-click the executable. When the installer starts, follow the prompts.

Installing and the Starting the NetBeans IDE

If you do not already have the NetBeans 7.3.1 IDE installed on your system, you can download it here:

Once you have downloaded the NetBeans installation module, do the following.

  1. Double click the NetBeans executable file, netbeans-7.3.1-windows.exe.

  2. When the NetBeans Installer starts, follow the prompts.

    When the installation is complete, NetBeans creates a shortcut on your desktop.

  3. Double click the NetBeans IDE 7.3.1 shortcut to launch NetBeans.

Figure 1-1 The NetBeans Start Screen

Description of Figure 1-1 follows
Description of "Figure 1-1 The NetBeans Start Screen"


Oracle Java ME SDK 3.4 also supports NetBeans 7.4 Beta. However, its use is not described in this guide.

For more information on working with the NetBeans IDE, see

Installing and Starting the Eclipse IDE

If you do not already have Eclipse Indigo 3.7 installed on your system, you can download it here:

You can download Juno 4.2 here:

You can download Kepler 4.3 here:

Once you have downloaded the Eclipse Kepler 4.3 executable, eclipse-java-kepler-ga-offline-installer-windows.exe, double-click -it to start running and follow the prompts.


For Eclipse Kepler, you must also specify a directory location in which to store your Eclipse project files, as shown in Step 3, below.

For the Eclipse Indigo 3.7 or Juno 4.2 installation modules, do the following to install Eclipse on your system:

  1. In the C:\Program Files directory, unzip the Eclipse distribution zip file.

  2. In the C:\Program Files\eclipse directory, click eclipse.exe to launch Eclipse.

  3. When the Select a Workspace dialog box appears, specify a directory location in which to store your Eclipse project files. Click OK.

    Figure 1-2 The Eclipse Workspace Launcher

    Description of Figure 1-2 follows
    Description of "Figure 1-2 The Eclipse Workspace Launcher"

    This opens the Eclipse main screen, as shown in Figure 1-3.


    Eclipse Kepler 4.3 is similar to Juno 4.2 and Eclipse 3.7. The instructions you see for those versions in this guide also apply to Kepler 4.3.

    Figure 1-3 The Eclipse Start Screen

    Description of Figure 1-3 follows
    Description of "Figure 1-3 The Eclipse Start Screen"

  4. Click the icon on the far right (it says "Workbench"). This displays an empty workbench screen, as shown in Figure 1-4.

    Figure 1-4 The Eclipse Workbench Start Screen

    Description of Figure 1-4 follows
    Description of "Figure 1-4 The Eclipse Workbench Start Screen"

For more information on working with the Eclipse IDE, see

Verifying the UART Prefix

Lastly, verify that the deviceaccess.uart.prefix property in the jwc_properties.ini file contains a prefix that will make it easy to convert the UARTConfig.portNumber value to a platform-specific port name. This is used for COM port discovering.


If you are planning to work only in emulation, you can skip this step.

In the Win32 environment, the property should be set to COM so that appending a port number maps correctly to the proper port name. Add the following line to the jwc_properties.ini file:


The jwc_properties.ini file is found in the following location: