Differences

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

--- devel:configwindows [2015/01/14 17:22] – 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
+  * d'un ensemble d'outils de compilation/programmes/librairies:
     * [[http://www.cmake.org/|CMake]] : générateur de projet
-    * [[http://www.swig.org/|swig]] : interface c++/python
+    * [[http://www.swig.org/|SWIG]] : interface c++/python
-    * [[https://www.python.org/|python]] : interface utilisateur de Metafor
+    * [[https://www.python.org/|Python]] : interface utilisateur de Metafor
-    * [[https://www.threadingbuildingblocks.org/|Intel Tbb]] : librairie template de parallélisation c++
+    * [[https://www.threadingbuildingblocks.org/|Intel TBB]] : librairie template de parallélisation C++
-    * [[https://software.intel.com/en-us/intel-mkl|Intel MKL]] : librairie mathématique (blas&solver)
+    * [[https://software.intel.com/en-us/intel-mkl|Intel MKL]] : librairie mathématique (BLAS & solveur linéaire)
-    * [[http://www.vtk.org/|VTK]] : librairie de dessin (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).
+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 francais). Seul le compilateur c++ et les "Microsoft Fundation Classes for c++" sont indispensables.
+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.
-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.
+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.
+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
-=== Installation de svn ===
+{{ :devel:vs2012tabs.jpg?400 |}}
+=== Installation de git ===
-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.
+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|]].
-[[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).
 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 ===
 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 pouvant aider au quotidien ===
+=== Utilitaires complémentaires ===
 Une série de programmes complémentaires peuvent être installés pour améliorer votre expérience de programmation :
-  * [[http://visualstudiogallery.msdn.microsoft.com/3a96a4dc-ba9c-4589-92c5-640e07332afd|Productivity Power Tools 2012]] : Boite à outil du visual studio permettant entre autre d'imprimer le code en couleur (configurez les outils utils pour votre usage)
   * [[http://www.xoreax.com/|Incredibuild]]: compilation partagée sur le réseau
-    * télécharger la dernière version sur le ftp : /ftpDisk/apps/_dev/Incredibuild/
+    * 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
   * ...