|
Install
Procédure d'installation de l'application Niiuzu sur un poste de développement
Installation du projet NiiuzuCette 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'installationAssurez-vous d'avoir installé les éléments ci-dessous sur le poste de développement :
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 projetLes 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. MavenUne 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 IDEA 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 :
UTF-8 : encodage des fichiersL'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 :
Attention : Version GWTPour 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. DatanucleusA compléter... |