Installer un environnement de développement HomePlayer

Ce topic explique comment installer un environnement de dévellopement pour HomePlayer. Ca permettra aux curieux de voir comment tout ca fonctionne.
Ca permettra aussi aux utilisateurs qui ont des petits soucis et qui sont un peu développeurs de pourvoir creuser le problème par eux-même.

Cette procédure devrait fonctionner sous linux et sous windows.
Les seuls prérequis sont d'avoir installé le JDK1.4 ou 1.5 et Eclipse 3.1.
J'ai essayé d'être aussi précis que possible....

Ca se fait en 3 étapes :
1 / Récupérer les sources
2 / Configurer le projet
3 / Lancer HomePlayer

-------------------------
Récupérer les sources
-------------------------

Une fois eclipse lancé :
- File / New Project
- CVS / Checkout Projects from CVS
- create new repository location
- config cvs :
Host : homeplayer.cvs.sourceforge.net
Repository path : /cvsroot/homeplayer
User : anonymous
Connection type : pserver
Use default port
- Use specified module name : HomePlayer
- Check out as a project configured using the New Project Wizard
- Finish (pas de selection de tag)
- Select a wizard : Java Project
- Configuration projet :
Project name : HomePlayer
Contents : le répertoire dans lequel mettre les sources
JDK compliance : J2SE-1.6
Project layout : Create separate source and output folders
- bouton Finish

Là ca va télécharger les fichiers de CVS ... y en a pour un petit moment ...

-------------------------
Configurer le projet
-------------------------

une fois que c'est fait, le projet a des erreurs de comile : il configurer les jar à utiliser :

- Project / Properties
- Java Build Path / Libraries
- Add Jars
- ajouter les jars du répertoire lib
- attention : sous windows : HomePlayer/homeplayer_root/lib/jdic.jar
- sous linux : HomePlayer/homeplayer_root/lib/linux/jdic.jar
- bouton OK

Ensuite, il faut lever les restriction d'accès à certaines classes du JRE :
- Window / preferences
- Java / compiler / Erros/Warnings
- Deprecated and Restricted API
- passer le 'Forbidden references (access rules) à "Warning"

Là logiquement, le projet compile.

-------------------------
Lancer HomePlayer
-------------------------

Pour lancer HomePlayer, il faut créer une instance de lancement :
- Run / Run...
bouton New (en bas à gauche)
Name (en haut) : HomePlayer
Project : HomePlayer
Main class : org.homeplayer.HomePlayer
- Onglet Arguments
Program arguments : -dev
(permet de diriger les logs vers la sortie standard plutot que dans le fichier de log)
- Onglet Classpath
- cliquer sur User Entries
- Advanced / add Folder : /HomePlayer/homeplayer_root/
- Advanced / add Folder : /HomePlayer/homeplayer_root/webapps/ROOT
- bouton Run en bas à droite

Et voilà. Là en principe HomePlayer est lancé.

Il est également possible de le lancer en mod debug ... D'ailleur, je conseille fortement d'installer WTP (Web Tools Project) pour avoir accès au mod debugage et à la completion dans les JSP. Ca se fait dans Help/Software updates/Find and Install/search for new Features to update ... je vous laisse faire la suite. il suffit de sélectionner un serveur et de cocher les trucs parlant de WTP et de sélectionner les dépendances. Y a beaucoup de choses à télécharger => c'est un peu long ...