Projet esup-ecm

Recherche

Sommaire

Pages enfant
  • Environnement de développement

Comparaison des versions

Ancienne version 2

changes.mady.by.user Raymond Bourges

Sauvegardée le

comparé à

Nouvelle version Actuel

changes.mady.by.user Vincent Bonamy

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Commentaire: Migrated to Confluence 5.3
Sommaire

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.

Remarque

Les procédures ci-dessous peuvent prendre plusieurs minutes

...

Utiliser mercurial et forest via cette commande :

Bloc de code
hg fclone -r release-5.1.6 http://hg.nuxeo.org/nuxeo nuxeo
cd nuxeo
Info
Si vous utiliser TortoiseHg il faut enlever le "!" à la fin de la ligne "hgext.forest =" dans le fichier Mercurial.ini pour activer l'extension forest.
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=128m256m
  • 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
    hgf updatehg fupdate -C 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
      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 :

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