Projet esup-ecm

Recherche

Sommaire

Pages enfant
  • Environnement de développement

Travail préalable

Créer un répertoire de travail. <nuxeo-dev> dans la suite de ce document.

Vérifier que vous utilisez :

  • maven 2.0.10

    Si vous utilisez déjà maven. Vérifier, avec la commande mvn help:describe -Dplugin=eclipse, que le plugin eclipse pour maven est en version 2.5.1. Il est possible de faire une mise à jour avec une commande du type mvn -U eclipse:clean

  • ant 1.7.1
  • jdk 1.6.0_12

Récupération des sources nuxeo

Nuxeo utilise pour la gestion de versions de ses sources l'outil mercurial. cf. FAQ nuxeo à ce sujet

Comme proposé ci-dessous cependant, privilégiez l'usage de mercurial + forrest à l'usage de scripts bash spécifiques Nuxeo (hgf et hgx) que propose la FAQ de Nuxeo : forrest allié à mercurial est en effet plus usuel, souple et puissant : pour avoir l'"effet forrest" (portée des commandes à tout l'arbre ou plutôt toute la forêt des repositories mercurial), préfixez simplement d'un f les commandes standards mercurial.

Les procédures ci-dessous peuvent prendre plusieurs minutes

Typiquement ici nous clonons (terme mercurial) dans le répertoire <nuxeo-dev> les repositories suivants :

Voir la page téléchargement sourcesup pour connaitre les numéros de versions exactes. Dans l'exemple ici nous utilisons la version 5.1.6. Elle même liée à une version 1.4 de nuxeo-core.

Utiliser mercurial et forest via cette commande : 

hg fclone http://hg.nuxeo.org/nuxeo nuxeo
cd nuxeo
hg fupdate -C 5.2.0
hg fupdate -C 1.5.0

Ensuite, il est possible de rendre ces différentes sources des projets Eclipse.
Dans le répertoire <nuxeo-dev>/nuxeo :

  • Positionner la variable d'environnement MAVEN_OPTS à -Xmx512m -XX:MaxPermSize=256m
  • Lancer mvn -Dmaven.test.skip=true install
  • Lancer mvn eclipse:eclipse
  • Importer dans eclipse les différents projets :
    • File > Import > General > Existing Projects Into Workspace
    • Sélectionner <nuxeo-dev>/nuxeo

Récupération des "addons"

  • Si on souhaite récupérer tous les addons, on utilisera les commandes suivantes depuis le répertoire <nuxeo-dev> : 
    hg fclone http://hg.nuxeo.org/addons addons

    Rappel : hg fclone est disponible grâce à forest(voir ci-dessus et page précédente).

  • Puis depuis le répertoire addons : 
    hg fupdate -C 5.1.6
    Ici des problèmes peuvent apparaître sur hg update 5.1.6 pour les plugins/addons qui n'ont pas de release 5.1.6 ...
  • Enfin d'importer les sources des addons en tant que projets eclipse, on peut également, dans chacun des répertoires correspondants aux addons qui nous interessent :
    • Invoquer la commande 
      mvn eclipse:eclipse
    • Importer dans eclipse le projet :
      • File > Import > General > Existing Projects Into Workspace
      • Sélectionner <nuxeo-dev>/addons/<nom_addon>

Récupération du projet ESUP-ECM

Ici on utilise un subversion plus classique.

Typiquement ici nous faisons un checkout (terme subversion) dans le répertoire <nuxeo-dev>/esup-ecm le repository suivant :

Ensuite on crée les projets dans eclipse

  • Dans le répertoire <nuxeo-dev>/esup-ecm/esup-ecm-config-plugin :
    • Lancer mvn -Dmaven.test.skip=true install
    • Lancer mvn eclipse:eclipse -DdownloadSources=true

      Pour partir sur un projet "propre" il est conseillé de faire avant : mvn clean puis mvn eclipse:clean

  • Importer dans eclipse le projet :
    • File > Import > General > Existing Projects Into Workspace
    • Sélectionner <nuxeo-dev>/esup-ecm/esup-ecm-config-plugin
  • Pour travailler sur le package ESUP-ECM dans son ensemble. Dans eclipse
  • File > New > project (choisir un type standard)
    • nom esup-ecm
    • content pointant sur <nuxeo-dev>/esup-ecm

Test du projet ESUP-ECM

Il est intéressant, à ce stade de tester le plugin. Pour cela, dans le répertoire <nuxeo-dev>/esup-ecm :

  • Editer le fichier build.properties pour personnaliser la propriété jboss.dir. Elle devrait correspondre au répertoire de déploiement de ESUP-ECM suivit du nom du répertoire correspondant à la version de nuxeo intégrée dans ESUP-ECM. Exemple : /data/nuxeo/esup-ecm-<version>/nuxeo-ep-<version>.GA
  • Lancer ant deploy
  • Lancer ESUP-ECM
  • Tester via http://localhost:8080/nuxeo que vous obtenez un onglet ORI-OAI après avoir cliqué sur un fichier contenu dans un espace nuxeo
  • Stopper ESUP-ECM
  • Aucune étiquette