https://github.com/njourdane/volley
Logiciel d'aide à la mise en place de stratégies de volley-ball.
https://github.com/njourdane/volley
Last synced: 2 months ago
JSON representation
Logiciel d'aide à la mise en place de stratégies de volley-ball.
- Host: GitHub
- URL: https://github.com/njourdane/volley
- Owner: njourdane
- Created: 2012-10-29T22:07:15.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2013-04-05T09:20:09.000Z (about 12 years ago)
- Last Synced: 2025-01-08T10:44:52.803Z (4 months ago)
- Language: Java
- Size: 1.54 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
volley
======
Roipoussiere ; julienA974 ; Scytes ; Xavier31
Logiciel d'aide à la mise en place de stratégies de volley-ball.
Instructions :
***GIT***
Le répertoire src correspond au workspace Eclipse
J'ai configuré Git pour ques les fichiers générés par Eclipse (.classpath, .metadata, ...) soient ignorés par Git.
Il existe un client github pour windows téléchargeable ici :
http://windows.github.com/
Il existe aussi un addon Eclipse mais c'est un peu la misère à utiliser, je vous le déconseille.
Par contre il y a un très bon tutoriel pour git ici :
http://www.siteduzero.com/informatique/tutoriels/gerez-vos-codes-source-avec-git
Vous devez surtout vous familiariser avec ces commandes :
status, add, commit, pull, push
Les commandes de git sont les mêmes sous Windows et Linux.
Après avoir installé le client GitHub, vous devez vous créer un répertoire local dans le quel vous mettrez tous les fichiers du projet.
En suite, passez en mode console et effectuez cette commande pour cloner le dépot distant avec votre répertoire local :
git clone https://github.com/votre_login_github/volley.git votre_repertoire
Ensuite, à chaque fois que vous travaillez et que vous voulez envoyer vos fichiers sur le dépot, il faudra effectuer ces commandes :
#Si c'est pas fait, on se place dans le repertoire git local :
cd votre_repertoire_git
#On regarde quels sont les fichiers qui ont été modifiés :
git status
# Eventuellement on ajoute des fichiers au dépot (si on en a crée) :
git add le_fichier
# On commite les fichiers pour dire à Git qu'il faut versionner les fichiers que vous avez modifié :
git commit -a -m "Message pour décrire la modification effectuée"
# On récupère les fichiers présents sur le dépot pour avoir tout à jour :
git pull
#On envoie les fichiers locaux vers le dépot github :
git push
Tout cela vous parait un peu fastidieu mais vous vous y ferez très vite.
***Configuration d'Eclipse***
Workspace :
Travaillez sur celui du projet (le dossier src du dépot), pas sur votre workspace perso!!
Pour que les caractères soient en utf-8 :
-> Window, General, Workspace, Text file encoding : UTF-8
Pour la javadoc (voir plus bas)
-> Project, Generate Javadoc..., sélectionner le programme javadoc.
Par défaut, sur Windows : C:\ProgramFiles\java\jdk1.6.0_01\bin\javadoc.exe
***Javadoc***
Pour ne pas s'embéter à rédiger la documentation, nous allons de la demander à Eclipse de la générer.
Pour cela, il faut insérer des commentaires petit à petit dans le code, avant chaque classe et chaque méthode.
Il faut placer ces commentaires juste au dessus de la classe ou méthode à commenter.
Il existe des tags qui seront compréhensibles par la javadoc, ils commencent par '@'.
Cela doit ressembler à ça :
/**
* Description de la methode.
* Il est necessaire d'insérer les '
' pour faire plusieurs lignes.
* @author Votre nom et prénom (si la méthode a été réalisée à plusieurs, mettre tous les noms, séparés par une virgule).
* @param _chaine Description du 1er parametre.
* @param _i Description du 2eme parametre.
* @return Description de la valeur de retour.
* @see package.Classe#methodeInteresante()
*/
public Methode (String _chaine, int _i)
{...
Pour générer la javadoc : Project, Generate Javadoc... , comme vu plus haut.
***Généralités sur le code***
Respect du modèle MVC.
Toutes les actions seront traitées dans le controleur.
On créera une nouvelle classe dans un nouveau fichier pour chaque écouteur.
***Normalisation du code***
Les noms des paramètres d'une méthodes seront précédés par un '_' pour les différencier des variables déclarées dans la méthode.
ex:
public Methode (String _chaine, int _i)
Les accolades seront toujours sur une nouvelle ligne
ex:
public Methode ()
{
...
}
Les arguments de la classe seront toujours appelés par this
ex:
this.bouton = new JButton ("Bouton");