• Introduction
• Présentation générale de Lutece
• Description d'une webapp Lutece
• Description fonctionnelle des composants
• Description de l'architecture logicielle
• Description de la composition des plugins
• Généralités concernant le développement sur Lutece
• Construction et assemblage : les builds
• Règles de codage
• Règles de nommage et vérification
• Règles de documentation
• Gestion des faits techniques
• Gestion des sources sur GitHub
• Socle technique et principaux frameworks
• Le moteur de templates : Freemarker
• Le framework CSS responsive : Bootstrap
• L'injection de dépendances avec Spring
• Le framework MVC de Lutece
• La validation des formulaires
• L'internationalisation (i18n)
• L'écriture de logs
• Les tests unitaires
• Installation et configuration
• Installation de l'environnement de travail
• Test de construction et de déploiement d'un premier plugin
• Configuration Lutece avancée
• Initialisation de la base de données
• Guides de développement de composants
• Développer le squelette du plugin avec PluginWizard
• Créer une application Front Office (XPage)
• Créer ma première application Front Office : Mon plugin HelloWorld
• Créer un Portlet Front Office
• Créer un bloc dynamique de Page (PageInclude)
• Créer un service de fourniture de contenu (ContentService)
• Définir des filtres et servlets de plugin
• Créer une fonctionnalité Back Office (AdminFeature)
• Créer un bloc pour le tableau de bord Back-Office (DashboardComponent)
• Créer un service d'extension de l'éditeur de texte riche (HtmlService ou LinkService)
• Créer un traitement d'arrière-plan (Daemon)
• Créer une tâche de workflow
• Développements avancés
• L'authentification Front Office (MyLutece)
• Créer des Web Services REST
• Gérer et développer des services de caches
• Intégrer le moteur de workflow à un plugin
• Ajouter des extensions à des contenus (commentaires, notes, vues...)
• Conclusion

Gestion des sources sur GitHub

Les plugins génériques de Lutece sont hébergés sur la plate-forme de développement collaborative GitHub à l'adresse suivante :

https://github.com/lutece-platform

La gestion des sources est donc basée sur l'outil de contrôle de version (SCM) Git.

Pour mettre à jour du code, il est impératif de bien comprendre et s'inscrire dans les choix de gestion de branches retenus pour Lutece.

Gestion des branches

Pour les plugins génériques et le core, deux branches permanentes sont utilisées :

• la branche develop est la branche dans laquelle sont faits tous les développements.
• la branche master correspondant au code dans sa version releasée. Aucun commit ne doit être fait sur cette branche. Un merge de la branche develop est fait dans cette branche au moment des releases. Aucun commit ou push ne doit être réalisé directement sur cette branche.

Des branches temporaires peuvent être créées pour des nouvelles fonctionnalités. Leur nom correspond au code de l'évolution JIRA.

Commandes GIT

Pour une petite correction ou évolution

Il n'est pas nécessaire de créer une branche. La modification peut se faire directement sur la branche develop

 git checkout develop
 git pull origin develop
 << réalisation et commit des modifications >>
 git push origin develop 

Pour une correction ou évolution significative

Une branche temporaire feature (où feature désigne le code JIRA de l'évolution ou de la correction) doit être créée. Les développements se font sur la branche feature. La branche est partagée sur le repository origin. A l'issue des développements la branche sera fusionnée (merge) sur la branche develop.

git checkout develop
git pull origin develop
git checkout -b JIRA-NNN
git push origin JIRA-NNN
<<réalisation et commit des modifications >>
git pull origin JIRA-NNN
git checkout develop
git pull origin develop
git merge JIRA-NNN
git push origin develop

Pour une contribution externe

L'auteur de la contribution doit forker le projet et créer une branche correspond au JIRA de sa contribution. Il pourra ensuite proposer sa contribution par le mécanisme de Pull Request de GitHub