Run Java MIDlet on your device
Operate other functions during Java execution
Configure JBlend™ on your device
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.
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.
Install a MIDlet to your device from local file system
Install a MIDlet to your device from Internet
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.
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.
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.
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
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.
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.
You can suspend the running MIDlet in the background by selecting "Back" or "Home" or "End" key and go for other programs.
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)..
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 Environment Configurations
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:
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.
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.
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].
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 |