JBlend Help

About JBlend™

About MIDlet

How to

Run Java MIDlet on your device

Operate other functions during Java execution

Networking of Java programs

Configure JBlend™ on your device

Troubleshooting



About JBlend™

JBlend™ is an embedded software product provided by Aplix that enables Java Virtual Machine on Microsoft Windows Mobile devices. JBlend™ provides a rich programming environment on your device so that various Java programs could be designed and executed flawlessly. JBlend™ incorporates many state-of-the-art Java features to help users to establish a versatile Java environment on Windows Mobile devices.

JBlend™'s Java Application Management System provides you an environment to execute J2ME compatible Java applications on your Windows Mobile device. You can enjoy your favorite Java Games, or use some convenient tools designed for Windows Mobile device. You may install Java applications (MIDlets) from your device or storage card. Furthermore, you can download and install MIDlets via Internet by using ActiveSync or GPRS/3G network.

Meanwhile, JBlend™ also provides comprehensive controls and settings of application permissions to ensure the security of Windows Mobile environment. Using JBlend™ one can ensure the total control over all the Java applications to prevent any malicious attempts from the Java applications.

Please refer to following chapters to help you gain an overall understanding of Aplix's JBlend solution.



About MIDlet

A MIDlet is a Java application that conforms to the MIDP (Mobile Information Device Profile) standard for embedded devices, more specifically the J2ME (Java 2 Micro Edition) virtual machine. Generally, these are Java games and applications that run on a MIDP mobile device.

MIDlet consists of two parts, .jad file and .jar file. .jad file is the description of the Java application while .jar file contains the bundle multiple files into a single archive file. You can download, install, launch, or delete MIDlet via JBlend's Java Application Management System.



How-to

Install a MIDlet to your device from local file system

Install a MIDlet to your device from Internet

Update your installed MIDlet

Rename your installed MIDlet

Delete your installed MIDlet



Install a MIDlet to your device from local file system

You can copy MIDlets from the desktop to mobile device using ActiveSync by creating a new folder or the existing folder (Ex: \My Documents). Once MIDlets are copied to the mobile device, you can start installation. JBlend™ also supports ‘Searching of MIDlets’ available on the device. You can select and install the MIDlets from the list of searched MIDlets.

1. Press [Start]-> launch File Explorer in the program list-> MIDlets Folder, and then select the specific MIDlet to install .

2. Click either JAD or JAR file to start the MIDlet installation.

(You can also search MIDlets with the help of JBlend™:

1. Press [Start]->[Programs]->[JBlend].

2. Click [Install]->[Local Install]->[Search MIDlet], it will list all the available MIDlets on the device. You can select the MIDlet and start installing the MIDlet.)

3. JBlend Installer window will show up with a confirmation message like [Would you like to install the MIDlet] to proceed the MIDlet installation.

4. Select [Yes] to continue the MIDlet installation or select [No] to cancel the installation.

5. If selected [Yes], JBlend™ will display the installation progress; after completion of installation, it will prompt a confirmation message to notify that "Installation complete. Would you like to run the MIDlet?"

6. Select [Yes] to run the installed MIDlet directly or select [No] to cancel the MIDlet launch and return to the File Explorer.



Install a MIDlet to your device from Internet

JBlend™ supports MIDlet download and installation via Internet using Pocket Internet Explorer. You can download either JAD or JAR files by Pocket Internet Explorer, and then it will invoke JBlend™ to start the MIDlets installation. JBlend™ also supports to connect to a default website via Pocket Internet Explorer.

1. Connect to Internet and browse the website for MIDlets.

2. Select .jad file and/or .jar file to start the MIDlet installation.

(You can use JBlend™ to connect a default website:

1. Press [Start]->[Programs]->[JBlend].

2. Click [Install]->[Download] to connect a default website via Pocket Internet Explorer)

3. JBlend Installer window will show up with a confirmation message like "Would you like to install the MIDlet?" to proceed the MIDlet installation.

4. Select [Yes] to continue the MIDlet installation or select [No] to cancel the installation.

5. If selected [Yes],JBlend™ will display the installation progress; after completion of installation, it will prompt a confirmation message to notify that "Installation complete. Would you like to run the MIDlet"

6.Select [Yes] to run the installed MIDlet directly or select [No] to cancel the MIDlet launch and return to the download page.



Update your installed MIDlet

1. Press [Start]->[Programs]->[JBlend].

2. JBlend™ will show the list of MIDlets currently installed on the device.

3. Select a MIDlet from the list to update by clicking [Menu]->[Application]->[Update Info]

4. Message [Would you like to update the MIDlet?] will be displayed if the updated version of the MIDlet is available.

5. Select [Update] to update the MIDlet or select [No] to cancel the update and return to JBlend™.

6. Message [Update Information is not available for the MIDlet] will be displayed if there are no updates. Select [Cancel] to return to JBlend™

Note:

If youˇ¦re asked with a message [Do you wan to keep old RMS?] for the update or re-installation of a MIDlet, which means already MIDlet-related data was generated and saved during the previous execution of the same MIDlet,

1. Select [Yes] to keep previous information generated by the MIDlet.

2. Select [No], which will result the data will be removed.

3. JBlend™ will continue its installation after confirmation.



Rename your installed MIDlet

1. Press [Start]->[Programs]->[JBlend].

2. JBlend™ will show the list of MIDlets currently installed on the device.

3. If you want to rename a specific installed MIDlet, press [Menu]->[Application]->[Rename]. A prompt window will be shown with "Please input new name : " for you to input preferred name. Select [OK] to confirm your change or [Cancel] to cancel this operation.



Delete your installed MIDlet

1. Press [Start]->[Programs]->[JBlend].

2. JBlend™ will show the list of MIDlets currently installed on the device.

3. If you want to delete a specific installed MIDlet, press [Menu] -> [Application] -> [Delete]. A Confirmation window will be shown with "Do you really want to delete this application?" when [Delete] option is selected. Select [Yes] to delete the MIDlet or [No] to cancel the deletion.

4. If you want to delete all of installed MIDlet, press [Menu] -> [Application] -> [Delete All]. A Confirmation window will be shown with "Do you really want to delete all the MIDlets?" when [Delete All] option is selected. Select [Yes] to delete the MIDlet or [No] to cancel the deletion.



Run Java MIDlet on your device

Start

Stop

Suspend

Resume



Start

JBlend™ enables you to run MIDlets on your mobile device. You can execute the MIDlet immediately by following steps or you can launch JBlend™ via shortcut and then execute the MIDlet.

1. Press [Start]->[Programs]->[JBlend].

2. JBlend™ will list all the MIDlets you have already installed on the device.

3. Select the MIDlet and press "Action" key to start running the MIDlet.



Stop

If the MIDlet has the "Exit" function, close the MIDlet by selecting such option in the game. After exiting the game, it will return to JBlend™ Otherwise, you can use suspend methods to terminate the currently running MIDlet.

Please be noticed that you may also exit the MIDlet by selecting either of the following methods, which will make JBlend™ to prompt [JBlend Resume or Stop] dialog. Then select [No] to terminate the MIDlet and return to JBlend™.

Here are the ways to stop the MIDlet:

1. Select [End] key and then [Back] key.

2. Select [Home] key and then [Back] key.

3. Select [Home] or [End] key and then click JBlend™ again from the shortcut or from the program list.



Suspend

You can suspend the running MIDlet in the background by selecting "Back" or "Home" or "End" key and go for other programs.



Resume

1. If the MIDlet is suspended in the background, press "Back" key or launch JBlend™ again.

2. [JBlend Resume or Stop] dialog will be prompted with message [The application is paused. Do you want to resume?]. Select [Yes], then MIDlet can be continued from where it is suspended.



Operate other functions during Java execution

JBlend™ supports suspend and resume features to help you to switch from JBlend™ to the other Windows Mobile applications during JBlend™ operation.

During JBlend™ is running, when you press any dedicated keys such as, "Home", "End", etc, or receive an incoming phone call or SMS, JBlend™ will be suspended automatically. JBlend™ can be resumed and continued from where it is suspended without losing any information (ex: game score, input data, game settings)..



Networking of Java programs

JBlend™ supports complete networking features. Java applications running in it will use network and send or receive data as other Windows Mobile applications. Additional service charge or network packet fees will be billed. If you are not sure how to set network access permission properly, please contact your service/network provider for details.



Configure JBlend™ on your device

Java Permission Control

Java Application settings

Java Application Info

Java Environment Configurations



Java Permission Control

Permission Dialog

JBlend™ pops up a permission dialog, when the MIDlet is trying to access resource (like Network or SMS) from Internet. Generally permission dialog will be displayed with a combination of following options:

  • Allow and don't ask again
  • Allow for this session
  • Allow and ask me next time
  • Don't allow this time
  • Never
  • JBlend™ will allow or deny the MIDlet to access the requested resource based on the above options.

    Configure Default Application Permission Settings

    JBlend™ provides the provision to set the default permissions for any MIDlet installed in the device. Access the permission settings by selecting [Menu]->[Application] ->[Permissions]

    After changing the permission settings, select [OK] to apply the changes to permissions, select [Cancel] to omit the changes made to permissions.



    Java Application settings

    JBlend™ allows user to adjust MIDlet-based Network settings.

    Configure Application Network Settings

    JBlend™ provides the option to configure the Application Network settings from the option “Select Network” in [Menu]->[Application]->[Settings], and select [OK].

    This configuration takes precedence over the Default Network settings after configured by user.



    Java Application Info

    JBlend™ provides the complete information about the selected MIDlet such as name, version, vendor, JAR-url, domain that MIDlet belongs and DRM Type.



    Java Environment Configurations

    JBlend™ provides the option to configure the Backlight settings from the [Menu] -> [Java Settings], uncheck the " Backlight always on" option and select [OK] to minimize the power-consumption.

    JBlend™ provides the option to configure the Default Network settings from the option “Select Network” in [Menu]->[Java Settings], and select [OK].



    Troubleshooting

    The error messages that will be displayed, when JBlend™ encounter some problems

    Message

    Description

    Internal Error

    JBlend™ internal error

    Insufficient Memory

    Not enough memory to install a MIDlet on your device

    User Cancelled

    This message is shown when user cancelled the MIDlet installation

    JAR size mismatch

    JAR size in JAD file attribute mismatches with actual JAR size

    Attribute Mismatch

    Mismatch in attribute value between JAD and JAR files

    Invalid Descriptor

    Invalid MIDlet-Descriptor in JAD file provided by MIDlet vendor

    Invalid JAR

    Invalid MIDlet JAR file provided by MIDlet vendor

    Incompatible Configuration or Profile

    The version number of MIDP or CLDC in JAD file is not correct

    Application authentication failure

    MIDlet failed to authenticate due to security restrictions

    Application authorization failure

    MIDlet failed to authorize due to security restrictions

    Push registration failure

    Fail to register the MIDlet with the device

    Root Certificate authorizing this application is not available. The application can not be executed.

    The MIDlet is signed by one certificate or a certificate chain, but one of the certificates is not installed in the device

    There is not enough memory to start this application. Please close other applications and try again.

    Could not run a MIDlet because there is not enough free memory

    Network is too slow, WAIT_TIMEOUT(258). Please increase time-out value

    Network time-out occurred, while downloading the file

    Failed to Notify Server

    The server is down or network failure. So notification to server failed

    JBlend failed to install the MIDlet because memory is dangerously low. Please create more space by removing some files.

    Could not install a MIDlet because there is not enough free space

    Cannot connect to server

    An error occurred while JBlend™ is trying to connect to server

    Error loading JAR file

    An error occurred while JBlend™ is trying to load JAR file

    Error extracting JAD file

    An error occurred while JBlend™ is trying to extract JAD file

    Error getting JBlend Path. Please set the JBlend Path correctly

    JBlend™ path is not set correctly in the registry

    Missing Jar-Url property in JAD file

    There is no Jar-URL attribute in JAD file

    An error occurred while attempting to download files

    An error occurred while JBlend™ is trying to download a file

    The application size exceeds the defined limit. Installation is cancelled.

    Not enough memory space to install the JAR file on the device

    Unsafe installation attempted. Same application with higher security settings exists. Delete existing application and try again.

    Trying to re-install or update with the un-trusted MIDlet or MIDlet with lower security settings, when there is already a trusted MIDlet or MIDlet with high security installed

    [MIDlet] cannot be installed. The trusted certificate used to authorize the application has expired. Contact your application provider to correct this situation

    The certificates signed with the installing MIDlet already expired

    [MIDlet] cannot be installed. The authentication of certificate is failed. Contact your application provider to correct this situation

    The certificates signed with the installing MIDlet are not available on the device certificate store

    You are not allowed to run this MIDlet because of DRM Rights not passed.

    MIDlet failed to pass DRM Rights