My favorites | Sign in
Project Home Wiki Issues Source
READ-ONLY: This project has been archived. For more information see this post.
Search
for
Install  
Procédure d'installation de l'application Niiuzu sur un poste de développement
Updated Jul 21, 2011 by thi...@gmail.com

Installation du projet Niiuzu

Cette procédure vous permettra d'installer le projet Niiuzu sur un poste de développement afin de parcourir les fichiers sources facilement et d'exécuter l'application en debug.

Prérequis à l'installation

Assurez-vous d'avoir installé les éléments ci-dessous sur le poste de développement :

  • JDK 6 (version récente).
  • Maven 2 (version 2.1 minimum).
  • Un IDE avec les tous outils nécessaires au lancement d'une application GWT en debug.

Le projet Niiuzu n'est pas dépendant d'un IDE en particulier, il est à priori possible d'utiliser n'importe quelle plateforme de développement Java/J2EE à partir du moment où le SDK de GWT est installé sur le poste. A noter que le développement du projet s'effectue sur eclipse depuis sa création et que l'installation sur un autre IDE n'a pas été testée à ce jour.

Je recommande donc l'utilisation d'eclipse car Google fournit une documentation détaillée sur l'installation d'un environnement de développement eclipse/GWT (cf. eclipse/GWT) et des plugins eclipse permettant de démarrer facilement une application GWT en debug.

Récupération des sources du projet

Les fichiers sources du projet Niiuzu sont stockés sur Google Project Hosting sur un serveur subversion (cf. Parcourir l'arborescence subversion du projet). Il vous sera alors nécessaire d'utiliser un client subversion pour récupérer ces fichiers (checkout). Si vous utilisez eclipse, je vous recommande subclipse qui est un client subversion qui s'intègre parfaitement à l'IDE eclipse (cf. subclipse).

Les versions stables du projet se situent dans le dossier "tags" de l'arborescence (chaque version jugée comme étant stable est tagguée/copiée dans ce dossier afin de retrouver facilement une version antérieure du projet). La version la plus récente est celle dont le numéro de version est le plus grand (exemple : la version 01-02-03 est plus récente que la version 00-99-99). L'ensemble des versions stables du projet sont listées sur cette page : voir la liste des versions stables.

Remarque : Le dossier "trunk" contient la dernière version en développement de l'application, celle-ci n'est pas forcément stable. Si avez l'intention d'étudier le code source et d'exécuter l'application en debug, il vous est fortement recommandé de récupérer un "tag" de manière à être sûr de récupérer une version stable de l'application.

Maven

Une fois les fichiers sources récupérés, il est nécessaire d'exécuter la commande Maven suivante afin de récupérer toutes les dépendances au projet (librairies, code java généré, etc...).

Si vous utilisez eclipse :

$ mvn eclipse:eclipse

Si vous utilisez un autre IDE :

$ mvn compile

Intégration du projet dans votre IDE

A cette étape, il est possible d'intégrer le projet Niiuzu dans votre IDE. Reportez-vous à la documentation de votre IDE pour connaitre la procédure d'intégration d'un projet Java/GWT.

Sur eclipse :

  • Allez dans le menu File puis Import...
  • Sélectionnez Existing Projects into Workspace...
  • Sélectionnez le dossier où vous avez effectué un checkout du projet Niiuzu
  • Cliquez sur Finish

UTF-8 : encodage des fichiers

L'ensemble des fichiers sources du projet est encodé en UTF-8, aussi pensez à configurer votre IDE pour qu'il interprète les fichiers dans cet encodage.

Sur eclipse :

  • Clic-droit sur le projet, sélectionnez Properties
  • Sélectionnez Resource dans le menu de gauche
  • Dans le paragraphe Text file encoding vérifiez que l'encodage soit bien de l'UTF-8

Attention : Version GWT

Pour exécuter le projet sur votre poste, vous aurez besoin de la bonne version du SDK de GWT (ou du plugin eclipse/GWT). Or le projet Niiuzu évolue avec les mises à jour de GWT et il est nécessaire de vérifier la version adaptée à chaque version stable.

Par exemple, la version "00-00-01" de Niiuzu requière la version 2.1.1 de GWT, tandis que la version "00-00-02" requière la version 2.2.0 de GWT. De plus ces versions ne sont pas rétro-compatibles (la version 2.2.0 de GWT ne saura pas exécuter la version "00-00-01" de Niiuzu).

Pensez donc à changer la version de GWT en fonction de la version de Niiuzu récupérée.

Aide : pour identifier la version de GWT nécessaire à Niiuzu, ouvrez le fichier "pom.xml" à la racine du projet et cherchez la balise "gwtVersion", la valeur de cette balise correspond à la version de GWT.

Datanucleus

A compléter...

Powered by Google Project Hosting