User Tools

Site Tools


private:copielocalepourlesmodelisateurs

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).

Note importante

Si vous n'êtes pas un modélisateur Capsis et si vous souhaitez intégrer un modèle dans Capsis, veuillez lire How to join Capsis et contacter l'équipe de développement (voir contact) pour que votre inscription soit validée.

1. Installer Java SE 8 (JDK)

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

  • 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

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

2. Créer un login sur le serveur amap-dev

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.

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

3. Récupérer une copie locale du projet (checkout)

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 :
  • 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

4. Opérations SVN habituelles

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.

5. Recompiler et démarrer Capsis

  • 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.

private/copielocalepourlesmodelisateurs.txt · Last modified: 2022/12/22 08:30 by coligny