deniger
2003-02-05
Description de la procédure à suivre pour installer le projet.

Fudaainstallation et organisation du projet

Cette page présente l'organisation des sources du projet Fudaa.

Avant de mettre en place Fudaa, vous devez installer CVS/ssh. Vous pouvez vous aider du document d'installation de CVS/ssh

Les outils à installer

Fudaa utilisent la machine virtuelle compatible JRE 1.3. Pour le développement, vous devez télécharger un kit de développement 1.3.

Le dossier volume d'ebli et certains projets de fudaa (vag, seuil, hiswa, ...) utilisent java3D: il conseillé d'installer cette librairie.

Les kits de développement:

  • -Le kit de développement de Sun.
  • -Le kit d' IBM.

La bibliothèque Java 3D:

Vous devez également installer l'outil ant qui est utilisé pour la compilation du projet.

Récupérer les sources

Pour travailler avec Fudaa, vous devez "rapatrier" ( cvs checkout ) les sources de fudaa sur votre poste. Vous trouverez les informations nécessaires sur le page CVS de sourceforge.

windows

Votre client cvs doit être configurer comme indiqué dans le document d'installation de CVS. Ensuite, vous devez renseigner les champs suivants (pour winCVS):

  • CVSROOT : votreId@cvs.sourceforge.net:/cvsroot/fudaa
  • type d'authentification : SSH server

Pour eclipse, les renseignements à fournir diffèrent:

  • Host : cvs.sourceforge.net
  • Repository Path : /cvsroot/fudaa
  • Connection type : ext

Vous pouvez maintenant rapatrier le module fudaa_devel sur votre poste : le menu Create/checkout module pour winCVS.

  • !!! Avant de lancer le "checkout",n'oubliez pas de lancer l'agent ssh comme indiqué dans le document d'installation de CVS

Unix/Linux

Il suffit d'exécuter les commandes suivantes :

export CVS_RSH=ssh
cvs -z3 -d:ext:votreNom@cvs.sourceforge.net:/cvsroot/fudaa/ co fudaa_devel

Vous pouvez également récuperer le module fudaa_scripts qui pourront vous simplifier certaines tâches. Pour vos prochaines commandes cvs, vous pourrez utiliser le script suivant:

#!/bin/sh

export CVS_RSH=ssh

EXEC_REPOSITORY=:ext:votreNom@cvs.sourceforge.net:/cvsroot/fudaa
\cvs -z3 -d "$EXEC_REPOSITORY" $*

L'organisation des sources

Voici l'arborescence initiale du projet Fudaa:

  fudaa_devel
  |
  |--aide
  |    |-src       l'aide (html) des applications
  |
  |--ctulu
  |    |
  |    |-src       les sources java du projet ctulu
  |    |-lib       les libraires du projet ctulu
  |
  |--dodico
  |    |
  |    |-src       les sources java du projet dodico
  |    |-idl       les sources idl du projet dodico
  |
  |--ebli
  |    |
  |    |-src       les sources java du projet ebli
  |
  |--fudaa
  |    |
  |    |-src       les sources java du projet fudaa

Ajouter les liens pour les serveurs, l'aide et les exemples

Votre application aura besion d'un dossier serveurs qui contiendra les exécutables des codes de calculs. Ce dossier doit être ajouté dans les projets dodico et fudaa. Vous devez créer les dossiers fudaa_devel/dodico/serveurs et fudaa_devel/fudaa/serveurs. Sous unix/linux le dossier serveur sera un lien symbolique. Le dossier d'aide doit également être disponible à la base du projet fudaa: vous devrez créer le dossier fudaa_devel/fudaa/aide. Sous unix/linux, ce dossier pourra être un lien symbolique vers fudaa_devel/aide/src. De la même façon, vous pourrez ajouter un dossier pour les exemples de votre applications. Tous ces dossiers seront ignorés par CVS.

La compilation

Pour chaque projet, la compilation ( ainsi que génération de la javadoc, du jar des fichiers java ...) se feront dans le dossier build. Pour le projet fudaa; un dossier de distribution (fudaa_devel/fudaa/dist) contiendra les classes et les jars destinés à être fournis aux utilisateurs.

L'arborescence finale du projet

  fudaa_devel
  |
  |--aide
  |    |-src
  |
  |--ctulu
  |    |
  |    |-src
  |    |-lib
  |    |-build            dossier généré
  |       |-classes       les classes de ctulu
  |       |-javadoc       la javadoc de ctulu
  |       |-ctulu.jar     le jar de ctulu
  |
  |--dodico
  |    |
  |    |-src
  |    |-idl
  |    |-serveurs         lien vers vos codes de calculs
  |    |-build
  |       |-java_genere   les fichiers java généré à partir de l'idl
  |       |-classes
  |       |- etc...
  |
  |
  |--ebli
  |    |
  |    |-src
  |    |-build
  |       |-classes
  |       |- etc...
  |
  |--fudaa
  |    |
  |    |-src
  |    |-aide             lien vers votre aide
  |    |-serveurs         lien vers vos codes de calculs
  |    |-build
  |    |  |-classes
  |    |  |- etc...
  |    |
  |    |-dist             le repertoire des fichiers a distribuer
  |       |-classes       les classes de tous les projets
  |       |-fudaa.jar     le jar a distribuer

La prochaine étape: la compilation du projet