Comment obtenir une copie locale de Capsis avec les droits modélisateur

Cette documentation est un résumé en français de la documentation Developing models in Capsis with JDK 1.8 and Subversion (SVN).

Cette documentation est destinée aux modélisateurs Capsis (selon les termes de la charte Capsis). Elle leur permet d'obtenir une copie locale complète de Capsis sur leur ordinateur pour leur permettre d'ajouter leur travail dans la plateforme.

Les codes sources de Capsis sont hébergés sur un serveur de versionnement Subversion (SVN).

Un login est requis (voir section 2).

Capsis est écrit en langage Java. Il nécessite l'installation de Java version 1.8 (ou Java 8) sur votre machine (SE : Standard Edition, JDK : Java Development Kit).

En cas de difficultés avec cette procédure en francais, consultez la page de référence en anglais : the Java 8 installation page

→ Pour vérifier si votre installation de java est correcte, consulter la FAQ, section 3.6. Le système doit trouver un jdk 1.8.x. Si correct, passer directement à la section 2.

Attention, il faut installer le JDK 1.8.x (Java Developement Kit, Standard Edition, qui contient le compilateur Java) et non pas la JRE 1.8.x (Java Runtime Environment, exécute les programmes Java, souvent déjà installée sur les machines récentes).

Sous Windows

• Télécharger et installer le JDK 1.8.
  • Essayez ici (e.g. Windows x86 for 32 bits systems)
  • Vous pouvez aussi regarder dans la page des archives de téléchargement java 1.8.

• Modifier la variable d'environnement PATH de votre système pour y ajouter le répertoire contenant java :
  • Avec un gestionnaire de fichier, ouvrir le répertoire d'installation de java, puis son répertoire bin/ (ce répertoire contient le programme java). Copier le chemin dans le presse papier du système (Ctrl-C)
  • Démarrer > Panneau de configuration > Système > Avancé > Variables d'environnement
  • Modifier la variable système PATH : coller (Ctrl-V) le chemin du répertoire bin/ copié ci dessus EN TETE de la variable PATH, suivi d'un ';' pour le séparer des autres chemins
  • Valider

Sous Linux

• Télécharger un installeur Java
  • Essayez ici (e.g. Linux x64 tar.gz for Linux Ubuntu)
  • Vous pouvez aussi regarder dans la page des archives de téléchargement java 1.8.

→ Pour vérifier si votre installation de java est maintenant correcte, consulter la FAQ.

Les fichiers Capsis sont hébergées sur le serveur de développement amap-dev. Pour y accéder, il vous faut créer un compte sur ce serveur.

• Enregistrez vous sur https://amap-dev.cirad.fr/account/register
• Une fois votre login validé par un administrateur, vous pouvez accéder aux pages de développement du projet: https://amap-dev.cirad.fr/projects/show/capsis

Votre login/password sera utilisé pour accéder au serveur SVN, mais aussi pour modifier vos pages sur le site wiki Capsis.

SmartSVN permet d'accéder au dépot de versionnement.

• Télécharger et installer SmartSVN : https://www.smartsvn.com/
• Démarrer SmartSVN
  • Choisir la version professionnelle, elle basculera automatiquement vers la version libre au bout d'un mois
• Choisir 'Checkout project from repository'
• Quick Checkout :
  • Entrer l'URL: https://amap-dev.cirad.fr/svn/capsis/trunk
  • Répertoire local : le répertoire que vous choisirez pour votre copie locale (ex : C:\capsis4 OU /home/coligny/java/capsis4)
• Accepter le 'server fingerprint' si proposé
• Entrer votre login / mot de passe quand demandé Note: il s'agit du login / mot de passe amap-dev obtenu à la section 2
• Valider

Le checkout que vous venez d'effectuer permet d'obtenir une copie locale de Capsis sur votre machine une fois pour toute. Ultérieurement, si vous devez récupérer les dernières modifications remontées sur le serveur, vous utiliserez SmartSVN et la commande update.

Dans le cas ou vous seriez amenés à remonter vos propres modifications sur le serveur, il faudrait utiliser la commande SVN commit.

Vous pouvez demander de l'aide si vous rencontrez des problèmes avec SmartSVN, ces opérations techniques s'adressent habituellement à des développeurs. Vous pouvez également consulter cette documentation complémentaire.

• Ouvrir un terminal (Invite de commande DOS sous Windows, Shell sous Linux)
• Se rendre sous le répertoire d'installation de Capsis avec cd

# ex sous windows:
C:
cd capsis4

• Recompiler le projet comme suit :

ant compile

Note : Il peut arriver que vous trouviez des erreurs (BUILD FAILED) à cette étape, dans ce cas, contactez l'équipe Capsis.

• Lancez Capsis avec les scripts de démarrage :

Sous Windows

capsis 

Sous Linux

sh capsis.sh

Il est possible de faire un raccourci vers le script de démarrage depuis votre bureau pour lancer Capsis.