ACCESS Developer Network | Running Java MIDlets | Java, Application, Device, Select, Applications

The ACCESS Linux Platform support for Java MIDlets enables users to download a range of Java applications including games to their mobile device.

User Installation of Java Applications ^TOP^

The following sections describe the steps the user needs to perform to install Java applications on an device running ACCESS Linux Platform.

Download from Web to Device ^TOP^

You can download Java applications from a website using the ACCESS Linux Platform browser.

NOTE: Download only those Java applications that conform to the Java MIDP 2.0/CLDC 1.1 specifications.

Prior to performing a Browser download, you need to establish your Internet connection methods. Use the Connections panel in Settings to set up your Internet connection method.

To download a Java application using the Browser

Select the Browser application from the Launcher.

Figure 3.1 Select Browser

Navigate to the website containing the Java applications you want to download to your mobile device. The Browser displays a dialog where you can enter the website URL.

Figure 3.2 Navigate to Web Site

Once you enter the website URL, select OK.
1. If you want to open the website in a new window, select the check box for "Open in New Window"
The Browser displays the Connecting dialog and displays the website. If you have not established a method of connection, it may run through the following dialogs:
1. Select the Allow button to connect. If you do not want to download the Java application, select the Reject button.
2. The Browser displays a Connecting dialog indicating the method of connection.
3. Select the Cancel button to end the connection and stop the download.
When the website page is downloaded to the Browser, select the Java application or Java MIDlet to download.

Figure 3.3 Select Java MIDlet

The Browser window displays the prompt "Open in new window. Copy the URL" and follows by displaying a Download complete dialog indicating the type of file downloaded: .jad or .jar.

Figure 3.4 .Jar Installed Dialog

The Download dialog displays indicating your download has completed. Select OK to return to the Launcher or Open to install the application.
Once you Download the application you need to install it. A dialog will display asking you if you want to install the file. Select OK to begin the installation.

Figure 3.5 Install Dialog

During the installation process you can Cancel at any time. See Figure 3.6.

Figure 3.6 Saving .Jar Dialog

Once the installation is complete a dialog displays and asks if you want to run the application. Select OK to launch the Java application or Cancel to return to the main Launcher. Figure 3.7

Figure 3.7 Run Java Application Dialog

HotSync Java Applications from PC to Device ^TOP^

ACCESS Linux Platform supports HotSync™ operations allowing you to install Java applications from your PC to your mobile device. You must have the ACCESS Linux Platform Desktop package with HotSync Manager installed on your PC to enable transfer of any Java applications from a PC to your mobile device.

The HotSync Manager, an independent application that oversees the HotSync operation, must be running before you can synchronize data. However, the ACCESS Desktop need not be running. While a HotSync operation is in progress, you cannot use the ACCESS Desktop if the current user is the same as the one performing the HotSync operation.

The HotSync Manager continuously listens for a HotSync command from your handheld device, which can be delivered via Wi-Fi, Bluetooth, or a USB cable, depending on the capabilities of your device and your computer.

For more detailed information about installing applications from your PC to your mobile device, see the ACCESS Linux Platform Desktop HotSync Operations Help available on your desktop.

NOTE: You need to quit any Java MIDlet related tasks (e.g. install/update/execution/remove/security setting/attribute) before performing a HotSync operation.

The following instructions are from the HotSync Operations Help System:

To Select Applications and Files to Install on a Device:

Launch HotSync Manager.
Click File Installation.
On the File Installation page, click Add.
Click Browse to locate the file or application to install. You can also drag files onto the File Installation page.

NOTE: If your device has an expansion card, or you have not yet performed a HotSync operation, the Open dialog displays an Install to Card check box. Select the check box to install the selected files on an expansion card rather than on your device.

After you browse to the file you want to install (or drag it into the HotSync Manager window), you "perform a HotSync operation" to complete the file installation process.

You can perform a HotSync operation to install the files and applications immediately to your device. Otherwise, the files are installed the next time you sync your device with your desktop.

Mobile Device HotSync Set Up

On your mobile device, if you have not setup and initiated synchronization, ACCESS Linux Platform prompts you through the synchronization steps.

Select HotSync from the Launcher (see Figure 3.8)
HotSync displays a panel indicating the status of your synchronization set up.

Figure 3.8 HotSync

If you have never synchronized your device with your PC, select the Sync button to start that process (see Figure 3.9).

Figure 3.9 Initiate New Sync

You can set up multiple desktops to synchronize with using the MyDesktop drop-down menu in the upper right title bar. Selecting this drop down displays a dialog that enables you to add or view details about desktops.

Deleting Java Applications from the Device ^TOP^

Removing Java application (MIDlets) from a device is straightforward for the ACCESS Linux Platform user. Once the Java application is installed on the device, JV-Lite2 enables the display of the application in the ACCESS Linux Platform Launcher. You can install a Java application by any of the available methods described in "User Installation of Java Applications."

The Launcher offers users various options for working with the listed applications.

To Delete an Application or MIDlet Suite ^TOP^

Select the application or MIDlet Suite in the Launcher.
1. You can select the application either through finger touch, stylus, or by using the 5-way navigator.
2. Tap the application icon (if in Grid View) or name (in List View) only once, if using finger or style. A double-tap will activate the application.
When the item has focus, select the Applications menu in the title bar to display a menu of options you can perform on the applications.
Select Delete from the Applications menu to display the Delete confirmation dialog.
Select the Delete button to confirm that you want to delete the Java application and all of its associated files. Select Cancel, if you do NOT wish to delete the application.
The dialog displays a Removing message that also offers another opportunity to Cancel the delete.
If you do not cancel the operation, a final dialog is displayed indicating that the selected java application was removed. Select the OK button to return to the Launcher.

Running Java MIDlet Applications ^TOP^

When a Java MIDlet is installed on a device, the Launcher displays the icon for that MIDlet and the user can select the icon and activate the application.

During startup the JVLite will go through the MIDlet List and Show the MIDlets to the user for selection.

NOTE: You cannot run more than one MIDlet simultaneously because JV-Lite2 does not support running more than one Java application at one time.

Switching Between Activities ^TOP^

On ACCESS Linux Platform you can switch from your Java application to other activities or tasks such as answering the telephone, sending a message, answering email or using other applications.

When you switch to another task or activity, your Java application is paused and you can return to it by selecting it from the ACCESS Linux Platform Jumplist. The Jumplist is a convenient tool that allows you to view your recent applications.

Key Mapping ^TOP^

To run Java applications, especially Java games on your ACCESS Linux Platform mobile device, you may need to assign keys to perform functions usually mapped to specific keyboard keys.

A large variety of Java MIDlet applications exist with each application potentially having unique input requirements. A Java MIDlet game may need different key mapping than a Java MIDlet business application. ACCESS Linux Platform allows you to reassign keys on your device for each Java MIDlet application that you download.

The following section describe how to set up Key Mapping for a Java MIDlet.

Setting up Key Mappings ^TOP^

Select the Applications button on your device to activate the Launcher.
Select the Settings icon or name in the Launcher.

Figure 3.10 JV-Lite2 Settings

Select JV-Lite2 to map softkey buttons for JV-Lite2.
The Settings panel for JV-Lite2 allows you to assign both left and right keys (Softkey or Hardkey) to either the Menu button or to a specified Left and Right keys.

Figure 3.11 illustrates the assignment of softkeys to specific left and right buttons on your device.

Figure 3.11 Assign softkeys to Menu or buttons

The following table shows the reassignment of keyboard keys F1 and F2 to Softkey 1 and 2 for JV-Lite2.

Simulated Feature	Keyboard Key	Softkey
Left soft key	F1	1
Right soft key	F2	2