...
Avoir un compte github
Remarque Dans la suite du document le compte utilisé est raymondBourges. Il convient d'adapter l'exemple avec votre propre compte.
- Avoir enregistré sa clé SSH (Cf. aide GitHub sur le sujet)
Avoir un IDE java avec des plugin plugins pour GIT et Maven
Remarque Dans la suite du document eclipse et les plugins EGit et m2e sont utilisés.
Forker le projet sur github
| Remarque |
|---|
Il faut avoir créer un compte sur GitHub et s'y connecter. Dans la suite document le compte utilisé est raymondBourges. Il convient d'adapter l'exemple avec votre propre compte. |
Aller sur la page du projet
...
Cloner le projet sur votre poste de travail :
| Remarque |
|---|
Ici on utilise la commande git en ligne de commande mais d'autres solutions sont possible (plugin egit EGit eclipse par exemple) |
| Bloc de code |
|---|
cd /tmp git clone git@github.com:raymondBourges/esup-opi.git |
...
En tant que développeur vous avez besoin de configurer l'application notamment pour préciser les paramètres liés à la base de données, l'authentification CAS, les URL des fichier description WSDL des Web Services.
| Remarque | ||
|---|---|---|
la La localisation du fichier de configuration est fonction de la variable d'environnement config.location (Cf. esup-opi-web-jsf-servlet/src/main/resources/properties/applicationContext.xml). Cette variable d'environnement sera à positionner lors des appels maven. En ligne de commande. Ex : export configFile=/path/to/configs/esup-opi/config.properties mvn -Dconfig.location=$configFile jetty:run Dans eclipse. Ex :
|
...
Pour la base de données une source JNDI est utilisée. La source JNDI est définie au niveau du serveur d'applications. Dans le cadre du développement, maven est utilisé et c'est le plugin jetty qui fait office de serveur d'applications. Il faut donc définir la source JNDI dans un fichier de configuration du serveur d'pplication d’applications jetty.
Un fichier d'exemple (utilisé par défaut) est fourni : esup-opi-web-jsf-servlet/src/main/jetty/jetty-env.xml
...
| Remarque | ||
|---|---|---|
la localisation du fichier de configuration est fonction de la variable d'environnement jetty.envXml. Cette variable d'environnement sera à positionner lors des appels maven.
|
...
Pas besoin d'installer un serveur d'applicationapplications, maven s'occupe de tout.
...
Proposer votre contribution à ESUP sous la forme d'un Poll Pull Request :
Puis :
Enfin :
Les développeurs du projet n'auront quequ'un clic à faire pour intégrer la contribution.