Travail préalable

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

Récupération des sources nuxeo

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

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

Utiliser mercurial et forest via cette commande :

hg fclone -r release-5.1.6 http://hg.nuxeo.org/nuxeo nuxeo

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 :

  hgf update 5.1.6
  

  Rappel : hgf est une petite fonction shell proposée par Nuxeo (voir ci-dessus et page précédente).

  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 :

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

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

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