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.
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.
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
¾ 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. »
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) Configuration de la machines virtuelle et de l’exécution des MIDlets
Options de débogage des applications Java.
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.
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. 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.
1
2
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
