Vendée Globe 2008 Virtual Regatta - Enter the b world

VGVR
Vendée Globe 2008 Virtual Regatta
bwa
VGVR:
bwa
Vendée
Globe
2008
Virtual
Regatta:
Table des matières
Préface ....................................................................................................................... vi
I. Présentation .............................................................................................................. 1
1. Introduction ...................................................................................................... 2
2. La flotte bworld ................................................................................................ 3
2.1. arthurix ................................................................................................. 3
2.2. boudout ................................................................................................. 4
2.3. bwa ...................................................................................................... 6
2.4. segogo .................................................................................................. 8
2.5. Snow pearl ............................................................................................ 8
II. Manuel vgvr ........................................................................................................... 11
3. Manuel utilisateur ............................................................................................ 12
3.1. Pré-requis ............................................................................................ 12
3.2. Installation ........................................................................................... 12
3.3. Onglet Flotte ........................................................................................ 14
3.3.1. Identifiant Virtual Regatta ............................................................ 15
3.3.2. Configuration manuelle ................................................................ 17
3.4. Onglet Position actuelle .......................................................................... 18
3.5. Onglet Auto record ................................................................................ 19
3.5.1. Les fichiers générés ..................................................................... 20
4. Guide du développeur ...................................................................................... 22
A. Installation de java .................................................................................................. 23
A.1. Récupérer le jdk ........................................................................................... 23
A.2. Installation du jdk sous debian ........................................................................ 23
A.2.1. Exécuter les applets depuis votre navigateur ............................................ 24
A.3. Installation du jdk sous windows ..................................................................... 24
B. Glossaire ............................................................................................................... 28
C. A propos ............................................................................................................... 29
iv
Liste des tableaux
C.1. Historique des versions de ce document .................................................................... 29
v
Préface
Le Vendée Globe Virtual Regatta 2008 [http://www.virtualregatta.com/index.php] est un jeu en ligne
donnant aux participants la possibilité de simuler une course autour du monde dans les conditions
météorologiques réelles de la vraie course du Vendée Globe [http://www.vendeeglobe.org/fr/course/
presentation.html].
Le départ de la vraie course et de la course en ligne ont eu lieu le 9 novembre 2008 à 13h02 gmt+1
aux Sables d'Olonnes.
La participation au jeu requiert une inscription (gratuite) au cours de laquelle le concurrent est invité
à choisir un nom de navire (correspondant au login d'inscription), puis de personnaliser les couleurs
de ses voiles.
L'inscription au jeu a été possible jusqu'à fin décembre 2008. Les organisateurs du jeu
n'avaient pas prévu un tel succès, plus de 270000 concurrents !
Rapidement pris au jeu, j'ai commencé à tenir un journal de bord pour mon navire à partir des informations fournies sur l'interface du jeu : position, classement, vitesse, gréement, etc...
Ma passion grandissante pour ce jeu m'a entrainé à automatiser les relevés. D'autant plus quand mes
enfants Arthur et Victor se sont inscrits : il ne leur était pas possible de bien avancer depuis l'école,
car le jeu requiert une grande disponibilité derrière l'écran !
Je n'avais donc plus un, mais trois navires à gérer pendant les heures d'école, et la nuit...
Pendant les vacances de Noël 2008, Arthur et Victor se sont de plus retrouvés sans connexion internet
pendant quinze jours... Tout comme les skippers des navires Snow Pearl et segogo qui m'ont
appelé à l'aide pour m'occuper d'eux.
Je me suis donc retrouvé skipper de 5 navires... La tenue d'un journal de bord pour chacun d'entre eux
m'a motivé pour développer le logiciel vgvr.
Ce document a plusieurs objectifs et est découpé en autant de parties :
• Présentation : présenter ce jeu passionnant
• Manuel vgvr : proposer un manuel utilisateur de mon logiciel vgvr (et à terme un guide du développeur)
Au moment de l'écriture de ces lignes, tout est "en cours" : la course, le logiciel et l'élaboration de
cette doc !
vgvr est écrit en language java pour pouvoir être exécuté depuis toute machine disposant d'une machine virtuelle java : j'ai testé sous linux debian, mac, windows. Adepte du logiciel libre, les sources
sont évidemment libres !
Ce document et le logiciel sont donc destinés à tout public, plus particulièrement aux coureurs du
Vendée Globe Virtual Regatta 2008.
Ce document est disponible en version html consultable en ligne et version pdf imprimable à partir
de http://bworld.free.fr.
vi
Partie I. Présentation
Cette partie présente le jeu officiel et la flotte bworld.
Chapitre 1. Introduction
TODO ;-)
Pour la vraie course du Vendée Globe 2008, voir : http://www.vendeeglobe.org
Pour la course virtuelle, voir http://www.virtualregatta.com
2
Chapitre 2. La flotte bworld
Voici par ordre alphabétique les navires et leurs différents gréements de la flotte bworld lors de la
Vendée Globe Virtual Regatta 2008.
2.1. arthurix
Skipper : Arthur.
arthurix gréé sous Foc pro : TODO
arthurix gréé sous Génois :
arthurix gréé sous Code Zero :
arthurix gréé sous Spi léger :
3
La flotte bworld
arthurix gréé sous Gennaker :
2.2. boudout
Skipper : Victor.
boudout gréé sous Foc pro : TODO
boudout gréé sous Génois :
4
La flotte bworld
boudout gréé sous Code Zero :
boudout gréé sous Spi léger :TODO
boudout gréé sous Gennaker :
5
La flotte bworld
2.3. bwa
Skipper : bwa (<[email protected]>).
bwa gréé sous Foc pro :
bwa gréé sous Génois :
bwa gréé sous Code Zero :
6
La flotte bworld
bwa gréé sous Spi léger :
bwa gréé sous Gennaker :
7
La flotte bworld
2.4. segogo
Skipper : Saïd.
segogo gréé sous Foc pro : TODO
segogo gréé sous Génois :
segogo gréé sous Code Zero :
segogo gréé sous Spi léger :TODO
segogo gréé sous Gennaker :TODO
2.5. Snow pearl
Skipper : Ségo.
8
La flotte bworld
Snow pearl gréé sous Foc pro :
snowPearl gréé sous Génois :
Snow pearl gréé sous Code Zero :
9
La flotte bworld
Snow pearl gréé sous Spi léger :
Snow pearl gréé sous Gennaker :
10
Partie II. Manuel vgvr
Cette partie correspond au manuel du logiciel qui permet pour l'instant d'enregistrer les profils de navires lors de
la course et à terme de générer un journal de bord.
Chapitre 3. Manuel utilisateur
La version 1.0 de vgvr permet :
• de faire rapidement le point (position cap etc...) sur le profil d'une flotte de navires participant au
jeu Vendée Globe Virtual Regatta (sans se loguer sur le site officiel).
• d'enregistrer automatiquement à une fréquence choisie des rapports dans des fichiers au format xml.
A terme, vgvr devrait pouvoir utiliser ces fichiers xml pour générer un historique "human-friendly"
de la course pour chacun des navires gérés. L'important pour l'instant est de garder une trace de la
route des navires de la flotte. Pour l'instant (version 1.0), la route de chaque navire de la flotte est
enregistrée sur le disque dans un fichier xml.
3.1. Pré-requis
VGVR (pour Vendée Globe Virtual Regatta) est un logiciel écrit en java pour s'affranchir du système
d'exploitation, pourvu qu'il soit muni d'une Java Runtime Environment.
Une version supérieure ou égale à la 1.6 de java est nécessaire pour pouvoir exécuter
VGVR. Pour savoir si votre système dispose d'un tel environnement java, ouvrez une
console (shell, dos) et tapez java -version sur la ligne de commande. Un message proche
du suivant doit s'afficher :
java version "1.6.0_03"
Java(TM) SE Runtime Environment (build 1.6.0_03-b05)
Java HotSpot(TM) Client VM (build 1.6.0_03-b05, mixed mode, sharing)
Il faut donc un ordinateur avec java installé et une interface graphique. L'appendice Installation de
java présente l'installation du Java Development Kit (une Java Runtime Environment est incluse dans
un jdk).
Il faut également au moins un compte sur le jeu en ligne Vendée Globe Virtual Regatta et une
connexion internet.
Et puis, il faut une distribution du logiciel vgvr, disponible en ligne à partir de l'adresse suivante :
http://bworld.free.fr.
3.2. Installation
Les distributions de vgvr sont archivées dans un fichier compressé vgvr_<version>.zip,
où <version> indique la date de ant build process du fichier. Par exemple :
vgvr_1.0_200901201205.zip correspond à la version 1.0 du logiciel "buildé" le 20 janvier
2009 à 12h07.
Il s'agit donc de récupérer une distribution du logiciel disponible en ligne à partir du site http://
bworld.free.fr et de la décompresser sur votre disque. Vous obtenez une hiérarchie de répertoires semblable à :
(...)/vgvr_1.0_200901201207/
bin/
vgvr.jar
lib/
jdom.jar
README_vgvr.jar
Le fichier exécutable est vgvr.jar, jdom.jar est une librairie permettant de manipuler du xml
en java.
12
Manuel utilisateur
Pour exécuter vgvr, il suffit sous mac (ou windows) de double-cliquer depuis le Finder (ou l'Explorateur) sur vgvr.jar.
Alternative : depuis la ligne de commande (console shell ou dos), tapez la commande suivante depuis
le répertoire où se trouve le fichier vgvr.jar :
java -jar vgvr.jar
L'interface graphique de vgvr est internationalisée en français et en anglais. Pour lancer
l'interface en anglais, tapez :
java -jar vgvr.jar en
. Par défaut, l'interface est en français, mais la commande java -jar vgvr.jar fr marche
aussi.
Si tout se passe bien, l'application ouvre la fenêtre suivante :
13
Manuel utilisateur
En cas de problème ou de comportement inattendu, lancez l'application depuis une console comme
indiqué plus haut, les messages d'erreur s'y afficheront (normalement).
3.3. Onglet Flotte
Tant que vous n'avez pas configuré les navires de votre flotte, le tableau est vide (contrairement à ce que l'on voit sur cette copie d'écran).
Cet onglet vous permet de configurer les navires de la course que vous voulez suivre. Au premier
lancement du logiciel, aucun navire n'apparaît dans la liste.
En bas de la fenêtre, un bouton permet d'ajouter un navire à la liste. En cliquant le bouton "Ajouter",
une fenêtre de dialogue s'ouvre et invite l'utilisateur à rentrer un nom pour le navire :
14
Manuel utilisateur
Le nom du navire ne doit être composé que de lettres ou de chiffres, pas d'espaces ou
autres caractères chelous.
Si le nom de navire est validé (lexicograhiquement), une nouvelle fenêtre s'ouvre pour demander un
identifiant Virtual Regatta :
3.3.1. Identifiant Virtual Regatta
La participation au jeu requiert une inscription (gratuite). Chaque inscription est associée :
• à un nom d'utilisateur qui devient le nom du navire
• un identifiant
L'identifiant n'est pas clairement fourni par les organisateurs. Je ne connais qu'une façon de le déterminer :
1. s'authentifier sur le jeu
2. cliquer sur le lien "Profil"
3. au milieu de la page du profil, cliquer-droit et choisir dans le menu contextuel "Ce cadre" puis
"Afficher ce cadre uniquement" (ou "Afficher dans un nouvel onglet")
15
Manuel utilisateur
.
4. dans
la
barre
d'adresse
du
navigateur
apparaît
alors
une
url
du
type
:
http://vendeeglobe.virtualregatta.com/profil.php?
id_user=IDENTIFIANT&langue=FR où IDENTIFIANT est un chiffre que j'appelle ici
l'identifiant Virtual Regatta du navire :
16
Manuel utilisateur
Sur cette capture d'écran, l'identifiant de 6 chiffres a volontairement été masqué de
rouge : qui voudrait voir mon profil ?
Il s'agit donc de reporter cet identifiant dans le champ texte de la boîte de dialogue qui s'est ouverte
après avoir cliqué "ajouter un navire" et choisi un nom pour le navire.
Le logiciel vérifie que la valeur rentrée est bien un entier positif (vérification succinte, je n'ai pas
d'autres infos quant à cet identifiant). Si c'est le cas, le couple nom du navire - identifiant
du navire est validé par vgvr.
Bon c'est pas très dynamique pour l'instant, il faut redémarrer vgvr pour voir apparaître
le nouveau navire ajouté dans la liste... A corriger...
Au nouveau démarrage du logiciel, le navire apparaît bien dans la liste. La section suivante indique comment configurer manuellement sa flotte (sans passer par cette interface
pas très dynamique).
3.3.2. Configuration manuelle
La liste des navires gérés par le logiciel est tout simplement écrite dans un fichier de propriétés au
format texte : ce fichier se nomme vgvr.properties. Ce fichier est créé lors du premier ajout de
navire dans le répertoire USER.HOME de l'utilisateur système courant. Ce répertoire USER.HOME
est le répertoire d'accueil du compte de l'utilisateur système exécutant le logiciel. Typiquement, ce
répertoire d'accueil est, pour l'utilisateur système toto :
• Sous linux : /home/toto/
• Sous mac: /Users/toto/
• Sous windows : C:\Documents And Settings\toto\
Le fichier ressemble à ça :
#Last update: 2009-01-16 01:36
jesus=000000
satan=666999
Le fichier peut également contenir des lignes de commentaire si elles commencent par le caractère
dièse (#). Ces commentaires ne sont pas interprétés.
Il est donc tout à fait possible d'éditer ce fichier USER.HOME/vgvr.properties avec un simple
éditeur de texte et d'y ajouter manuellement la liste des couples (nom de navire, identifiant), un par ligne.
Ce fichier est une liste de couples clé-valeur, un couple par ligne, la clé (sans espace), une virgule, et
sa valeur (un entier positif attendu, 6 chiffres à priori). La clé correspond au nom du navire. La valeur,
c'est l'identifiant Virtual Regatta.
Dans l'exemple de contenu précédent, le logiciel vgvr s'occuperait donc de deux navires nommés
jesus (identifiant : 000000) et satan (identifiant : 666999).
Evidemment, il n'y a aucune vérification que l'identifiant correspond bien au nom du navire enregistré
sur Virtual Regatta ! C'est à vous d'être vigilant sur l'association nom-identifiant.
17
Manuel utilisateur
Les modifications du fichier vgvr.properties ne sont effectives qu'au redémarrage
du logiciel...
3.4. Onglet Position actuelle
L'onglet "Position actuelle" du logiciel permet de faire le point sur la position courante du navire
sélectionné dans la boîte de sélection.
Il affiche les mêmes informations que la page "Profil" du jeu en ligne. Mais pas besoin de se loguer
au jeu !
Comme son nom l'indique, le bouton "Actualiser" permet de rafraichir les informations.
18
Manuel utilisateur
Les mises à jour sur le serveur sont effectuées toutes les 10 minutes environ.
3.5. Onglet Auto record
Cet onglet permet de lancer et d'arrêter l'enregistrement automatique, à interval de temps régulier, les
"profils" des navires gérés dans la flotte.
La boîte de sélection en haut de l'onglet permet de choisir une période parmi les suivantes : 10 minutes,
30 minutes, 1 heure, ..., 24 heures.
Un message au centre indique le statut de l'enregistreur automatique (on/off). Quand l'enregistrement
automatique est lancé, un message indique depuis quelle heure.
Les boutons en bas permettent de lancer et d'arrêter le processus d'enregistrement.
19
Manuel utilisateur
Pour changer la période d'enregistrement quand l'enregistrement est activé, il faut l'arrêter, choisir la
nouvelle période, et le relancer.
L'enregistrement est rapide (quelques secondes), pour n'enregistrer que la position courante des navires, cliquez "lancer" puis "stop" quelques secondes plus tard.
3.5.1. Les fichiers générés
Pour chacun des navires reconnus par le logiciel (contenu du fichier vgvr.properties,
voir Configuration manuelle), l'enregistreur automatique lance une requête à intervals réguliers sur le serveur pour récupérer les profils courants des navires de
la flotte (depuis l'url http://vendeeglobe.virtualregatta.com/profil.php?
id_user=IDENTIFIANT&langue=FR, avec évidemment un IDENTIFIANT pour chaque navire).
Le flux récupéré par vgvr est au format texte html. Les informations (classement, position, voile, ...)
sont contenues dans un tableau html entre des balises <table>. Le logiciel extrait ce tableau, le "parse"
et génère un fichier xml.
Les fichiers xml (un par navire) sont générés dans le répertoire USER.HOME et leur nom suit le modèle
suivant : vgvr_<nom_du_navire>_history.xml. Par exemple, pour un navire nommé toto,
vgvr va générer un fichier vgvr_toto_history.xml.
Le fichier xml généré (un par navire) ressemble à ça :
<?xml version="1.0" encoding="UTF-8"?>
<vgvr version="1.0">
<profile timestamp="200901191751" shipName="bwa">
<position_date>2009-01-19 17:45:01</position_date>
<ranking>27476</ranking>
<latitude>45° 21' 45" S</latitude>
<longitude>48° 47' 39" W</longitude>
<distance_to_finish>6051.86 milles</distance_to_finish>
<distance_from_start>20164.4 milles</distance_from_start>
<ship_speed>12 nds</ship_speed>
<sail>Code zéro</sail>
<wind_speed>11.3 nds</wind_speed>
<wind_angle>119°</wind_angle>
<h24_record_distance>455.9 milles</h24_record_distance>
<h24_record_date>2009-01-13 23H</h24_record_date>
<h24_record_ranking>21853</h24_record_ranking>
<validated_buoy_number>9 Bouées validés</validated_buoy_number>
</profile>
<profile timestamp="200901191806" shipName="bwa">
<position_date>2009-01-19 17:55:01</position_date>
<ranking>27477</ranking>
<latitude>45° 20' 11" S</latitude>
<longitude>48° 46' 25" W</longitude>
(...etc...)
</profile>
</vgvr>
Pour des raisons d'informatichien, le noms des balises xml sont en anglais. Les fichiers
vgvr_*_history.xml sont mis à jour périodiquement suivant la valeur choisie dans la combo
"période" (10 minutes, 30 minutes, ...). La balise "root" vgvr inclut une liste de balises "filles" profile. Chacune de ces balises profile correspond à un profil disponible à un moment donné sur le
serveur sur la page "Profil" d'un navire (page mise à jour toutes les 10 minutes environ) :
20
Manuel utilisateur
1. date (côté serveur) du profil
2. classement
3. latitude
4. longitude
5. distance au but
6. distance parcourue
7. vitesse du navire
8. voile
9. vitesse du vent
10.angle au vent
11.record de distance en 24 heures
12.date du record
13.classement pour le record
14.nombre de bouées validées
vgvr ne "parse" pas la position des bouées validées, par rapport au profil disponible sur
le server Virtual Regatta, les fichiers vgvr_*_history.xml s'arrêtent au nombre de
bouées validées.
Ces fichiers xml permettent donc déjà de suivre l'évolution de son classement, de ses positions... Il
suffit d'ouvrir ces fichiers xml avec un éditeur de texte ou même un navigateur.
Une prochaine version de vgvr devrait permettre de transformer (technologie xslt) ces fichiers xml en
jolis fichiers avec des icônes et tout, et surtout plus faciles à lire pour les humains non-informatichiens.
Je verrais bien un tableau avec les différentes informations, j'ai d'ores et déjà récupéré les icônes :
A SUIVRE...
21
Chapitre 4. Guide du développeur
Documentation technique du logiciel
TODO: mvc, uml, ant, junit, javadoc, cvs, dist
22
Annexe A. Installation de java
En pré-requis, ce chapitre présente l'installation et la configuration de java sur votre système.
A.1. Récupérer le jdk
Depuis le site de sun [http://java.sun.com/javase/downloads/index.jsp], cliquez sur le lien "download"
pour télécharger le jdk. Vous arrivez sur une page chiffrée, pour télécharger le jdk vous devrez accepter
les termes de la licence.
On choisira la version du jdk en fonction de son système :
• Pour debian, on choisira le Linux self-extracting file jdk-6-linux-i586.bin.
• Pour windows, on pourra chosir Windows Offline Installation, Multi-language jdk-6-windows-i586.exe.
A.2. Installation du jdk sous debian
Nous n'utilisons pas ici les outils apt de debian mais préférons maitriser la version de java utilisée et
l'installer manuellement. On installera ainsi java sous le répertoire /opt/, ce répertoire étant conçu
pour de tels programmes externes indépendants des librairies et packages debian.
La procédure d'installation nécessite de se logger en tant qu'utilisateur root. Nous recommandons la
procédure suivante :
• Créer le répertoire /opt/java. Cette arborescence permettra si besoin est d'y placer plusieurs
versions du jdk.
# mkdir /opt/java
• Placer le fichier jdk-6-linux-i586.bin téléchargé ou copié depuis le cdrom sous ce répertoire /opt/java, avant de le décompresser ici.
Pour rendre ce fichier exécutable (si nécessaire), exécuter la commande suivante :
# chmod +x jdk-6-linux-i586.bin
Pour extraire le jdk, on lancera simplement la commande # ./jdk-6-linux-i586.bin
Le répertoire "maison" de java est ainsi créé : /opt/java/jdk1.6.0/
• Instancier la variable d'environnement JAVA_HOME dans le fichier /root/.bashrc : on rajoute
les deux lignes suivantes indiquant au système la "maison" du jdk :
JAVA_HOME=/opt/java/jdk1.6.0
export JAVA_HOME
• Modifier la variable d'environnement PATH pour pointer vers le répertoire bin de votre installation
java. Ainsi, dans le fichier /root/.bashrc on rajoute le répertoire ${JAVA_HOME}/bin au
PATH :
PATH=${JAVA_HOME}/bin:~/bin:"${PATH}"
Afin que le système prenne en compte les modifications survenues sur les variables d'environnement
du .bashrc, on "source" ce fichier :
23
Installation de java
# source .bashrc
On peut tester l'installation du jdk en exécutant la command java -version. En fonction de la version
installée, on obtient un message du genre :
# java -version
java version "1.6.0"
Java(TM) SE Runtime Environment (build 1.6.0-b105)
Java HotSpot(TM) Client VM (build 1.6.0-b105, mixed mode, sharing)
Les commandes java seront ainsi disponibles pour l'utilisateur root. Les autres utilisateurs devront rajouter les mêmes lignes dans le fichier .bashrc de leur répertoire d'accueil (/home/
toto/.bashrc pour l'utilisateur toto).
A.2.1. Exécuter les applets depuis votre navigateur
Afin de rendre disponible les applets sous le navigateur (ici Mozilla Firefox Iceweasel™), il est nécessaire de renseigner le "java plugin".
Pour une version antérieure de Mozilla 1.4 et Netscape, reportez vous à la page de documentation sun [http://java.com/en/download/help/5000010500.xml#selfextracting]
1. Placez vous dans le sous-répertoire plugins du navigateur (exemple pour le navigateur iceweasel : /usr/lib/iceweasel/plugins/).
cd /usr/lib/iceweasel/plugins
2. Dans ce répertoire, créez un lien symbolique vers le fichier de la JRE libjavaplugin_oji.so.
La JRE a été installée sous le jdk.
ln -s /opt/java/jdk1.6.0/jre/plugin/i386/ns7/libjavaplugin_oji.so
3. Démarrer ou redémarrer (s'il est démarré) le navigateur pour qu'il prenne en compte les modifications.
4. Depuis le menu "Edition", choisissez "Préférences". Sous "Avancé", vérifiez que la case "Autorisez
java" est cochée.
Votre navigateur doit pouvoir maintenant reconnaitre et exécuter les applets java. Pour tester, cliquez
le bouton "Verify installation" sur la page test applet [http://java.com/en/download/installed.jsp].
A.3. Installation du jdk sous windows
L'installation sous windows suit la même procédure : on installe le jdk, on ajoute la variable d'environnement JAVA_HOME et on modifie le Path afin de pointer sur le répertoire bin du JAVA_HOME.
On commence par exécuter le fichier jdk-6-windows-i586.exe. Les éléments suivants seront
alors installés :
• le jdk
• la jre
• le java plugin pour les navigateurs
• Java Web Start
24
Installation de java
Lors de l'installation de la jre, il vous sera demandé si vous désirez installer le java plugin.
Acceptez pour pouvoir lire les applets java depuis vos navigateurs.
Il est alors nécessaire de créer une nouvelle variable d'environnement, JAVA_HOME.
Depuis l'explorateur windows par exemple, cliquez droit sur "Poste de travail", puis cliquez "Propriétés", choisissez l'onglet "Avancé" puis cliquez le bouton "Variables d'environnement".
Dans la partie "Variables système", cliquez le bouton "Nouveau". Pour le champ "Nom de la variable",
inscrivez JAVA_HOME, dans le champ "Valeur de la variable", indiquez le répertoire d'installation du
jdk (exemple : C:\Program Files\Java\jdk1.6).
Les images suivantes présentent les fenêtres alors parcourues.
25
Installation de java
Une fois la variable système JAVA_HOME créée, on modifie la variable Path en choisissant "Path"
et en cliquant le bouton "Modifier". Dans le champ "Valeur de la variable", on rajoute AU DEBUT
(important !) du champ %JAVA_HOME%\bin;.
L'image suivante présente une copie d'écran de l'opération :
26
Installation de java
On valide en cliquant les boutons "OK".
Pour tester l'installation du jdk, on ouvre une nouvelle console dos (aussi nommée "Invite de commandes", disponible depuis le menu "Accessoires" de windows) dans laquelle on tape java -version.
Le résultat doit correspondre à l'image suivante, à la version installée près...
27
Annexe B. Glossaire
Trouvez ci-dessous par ordre alphabétique une définition des acronymes utilisés dans ce document.
build : ant build process : action de générer une suite de taches automatiques à l'aide de ant
[http://ant.apache.org]. Exemple : compiler, lancer des tests JUnit, créer un .jar, etc...
IDE : Integrated Development Environment (environnement de développement).
Logiciel conçu pour faciliter le développement de programmes. Exemple : Eclipse [http://
www.eclipse.org].
jdk : Java Development Kit : permet de développer des programmes en language java. Une
Java Runtime Environment est incluse dans un jdk.
JRE : Java Runtime Environment (machine virtuelle java), permettant d'exécuter des applications et applets écrites en java. Voir le site java.sun.com [http://java.sun.com] pour plus d'informations.
JVM : Java Virtual Machine machine virtuelle java. Moteur permettant d'interpréter du code
java.
vgvr : Vendée Globe Virtual Regatta : logiciel décrit dans ce document pour faciliter le
suivi de la course virtuelle du même nom.
28
Annexe C. A propos
Ce document a été généré le 2009-01-21 13:30:44 (année-mois-jour heure:minutes:secondes).
Tableau C.1. Historique des versions de ce document
Version
Build date
Remarque
1
2009-01-21 13:30:44
Manuel utilisateur ajouté.
0.1
2009-01-14
Découpage de ce document en
différentes parties.
0
2008-12-27
Création du document.
Crédits :
• Toutes les images sont récupérées depuis le site officiel de la Virtual Regatta [http://
www.virtualregatta.com] et ajustées avec The Gimp [http://www.gimp.org].
• Ce documentat a été écrit et généré à l'aide de DocBook [http://www.docbook.org] et ant [http://
ant.apache.org].
• Le logiciel vgvr est développé sous l'Integrated Development Environment Eclipse [http://
www.eclipse.org] et "buildé" avec ant [http://ant.apache.org].
Pour toute question suggestion ou commentaire, visitez http://bworld.free.fr ou envoyez un mail à
<[email protected]>.
29