Projet esup-ecm

Recherche

Sommaire

Pages enfant
  • Environnement de développement

Comparaison des versions

Ancienne version 1

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. 

Installation d'ESUP-ECM 

Pour développer il faut utiliser une base qui sera la dernière version de ESUP-ECM :

  • Télécharger la dernière version depuis sourcesup
  • Suivre la documentation "Guide d'installation"

Création d'un projet vide

Dans la documentation nuxeo (à partir de Generate a new project with the nuxeo-archetype-start archetype) il est proposé une solution pour créer un projet de base qui permet de démarrer un nouveau développement. Dans cette section nous allons procéder différemment. En effet, nous allons utiliser un projet préexistant afin de démontrer certains concepts. De plus, nous allons procéder au rapatriement des sources de nuxeo afin d'en disposer en tant que projet eclipse.

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

Import des projets dans eclipse

Il est temps maintenant d'importer dans eclipse les différents projet nuxeo et le projet tuto-plugin-nuxeo

Dans eclipse :

  • File > Import > General > Existing Projects Into Workspace
  • Sélectionner <nuxeo-dev>/nuxeo
  • File > Import > General > Existing Projects Into Workspace
  • Sélectionner <nuxeo-dev>/nuxeo-ep-5.1.6.GA