Differences

This shows you the differences between two versions of the page.

--- devel:configwindows [2015/01/14 17:00] – papeleux
+++ devel:configwindows [2021/10/05 16:39] (current) – papeleux
@@ Line 3: / Line 3: @@
 ===== Configurer sa machine Windows =====
 Pour compiler/executer Metafor, il est nécessaire de disposer
-* d'un compilateur (Visual Studio 2012)
+  * d'un compilateur (Visual Studio 2017)
-* d'un gestionnaire de source (SVN)
+  * du gestionnaire de source Subversion (SVN)
-* d'un ensemble d'outils de compilation/programmes/librairies
+  * du gestionnaire de source git
-  * [[http://www.cmake.org/|CMake]] : générateur de projet
+  * d'un ensemble d'outils de compilation/programmes/librairies:
-  * [[www.swig.org/|swig]] : interface c++/python
+    * [[http://www.cmake.org/|CMake]] : générateur de projet
-  * python : interface utilisateur de Metafor
+    * [[http://www.swig.org/|SWIG]] : interface c++/python
-  * [[https://www.threadingbuildingblocks.org/|Intel Tbb]] : librairie template de parallélisation c++
+    * [[https://www.python.org/|Python]] : interface utilisateur de Metafor
-  * [[https://software.intel.com/en-us/intel-mkl|Intel MKL]] : librairie mathématique (blas&solver)
+    * [[https://www.threadingbuildingblocks.org/|Intel TBB]] : librairie template de parallélisation C++
-  * [[http://www.vtk.org/|VTK]] : librairie de dessin (interface graphique)
+    * [[https://software.intel.com/en-us/intel-mkl|Intel MKL]] : librairie mathématique (BLAS & solveur linéaire)
-  * [[http://qt-project.org/|Qt]] : librairie de gestion de menu/boutons (interface graphique)
+    * [[http://www.vtk.org/|VTK]] : librairie de dessin 3D (interface graphique)
-  * ...
+    * [[http://qt-project.org/|Qt]] : librairie de gestion de menu/boutons (interface graphique)
+    * ...
-A l'exception du compilateur (vs2012) et du gestionaire de sources (SVN), tous ces outils/librairies sont pré-compilés pour vous et packagés dans une archive téléchargeable sur le ftp du service (/ftpDisk/metafor/bin/VS2012_X64/)
+A l'exception du compilateur (VS2017), des gestionaires de sources (SVN, git), et des outils de post-traitement numériques (Matlab, scilab), tous ces outils/librairies sont pré-compilés pour vous et packagés dans une archive téléchargeable sur le FTP du service (/ftp/metafor/bin/VS2017Python3_X64/)
+Pour exécuter la batterie de test de Metafor, Matlab sera lui aussi nécessaire pour valider certains post-traitements. Le chemin d'accès de l'exécutable ('matlab.exe') doit aussi se trouver dans le path.
 === Installation du compilateur ===
-Le compilateur par défaut actuellement utilisé pour développer Metafor sous Windows est le Visual Studio 2012 (numéro de version interne : vs 11.0).
-La première étape est donc de l'installer (téléchargez l'iso sur le ftp /ftpDisk/apps/_dev/Visual Studio 2012/Visual_Studio_Pro_2012_Eng.ISO) en version anglaise (la gestion des codes d'erreur est buggée en francais). Seul le compilateur c++ et les "Microsoft Fundation Classes for c++" sont indispensables.
-La deuxième étape est d'appliquer le dernier service pack (/ftpDisk/apps/_dev/Visual Studio 2012/VS2012.4.iso) pour que le compilateur soit à jour.
+Le compilateur par défaut actuellement utilisé pour développer Metafor sous Windows est le Visual Studio 2017 (numéro de version interne : vs 15.0).
+La première étape est donc de l'installer (téléchargez l'iso sur le ftp /ftpDisk/apps/_dev/Visual Studio 2012/Visual_Studio_Pro_2012_Eng.ISO) en version anglaise (la gestion des codes d'erreur est buggée en français). Seul le compilateur C++ et les "Microsoft Fundation Classes for C++" sont indispensables.
-=== Installation de svn ===
+La deuxième étape est d'appliquer le dernier service pack (/ftpDisk/apps/_dev/Visual Studio 2012/VS2012.5.iso) pour que le compilateur soit à jour.
-Les sources Metafor étant gérées par un serveur [[https://subversion.apache.org/|SVN]], il est nécessaire d'installer un client SVN pour pouvoir y accéder.
-[[http://tortoisesvn.net/|Tortoise SVN]] est le client windows généralement utilisé au service. Télécharger et installer la dernière version de la branche 1.8 (pour faciliter vos futurs commits).
+Enfin, afin d'uniformiser l'écriture du code, l'éditeur doit être configuré pour insérer 4 espace en lieu et place de la tabulation :
+Tools -> Options -> Text Editor -> All Languages -> Tabs
+=> remplacer "keep tabs" par "Insert Spaces" et "Tab size" = 4
+{{ :devel:vs2012tabs.jpg?400 |}}
+=== Installation de git ===
+Toutes les sources des modules de Metafor sont gérés par le serveur gitlab de l'université. Pour plus d'information   se référer à la page [[devel:gitconfig|]].
 ATTENTION :
-  * le "command line client tools" n'est pas sélectionné par défaut par l'installeur mais indispensable pour compiler Metafor => séléctionnez le
+  * pour éviter d'envoyer des crasses sur les serveurs git, il est important de configurer correctement son client ... [[devel:gitconfig]] dès maintenant
-  * pour éviter d'envoyer des crasses sur les serveurs svn, il est important de configurer correctement son client svn ... [[doc:devel:svnConfig]] dès maintenant
 === Installation des librairies ===
-Avant même d'installer les libs, il faut installer le compilateur (Visual Studio). Prendre la dernière version disponible sur le serveur FTP dans apps/_dev.
 Metafor nécessite une volée de libs (par exemple Python, Qt, VTK, Swig, TCL/TK...) qu'il faut compiler. La solution simple consiste à reprendre les "libs de Luc":
-  * Vérifiez que vous n'avez pas d'ancienne libs ou de python préinstallés sur votre machine
+  * Récupérer l'archive sur le ftp dernière archive :''/ftp/metafor/bin/VS2017Python3_X64/LibsVs2017Py3-XXXXXX.zip''
-  * Dézippez l'archive de Luc sur votre PC (''LibsVs2012-XXXXXX.zip'' obtenue sur le FTP de Metafor)
+  * Vérifier que vous n'avez pas d'ancienne libs ou de python installés sur votre machine
-  * Lisez le fichier ''LibsVs2012/README.txt''. Luc vous a mâchouillé tout le travail (plusieurs semaines de boulot - je vous déconseille donc de souffler en sa présence parce que vous trouvez la procédure "longue"). Il ne vous reste plus qu'à lancer une commande du type ''python setup.py'' pour que tout soit configuré automatiquement.
+  * Définir un répertoire racine de vos développements (''E:\Dev'') sur un disque ayant quelques Gb disponibles
-  * **Remarque** : pour lancer ''setup.py'' en mode administrateur dans Windows 7, cliquez sur ''Démarrer'', tapez ''cmd'' dans la case prévue et pressez Ctrl+Shift+Enter (au lieu de Enter). C'est très intuitif mais mieux vaut quand même préciser.
+  * Dézipper l'archive sur votre PC (''E:\Dev\LibsVs2017Py3'')
-  * Le projet est géré par CMake (pas besoin de l'installer, il est dans les libs de Luc), procédure CMake détaillée : [[http://metafor.ltas.ulg.ac.be/dokuwiki/commit/2010/06_13|commit du 13/06/2010]]
+  * Lire le fichier ''E:\Dev\LibsVs2012/README.txt''
+  * Ouvrir une fenetre de commande EN MODE ADMINISTRATEUR (Start -> execute -> cmd : "as administrator"!!!)
+  * Installer les Libs : executer la commande suivante:
+    * "E:\Dev64\LibsVs2017Py3\Python-XXXXX\bin\python E:\Dev64\LibsVs2017Py3\setup.py install"
+    * remplacer xxxx par le numero de la version de python dans les Libs
+  * générez un lien vers le fichier E:\Dev64\LibsVs2017Py3\LibsVS2017Py3.cmd et mettez le sur votre bureau, dans votre barre de lancement ou ... selon vos habitudes
+  * En executant le liens vers LibsVS2017Py3.cmd, une fenêtre de commande configurée et contenant toutes les librairies précompilées et les outils nécessaires à la génération du projet.
+=== Utilitaires complémentaires ===
-=== utilitaires pouvant aider au quotidien ===
+Une série de programmes complémentaires peuvent être installés pour améliorer votre expérience de programmation :
- et les outils associés:
+  * [[http://www.xoreax.com/|Incredibuild]]: compilation partagée sur le réseau
-  * [[http://www.xoreax.com/|Incredibuild]]: compilation partagée sur le réseau
+    * télécharger la dernière version sur le ftp : /ftp/apps/_dev/Incredibuild/
+    * installer en tant que "Agent"
+    * coordinateur : corto.ltas.ulg.ac.be (effectuer le test pour ouvrir les firewalls)
+    * installer les "Add-In" pour le Visual Studio 2017
   * [[http://www.araxis.com/|Araxis Merge]]: diffs entre fichiers
+    * Utilisation de Araxis Merge avec TortoiseSVN :
+    {{ :devel:tortoisearaxis.png?400 |}}
+  * [[http://notepad-plus-plus.org/|Notepad++]]: editeur de texte
   * [[http://www.editpadpro.com/|Editpad Pro]]: éditeur texte
   * [[http://www.powergrep.com/|PowerGrep]]: search/replace dans le source
   * ...