Genj - Développement

De Arvernes Wiki.

Pour pouvoir commencer à participer au développement de GenjFr, il vous faut le code source du logiciel.

Avec GenjFr, aucun problème pour l'obtenir, GenjFr est un logiciel Open Source, donc le code source est librement disponible sous licence GPL. Plusieurs explications vous sont données sur ce qu'est la licence GPL. Une traduction est également à votre disposition.

Sommaire 1 L'accés SVN 2 IDE - Environnement de Développement Intégré 2.1 JDK 2.2 Netbeans 2.2.1 Installation 2.2.2 Ouverture du projet dans Netbeans 2.2.3 Problèmes lors de la mise à jour 3 La liste de discussion française de développement 3.1 La liste en elle-même 3.2 Les archives de la liste 4 Possibilité de mettre vos développements sur Arvernes 5 Site de suivi français 6 Notes

L'accés SVN

Arvernes Wiki Des utilisateurs ont trouvé cet article pas assez clair. L'un d'eux a mis ce bandeau. Il faudrait y apporter des précisions. N'hésitez pas à le faire. Il faut bien sûr vous loguer pour pouvoir modifier quelque chose.

Un site vous donne une bonne vision de ce qu'est subversion (SVN)

Un dépôt SVN permet à plusieurs personnes de collaborer à un même projet. Ce qui est intéressant, ce n'est pas l'importance du projet, mais plus l'aspect collaboratif. Un dépôt SVN peut très bien s'imaginer pour des gens qui décident de travailler sur un projet de logiciel, mais aussi un projet de revue, où certains vont faire un article, d'autres un autre, d'autres encore vont travailler à un sommaire, etc.

Pour avoir l'accès SVN en tant que développeur, vous devez mettre un petit mot à François pour qu'il vous donne accès en écriture sur le dépôt. De cette manière vous pourrez bien sûr reprendre le code, mais aussi remonter sur le dépôt vos développements, modifications, etc...

Ensuite, il faut installer subversion (SVN) sur votre système. Voilà quelques liens :

Installation de SVN sous Windows.

Installation sous Linux.

(N'hésitez pas à mettre d'autres liens, ou de meilleurs liens)

Une fois que c'est fonctionnel, vous pouvez reprendre le code en tapant dans un terminal :

svn co http://arvernes.dyndns.org/fgenj/trunk /home/monrepertoire/fgenj/trunk

(bien sûr vous devez changer le mot "monrepertoire" par le bon répertoire et que avez bien créé les deux répertoire et sous-répertoire "fgenj/trunk".)

A priori, vous devriez être en possession de tout le code de GenjFr, vous allez pouvoir commencer à travailler sur le code.

IDE - Environnement de Développement Intégré

Un IDE (Integrated Development Environment) va vous permettre de développer votre application java dans un environnement convivial et puissant.

JDK

Avant d'installer Netbeans, il convient de vérifier que vous avez bien java d'installé. Java mais surtout le JDK (Java Development Kit).

Installation manuelle (Windows, Linux...) :

Celui-ci (le JDK) est disponible pour une installation manuelle. Si vous allez sur la page de téléchargement de java, vous pourrez voir qu'il existe une possibilité de télécharger et d'installer, et le jdk, et netbeans. A vous de voir si c'est la solution vers laquelle vous voulez vous orienter. J'ai tendance à privilégier, et l'installation de java et l'installation de Netbeans séparemment. Pour télécharger le JDK, allez sur la page du site web vous permettant un tel téléchargement.

En fonction de votre système d'exploitation, Windows, Linux, .... choisissez la version qui vous convient.

Installation par synaptic sous Linux :

Synaptic vous permet de choisir les paquets à installer si vous êtes sous Linux Ubuntu. Lancez Synaptic, et choisissez d'installer :

• sun-java6-jdk
• java-common
• sun-java6-bin
• sun-java6-jre
• rhino
• libxerces2-java
• libjaxp1.3-java
• libaccess-bridge-java
• sun-java6-plugin
• unixodbc

J'ai aussi choisi de désinstaller le openjdk qui est installé par défaut. A vous de voir, mais je le conseille vivement.

Vous pouvez aussi faire cela dans un terminal, en tapant :

• sudo apt-get install sun-java6-jdk java-common sun-java6-bin sun-java6-jre
• sudo apt-get install rhino libxerces2-java libjaxp1.3-java libaccess-bridge-java
• sudo apt-get install sun-java6-plugin unixodbc

Netbeans

Installation

• Tout d'abord il faut télécharger l'environnement NetBeans à cette adresse: http://netbeans.org/downloads/index.html. Prenez la dernière version (à ce jour c'est la 6.8) et en français (c'est le petit menu déroulant "Langue de l'IDE"), afin d'avoir tout ce qu'il faut. Seul le premier package est nécessaire (Java SE soit 58M avec le support du français).
• Lancez ensuite l'installation en exécutant le programme juste téléchargé; laissez-vous ensuite guider. Tout ce qu'il faut pour développer pour GenjFr sera alors installé correctement.
• Vous devez avoir les sources de GenjFr disponibles dans un répertoire de votre disque dur. On appellera le répertoire dans lequel vous avez mis les sources "genjfr".
• lancez NetBeans puis faites Fichier/Ouvrir un projet...
• Sélectionnez dans genjfr/trunk/dev les deux projets "app" et "GenjFrApp". Ces deux répertoire doivent être repérés différemment. Dans la partie gauche, vous devriez voir deux projets, GenJ et GenjFrApp.

Ouverture du projet dans Netbeans

• Si vous voulez reprendre le dernier code du dépôt SVN, pour travailler sur quelque chose qui soit à jour avec les modifications des autres développeurs, mon conseil est de ne rien renseigner dans Netbeans comme "login" et "mot de passe". Faites un petit "commit", vous modifiez une page sans conséquence, de toutes façons, vous pourrez toujours revenir en arrière. Lors de ce "commit", Netbeans va vous demander votre "login" et "mot de passe". Il vous suffira de renseigner ces deux éléments et de demander à Netbeans qu'il sauvegarde ces informations.
  Ensuite pour reprendre le code, vous faites un clic droit sur le projet "GenjFrApp", puis "subversion", puis "mise à jour", et votre code devrait se mettre à jour tout seul.^[1]
• Pour construire le projet:

• Clic droit sur GenJ, "Nettoyer et construire"
• Clic droit sur GenjFrApp, "Tout nettoyer et générer"
• et pour le lancer, "exécuter projet"

• Pour créer l'archive zip: Clic droit sur GenjFrApp, "Générer la distribution des fichiers ZIP"

Problèmes lors de la mise à jour

Supposons que vous ayez quelques problèmes pour mettre à jour tous les fichiers source quand vous êtes dans Netbeans.

Il faut vous assurer que les informations pour le projet genjfr sont bien renseignées. Dans Netbeans, regardez dans "Equipe" - "Checkout". Là vous allez vérifiez que vous avez pour :
URL du référentiel : http://arvernes.dyndns.org/fgenj

Utilisateur : le nom d'utilisateur que vous avez donné à François pour accéder au dépôt SVN.
Mot de passe : le mot de passe que vous avez donnée à François pour accéder au dépôt SVN.
(x) Enregistrer le nom d'utilisateur et le mot de passe.
A priori pour proxy, rien de ne devrait être à changer.
Pour l'écran suivant, tout devrait être déjà paramétré comme il faut.

Là vous faites annuler, car si vous faites "Terminer", et que vous avez mis votre dépôt dans un autre endroit, ça va encore tout vous reprendre. Le but de la manoeuvre ci-dessus est de vérifier que l'URL est bonne.

La liste de discussion française de développement

La liste en elle-même

Vous connaissez GenjFr, vous voulez participer à son développement en écrivant du code, en modifiant le code du programme.

Il vous suffit pour cela de vous abonner à la liste de discussion dédiée à cela.

• Procédure d'Abonnement :

Il vous suffit pour cela de rejoindre le forum de discussion en envoyant un simple message à l'intention de : "genj_dev-subscribe@ml.arvernes.com". Ne mettez rien dans le corps du message, mais dans la ligne du "sujet" mettez uniquement le mot subscribe et c'est tout.

N.B.

(Vous pouvez aussi si vous le souhaitez cliquer sur le nom du destinataire ci-dessous, cela ouvrira automatiquement votre logiciel de courrier et mettra le mot requis dans la ligne "sujet". Vous n'aurez qu'à l'envoyer) : genj_dev-subscribe@ml.arvernes.com

• Procédure de Désabonnement :

Pour vous désabonner de la liste, il suffit de faire un message à l'intention de "genj_dev-unsubscribe@ml.arvernes.com" et mettre le mot unsubscribe dans la ligne du sujet. Ou alors cliquez sur l'adresse ci-contre : genj_dev-unsubscribe@ml.arvernes.com

Et envoyez le message qui va être généré.

• Pour envoyer un message à l'Administrateur de la liste :

Il suffit de faire un message à l'intention de : genj_dev-owner@ml.arvernes.com

• Gestionnaire de la liste :

La personne en charge de cette liste est Daniel ANDRÉ.

Les archives de la liste

N'oubliez pas que vous pouvez toujours consulter les archives de la liste de discussion ici.^[2]

Possibilité de mettre vos développements sur Arvernes

Vous avez la possibilité de remonter des fichiers (vos réalisations) sur Arvernes dans un répertoire qui vous est dédié. Cela va permettre aux utilisateurs de GenjFr de les télécharger, et donc de les utiliser/tester.

Toutes les personnes qui ont accés en ftp sur ce site, utilisent toutes le même login et le même password. Cela veut dire que vous pouvez visualiser, et voir même, modifier le ou les fichiers des autres utilisateurs. Il faut donc respecter le travail que les autres ont fait.

Pour bien distinguer votre travail, il est conseillé de mettre vos fichiers dans un sous-répertoire à votre nom. Si je m'appelle Jean Dupont, je vais créer un sous répertoire qui s'appellera "Dupont_Jean". J'ai tendance à mettre le nom avant le prénom pour des raisons de classement alphabétique. Je vous demande aussi de mettre un "underscore" (le petit tiret qui se trouve sous votre touche 8 de votre clavier : "_") pour relier différents mots de votre répertoire. Bien entendu, dans ce sous-répertoire que vous vous êtes attribué, vous pouvez créer autant de sous sous-répertoires que vous avez besoin.

Voilà comment vous devez insérer un lien sur le wiki pour que le fichier puisse être téléchargé :

[http://www.arvernes.com/V1/pages/compteur_dl.php?/files/ftparvernes/Dupont_Jean/le_nom_de_mon_fichier.zip le_nom_de_mon_fichier.zip]

Faites attention à la casse de vos mots. "Dupont_Jean", n'est pas pareil que "Dupont_jean" ou "dupont_jean", ou "dupont_Jean".

Dernière remarque : ne confiez pas vos login et mot de passe à d'autres personnes. Merci.

Site de suivi français

Il existe en plus de ce wiki un site du suivi des bugs, demandes, etc... enfin tout ce qui concerne le développement géré par Daniel André sur le site Trac de Arvernes.

En visitant ce dernier site, vous verrez les différentes demandes qui ont été faites, les développements en cours sur certaines d'entre elles. Promenez-vous dans les pages du site, et vous comprendrez trés facilement comment tout cela fonctionne.

Notes