Machine virtuelle Java pour Palm TX

JVM pour Palm TX
Machine virtuelle Java pour Palm TX
Sommaire
1.
2.
Présentation de la machine virtuelle d’IBM..........................................................................................................1
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
JVM pour Palm TX
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
JVM pour Palm TX
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
JVM pour Palm TX
¾
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
JVM pour Palm TX
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
JVM pour Palm TX
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
JVM pour Palm TX
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-ListIcon » 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