Manuel utilisateur du plugin Eclipse

Version 2.0, Avril 2019

Maintenu par : Christophe Saint-Marcel (Velossity), Astor Bizard (Caseine), Nicolas Catusse (Grenoble-INP), Lee Yee (université Grenoble Alpes, stagiaire, version 1.0)

Note : Ce manuel concerne l'utilisation du plugin Eclipse. L'utilisation dudit plugin nécessite qu'il soit au préalable installé. Pour l'installation, consultez le tutoriel d'installation.

L'ID Vpl et le Token

Avant de continuer, il y a deux notions importantes pour effectuer des exercices de Caseine sur Eclipse : l'ID Vpl et le Token.

Un Token est une chaine de caractères qui vous identifie sur Caseine. Chaque utilisateur a un Token qui lui est propre.
Pour trouver votre Token, rendez-vous sur vos préférences caseine, puis cliquez sur [Clefs de sécurité].
Cherchez la ligne avec la mention "VPL web service", votre Token est la clef présente sur cette ligne.


Un ID Vpl est un identifiant pour un exercice Caseine. Chaque exercice a un ID Vpl qui lui est propre.
Pour trouver l'ID Vpl d'un exercice, rendez-vous sur la page de l'exercice sur caseine.org, puis regardez dans la barre d'URL de votre navigateur. Vous devez y trouver une mention de la forme "id=XXXX". Ce XXXX est l'ID Vpl associé à l'exercice (8207 dans notre exemple).


Démarrer un exercice : créer un projet CaseInE

Une fois que vous avez récupéré votre Token et l'ID Vpl de l'exercice que vous souhaitez faire, rendez-vous sur Eclipse, et cliquez sur [File > New > Project…]. Vous devez obtenir la fenêtre suivante.
Note : Si vous ne trouvez pas le groupe "Caseine Wizards", essayez de passer par [File > New > Other…].

Développez le groupe "Caseine Wizards" et sélectionnez "Caseine Project", puis cliquez sur [Next >]. Vous devez obtenir la fenêtre suivante :

Entrez votre Token dans le champ "token" et l'ID Vpl de votre exercice dans le champ "VPL ID".
• Si vous souhaitez commencer un exercice dans son état initial, laissez cochée la case "Initial Project". Si vous avez déjà commencé l'exercice et enregistré des modifications sur Caseine (directement sur Caseine ou depuis un autre ordinateur par exemple), et que vous souhaitez récupérer les fichiers tels que vous les avez modifiés, décochez la case "Initial Project".
• Si vous êtes dépendant de GI-INP, cochez la case "Include GI Libraries". Si vous oubliez cette étape, il vous sera possible d'inclure les bibliothèques une fois le projet créé, depuis le menu contextuel Caseine.
Note : Votre Token est automatiquement sauvegardé sur Eclipse après cette étape, donc vous n'aurez à le rentrer qu'une seule fois. Il est possible de le modifier depuis [Window > Preferences > Caseine > User security key].
Cliquez sur [Next >]. Vous arrivez sur la fenêtre de création de projet sous Eclipse. Vous pouvez configurer le projet comme vous le souhaitez, ou bien laisser les valeurs par défaut et cliquer sur [Finish].


Le projet que vous venez de créer doit apparaître dans le Package Explorer. Les projets Caseine ont l'icône : 


Au travail !

Vous pouvez maintenant apporter vos modifications au projet et faire votre exercice !

La perspective Caseine

Lorsque vous créez un nouveau projet Caseine, Eclipse ouvre automatiquement la perspective Caseine (il s'agit de la perspective Java standard, avec quelques éléments supplémentaires) :

● A droite ("CaseInE View") : l'onglet "Description" contient la description de l'exercice sur Caseine. L'onglet "Result" contiendra le résultat de l'évaluation, nous y reviendrons bientôt !
● En bas ("Caseine Comments") : cet onglet contient un récapitulatif des éventuels commentaires Caseine, laissés par votre enseignant (ou par vous si vous le souhaitez).
● En haut à gauche (deux boutons) : nous en parlons dans les parties suivantes !

Note : Il est possible d'ouvrir manuellement la perspective Caseine en passant par [Window > Perspective > Open Perspective > Other...].

Enregistrer son exercice sur Caseine

Une fois votre exercice commencé (ou même fini !), vous pouvez enregistrer vos modifications sur Caseine. Pour cela, cliquez sur votre projet (dans le Package Explorer), puis cliquez sur le bouton [Push] (icône Vache). Vous pouvez également faire un clic droit sur votre projet, et cliquer sur [CaseInE > Push].


Évaluer son exercice

Caseine offre la possibilité d'évaluer automatiquement votre code. Pour cela, cliquez sur votre projet (dans le Package Explorer), puis cliquez sur le bouton [Evaluate] (icône Check). Vous pouvez également faire un clic droit sur votre projet, et cliquer sur [CaseInE > Evaluate]. L'évaluation prend quelques secondes (une barre de progression apparaît tout en bas à droite de la fenêtre d'Eclipse).
Note : Le bouton [Evaluate] effectue automatiquement un [Push].


Résultats de l'évaluation

Vous obtenez alors le résultat de l'évaluation à droite dans l'onglet "Caseine View > Result".
Il contient votre note pour cette évaluation, ainsi que le détail des tests automatiques intervenant pour votre note.
Un test vert représente un test passé avec succès, un test avec une croix bleue ou rouge indique un test échoué.
Vous pouvez cliquer sur un test échoué pour obtenir des détails sur ce test.
          

Récupérer les fichiers de Caseine

Les plus observateurs (et perspicaces !) d'entre vous auront remarqué les options [Pull] et [Reset] dans le menu contextuel CaseInE.
Elles permettent de récupérer des fichiers depuis Caseine si vous avez déjà créé le projet associé à l'exercice.
- [Pull] permet de récupérer les fichiers de votre exercice tels que vous les avez enregistrés sur Caseine (via un [Push] ou via l'éditeur de Caseine).
- [Reset] permet de récupérer les fichiers de votre exercice dans leur état initial.

Attention : Ces deux options écrasent vos fichiers du projet local. Attention aux pertes de modifications !
Последнее изменение: Thursday, 11 April 2019, 16:11