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

  Remarque
  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.

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

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> :

  Bloc de code
  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 :

  Bloc de code
  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

    Bloc de code
    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 :

• https://subversion.cru.fr/esup-ecm/esup-ecm-config/trunk/

  Remarque
  Un autre projet d'exemple intéressant est fourni par nuxeo : cf. http://svn.nuxeo.org/nuxeo/org.nuxeo.project.sample

  Bloc de code
  svn co https://subversion.cru.fr/esup-ecm/esup-ecm-config/trunk/ .

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

    Remarque
    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