FAQ-0881 How do I install my MIDlet onto the UIQ based Sony Ericsson P800 using the JAD file?


FAQ-0881 How do I install my MIDlet onto the UIQ based Sony Ericsson P800 using the JAD file?

» Symbian OS » Developer Knowledgebase » FAQ-0881

Classification:	Java	Category:	Deployment
Created:	06/09/2003	Modified:	06/11/2003
Number:	FAQ-0881
Platform:	Symbian OS v7.0

Question:
How do I install my MIDlet onto the UIQ based Sony Ericsson P800 using the JAD file?

Answer:
The JAD file is not required by the MIDP 1.0 spec. If you've not set any optional attributes in the JAD file and the JAD file is not an essential requirement then the simplest approach is to install the MIDlet via the JAR file.

i) If your host pc has an IR capability you can simple beam the JAR file across to the P800. The JAR file will appear as a new message in the inbox. Select the "View" option, the installer will automatically launch. Simply follow the instructions.

ii) Use the P800 pc suite. Select the "Install Software" option, navigate to your JAR file. Again the installer will launch.

If your must install your midlet via a JAD file (for instance because optional attributes are set in the JAD file) then a slightly different installation procedure is required. This is because the MIDlet installer on the P800 is primarily geared to "Over the Air" (OTA) installation. If OTA installation is what your want then all that is required is that the JAD file has the URL of the JAR set in the MIDlet-Jar-URL attribute. Then simply follow the procedures outlined above substituting JAD for JAR.

However in the development phase putting your JAR file up on to a web server then installing it OTA may seem an excessive, not to say expensive, way of installing a MIDlet onto the target device.

A robust solution also suitable for delivering a release version of the MIDlet is to package you JAD and JAR pair into a SIS file. Ensure the MIDlet-Jar-URL attribute has the default value as set by the J2ME Wireless Toolkit (eg MyMidlet.jar). A template package file is shown below:

; Midlet Installation script.

; Specify the supported languages; items must appear in this order subsequently
&EN
;
; The installation name and UID
#{"MidletInstaller"},(0x0100000F),1,0,0
; Required for UIQ SIS file
(0x101F617B), 2, 0, 0, {"UIQ20ProductID"}
;
; The files to install
"MyMidlet.jar"-"c:\MyMidlet.jar"
"MyMidlet.jad"-"c:\MyMidlet.jad"

Use the .pkg file to create the SIS file using makesis. Then install the SIS file onto the device using the PC suite (or any other suitable method). Installing the SIS file results in the JAD and JAR pair being placed in the root of the c: drive from where the MIDlet can then be installed by invoking the on board installer (from the Application Launcher view select the "Applications" option from the menu and then "Install").

Simply beaming across the JAD and JAR files to the P800 does not result in sucessful installation because the two files get placed in separate folders in the inbox. Selecting the JAD file launches the installer which then searchs the local folder for the JAR file and fails to find it.

;