3 Installation and Configuration Directories
When using Oracle Java ME SDK, you need to understand the structure of directories that are installed. Knowing the location of specific files can help you with troubleshooting, maintenance, and advanced configuration.
You can run Oracle Java ME SDK from different user accounts on the host machine. This feature is called Multiple User Environment (MUE). MUE does not support multiple users accessing Oracle Java ME SDK simultaneously. When you switch users, you must close Oracle Java ME SDK and exit the Device Manager. A different user can then start Oracle Java ME SDK as the owner of all processes.
During installation of Oracle Java ME SDK, a user-specified location is used as the main distribution directory, where various executable, source, and documentation files reside. A separate location, which is fixed relative to the user's home directory, is used for setup, configuration, and log files.
The following sections describe the structure of each directory:
3.1 The Oracle Java ME SDK Installation Directory Structure
The location of the Oracle Java ME SDK installation directory is specified by the user during the installation process. This directory is referred to as JAVAME_SDK_HOME. By default, Oracle Java ME SDK 8.2 is installed to the C:\Program Files\Java_ME_platform_SDK_8.2 directory on Windows and to ~/Java_ME_platform_SDK_8.2. on Linux.
The Oracle Java ME SDK installation directory structure conforms to the Unified Emulator Interface (UEI) Specification version 1.0.2 available at
http://www.oracle.com/technetwork/java/javame/documentation/ueispecs-187994.pdf
This structure is recognized by all IDEs and other tools that work with the UEI.
The root of the JAVAME_SDK_HOME directory contains the remove.exe file on Windows (remove.sh - on Linux) that starts the Java ME SDK Installer Wizard for removing Oracle Java ME SDK. It also contains subdirectories listed in Table 3-1.
Table 3-1 The Structure of the Oracle Java ME SDK Installation Directory
| Folder | Description |
|---|---|
|
|
Contains executable files and dynamic-link libraries for running various Oracle Java ME SDK utilities |
|
|
Contains documentation for standard JSR APIs and Oracle APIs supported by Oracle Java ME SDK |
|
|
Contains runtime binaries that can be flashed to a device. |
|
|
Contains a text file with legal information about third-party software |
|
|
Contains JAR files with standard JSR APIs and Oracle APIs required for compilation of Java ME Embedded applications |
|
|
Contains the Java ME Embedded Profile (MEEP) runtime files |
|
|
Contains files for configuration and definition of devices and UI elements, executable and configuration files for the Device Manager and other Oracle Java ME SDK services and utilities |
3.2 The Oracle Java ME SDK Configuration Directory Structure
The location of the Oracle Java ME SDK configuration directory is relative to the user's home directory. This location is referred to as JAVAME_SDK_USER. The Oracle Java ME SDK 8.2 configuration directory is located in the <user.home>\.javame-sdk\8.2 directory. If you delete this directory, it is re-created automatically when the Device Manager is restarted.
The root of the JAVAME_SDK_USER directory is used for temporary lock files and the rmi-registry.port file that defines the remote method invocation (RMI) registry port number. It also contains subdirectories listed in Table 3-2.
Table 3-2 The Structure of the Oracle Java ME SDK Configuration Directory
| Folder | Description |
|---|---|
|
|
Contains information about the devices detected by the Device Connections Manager |
|
|
Contains cached Oracle Java ME SDK help pages (for NetBeans IDE plug-ins, Eclipse IDE plug-ins, and the Java ME Embedded Emulator) |
|
|
Contains log files of all Oracle Java ME SDK tools (such as Device Manager, Device Selector, Custom Device Editor, and so on) |
|
|
Contains downloaded updates for Oracle Java ME SDK |
|
|
Contains folders with configuration and log files for all connected devices (both emulated and real devices) |
