Cette page présente l'usage des outils de développement dans le cadre des projets ESUP-SGC / ESUP-NFC-TAG. Ces outils peuvent être utilisés au moment de l'intégration de la solution ainsi que pour le développement de nouvelles interfaces.
Lors de l’intégration du projet il est intéressant d'importer les sources dans un outils de développement pour bénéficier de ses fonctionnalités (auto-complétion, coloration syntaxique, indentation..). Par ailleurs cela peut permettre d'implémenter de nouveaux services ex :
Esup-SGC et Esup-Nfc-Tag-Server sont développés à l'aide de SpringToolSuite STS (basé sur Eclipse) : https://spring.io/tools
Après avoir cloné le projet (dans /opt/esup-sgc), démarrez STS et créez un nouveau workspace dans /opt/workpaces/esup-sgc par exemple
Lorsque STS est démarré faites "File -> Import" puis choisissez "Maven -> Existing Maven Projects" et naviguez dans le dossier des sources où se trouve le pom.xml
Cliquez sur "Finish", le projet s'importe puis vous devez obtenir l’arborescence suivante :
Dans STS l'auto-complétion est déclenchée par la combinaison CTRL + Espace
L'auto-complétion va nous permettre de modifier facilement la configuration. On prend comme exemple le ficher src/main/ressources/META-INF/spring/applcationContext-services.xml. Si l'on souhaite ajouter un service CardIdsService
A la saisie dans le nouveau bean au niveau du '<bean class="org.esupportail.sgc.services.cardid.' l'auto-complétion va proposer CnousCardIdService, ComueNuAccessControlCardIdService, GenericCardIdService ...
De même, pour la saisie des propriétés l'auto-complétion fonctionne et propose les noms des attributs de la classe sélectionnée.
Cette méthode permet de sécurisé l’édition des fichiers de configuration.
D'une manière générale il est conseillé de faite des commits GIT locaux pour sauvegarder vos modifications de configuration.
Lorsque vous avez fini la configuration du fichier vous pouvez exécuter les commandes suivantes depuis la racine de vos sources
git add src/main/resources/META-INF/spring/applicationContext-service.xml git commit -m "config prod univ-ville-fr" |
La modification du fichier applicationContext-service.xml sera versionnée ce qui permet de conserver les traces de toutes les modifications (procédure à faire à chaque modification). De plus lors d'une mise à jour d'ESUP-SGC (git pull) la configuration ne sera pas écrasée.
Pour compiler ou lancer le projet il faut créer une configuration de lancement de type "Maven Build" dans "Run -> Run Configurations" comme suit :
Esup-Nfc-Tag-Droid est développé sous Android Studio https://developer.android.com/studio/index.html
Pour verifier l'installation de SDK, il faut ouvrir SDK Manager depuis le menu "Configure"
Après avoir cloné le projet (dans /opt/esup-nfc-tag-droid), choisir "Import project"
Si la version de gradle n'est pas bonne l'ide propose de fixer le projet The versions of the Android Gradle plugin and Gradle are not compatible. ou Upgrade build tools |
Losque le project compile correctement la barre d'outils présente le bouton d'execution
L'application peut etre lancée soit sur un emulateur Android paramétré depuis l'écran "Select deployment Targe" (voir dans "Create New Virtual Device") soit sur un téléphone Android avec degobage USB activé
Modifier l'adresse d'Esup-Nfc-Tag-Server dans esupnfctag.properties
esupNfcTagServerUrl=https://esup-nfc-tag.univ-ville.fr |
Cliquer sur "Build -> Generate Signed APK" puis renseigner le keystore
Visual Studio
Esup-CNOUS-Client est développé sous Visual Studio Community https://www.visualstudio.com/fr/
Après avoir cloné le projet (dans c:\opt\esup-nfc-tag-droid), faire "Fichier -> Ouvrir un projet" puis choisir le fichier sln
Choisir "Release" au niveau de la barre d'outils" puis cliquer sur "Générer -> Générer la solution" (raccourci Ctrl+Maj+B)
Dans le dossier c:\opt\esup-crous-client\bin\Release on trouve l'executable CreationCarteCrous.exe ainsi que le fichier de configuration CreationCarteCrous.exe.config