##################################

##  Opale V1b4 		        ##
##  NOTES POUR L'INSTALLATION   ##

##################################

Selon l'usage envisag de la bibliothque Opale, deux types d'installation s'offrent  vous : l'installation utilisateur ou l'installation dveloppeur.

Essentiellement elles sont identiques si ce n'est que l'installation dveloppeur consiste  dfinir des variables d'environnement afin de pouvoir utiliser des scripts facilitant les tches de compilation. 


1)INSTALLATION UTILISATEUR

Pour utiliser les classes de la librairie dans vos propres programmes, il suffit de placer dans la variable CLASSPATH le chemin complet de l'archive opale.jar. Par exemple en bash :
export CLASSPATH=$CLASSPATH:/home/cioni/OpaleV1b2/opale.jar
Une autre possibilit consiste  indiquer  chaque fois  la machine virtuelle java le chemin de l'archive, par exemple :
java -classpath .:/home/cioni/OpaleV1b2/opale.jar MyClass

Si vous dsirez utiliser la bibliothque opale dans une applet il suffit d'indiquer dans le champ ARCHIVE  du tag APPLET le chemin de l'archive opale.jar. Par exemple si l'archive opale.jar se trouve au mme niveau que la classe applet, on crira :
<APPLET CODEBASE=. CODE=AppletOpale.class ARCHIVE="opale.jar" WIDTH=500 >

 
2)INSTALLATION DEVELOPPEUR (POUR UNIX SEULEMENT)
  
Cette installation vous concerne si vous dsirez dvelopper vos propres classes directement dans le projet et/ou modifier, amliorer certaines existantes. Elle a pour but de mettre  disposition du programmeur des scripts facilitant la compilation du projet, la cration de la documentation de l'API...  

Pour dcompresser les sources : jar xvf opale_src.jar 

On obtient le rpertoire opale/ et les sous rpertoires correspondants aux modules prsents dans la version courante de Opale. 
 
Pour pouvoir travailler avec ces sources il convient de placer dans le CLASSPATH le chemin complet du rpertoire opale/ par exemple sous le shell bash:
export CLASSPATH=$CLASSPATH:/home/cioni/OpaleV1b2/
si opale/ se trouve dans /home/cioni/OpaleV1b2/.
 
De plus pour bnficier des outils (scripts prsents dans le sous-rpertoire utils/sh/) il faut placer la variable d'environnement OPALE_DIR de telle sorte qu'elle indique aussi le chemin d'accs au rpertoire opale/. Cette variable permet d'utiliser les scripts contenus dans utils/sh/ qui servent  simplifier les tches de compilation (voir utils/sh/documentation.txt). Par exemple :
export OPALE_DIR=/home/cioni/OpaleV1b2/

Enfin vous pouvez rajouter le chemin $OPALE_DIR/utils/sh  la variable d'environnement PATH afin de pouvoir acceder directement aux scripts de n'importe quel endroit. En bash :
export PATH=$PATH:$OPALE_DIR/utils/sh

L'automatisation de ces tches est possible par exemple en crivant les instructions prcdentes dans le fichier .bash_profile qui est execut  chaque ouverture de terminal sous bash.

Pour l'instant ces scripts sont crits uniquement en shell sh et fonctionnent donc sous la plupart des systmes Unix. Une version DOS de ces scripts est prvue.


** ASTUCES **

Si vous desirez travailler avec plusieurs versions d'Opale, il est peut tre
bon
de crer un lien symbolique comme suit 

ln -s  ~/OpaleV1b2/ ~/Opale

vous changez le lien des que vous voulez changer de version, vos PATH, CLASSPATH ET OPALE_DIR peuvent 
ainsi toujours rester sur  ~/Opale

de la maintenance en moins c'est toujours bon a prendre.



Une fois que l'installation est faite, vous pouvez tester l'archive en tapant java opale.Info : si un message d'information sur Opale apparait c'est que l'installation s'est bien passe. Ensuite il est possible de lancer des cas tests ; pour cela lire le fichier TEST.TXT.
