Maven utilise des repositories par défaut pour retrouver les librairies. Nuxeo utilise des repositories spécifiques. Il faut les définir dans le fichier de configuration maven. typiquement :
$HOME/.m2/settings.xml pour Linux
C:\Documents and Settings\<user>\.m2\settings.xml pour windows
Voici un settings.xmlfichier d'exemple.
Créer un répertoire de travail. <autoformationNuxeo> dans la suite de ce document.
Pour développer il faut utiliser une base qui sera la dernière version de ESUP-ECM :
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.
Nuxeo utilise pour la gestion de versions de ses sources l'outil mercurial. cf. FAQ nuxeo à ce sujet
Les procédures ci-dessous peuvent prendre plusieurs minutes |
Typiquement ici nous clonons (terme mercurial) dans le répertoire <autoformationNuxeo> 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 -r release-5.1.6 http://hg.nuxeo.org/nuxeo nuxeo |
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. |
Ensuite, il est possible de rendre ces différentes sources des projets Eclipse.
Dans le répertoire <autoformationNuxeo>/nuxeo :
Si on souhaite récupérer tous les addons, on utilisera les commandes :
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 |
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 ...Rappel : hgf est une petite fonction shell proposée par Nuxeo (voir ci-dessus et page précédente).
Invoquer la commande
mvn eclipse:eclipse |
Ici on utilise un subversion plus classique.
Typiquement ici nous faisons un checkout (terme subversion) dans le répertoire <autoformationNuxeo>/esup-ecm le repository suivant :
http://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 |
Il est intéressant, à ce stade de tester le plugin. Pour cela, dans le répertoire <autoformationNuxeo>/esup-ecm :
Il est temps maintenant d'importer dans eclipse les différents projet nuxeo et le projet tuto-plugin-nuxeo
Dans eclipse :