2 Setting Up the Development Environment

There are no hardware limitations for installing and running Oracle Java ME SDK as long as all software requirements are met.

The following table lists the software requirements for installing Oracle Java ME SDK 8.3.

It is possible to run several instances of Java ME SDK, but you may want to remove previous versions when installing a new one.

The Java Platform, Standard Edition (Java SE) Development Kit (JDK) includes a complete Java Runtime Environment (JRE) and tools for developing, debugging, and monitoring Java applications. As an implementation of the Java SE platform, the JDK is required for alignment of Java ME Embedded features and APIs through a unified development model.

Oracle Java ME SDK 8.3 requires JDK 8 with the latest updates.

To install the JDK:

For information about installing the JDK, refer to the Java Platform, Standard Edition Installation Guide at

http://docs.oracle.com/javase/8/docs/technotes/guides/install

The base Oracle Java ME SDK 8.3 package includes a set of tools for developing Java ME Embedded applications, and the Java ME Embedded 8.3 runtime as a device emulation environment for Windows and Linux.

NetBeans IDE is a free and open source integrated development environment (IDE) that facilitates the development of Java applications. Oracle Java ME SDK plug-ins for NetBeans IDE enable all features to be used from within the IDE.

NetBeans IDE 8.1 or later is required if you want to use the Oracle Java ME SDK plug-ins.

To install NetBeans IDE 8.1:

After you install NetBeans IDE, start it and check for updates. If updates are available, a corresponding indicator will be available in the status bar at the bottom right of the main window. To start the check manually, open the Help menu and select Check for Updates.

For detailed information about installing NetBeans IDE, refer to the installation instructions page at

https://netbeans.org/community/releases/80/install.html

Plug-ins for NetBeans IDE enable all features of Oracle Java ME SDK to be used from within the IDE.

Oracle Java ME SDK 8.3 provides the following plug-ins for working with NetBeans IDE 8.1:

• Java ME SDK Tools: Integrates the Oracle Java ME SDK tools into the IDE.

• Java ME SDK Demos: Provides demo Java ME Embedded applications.

The Oracle Java ME SDK plug-ins for NetBeans IDE are distributed as NetBeans module (NBM) files in a ZIP archive. The NBM files are recognized by the NetBeans Plugin Manager. You can configure the Plugin Manager to automatically install the plug-ins by pointing it to the updates.xml file that is available in the archive.

To install the Oracle Java ME SDK plug-ins for NetBeans IDE:

1. Download the ZIP archive with the Java ME SDK plug-ins at

   http://www.oracle.com/technetwork/java/javame/javamobile/download/sdk

   Note:

   You must accept the Oracle Technology Network (OTN) License Agreement to download this software.

2. Extract the ZIP archive with the plug-ins to a directory on your computer.

3. Start NetBeans IDE, open the Tools menu, and select Plugins.

4. If you have a previous version of the Java ME SDK plug-ins installed, remove them as follows:

   1. On the Installed tab, select Show Details (if available), then select Java ME SDK Tools and Java ME SDK Demos in the list, and click Uninstall.

   2. Follow the steps in the NetBeans IDE Installer Wizard. On the last step of the wizard, select to restart NetBeans IDE now, and click Finish.

5. When NetBeans IDE restarts, open the Tools menu, select Plugins, and add an update center for Java ME SDK plug-ins as follows:

   1. On the Settings tab, click Add.

   2. In the Name field, enter Java ME SDK Plug-ins Update Center.

   3. Select Check for updates automatically.

   4. In the URL field, use the file uniform resource locator (URL) scheme to point to the location where you extracted the Java ME SDK plug-ins, for example:

      file:///C:/My_Update_Center_Plugins/updates.xml
      

   5. Click OK.

   6. Ensure that the Java ME SDK Plug-ins Update Center is active by selecting the corresponding check box in the list on the Settings tab.

6. Install the Java ME SDK plug-ins as follows:

   1. On the Available Plugins tab, select Java ME SDK Tools and Java ME SDK Demos in the list, and click Install. The two plug-ins are in the Java ME SDK Tools category.

   2. Follow the steps in the NetBeans IDE Installer Wizard. On the last step of the wizard, select to restart NetBeans IDE now, and click Finish.

   Note:

   If the Java ME SDK plug-ins are not in the list on the Available Plugins tab, it is likely that you specified the wrong URL to the updates.xml file in the update center.

   If you are not able to get the Plugins Manager to recognize the Java ME SDK plug-ins, install them manually. To install the plug-ins manually:

   1. On the Downloaded tab, click Add Plugins.

   2. Browse to the directory where you extracted the archive with the Java ME SDK plug-ins, select all NBM files and click Open.

   3. Follow the steps of the NetBeans IDE Installer Wizard. On the last step of the wizard, select to restart NetBeans IDE now, and click Finish.

7. When NetBeans IDE restarts, open the Tools menu, select Plugins, and verify that the Java ME SDK plug-ins are active as follows:

   1. On the Installed tab, select Show Details (if available), then find the Java ME SDK Tools and Java ME SDK Demos plug-ins in the list. If they are not active, then select them and click Activate.

   2. When the Java ME SDK plug-ins are active, click Close to close the Plugins window.

If the plug-ins were installed successfully, the Java ME SDK Start Page tab should be open in NetBeans IDE. To view this tab, select Java ME SDK Start Page on the Help menu.

Eclipse IDE is a free and open source integrated development environment (IDE) that facilitates the development of Java applications. Oracle Java ME SDK plug-ins for Eclipse IDE enable all features to be used from within the IDE.

Eclipse IDE 4.5 or later is required if you want to use the Oracle Java ME SDK plug-ins.

To install Eclipse IDE 4.5:

For detailed information about installing Eclipse IDE, refer to the installation instructions page at

https://wiki.eclipse.org/Eclipse/Installation

Plug-ins for Eclipse IDE enable all features of Oracle Java ME SDK to be used from within the IDE.

Oracle Java ME SDK 8.3 provides the following plug-ins for working with Eclipse IDE 4.5:

• Java ME SDK Tools: Integrates the Oracle Java ME SDK tools into the IDE.

• Java ME SDK Demos: Provides demo Java ME Embedded applications.

Note that to use the Java ME SDK plug-ins, you must run Eclipse IDE on top on GTK2 rather than the default GTK3.

The Java ME SDK plug-ins are distributed as JAR files archived inside a ZIP file. The JAR files contain platform extensions for Eclipse IDE that are recognized by the Install New Software Wizard.

In order to install the Java ME SDK plug-ins, you need the Mobile Tools for Java (MTJ) extensions. They are also distributed as JAR files, but in a separate ZIP file. When you install the Java ME SDK plug-ins, MTJ extensions should install automatically. However, you can download and install them separately. For more information, see Installing Mobile Tools for Java Extensions.

To install the Java ME SDK plug-ins for Eclipse IDE:

1. Download the ZIP files with the Java ME SDK plug-ins from

   http://www.oracle.com/technetwork/java/javame/javamobile/download/sdk

   Note:

   You must accept the Oracle Technology Network (OTN) License Agreement to download this software.

2. Start Eclipse IDE and uninstall the previous versions of Java ME SDK plug-ins as follows:

   1. Open the Help menu and click Installation Details.

   2. On the Installed Software tab, select Java ME SDK Tools, and Java ME SDK Demos in the list, and click Uninstall.

   3. On the Uninstall Details window, click Finish.

   4. When prompted, click Yes to restart Eclipse IDE.

3. Install the Java ME SDK plug-ins as follows:

   1. Open the Help menu and select Install New Software.

   2. At the top of the Available Software window, click Add.

   3. In the Add Repository dialog, click Archive.

   4. In the file-system explorer window, browse to the ZIP file with the Java ME SDK plug-ins and click Open.

   5. In the Add Repository dialog, click OK.

   6. On the Available Software window, select Java ME SDK Tools and Java ME SDK Demos in the list, and click Next.

   7. On the Install Details window, click Next.

   8. Accept the terms of the license agreement and click Finish.

   9. When the installation process completes, restart Eclipse IDE.

When you start Eclipse IDE, to develop Java ME Embedded applications, activate the Java ME perspective as follows:

1. Open the Window menu, select Perspective, select Open Perspective, then Other.

2. In the Open Perspective window, select Java ME and click OK.

To use the Java ME SDK plug-ins for Eclipse IDE on Linux platform, you must install the WebKit engine for GTK+. The version of the WebKit must be compatible with the GTK+ library used to render Eclipse IDE.

E.g., on Ubuntu 15.10, download WebKit 1.0-0 and perform the following command:

sudo apt-get install libwebkitgtk-1.0-0

Note that only Eclipse rendered by GTK2 is currently supported. To enable running Eclipse IDE on top of GTK2, set the SWT_GTK3 environment variable to 0.

E.g., on Ubuntu 15.10, use the following command:

export SWT_GTK3=0

When you install the Java ME SDK plug-ins, Mobile Tools for Java (MTJ) extensions should install automatically. However, you can download and install them separately as follows:

1. Download the ZIP file with the MTJ 2.0.1 extensions from

   http://www.eclipse.org/mtj/

2. Start Eclipse IDE and uninstall the previous versions of MTJ extensions as follows:

   1. Open the Help menu and click Installation Details.

   2. On the Installed Software tab, select Mobile Tools for Java, and click Uninstall.

   3. On the Uninstall Details window, click Finish.

   4. When prompted, click Yes to restart Eclipse IDE.

3. Install the MTJ plug-ins as follows:

   1. Open the Help menu and select Install New Software.

   2. At the top of the Available Software window, click Add.

   3. In the Add Repository dialog, click Archive.

   4. In the file-system explorer window, browse to the ZIP file with the MTJ plug-ins and click Open.

   5. In the Add Repository dialog, click OK.

   6. On the Available Software window, select Mobile Tools for Java in the list, and click Next.

   7. On the Install Details window, click Next.

   8. Accept the terms of the license agreement and click Finish.

   9. When the installation process completes, restart Eclipse IDE.

Oracle Java ME SDK supports JSR 177 Security and Trust Services APIs. If you want to work with the APDU emulation, you must download and install JavaCard SDK 2.2.1 from

http://www.oracle.com/technetwork/java/embedded/javacard/downloads/index.html

You need only JavaCard emulator (cref.exe) to enable APDU emulation in Java ME SDK 8.3.