Machine virtuelle Java pour Palm TX Sommaire 1. Présentation de la machine virtuelle d IBM...1 2. Installation sur le Palm TX...2 2.1. Téléchargement...2 2.2. Installation...2 2.3. Application de test...2 3. Installation sur le simulateur Palm TX...3 3.1. Téléchargement...3 3.2. Installation...3 3.3. Application de test...3 4. Configuration de la machine virtuelle IBM J9 VM...4 5. Convertir les fichiers Jar/Jad en fichier Prc...6 6. Documents de référence...7 1. Présentation de la machine virtuelle d IBM La machine virtuelle Java (Java 2 Micro Edition) doit être installée pour exécuter des programmes écrits en Java. Nous utilisons la JVM fournie par IBM et conseillée par Palm : WebSphere Everyplace Micro Environment (WEME) v. 5.7.1. (appelée aussi IBM J9 VM) WEME est constituée de 3 composants : la machine virtuelle (JVM) est la première couche de WEME la configuration CLDC 1.1 fournit les API de base pour les utilitaires Java, les entrées / sorties et les fonctions réseau le profil MIDP 2.0 ajoute les composants d interface graphique, les composants pour la sauvegarde de données et les supports pour les protocoles TCP, UDP, HTTP et HTTPS Ces composants sont distribués sous le format.prc (exécutables sous palm) Cette solution correspond aux préconisations de SUN pour J2ME. BTS iris - Lycée Eiffel - Armentières Page 1 sur 7 03/10/2006
2. Installation sur le Palm TX 2.1. Téléchargement Adresse de téléchargement de WEME571.zip : http://www.palm.com/us/support/jvm/download.html 2.2. Installation Décompressez le fichier WEME571.zip Lancez Démarrer > Programmes > Palm > Installation rapide Palm Ajoutez les fichiers suivants dans la partie «Ordinateur de poche» : \WEME571JVM\JVM\ARM4T\J9JavaVMMidp20.prc (la machine virtuelle) \WEME571JVM\JVM\ARM4T\J9JavaVMMidp20_fr.prc (version française de la JVM) \WEME571JVM\JVM\ARM4T\JavaVMCheck_frFR.prc (messages d erreurs) Effectuez l'opération HotSync. Ensuite, vous pouvez installer de la même façon les packages optionnels JSR 75 et JSR 172 Ajoutez les fichiers suivants dans la partie «Ordinateur de poche» de l installation rapide Palm : \WEME571JVM\JSR75\fileconnect.prc \WEME571JVM\JSR75\pimop.prc \WEME571JVM\JSR75\PIMPrefs.prc \WEME571JVM\JSR75\PIMPrefs_fr.prc \WEME571JVM\JS172\WebServices.prc \WEME571JVM\JS172\WS-Security.prc Effectuez l'opération HotSync. 2.3. Application de test Téléchargez le programme HelloWorld.prc disponible dans la partie «J2ME» de ce site ou directement à cette adresse : http://www4.ac-lille.fr/~irisarmentieres/media/terminauxmobiles/helloworld.prc Installez le MIDlet sur le Palm TX comme pour les fichiers précédents Lancez le MIDlet HelloWord. Si la machine virtuelle ne génère pas d erreur c est qu elle est bien installée. BTS iris - Lycée Eiffel - Armentières Page 2 sur 7 03/10/2006
3. Installation sur le simulateur Palm TX La JVM installée sur le simulateur du constructeur permettra, sur le PC de développement, de valider la solution déjà testée sur le simulateur générique de SUN Wireless Toolkit. 3.1. Téléchargement Adresse de téléchargement de la JVM pour le simulateur Palm TX (inscription préalable sur le site) https://www.developerpavilion.com/palmos/page.asp?page_id=365&tool_id=104 Téléchargez «Java Technology for Palm OS Garnet Toolkit (WEME Release 5.7.1)» et décompressez le fichier «Java_Tech_for_Garnet_WEME57.zip» 3.2. Installation Important : La machine virtuelle Java doit être installée sur la version RELEASE du simulateur Palm TX (simulateur non lancé) Décompressez le fichier «Java_Tech_for_Garnet_WEME57.zip» Copiez le fichier «\JVM\simulator\J9JavaVMMidp20.dll» dans le dossier contenant PalmSim.exe Créez un dossier «AutoLoad» dans le dossier contenant PalmSim.exe (respecter la casse) Copiez les fichiers PRC suivants dans le dossier AutoLoad \JVM\simulator\ams.prc \JVM\simulator\J9JavaVMMidp20.prc \JVM\simulator\J9JavaVMMidp20_fr.prc \JVM\simulator\j9keystore.prc \JVM\simulator\J9Launcher.prc \JVM\simulator\j9pref.prc \JVM\simulator\j9secpol.prc \JVM\simulator\PalmMidp20_22.prc \JVM\simulator\pref.prc Copiez au même endroit les packages optionnels JSR 75 et JSR 172 \JSR75\fileconnect.prc \JSR75\pimop.prc \JSR75\PIMPrefs.prc \JSR75\PIMPrefs_fr.prc \JS172\WebServices.prc \JS172\WS-Security.prc Lancez le simulateur avec PalmSim.exe Vérifiez la configuration du simulateur : Settings > Memory > Dynamic Heap Size >= 2048 KB 3.3. Application de test Téléchargez le programme HelloWorld.prc disponible dans la partie «J2ME» de ce site ou directement à cette adresse : http://www4.ac-lille.fr/~irisarmentieres/media/terminauxmobiles/helloworld.prc Installez le MIDlet sur le Palm TX comme pour les fichiers précédents Lancez le MIDlet HelloWord. Si la machine virtuelle ne génère pas d erreur c est qu elle est bien installée. Problèmes éventuels : Java ne démarre pas et une fenêtre d erreur apparaît : "This application has failed to start because MSVCR70.dll was not found. Re-installing the application may fix this problem." Trouvez une copie de Microsoft Visual C Runtime et copiez-la dans le dossier du simulateur. Si vous ne la trouvez pas, essayez de copier MSVCR71.dll et renommez la. BTS iris - Lycée Eiffel - Armentières Page 3 sur 7 03/10/2006
Une fenêtre d erreur apparaît : "Unable to create offscreen window." Vérifiez la configuration du simulateur : Settings > Memory > Dynamic Heap Size >= 2048 KB Un message d erreur apparaît qui mentionne que la fenêtre est plus large que l écran. L écran reste blanc. La machine virtuelle Java doit être installée sur la version RELEASE du simulateur Palm TX Le simulateur a déjà fonctionné mais il ne démarre plus Supprimez le fichier C:\PALM\ SimSlotDriverVolume et redémarrez le simulateur. 4. Configuration de la machine virtuelle IBM J9 VM La configuration de IBM J9 VM est identique sur le périphérique Palm TX et sur son simulateur. Les paramètres de la machine virtuelle peuvent être modifiés à partir du gestionnaire d applications : Applications > Catégorie «Système» > Icône «Préf.» Configuration de la machines virtuelle et de l exécution des MIDlets Options de débogage des applications Java. La configuration de la machine virtuelle (IBM Java VM) permet de : Fixer des préférences globales ou particulières pour une application donnée. Par défaut, chaque MIDlet utilise les paramètres globaux. Utiliser le double tampon : Le dessin d un canevas avec double tampon est plus progressif, mais se fait au détriment de la vitesse d affichage. Utiliser des coordonnées haute résolution : Avec les coordonnées haute résolution, le MIDlet dessine dans les coordonnées réelles de l écran (320 x 480) au lieu d émuler les coordonnées d écran standard.160 x 160. Définir le proxy http à utiliser, s il existe, pour les applications réseau. Définir le maximum de mémoire : maximum de mémoire que la machine virtuelle peut allouer (1 à 32 Mb) Définir la taille maximale de la pile de fil Java : (2 à 32 Kb) BTS iris - Lycée Eiffel - Armentières Page 4 sur 7 03/10/2006
Les options de débogage (J9 Java Options) sont prévues pour être uniquement utilisées par les développeurs. Elles permettent de : Sélectionner une application particulière (Java App) Choisir les options de la machine virtuelle (VM Options) Passer des paramètres à l application (App Options) Le bouton «Default» permet de restaurer les préférences par défaut de l application. Le bouton «Revert» permet de recharger les préférences enregistrées précédemment. Le bouton «Launch» permet de lancer l application avec les options de débogage saisies. L installation de la machine virtuelle a également installé un utilitaire appelé JAM (Java Application Manager) : Applications > Catégorie «Non classé» > icône «IBM Java VM» Cette application est en fait un logiciel AMS (Application Management Software), normalisé dans MIDP 2.0, qui permet de gérer les téléchargements et le cycle de vie des MIDlets venant du réseau sans fil. BTS iris - Lycée Eiffel - Armentières Page 5 sur 7 03/10/2006
5. Convertir les fichiers Jar/Jad en fichier Prc L utilitaire jartoprc_w.exe pour créer un fichier PRC à partir des fichiers JAD/JAR est inclus dans Java_Tech_for_Garnet_WEME57.zip (contenant la JVM pour le simulateur). Ce programme se trouve dans le répertoire \Tools\bin de l archive. Lancez : \Tools\bin\ jartoprc_w.exe 1 2 1. Sélectionnez le fichiez JAD créé avec le fichier JAR. 2. Si besoin, remplissez les champs optionnels. Ils peuvent être omis si les informations sont spécifiées dans le fichier JAD. 3. Cliquez sur «Generate PRC» : le fichier PRC est créé dans le même dossier que le fichier JAD. BTS iris - Lycée Eiffel - Armentières Page 6 sur 7 03/10/2006
Champs optionnels : Application Name : Le nom qui apparaît sous l icône dans le gestionnaire d application du Palm. Version Number : Ce nombre apparaît dans l environnement Palm dans le menu App > Info > Version Large Icon File : Le chemin vers l image utilisée comme icône pour l application dans le gestionnaire d application du Palm. Correspond à l attribut «MIDlet-Icon» du fichier JAD. L icône par défaut est utilisée si rien n est spécifié. Small Icon File : Le chemin vers l image utilisée comme icône pour l application dans le gestionnaire d application du Palm quand on le visualise sous forme de liste. Correspond à l attribut «Palm-MIDlet-List- Icon» du fichier JAD. L icône par défaut est utilisée si rien n est spécifié. Splash Screen : Le chemin vers la ressource binaire qui doit être utilisée comme «splash screen». Dans ce cas, l option «Creator ID» doit être égale à 2002. Creator ID : Un identifiant à 4 chiffres que le système d exploitation Palm utilise pour associer l application et ses fichiers de données. Cette valeur est automatiquement générée si elle n est pas spécifiée. 6. Documents de référence Technologies Java pour Palm http://www.palmos.com/dev/tech/java/developers.html Débogage d applications Java en utilisant une connexion réseau (avec WEME Toolkit) http://www.palmos.com/dev/tech/java/page11_1.pdf Guide d utilisation de WEME 5.7 http://www.palmos.com/dev/tech/java/weme_5.7_user_guide.pdf Support J2ME pour les périphériques Palm http://www.palmos.com/dev/tech/java/midp_2_porting_guide.pdf BTS iris - Lycée Eiffel - Armentières Page 7 sur 7 03/10/2006