Paramétrage d'Eclipse
Contents |
Installer et Configurer OfbizNeogia sur l'IDE Eclipse, sous Windows
Comment installer et configurer OfbizNeogia:
Paquetages nécessaires:
- jdk1.5.0_03 (version exécutable) minimum (marche aussi avec le jdk-6u12)
- Tomcat 5.5 (est déja embarqué dans ofbiz: vous n'avez pas besoin d'installer)
- Eclipse 3.2 (dossier) (marche aussi avec la version 3.4.0)
- apache-ant-1.7.0-bin.zip (version zippé)
- RQ : nous avons travaillé sur une machine Windows XP, Pentium IV, mémoire de 256Mo de ram, disque dur 20 Go.
Installation
- Installation du jdk
- Il faut d’abord installer le JDK en lançant l’exécutable, comme n’importe quelle installation sous Windows.
- Créer la variable d’environnement JAVA_HOME qui correspond au répertoire dans lequel vous avez installé le JDK.
- Installation de Tomcat
- ofbizNeogia est une application web compatible J2EE mais different des applications web classique. dans la mesure où ofbizNeogia utilise un serveur d'application,par défaut tomcat, embarqué dans ofbiz.
ofbizNeogia embarque également une base de données nommée Derby, mais laisse beaucoup de possibilité à l'utilisateur de configurer les sgbd que ce dernier souhaiterai utiliser(Mysql, postgres, oracle, sql server, hsql).
- Installation de Apache Ant (optionnel : déjà inclu en plugin dans Eclipse)
- Dézipper apache-ant-1.7.0-bin.zip sur un répertoire de votre choix sur votre système.
- Le dossier de Ant deviendra apache-ant-1.7.0.
- Créer la variable d’environnement ANT_HOME qui correspond au répertoire dans lequel est installé Ant.
- Installation de Eclipse
- Copier le répertoire d’éclipse sur le disque de votre système.
- L’installation de éclipse ne demande pas de lancer un fichier (setup.exe) comme plusieurs logiciels que vous installez.
- Elle nécessite tout simplement de désarchiver (dézipper si le paquet est au format zip) le paquet sur un répertoire de votre choix sur le disque dur. Un dossier eclipse est crée et à l’intérieur plusieurs fichiers et dossiers.
- Pour lancer eclipse double cliquez sur l’exécutable (eclipse.exe) du répertoire eclipse.
- Si c’est la première fois que vous lancez eclipse, une boite de dialogue vous demandera dans quel répertoire eclipse doit créer le répertoire de travail ou Workspace.
- Nous avons mis le Workspace dans le répertoire eclipse. Le Workspace est votre espace de travail. C’est dans ce répertoire où seront enregistrer tous les projets que vous allez créer.
Configuration d'Eclipse
- Lancez éclipse, en double cliquant sur l’executable (eclipse.exe) situé dans le répertoire eclipse.
- Sur l’onglet windows -> preferences->ant ->runtime -> ant_home, entrez le chemin vers le repertoire d’installation de ant, puis cliquer sur le bouton «apply» pour que le système tiens compte des modifications.
- Sur windows -> preferences->java->compiler, selectionnez la valeur 5.0 du « jdk compliance » sur le volet droit. (ou 6.0 si vous avez la version 6)
- Sur windows -> preferences->java->installed jres, verfier que c’est le jre 1.5 ou superieur qui est installé.
- Dans le menu Window -> Preferences ...
- Ant -> Editor -> Formatter, Tab size = 2
- Ant -> Editor -> Formatter, décocher "use tab character instead of space"
- Java -> Code style -> Formatter, Sélectionner le profile "Eclipse", et sélection "space only"
- Web and XML (ou Web) -> CSS File -> CSS Source -> Sélectionner "Indent using spaces"
- Web and XML (ou Web) -> CSS File -> CSS Source -> Indentation size = 4
- Web and XML (ou Web) -> HTML File -> HTML Source -> Sélectionner "Indent using spaces"
- Web and XML (ou Web) -> HTML File -> HTML Source -> Indentation size = 2
- Web and XML (ou XML) -> XML File -> XML Source -> Sélectionner "Indent using spaces"
- Web and XML (ou XML) -> XML File -> XML Source -> Indentation size = 2
- team -> file content -> ajouter *.ftl, *.bsh et *.groovy en ascii
- team -> cvs - onglet(files and folder) -> Default text mode = ko
- General -> Editor -> File Associations -> Ajouter "*.bsh" et "*.groovy" dans "File Types" et "Java editor" dans "Associated Editors"
- Java -> Compiler -> Errors/Warnings -> Generic types ->Uncheked generic type operation : Ignore ---- Usage of a row type -> Ignore
- Chargement des DTD Néogia pour les fichiers XML :
- File -> Import -> XML -> XML Catalog -> Sélectionner un dossier et son ".xmlcatalog"
Importation du projet ofbizNeogia
- Importation de OfbizNeogia ( Importer le projet ) via le cvs
Il est possible de télécharger ofbizNeogia à partir du cvs en passant par ofbiz :
file > import > project from cvs > Create a new repository location avec comme paramètre :
- connection type : pserver
- User : anonymous
- Host : cvs.labs.libre-entreprise.org
- Port : Default
- Repository path : /cvsroot/neogia
- module : ofbizNeogia
Bien faire attention à la branche que vous voulez télécharger.
- Importation de OfbizNeogia ( Importer le projet ) via un zip
- Téléchargez la version voulue sur http://sourceforge.net/project/showfiles.php?group_id=128662&package_id=140915
- Avant de commencer la configuration d’ofbizNeogia, vous devez dézipper le paquetage ofbizNeogia-X_X_X-src.zip sur le dossier Workspace de votre eclipse.
- Ensuite allez sur la fenêtre principale d’eclipse pour importer le projet sur eclipse.
- Pour cela cliquer sur le menu Fichier-> import.
- une fenêtre s’ouvre pour vous donnez la possibilité de choisir le projet que vous voulez importez.
- Sélectionnez « existing project into Workspace » ou « projet existant dans la zone de travail ». le système prendra quelques minutes pour importer votre projet.
- Les fichiers à ajouter au chemin de compilation(java build path)
- Sélectionner le projet, faire un click droit, sélectionner propriétés.
- Sélectionner Java Build Path, sur le volet droit, sélectionnez l’onglet Librairies. Sur cet onglet vous allez ajouter :
- une class Folder avec la valeur /framework/base/config
- Tous les fichiers jars se trouvant sur /framework/catalina/build/lib
- les jars commençant par derbyxxxx.jar se trouvant sur /framework/entity/lib/jdbc.
- Le fichier ant.jar se trouvant sur /framework/jetty/lib
- Un External jar tools.jar se trouvant sur le repertoire /lib du chemin d’installation de votre jdk c'est-à-dire \Program Files\Java\jdk1.5.0_03\lib
- Nb : pour toutes manipulations que vous faites, n’oubliez pas d’appliquer pour que le système puisse prendre en compte les modifications
- une class Folder avec la valeur /framework/base/config
Préparer la compilation
- Revenir sur l’écran principal de eclipse
- Dérouler l’arborescence du projet ofbizNeogia
- Sélectionnez le fichier build.xml et cliquez droit
- Sélectionnez debug, ensuite 2 ant build..,
- cette fenêtre s'ouvre.
- Deux onglets nous interrese ici :
- l’onglet targets : Sur cet onglet, décochez Build et cocher run-install-fr, puis validez.
- l’onglet Classpath Bien renseigner la variable Ant_home
- Appliquer les modifications, puis cliquez sur le bouton debug.
- La construction débutera et un fichier Ofbiz.jar sera crée.
- Si vous ne le voyez toujours pas, clique droit sur votre projet et "Refresh"
Executer votre projet
- Commencer par sélectionner le projet,
- cliquez droit sur le projet, sélectionnez Run As sur le menu contextuel, ensuite choisir Run…
- Double cliquez sur java application sur le volet gauche, une nouvelle configuration est créée.
- A. Sur l’onglet Main, Nommez la nouvelle configuration « ofbizNeogia, par exemple »
- Sur le champ Main class , donnez la valeur : org.ofbiz.base.start.Start,vous pouvez lancez la recherche en cliquant sur le bouton « Search.. »,
- appliquer les modifications.
- B. Sur l’onglet (x=) Arguments :
- Renseigner le champ VM arguments par les valeur : -Xms128M -Xmx256M
- nb: si d'après les tests j'ai effectués les valeurs 128 et 256 des arguments de la VM dépendent de votre Ram. si vous utilisez une Ram de 256Mo mettez ceci: -Xms256M -Xmx512M.
- appliquer les modifications
- C. Sur l’onglet Classpath, ajouter le jar Ofbiz.jar sur le parametre User Entries,
- pour cela cliquez sur le bouton add Jars…,
- dérouler +ofbizNeogia et sélectionnez Ofbiz.jar, qui se trouve directement à la racine de cette arborescence.
- Enlever le "default Classpath" (On ne doit avoir dans "User Entries" que le ofbiz.jar)
- Ajouter le jar ofbiz.jar en suivant la description effectué un peu plus haut.
- D. Sur l’onglet Environment, créez la variable d’environnement LC_ALL, affectez la, la valeur C.
- Appliquez les modifications, puis cliquez sur le bouton Run, pour exécuter le projet.
Ainsi se termine l'installation et configuration de ofbizNeogia dans eclipse.
Infos conseil
Lorsque nous avons installé ofbizNeogia sur eclipse3.0, nous avons eu beaucoup d’erreur. C’est lorsque nous avons demandé sur le forum, qu’un membre de l’équipe Neogia nous a fait savoir que c’était notre eclipse qui ne reconnaissais pas les nouveaux syntaxes de Java.
Eclipse3.0 utilise le JRE 1.4, même si on installe le jsdk 1.5, eclipse 3.0 ne reconnaissait pas. Donc nous avons changé eclipse 3.0 par eclipse3.2 qui prend en compte le JRE 5.0 et 6.0. Après exécution aucune erreur n’est apparue.
Le conseil que nous donnons c’est d’utiliser les nouvelles versions des outils utilisés, sur le projet ofbizNeogia lors des développements.
L’installation et la configuration a été testée sur plusieurs machines, (plus de 10 fois) et marche correctement. Bonne chance. !!!!
Ecrit par:
- Abdillah Hachim Djoumoi
- Audran Nkounkou SAMBA
- Pour tous éclaircissements, adressez vous sur le forum ou sur la mailling list
Conventions de codage
Neogia suit les mêmes conventions de codage que le projet Ofbiz. Les conventions de ce dernier peuvent être trouvées sur le wiki du projet http://ofbizwiki.go-integral.com/Wiki.jsp?page=FAQ27
- Encodage des fichiers sources : UTF-8
- Format d'indentation : espaces
- Taille d'indentation : 4 pour java, 2 pour xml
- Langue utilisée pour les commentaires des codes sources : anglais
- Langue utilisée pour les messages de commits : anglais
- type de fichier cvs Ascii pour ftl et bsh
- mode texte cvs par defaut ko
Conventions de codage spécifiques à java : Code Conventions for the JavaTM Programming Language
