Vous êtes ici : 6.0 > Guide du développeur > Environnement de développement

Environnement de développement




Ce document présente les différents logiciels à installer, ainsi que leurs configurations, afin de pouvoir exécuter un environnement K-portal V6. Avant de commencer veuillez vérifier que les pré-requis ci-dessous sont remplis:


  1. Disposer des droits d’administration de sa machine
  2. Disposer d’un accès à Internet


1- Récupération des binaires

À noter: Sur des postes linux, il est recommandé d’installer subversion 1.7 (intégré sur les dépots)

  • Télécharger eclipse 4.3 (au minimum), la version JavaEE.
  • Télécharger apache maven 3.0 (version extractable)
  • Télécharger apache tomcat 7.0 (version extractable)
  • Télécharger openJdk7 (nous sommes aussi compatible jdk7) (version extractable)
  • Télécharger la dernière version de mysql (seulement sous windows)

2- Installation

À Noter: [user] = nom de l’utilisateur courant

2.1- Maven

  • Extraire maven dans un répertoire (exemple: /home/[user]/kosmos-apps/ maven)
  • Garder le fichier par défaut dans "maven/conf/"
  • Configurer le repository maven kosmos
    • Si vous n'avez pas de configuration spécifique maven : Récupérer le fichier settings et le placer dans votre Home, dans un répertoire ".m2" (si le répertoire n'existe pas, le créer)
    • Si vous avez déjà une configuration spécifique maven : Ajouter le repository Kosmos comme indiqué sur cette page

2.2- Tomcat

2.3- JDK

  • Extraire la jdk dans un répertoire (exemple: /home/[user]/kosmos-apps/java),
  • Pour les postes Linux, installer openJdk7 depuis les dépots.

2.4- Eclipse

  • Extraire éclipse dans un répertoire (exemple: /home/[user]/kosmos-apps/ eclipse)
  • Se placer dans le répertoire d’extraction (exemple: /home/[user]/kosmos-apps/ eclipse/eclipse-xx) 
  • Editer le fichier “eclipse.ini”, ajouter (ou remplacer si l’argument existe déjà) la ligne suivante (en replaçant le path par le bon chemin): -vm /home/ [user]/kosmos-apps/java/versionJdk/bin (Pour connaître la syntaxe : http:/ /wiki.eclipse.org/Eclipse.ini#-vm_value:_Windows_Example)
AN : sous Windows, on peut faire la modif dans les propriétés d’un raccourci vers Eclipse.

2.5- Mysql

Sous windows lancer le setup et suivre les instructions, sous linux installer mysql depuis les dépots officiels.



3- Configuration

3.1- Tomcat

  • Dans le répertoire d'installation de tomcat éditer le fichier conf/server.xml
  • Localiser la balise "<Connector port=(...)" non commentée (qui ne commence pas par "<!--" et ajouter avant la fin de la balise ("/>") la variable suivante: URIEncoding="UTF-8"

3.2- Éclipse

  • Lancer éclipse
  • Vérifier la présence des plugins suivants, sinon les installer :
    • via “Eclipse Marketplace” : 
      • WST server adapters
      • JST server adapters
      • m2e (Maven Integration for Eclipse)
      • m2e-wtp
    • via “Install New Software” : 
      • subclipse 1.8 (http://subclipse.tigris.org/update_1.8.x) 
      • m2e-subclipse (http://subclipse.tigris.org/m2eclipse/1.0/)
      • Web Tools Platform (http://download.eclipse.org/webtools/updates/) 
En cas d’erreur “Failed to load JavaHL Library” au lancement d’Eclipse (ou d'une synchro svn), installer le paquet “libsvn-java” via la Logithèque Ubuntu pour que les librairies nécessaires soient rendues disponibles sur le poste. 
  • Commandes:
    • sudo apt-get install libsvn-java
    • sudo updatedb
    • locate libsvnjavahl-1.so
  • Copier le chemin de dossier de libsvnjavahl-1.so et ajouter la ligne suivante dans votre eclipse.ini, après -vmargs : -Djava.library.path=/usr/lib/x86_64-linux-gnu/jni/ (remplacer /usr/lib/... par le chemin trouvé précédemment). 

3.2.1- Mémoire allouée

  • Éditer le fichier eclipse.ini
  • Placer l'attribut Xms à 1024 (permet de réserver de la mémoire vive au démarrage) 
  • Placer l'attribut Xmx à 2048 (permet de spécifier la mémoire vive maximum)
  • Sauvegarder et lancer éclipse 

3.2.2- Maven sous éclipse

  • Cliquer sur window/preferences/maven/installations -> Add -> Sélectionner le répertoire d’installation (exemple: /home/[user]/kosmos-apps/maven/apache- maven-3.0.5/) et valider.

3.2.3- Tomcat sous éclipse

  • Cliquer sur window/preferences/server/Runtime Environnement -> Add - > Apache Tomcat7 + “create a new local server” -> next -> browse -> sélectionner l’installation de tomcat (exemple: /home/[user]/kosmos-apps/ tomcat/apache-tomcat-7.0.x”) -> Finish
  • Aller dans "run"/"run configuration" sélectionner lancer de votre nouveau serveur Tomcat et dans les arguments ajouter "-Xms1024m -Xmx1024m" puis sauvegarder. 
  • Vérifier dans la configuration du serveur Tomcat (sur éclipse) que l'encodage du connecteur est en UTF-8:
    • Editer le fichier Servers/Tomcat v7.0 Server at localhost-config/server.xml
    • Vérifier que pour la variable ' URIEncoding="UTF-8" ' est bien présente dans la balise "Connector"

3.2.4- Eclipse en UTF-8

  • Cliquer sur window/preferences/General/Content Types -> Déplier tout l’arbre, se placer sur chaque entrée (une a une) et saisir dans “Default encoding” la valeur “UTF-8” et cliquer sur “update” (a chaques fois)

3.2.5- Désactivation de la validation jsp et js

  • Cliquer sur: window/preferences/validation -> Décocher javascript validator + les validations JSP


4. Installation d'un compilateur Sass/Compass

4.1  Installation sous Linux

Dans un terminal taper les commandes suivantes :

sudo apt-get install make ruby ruby-dev
sudo gem install sass -v 3.3.14
sudo gem install zen-grids -v 1.5
sudo gem install compass -v 1.0.3

4.2 Installation sous Windows

1/ Télécharger et installer Ruby : rubyinstaller.org/downloads/

NB : Penser à bien cocher la case "Add to Path"

2/ Dans une invite de commande windows taper :

gem install sass -v 3.3.14
gem install zen-grids -v 1.5
gem install compass -v 1.0.3