Motorola maxx V6 manual Draft Subject to Change 136/201

Java ME Developer Guide

Chapter 19 - Downloading MIDlet through Browser

∙BACK shows previous screen to the user.

∙If the SELECT softkey is selected, the handset shows display the application size, time to install and version. If an error occurs with the descriptor file, the handset then displays the transient notice 'Failed Invalid File.' Upon Time-out, the handset goes back to browser.

∙If the CANCEL softkey is selected, it shows the Browser Application Card from where the application was selected.

∙If the DOWNLD softkey is selected, the handset starts downloading the application. The handset displays 'Downloading...% Complete' along with the percentage of downloading completed at a time. 'Downloading...% Complete' shall use static dots, not dynamic.

∙Before downloading the MIDlet, handset checks for available memory. Mot-Data-Space-Requirements and Mot-Program-Space-Requirements are two JAD attributes that will help the KVM determine whether there is enough memory to download and install the selected MIDlet suite. If there is not enough memory, 'Insufficient storage' transient dialog will be displayed before the download begins. Upon time-out, the handset goes back to browser.

∙If an error occurs during download, such as a loss of service, then the transient notice 'Download Failed' must be displayed. Upon time-out, the handset goes back to idle state.

∙A downloading application can be cancelled by pressing the END key. The transient notice, 'Download Cancelled, ' displays. Upon time-out, handset goes back to browser.

∙If JAR -file size does not match with specified size, it displays 'Failed Invalid File'. Upon time-out, the handset goes back to browser.

∙When the downloading application is cancelled, handset cleans up all files, including any partial JAR files and temporary files created during the download process.

∙When downloading is done, the handset displays a transient notice 'Download Completed'. The handset then starts to install the application.

∙The handset displays 'Installing...'.

∙After an application is successfully downloaded, a status message must be sent back to the network server. This allows for charging of the downloaded application.

∙Charging is per the Over the Air User Initiated Provisioning specification. The status of an install is reported by means of an HTTP POST request to the URL contained in the MIDlet-Install-Notify attribute. The only protocol that MUST be supported is 'http://'.

∙If the browser connection is interrupted/ended during the download/installation process, the device will be unable to send the HTTP POST with the MIDlet-Install Notify attribute. In this case, the MIDlet will be deleted to insure the user does not get a free MIDlet. The use case can occur when a phone call is accepted and terminated during the installation process, because then the browser will not be in the

DRAFT - Subject to Change [136/201]